Wikis provisionnés et code publié en tant que wiki

  • Article

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

Dans Azure DevOps, vous pouvez gérer votre contenu wiki dans un wiki de projet d’équipe ou un wiki 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

Le code de publication en tant que fonctionnalité wiki 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 code de publication en tant que wiki, vous pouvez ajouter, modifier et mettre à jour du contenu à partir de Repos ou de Code.

L’image suivante montre les options d’un wiki provisionné. Plusieurs de ces options ne sont pas prises en charge pour la publication en tant que pages wiki de code.

Capture d’écran des options de menu De page Wiki provisionnée.

Par exemple, l’option Modifier dans Repos pour le code de publication en tant que wiki vous amène à la page Dépôt pour modifier cette page spécifique. Mises à jour que vous effectuez sur une page dans la branche que vous avez sélectionnée pour le wiki sont automatiquement publiés 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 :

Le tableau suivant récapitule ces opérations ou fonctionnalités qui peuvent différer en fonction du type wiki.

Opération Wiki provisionné Publier du code en tant que wiki
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 code de publication en tant que wiki, définissez le fichier .order à 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 code de publication que le wiki exige que vous mainteniez manuellement la séquence de pages.

Pour plus d’informations sur l’utilisation des fichiers .order , consultez les fichiers de référentiel Git Wiki et la structure de 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 publication en tant que page wiki de code, 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. Le contrôle de version et la publication d’un wiki sont pris en charge uniquement pour les wikis que vous avez créés en publiant du code sur un wiki. Pour plus d’informations, consultez Publier un wiki de code/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.

  1. 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.

  2. 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.1 retourne tous les wikis du projet. Vous pouvez donc choisir celui à supprimer.

  3. 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 doublez case activée l’ID de référentiel, de sorte que vous ne supprimez 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.