Wiki provisionné et publié en tant que wiki de code
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Vous pouvez gérer votre contenu wiki dans un wiki de projet d’équipe ou un wiki de code publié en tant que wiki de code. Avec un wiki publié en tant que wiki de code, vous pouvez gérer plusieurs wikis avec version pour prendre en charge vos besoins de contenu, bien qu’il soit disponible uniquement si Azure Repos est activé.
Même si les deux options conservent le contenu wiki dans des dépôts Git, la façon dont vous ajoutez, mettez à jour et gérez le contenu wiki diffère.
Remarque
La fonctionnalité wiki publiée en tant que code est actuellement disponible sur Azure DevOps Server 2018 et versions ultérieures. Pour les versions antérieures, vous ne pouvez approvisionner qu’un wiki pour votre projet d’équipe.
Options de menu de page Wiki
Avec un wiki provisionné, vous pouvez ajouter et modifier des pages directement dans le wiki. Toutes les mises à jour de contenu d’un wiki provisionné se produisent dans le wiki.
Avec un wiki de code publié, vous pouvez ajouter, modifier et mettre à jour du contenu à partir de Repos ou code.
L’image suivante montre les options d’un wiki provisionné. Plusieurs de ces options ne sont pas prises en charge pour les pages wiki de code publiées.
Par exemple, l’option Modifier dans repos pour le wiki de code publié vous permet d’accéder à la page dépôt pour modifier cette page spécifique. Mises à jour apportées à une page dans la branche que vous avez sélectionnée pour le wiki sont publiées automatiquement sur le wiki.
Fonctionnalités prises en charge et différences opérationnelles
Les deux types de wiki prennent en charge les fonctionnalités suivantes :
- Format Markdown
- Balises HTML
- Insérer et redimensionner des images
- Notation mathématique et caractères
- Lien vers des éléments de travail à l’aide de #
- Joindre un fichier
- Filtrer le contenu du Wiki
- Imprimer une page Wiki
- Mettre à jour le contenu hors connexion
- Ajouter ou modifier des pages à partir du Wiki
Le tableau suivant récapitule ces opérations ou fonctionnalités qui peuvent différer en fonction du type wiki.
| Opération | Wiki provisionné | Publié en tant que wiki de code |
|---|---|---|
| Prendre en charge plusieurs wikis, nom wiki | ✔️ | |
| Ajouter ou modifier des pages à partir de fichiers de repos>ou de fichiers de code> | ✔️ | |
| Revenir à une révision antérieure à partir du Wiki | ✔️ | |
| Revenir à une révision antérieure de Repos ou de Code | ✔️ | ✔️ |
| Gérer les wikis avec version | ✔️ | |
| Sélectionner une version wiki | ✔️ | |
| Annuler la publication d’un wiki de code | ✔️ |
Ajouter des pages
Pour les deux types de wiki, sélectionnez Nouvelle page ou Ajouter une sous-page. Pour plus d’informations, consultez Ajouter et modifier des pages wiki.
Séquence de pages et liste de pages dans le volet de navigation
Le wiki provisionné gère automatiquement la séquence de pages et la liste des pages lorsque vous ajoutez ou déplacez des pages dans le volet de navigation.
Pour structurer la liste des pages dans le volet de navigation d’un wiki de code publié en tant que wiki de code, définissez le *.order* fichier à la racine et pour chaque sous-dossier ou page parente qui contient des sous-pages.
Les deux types de wikis suivent la même structure de fichiers, c’est simplement que le wiki de code publié en tant que wiki de code vous oblige à gérer la séquence de pages manuellement.
Pour plus d’informations sur l’utilisation .order des fichiers, consultez les fichiers de référentiel Git Wiki et la structure des fichiers.
Révisions de page et restauration vers une version précédente
À partir du wiki, vous pouvez afficher les révisions de n’importe quelle page wiki. Sélectionnez Révisions ou l’option de menu Afficher les révisions .
Toutefois, le processus de restauration diffère selon le type de page wiki.
- Pour une page wiki provisionnée, sélectionnez Rétablir, comme décrit dans Rétablir une validation sur une page wiki provisionnée
- Pour une page wiki de code publiée, travaillez à partir d’une branche locale et envoyez une demande de tirage pour mettre à jour la branche à partir de laquelle vous travaillez.
Contrôle de version et annulation de la publication d’un wiki
Avec le contrôle de version, vous pouvez publier différentes versions de contenu sur des wikis distincts, en fonction d’une branche versionnée d’un référentiel Git. Vous pouvez publier une version et annuler la publication d’un wiki uniquement si vous êtes celui qui l’a créé en publiant du code sur un wiki. Pour plus d’informations, consultez Annuler la publication d’un wiki de code.
Supprimer un wiki de projet
Remarque
Les API REST wiki ne prennent pas en charge la suppression d’un wiki de projet. Par conséquent, vous devez supprimer le référentiel wiki à la place.
Clonez le référentiel wiki pour effectuer la sauvegarde de tout son contenu. Les autres options ont l’URL du wiki clone, qui peut être utilisée pour cloner le wiki.
Obtenez l’ID de dépôt Git qui sauvegarde votre wiki. Vous pouvez utiliser l’API REST pour obtenir tous les wikis dans le projet.
Par exemple,
GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1retourne tous les wikis du projet. Vous pouvez donc choisir celui à supprimer.Utilisez l’API REST pour supprimer le dépôt Git de stockage. Utilisez l’ID de dépôt du wiki du projet que vous avez trouvé à l’étape précédente et vérifiez deux fois l’ID du dépôt. Vous ne supprimez donc pas le mauvais.
Par exemple,
DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1
Mettre à jour un wiki hors connexion
Vous pouvez travailler hors connexion ou dans une branche locale pour mettre à jour le contenu d’un wiki approvisionné et publier en tant que wiki de code. Pour plus d’informations, consultez Cloner et mettre à jour les pages wiki hors connexion.