Ajouter et modifier des pages Wiki

  • Article

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

Vous pouvez ajouter un titre et du contenu à une page, une fois que le dépôt Git wiki a été provisionné pour votre projet d’équipe. Il existe une expérience de modification et d’aperçu côte à côte dans laquelle vous pouvez modifier la page et afficher un aperçu du contenu au fur et à mesure.

Pendant que vous créez des pages au format Markdown, vous pouvez également utiliser le volet format pour la mise en forme de texte enrichi et l’insertion d’images, de pièces jointes et de liens.

Page d’accueil wiki

Lorsque vous modifiez la page, enregistrez-la en entrant Ctrl+S. Pour enregistrer avec un message de révision personnalisé, sélectionnez en regard de Enregistrer. Pour plus de raccourcis, consultez Raccourcis clavier pour gérer les pages wiki.

Page Enregistrer avec un message personnalisé

Outils en ligne de commande Wiki

Commandes Description
az devops wiki show Ouvrir un wiki
az devops page wiki show Obtenir le contenu d’une page ou ouvrir une page
az devops page wiki create Ajouter une nouvelle page
az devops page wiki update Modifier une page
az devops page wiki delete Supprimer une page

Notes

Pour ajouter ou modifier des pages à un wiki que vous avez publié à partir d’un dépôt Git, consultez Publier un dépôt Git sur un wiki. Cet article explique comment ajouter et modifier des pages d’un wiki que vous avez provisionné pour un projet d’équipe.

Prérequis

  • Vous devez disposer d’un wiki provisionné.
  • Vous devez être membre du projet d’équipe en tant que contributeur d’ajouter ou de mettre à jour des pages wiki.
  • Vous devez disposer du niveau d’accès de base pour modifier le wiki du projet.

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.

Ajouter une page wiki

Pour ajouter une autre page, choisissez Nouvelle page. Ou, pour ajouter une sous-page, ouvrez le menu contextuel d’une page existante et sélectionnez Ajouter une sous-page.

Spécifiez un titre unique de 235 caractères ou moins. Les titres de page respectent la casse. Pour obtenir d’autres restrictions de titre, consultez Fichiers de dépôt Git Wiki et structure de fichiers, Conventions de nommage de fichiers.

Capture d’écran de la première page wiki.

Vous pouvez également utiliser des raccourcis clavier pour ajouter une nouvelle page en appuyant sur n ou ajouter une sous-page en appuyant sur c. Pour obtenir la liste complète des raccourcis clavier, consultez Raccourcis clavier pour gérer les pages wiki.

Restrictions de nommage de titre de page Wiki

Chaque page wiki correspond à un fichier dans le référentiel Git wiki. Les noms que vous affectez au titre d’une page wiki doivent être conformes aux restrictions suivantes.

Type de restriction Restriction
Nom de fichier Le chemin complet de la page ne doit pas dépasser 235 caractères.
Unicité Les titres de page respectent la casse et doivent être uniques au sein de la hiérarchie du wiki.
Caractères spéciaux - Ne doit pas contenir de caractères de contrôle Unicode ou de caractères de substitution.
- Ne doit pas contenir les caractères imprimables suivants : / \ #.
- Ne doit pas commencer ou se terminer par un point ..
Taille du fichier Ne doit pas dépasser le maximum de 18 Mo.
Taille du fichier de pièce jointe Ne doit pas dépasser le maximum de 19 Mo.

Caractères spéciaux dans les titres des pages Wiki

Vous pouvez spécifier des titres de page qui contiennent un ou plusieurs de ces caractères : < > * ? | -spéciaux . Par exemple, vous pouvez nommer un fichier Markdown « FAQ » ou « Guide de configuration ». Les caractères ont les chaînes encodées d’URI suivantes :

Caractère Chaîne encodée
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" %22

Modifier et supprimer des pages wiki

Pour modifier une page wiki existante, ouvrez la page et sélectionnez Modifier, ou ouvrez le menu contextuel et sélectionnez Modifier. Vous pouvez également utiliser le raccourci clavier e pour accéder rapidement à la modification de la page active.

Pour les wikis de code, vous pouvez modifier une page dans l’éditeur côte à côte, à l’aide de la barre d’outils markdown pour créer votre contenu. Cette expérience est identique au processus dans un wiki de projet. Vous pouvez également modifier des pages wiki dans le hub Repos à l’aide de l’option Modifier dans Repos.

Capture d’écran de la page Modifier le wiki.

Si votre wiki de code comporte des stratégies de branche, sélectionnez Modifier dans Repos pour créer une branche et continuer à modifier. L’option Edit in Repos est spécifiquement disponible pour les wikis de code.

Pour supprimer une page, ouvrez le menu contextuel à partir de l’arborescence ou de celle à l’intérieur de la page, puis sélectionnez Supprimer. Confirmez la suppression dans la boîte de dialogue qui s’ouvre.

Remarque

Lorsque vous supprimez une page, vous supprimez également toutes les métadonnées et toutes ses sous-pages (le cas échéant) dans la hiérarchie.

Réorganiser une page wiki

Vous pouvez réorganiser les pages dans l’arborescence wiki pour que les pages apparaissent dans l’ordre et la hiérarchie souhaités. Vous pouvez glisser-déplacer un titre de page dans l’arborescence pour effectuer les opérations suivantes :

  • Modifier la relation parent-enfant d’une page.
  • Modifiez l’ordre de la page dans la hiérarchie.

Notes

Le déplacement d’une page dans la hiérarchie peut interrompre les liens vers celle-ci à partir d’autres pages. Vous pouvez toujours corriger les liens manuellement après le déplacement. La réorganisation d’une page au sein d’une hiérarchie n’a aucun impact sur les liens de page.

Vous pouvez également utiliser des raccourcis clavier pour réorganiser les pages. Sélectionnez une page et appuyez sur Ctrl + Haut ou Ctrl + Bas pour modifier les ordres de page. Pour modifier la relation parent-enfant d’une page, ouvrez son menu contextuel et sélectionnez Déplacer. La boîte de dialogue Déplacer la page s’ouvre. Sélectionnez une page parente sous laquelle vous pouvez déplacer la page active.

Déplacer la page wiki dans la hiérarchie

Pour obtenir la liste complète des raccourcis clavier, consultez Raccourcis clavier pour gérer les pages wiki.

Faire d’une page la page d’accueil du wiki

Par défaut, la première page que vous ajoutez lorsque vous créez un wiki est définie comme page d’accueil du wiki. Vous pouvez modifier la page d’accueil de votre wiki si une autre page devient plus pertinente en la faisant glisser-déposer en haut de l’arborescence.

Étapes suivantes

Afficher l’historique des pages wiki et rétablir