Migrer des pages de l’extension wiki vers un wiki de projet d’équipe

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

Migrez les pages créées avec l'extension du Marché Wiki vers le wiki de votre projet de l'équipe. Vous pouvez enregistrer toute page wiki créée avec l'extension Wiki Marketplace dans un dépôt Git de votre projet d'équipe.

Prérequis

Vue d’ensemble de la migration de pages et d’autres artefacts

1. Clonez le référentiel vsts-wikiTools et compilez l’outil MigrateToVSTSWiki .
2. Créez, puis clonez votre wiki Azure DevOps.
3. Déplacez et validez toutes les pages Markdown vers votre wiki Azure DevOps.
4. Exécutez l’outil de migration wiki ,MigrateToVSTSWiki.exe.
5. Lorsque l'outil de migration est terminé, transférez les modifications dans la branche principale par défaut, wikiMain, du dépôt Azure DevOps wiki.

Migrer des pages à partir de l’extension wiki

1. Clonez le référentiel vsts-wikiTools et compilez l’outil MigrateToVSTSWiki .

2. Pour générer l’outil de migration EXE, compilez le projet sous le chemin d’accès Tools/MigrateToVSTSWiki.

3. À partir d'un navigateur web, ouvrez votre projet d'équipe Azure DevOps et créez votre première page wiki.

4. Pour cloner votre wiki, obtenez l’URL. Pour plus d’informations, consultez Cloner votre wiki et modifier les pages wiki hors connexion. Nommez cet emplacement de clonage LocationA pour cette procédure.

5. Clonez le repo de votre wiki en utilisant votre IDE ou la commande git clone.

6. Clonez le dépôt de l'extension wiki. Le wiki est mappé dans un dossier qui vous a été donné lors de la création du wiki. Vous pouvez le confirmer en allant dans l'option gérer le wiki dans le wiki existant, comme le montre l'exemple suivant. Les pages de votre wiki existant sont sauvegardées dans le dossier Root.

   Par exemple, vous avez cloné le dossier sampleWiki mentionné précédemment à l'emplacement C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki

   Nommez cet emplacement LocationB pour cette procédure.

7. Créez un dossier vide dans n'importe quel chemin d'accès sur votre machine locale et nommez-le LocationC pour cette procédure.

   En résumé, les emplacements suivants sont représentés comme suit :

   • Emplacement A = Dépôt Wiki Azure DevOps
   • Emplacement B = Dépôt d'extensions Wiki
   • Emplacement C = Dossier vide dans lequel exécuter l'outil de migration

8. Ouvrez une invite de commande en tant qu'administrateur et exécutez MigrateToVSTSWiki.exe. Cet outil copie les fichiers de votre wiki existant dans le répertoire de destination que vous avez indiqué. Pendant la copie, l'outil convertit les pages pour qu'elles soient conformes au wiki Azure DevOps.

   MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

   Exemple :

   • E:\wiki\sampleWiki\_extensionWiki est le dossier dans lequel les fichiers wiki existants sont présents
   • E:\Temp\Wiki\New est le dossier vide dans lequel les fichiers migrés doivent être copiés.

9. Supprimez tous les fichiers de LocationA (s'il y en a), à l'exception des fichiers liés à Git, tels que .gitignore, etc.

10. Copiez tous les fichiers de LocationC et collez-les dans LocationA.

11. Exécutez git add . pour mettre en scène tous les fichiers nouvellement ajoutés dans LocationA pour le commit.

12. Exécutez git commit -m <commit message> pour valider les fichiers mis en scène localement.

13. Exécutez git push origin wikiMain -f pour pousser les changements vers la branche par défaut du wiki Azure DevOps.

Après avoir migré vos fichiers d’extension wiki vers le wiki Azure DevOps, vous êtes prêt à désinstaller l’extension Wiki.

Étape suivante

Contenu connexe

• Conventions de nommage de la page Wiki
• Cloner et mettre à jour des pages wiki hors connexion
• Code source pour les outils wiki
• Démarrage rapide de Git

Contributions

Ce projet a adopté le code de conduite Microsoft Open Source. Pour plus d'informations, consultez la FAQ sur le code de conduite ou communiquez avec opencode@microsoft.com pour toute question ou commentaire.