Créer un wiki pour votre projet

  • Article

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

Dans cet article, découvrez comment ouvrir un wiki et créer un dépôt Git pour votre wiki. Chaque projet d’équipe a un wiki. Utilisez le wiki pour partager des informations avec votre équipe pour comprendre et contribuer à votre projet.

Chaque wiki de projet d’équipe est alimenté par un dépôt Git dans le back-end. Lorsque vous créez un projet d’équipe, un dépôt Git wiki n’est pas créé par défaut. Créez un dépôt Git pour stocker vos fichiers Markdown wiki ou publiez des fichiers Markdown existants à partir d’un dépôt Git sur un wiki.

Prérequis

  • Vous devez avoir un projet d’équipe. Si vous n’avez pas encore de projet d’équipe, créez-en un dans Azure DevOps.
  • Vous devez disposer au moins d’un accès de base pour créer et modifier un wiki.
  • Vous devez disposer de l’autorisation Créer un référentiel pour publier du code en tant que wiki. Par défaut, cette autorisation est définie pour les membres du groupe Administrateurs de projet.
  • Toute personne membre du groupe de sécurité Contributeurs peut ajouter ou modifier des pages wiki. Tout utilisateur ayant accès au projet d’équipe, y compris les parties prenantes, peut afficher le wiki.
  • Vous devez avoir un projet d’équipe. Si vous n’avez pas encore de projet d’équipe, créez-en un local.
  • Vous devez disposer de l’autorisation Créer un référentiel pour publier du code en tant que wiki. Par défaut, cette autorisation est définie pour les membres du groupe Administrateurs de projet.
  • Toute personne membre du groupe de sécurité Contributeurs peut ajouter ou modifier des pages wiki. Tout utilisateur ayant accès au projet d’équipe, y compris les parties prenantes, peut afficher le wiki.

Ouvrir le Wiki

Connectez-vous à votre projet à l’aide d’un navigateur web pris en charge et choisissez Wiki.

Capture d’écran montrant la sélection du menu Wiki en surbrillance.

Si vous devez changer de projet d’équipe, choisissez Azure DevOps pour parcourir tous les projets d’équipe et équipes.

Créer un dépôt Git wiki

Créez un dépôt Git qui stocke toutes vos pages wiki et artefacts associés. Dans la page d’accueil du wiki, sélectionnez Créer un wiki de projet. Même si vous utilisez TFVC pour le contrôle de code source, vous pouvez créer un wiki avec un dépôt Git.

Capture d’écran de créer un wiki, un dépôt Git pour votre wiki ou publier des fichiers Markdown existants.

Si vous n’avez pas accès à la création d’un dépôt Git wiki ou si vous n’avez pas accès à l’un des wikis existants, le message suivant s’affiche.

Capture d’écran des autorisations insuffisantes pour créer un dépôt wiki.

Votre administrateur peut créer le dépôt Git wiki ou demander qu’il élève vos autorisations. Les parties prenantes ne peuvent pas créer de wiki, car elles n’ont pas les autorisations nécessaires pour travailler dans repos ou code.

Le dépôt Git wiki est appelé TeamProjectName.wiki. Par exemple, si votre projet d’équipe est foobar alors le dépôt wiki est étiqueté foobar.wiki.

Remarque

Si vous souhaitez créer d’autres wikis, vous devez publier du code en tant que wiki. Vous pouvez configurer plusieurs dépôts wiki au sein d’un seul projet.

Comment puis-je accéder au dépôt Git ?

TeamProjectName.wiki n’apparaît pas dans le menu déroulant des référentiels à partir de Repos ou code. Il ne figure pas non plus dans la liste fournie à partir des pages Project Paramètres Référentiels > ou Project Paramètres > Contrôle de version.
Toutefois, vous pouvez y accéder à partir de l’URL suivante :

https://dev.azure.com/<Org_Name>/<Team_Project_Name>/_git/<Wiki_Name>

https://<Server_Name>/Default_Collection/<Team_Project_Name>/_git/<Wiki_Name>

Sélectionnez Cloner wiki à partir des points de suspension près du sélecteur de wiki pour accéder à l’URL du wiki.

Capture d’écran de l’action Cloner le wiki.

L’URL du dépôt Git wiki est exposée. Copiez et collez-le dans votre navigateur web pour accéder au dépôt Git sous-jacent.

Étapes suivantes

Ajouter et modifier des pages Wiki