Wiki provisionné et publié en tant que wiki de code

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

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 de code publié, vous pouvez gérer plusieurs wikis versionnés pour répondre à vos besoins en contenu. Cette option est disponible lorsque vous activez Azure Repos.

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.

Gérer le contenu wiki

Pour les deux types de wiki, vous pouvez travailler directement dans GitHub ou travailler hors connexion, puis envoyer vos modifications au dépôt.

Pour un wiki provisionné, vous ajoutez et gérez des pages wiki directement dans la sectionPages> du dépôt. Toutes les mises à jour de contenu d’un wiki approvisionné se produisent dans le wiki lui-même.

Pour un wiki de code publié, vous ajoutez et gérez le contenu wiki en tant que fichiers de code dans le dépôt. Vous accédez aux fichiers dans les sections Repos ou Code du référentiel sur GitHub.

L’image suivante montre les options de menu d’un wiki provisionné :

Certaines options de menu ne sont pas prises en charge pour les pages publiées sous forme de wiki de code. Pour un wiki publié en tant que code, l’option Modifier dans Repos ouvre la page active afin de pouvoir modifier le contenu en place. Mises à jour apportées à une page dans la branche sélectionnée pour le wiki publient automatiquement sur le wiki.

Ajouter des pages wiki

Les options de menu Nouvelle page et Ajouter une sous-page sont disponibles pour les deux types de wiki dans GitHub. Pour plus d’informations, consultez Ajouter et modifier des pages wiki.

Ajuster la séquence de pages et la liste des pages

Les deux types de wiki appliquent la même structure de dossiers et de fichiers dans le dépôt Git. La différence réside dans la façon dont vous conservez la séquence de pages.

Pour un wiki provisionné, GitHub 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 un wiki de code publié, vous devez gérer manuellement l'ordre des pages. Pour structurer la liste des pages dans le volet de navigation, vous définissez un fichier .order à la racine et pour chaque sous-dossier ou page parente qui contient des sous-pages. Pour plus d’informations, consultez les fichiers de référentiel Git Wiki et la structure de fichiers.

Afficher les révisions de page et revenir à la version antérieure

À partir de la page Wiki du dépôt Git, vous pouvez afficher les révisions de n’importe quelle page dans le wiki. Utilisez les options de menu Révisions ou Afficher les révisions. Pour rétablir le contenu de la page active à une version antérieure, le processus diffère selon le type de page wiki.

Pour une page wiki provisionnée , sélectionnez l’option de menu Rétablir . Pour plus d’informations, consultez Annuler un commit sur une page wiki provisionnée.

Pour une page wiki de code publiée, vous travaillez à partir d’une branche locale et soumettez une pull request pour mettre à jour la branche sur laquelle vous travaillez.

Utiliser le contrôle de version et annuler la publication du wiki

La prise en charge du contrôle de version vous permet de publier différentes versions de contenu sur des wikis distincts, en fonction d’une branche versionnée d’un dépôt Git.

Vous pouvez publier une version et annuler la publication d’un wiki uniquement si vous êtes l’utilisateur qui a publié le code pour créer un wiki. Pour plus d’informations, consultez Annuler la publication d’un wiki de code.

Supprimer le wiki du projet

Les étapes suivantes décrivent comment supprimer un wiki de projet.

1. Clonez le référentiel wiki pour sauvegarder tout le contenu. Vous trouverez l’URL wiki dans le menu Autres options (...).

2. Obtenez l’ID de dépôt Git associé à votre wiki. Vous pouvez utiliser l’API REST pour obtenir tous les wikis dans le projet.

   Par exemple, la GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 commande retourne tous les wikis dans le projet. Exécutez la commande et choisissez le wiki à supprimer.

3. Supprimez le référentiel Git associé à votre wiki à l’aide de l’API REST. Utilisez l’ID de référentiel du wiki du projet que vous avez trouvé précédemment. Vérifiez l’ID du référentiel pour vous assurer que vous ne supprimez pas le mauvais wiki.

   Par exemple, la DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/<repositoryId>?api-version=4.1 commande supprime le wiki. Remplacez <repositoryId> par l’ID de référentiel du wiki à supprimer.

Mettre à jour le wiki en mode hors connexion

Vous pouvez travailler hors connexion ou dans une branche locale pour mettre à jour le contenu des deux types de wiki. Pour plus d’informations, consultez Cloner et mettre à jour les pages wiki hors connexion.

Explorer d’autres fonctionnalités et opérations

Les deux types de wiki prennent en charge plusieurs autres fonctionnalités et opérations :

• Format Markdown
• Balises HTML
• Insérer et redimensionner des images
• Notation mathématique et caractères
• Lien vers des éléments avec une balise de hachage (#)
• 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

Quelques opérations et fonctionnalités sont disponibles pour un seul type de wiki ou l’approche d’utilisation diffère :

Contenu connexe

• Créer un wiki pour votre projet d’équipe
• Fichiers de référentiel Git Wiki et structure de fichiers
• Publier un dépôt Git sur un wiki