Dela via

Migrate pages from the wiki extension to a team project wiki

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

Learn how to migrate pages created using the Wiki Marketplace extension to your team project wiki. You can save any wiki pages created using the Wiki Marketplace extension to a Git repo in your team project.

Anmärkning

The Wiki Marketplace extension is deprecated. Uninstall it after you migrate your pages.

Förutsättningar

Kategori Requirements
Projektåtkomst Medlem i projektet där wikin finns. Om du inte har åtkomst kan du begära det från projektadministratören.
behörigheter Member of the Contributors group.
Åtkomstnivåer Minst Grundläggande åtkomst.

Overview of migrating pages and other artifacts

  1. Clone the vsts-wikiTools repository and compile the MigrateToVSTSWiki tool.
  2. Skapa och klona sedan din Azure DevOps-wiki.
  3. Flytta och kommittera alla Markdown-sidor till din Azure DevOps-wiki.
  4. Kör wiki-migreringsverktyget MigrateToVSTSWiki.exe
  5. When the wiki migration tool is complete, push the changes to the default main branch, wikiMain, of the Azure DevOps wiki repository.

Migrate pages from the wiki extension

  1. Clone the vsts-wikiTools repository and compile the MigrateToVSTSWiki tool.

  2. To generate the migration tool EXE, compile the project under the path Tools/MigrateToVSTSWiki.

  3. Öppna ditt Azure DevOps-teamprojekt från en webbläsare och skapa din första wiki-sida.

  4. To clone your wiki, get the URL. For more information, see Clone your wiki and edit wiki pages offline.
    Namnge den här klonplatsen som LocationA för den här proceduren.

  5. Klona wiki-lagringsplatsen med hjälp av din IDE eller kommandot git clone.

  6. Klona lagringsplatsen för wiki-tillägget. Wikin mappas till en mapp som du fick när wikin skapades. Du kan bekräfta genom att gå till alternativet hantera wiki- i den befintliga wikin, som du ser i följande exempel. Dina befintliga wiki-sidor sparas under mappen med etiketten Root.

    Till exempel klonade du det tidigare nämnda sampleWiki på platsen C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki

    Namnge den här platsen som LocationB för den här proceduren.

  7. Skapa en tom mapp i valfri sökväg på den lokala datorn och ge den namnet LocationC för den här proceduren.

    Sammanfattningsvis representeras följande platser på följande sätt:

    • Plats A = Azure DevOps Wiki-lagringsplats
    • Plats B = Lagringsplats för Wiki-tillägg
    • Plats C = Tom mapp för att köra migreringsverktyget i

  8. Öppna en kommandoprompt som administratör och kör MigrateToVSTSWiki.exe. Det här verktyget kopierar filerna från din befintliga wiki till målkatalogen som du anger. Under kopieringen konverterar verktyget sidorna så att de är kompatibla med Azure DevOps-wikin.

    MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

    Till exempel:

    • E:\wiki\sampleWiki\_extensionWiki är mappen där de befintliga wiki-filerna finns
    • E:\Temp\Wiki\New är den tomma mapp som de migrerade filerna ska kopieras till.

  9. Ta bort alla filer från LocationA (om sådana finns) förutom Git-relaterade filer, till exempel .gitignoreoch så vidare.

  10. Kopiera alla filer från LocationC och klistra in dem i LocationA.

  11. Kör git add . för att stega upp alla nyligen tillagda filer i LocationA för commit.

  12. Run git commit -m <commit message> to commit the locally staged files.

  13. Kör git push origin wikiMain -f för att skicka ändringarna till standardgrenen för Azure DevOps-wikin.

After you migrate your wiki extension files to the Azure DevOps wiki, you're ready to uninstall the Wiki extension.

Nästa steg

Uninstall the Wiki extension

Bidrag

Det här projektet antog Microsoft Open Source Code of Conduct. Mer information finns i vanliga frågor och svar om uppförandekod eller kontakta opencode@microsoft.com med frågor eller kommentarer.