Ajouter et modifier des pages Wiki
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.
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.
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
Vous pouvez ouvrir et afficher une page wiki pour votre projet.
Connectez-vous à votre projet à l’aide d’un navigateur web pris en charge et choisissez Wiki.
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.
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.
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.
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.