Migrieren von Seiten aus der Wiki-Erweiterung zu einem Teamprojektwiki

  • Artikel

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

Erfahren Sie, wie Sie Mithilfe der Wiki Marketplace-Erweiterung erstellte Seiten zu Ihrem Teamprojektwiki migrieren. Mit der Veröffentlichung des integrierten Wikis können alle wiki-Seiten, die mit der Wiki Marketplace-Erweiterung erstellt wurden, in einem Git-Repository in Ihrem Teamprojekt gespeichert werden.

Voraussetzungen

Sie müssen Mitglied der Gruppe "Mitwirkende" Ihres Teamprojekts sein, um Wiki-Seiten zu Ihrem Teamprojektwiki zu migrieren.

Migrieren von Seiten und anderen Artefakten

  1. Klonen Sie vsts-wikiTools-Repository , und kompilieren Sie das MigrateToVSTSWiki-Tool .
  2. Erstellen Sie ihr Azure DevOps-Wiki, und klonen Sie es dann.
  3. Verschieben und Übernehmen aller Markdown-Seiten in Ihr Azure DevOps-Wiki.
  4. Ausführen des Wiki-Migrationstools MigrateToVSTSWiki.exe
  5. Wenn das Wiki-Migrationstool abgeschlossen ist, übertragen Sie die Änderungen an die Standardverzweigung Standard Branch, wikiMaindes Azure DevOps-Wiki-Repositorys.

Ausführliche Schritte

  1. Klonen Sie vsts-wikiTools-Repository , und kompilieren Sie das MigrateToVSTSWiki-Tool .

  2. Kompilieren Sie das Projekt unter dem Pfad Tools/MigrateToVSTSWiki , um das Migrationstool EXE zu generieren.

  3. Öffnen Sie in einem Webbrowser Ihr Azure DevOps-Teamprojekt, und erstellen Sie Ihre erste Wiki-Seite.

  4. Rufen Sie die URL ab, um Ihr Wiki zu klonen. Siehe Klonen Sie Ihr Wiki, und bearbeiten Sie Wiki-Seiten offline.
    Benennen Sie diesen Klonspeicherort wie LocationA bei diesem Verfahren.

  5. Klonen Sie Ihr Wiki-Repository mithilfe Ihrer IDE oder des Git-Klonbefehls .

  6. Klonen Sie das Wiki-Erweiterungs-Repository. Das Wiki wird einem Ordner zugeordnet, der Ihnen während der Wiki-Erstellung zugewiesen wird. Sie können bestätigen, indem Sie zur Option "Wiki verwalten" im vorhandenen Wiki wechseln, wie im folgenden Beispiel gezeigt. Ihre vorhandenen Wiki-Seiten werden unter dem Ordner mit der Bezeichnung Rootgespeichert.

    Sie haben z. B. die zuvor Erwähnung an der Position geklontsampleWiki.C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki

    Benennen Sie diesen Speicherort wie LocationB bei diesem Verfahren.

  7. Erstellen Sie einen leeren Ordner in einem beliebigen Pfad auf Ihrem lokalen Computer, und benennen Sie ihn LocationC für dieses Verfahren.

    Zusammenfassend werden die folgenden Speicherorte wie folgt dargestellt:

    • Speicherort A = Azure DevOps-Wiki-Repository
    • Speicherort B = Wiki-Erweiterungs-Repository
    • Speicherort C = Leerer Ordner zum Ausführen des Migrationstools in

  8. Öffnen Sie eine Eingabeaufforderung als Administrator, und führen Sie sie aus MigrateToVSTSWiki.exe. Dieses Tool kopiert die Dateien aus Ihrem vorhandenen Wiki in das von Ihnen bereitgestellte Zielverzeichnis. Beim Kopieren konvertiert das Tool die Seiten so, dass sie mit dem Azure DevOps-Wiki kompatibel sind.

    MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

    Zum Beispiel:

    • E:\wiki\sampleWiki\_extensionWiki ist der Ordner, in dem die vorhandenen Wiki-Dateien vorhanden sind
    • E:\Temp\Wiki\New ist der leere Ordner, in den die migrierten Dateien kopiert werden sollen.

  9. Entfernen Sie alle Dateien LocationA von (falls vorhanden) abgesehen von den Git-bezogenen Dateien, z .gitignore. B. usw.

  10. Kopieren Sie alle Dateien aus LocationC , und fügen Sie sie in LocationA.

  11. Führen Sie die Ausführung aus git add . , um alle neu hinzugefügten Dateien für den Commit zu LocationA stufen.

  12. Führen Sie die Ausführung aus git commit -m <commit message> , um die lokal mehrstufigen Dateien zu übernehmen.

  13. Führen Sie die Schritte ausgit push origin wikiMain -f, um die Änderungen an die Standardbranch des Azure DevOps-Wikis zu übertragen.

Nachdem Sie Ihre Wiki-Erweiterungsdateien zum Azure DevOps-Wiki migriert haben, können Sie die Wiki-Erweiterung deinstallieren.

Beiträge

Dieses Projekt hat den Microsoft Open Source Code of Conduct übernommen. Weitere Informationen finden Sie im Code of Conduct FAQ oder wenden Sie sich opencode@microsoft.com an Fragen oder Kommentare.