Migrera sidor från wiki-tillägget till en wiki för teamprojekt

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

Migrera sidor som skapats med Wiki Marketplace-tillägget till din gruppprojekt-wiki. Du kan spara alla wiki-sidor som skapats med Wiki Marketplace-tillägget till en Git-lagringsplats i ditt teamprojekt.

Anmärkning

Wiki Marketplace-tillägget är inaktuellt. Avinstallera den när du har migrerat dina sidor.

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 Medlem av gruppen Contributors.
Åtkomstnivåer Minst Grundläggande åtkomst.

Översikt över migrering av sidor och andra artefakter

  1. Klona vsts-wikiTools-lagringsplatsen och kompilera verktyget MigrateToVSTSWiki .
  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. När wiki-migreringsverktyget är klart skickar du ändringarna till standardhuvudgrenen, wikiMain, för Azure DevOps-wikins förvaret.

Migrera sidor från wiki-tillägget

  1. Klona vsts-wikiTools-lagringsplatsen och kompilera verktyget MigrateToVSTSWiki .

  2. Kompilera projektet under sökvägen Tools/MigrateToVSTSWikiför att generera migreringsverktyget EXE.

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

  4. Om du vill klona wikin hämtar du URL:en. Mer information finns i Klona din wiki och redigera wiki-sidor 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. Kör git commit -m <commit message> för att committa de lokalt mellanlagrade filer.

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

När du har migrerat dina wiki-tilläggsfiler till Azure DevOps-wikin är du redo att avinstallera Wiki-tillägget.

Nästa steg

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.