Bereitgestellte Wikis im Vergleich zu veröffentlichtem Code als Wiki

  • Artikel

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

In Azure DevOps können Sie Ihre Wiki-Inhalte in einem Teamprojektwiki oder als Codewiki veröffentlicht Standard. Mit einem als Codewiki veröffentlichten Wiki können Sie mehrere versionsierte Wikis Standard, um Ihre Inhaltsanforderungen zu unterstützen, obwohl sie nur verfügbar ist, wenn Azure Repos aktiviert ist.

Zwar verwalten beide Optionen den Wiki-Inhalt in Git-Repositorys, doch unterscheidet sich die Art und Weise, wie Sie den Wiki-Inhalt hinzufügen, aktualisieren und verwalten.

Hinweis

Der Veröffentlichungscode als Wiki-Feature ist derzeit in Azure DevOps Server 2018 und höheren Versionen verfügbar. Bei älteren Versionen können Sie nur ein Wiki für Ihr Teamprojekt bereitstellen.

Menüoptionen für Wiki-Seiten

Mit einem bereitgestellten Wiki können Sie Seiten direkt im Wiki hinzufügen und bearbeiten. Alle Inhaltsaktualisierungen für ein bereitgestelltes Wiki erfolgen innerhalb des Wikis.

Mit einem Veröffentlichungscode als Wiki können Sie Inhalte aus Repos oder Code hinzufügen, bearbeiten und aktualisieren.

Die folgende Abbildung zeigt Optionen für ein bereitgestelltes Wiki. Mehrere dieser Optionen werden für die Veröffentlichung als Codewikiseiten nicht unterstützt.

Screenshot der Menüoptionen für bereitgestellte Wiki-Seiten.

Die Option "In Repos bearbeiten" für den Veröffentlichungscode als Wiki führt Sie beispielsweise zur Repositoryseite, um diese bestimmte Seite zu bearbeiten. Aktualisierungen, die Sie an einer Seite in der Für das Wiki ausgewählten Verzweigung vornehmen, werden automatisch im Wiki veröffentlicht.

Unterstützte Features und Betriebsunterschiede

Beide Wiki-Typen unterstützen die folgenden Features:

In der folgenden Tabelle sind die Vorgänge oder Features zusammengefasst, die je nach Wiki-Typ unterschiedlich sein können.

Vorgang Bereitgestelltes Wiki Veröffentlichen von Code als Wiki
Unterstützen mehrerer Wikis, Namenswiki ✔️
Hinzufügen oder Bearbeiten von Seiten aus Repos>Files oder Code Files> ✔️
Wiederherstellen einer früheren Überarbeitung aus dem Wiki ✔️
Wiederherstellen einer früheren Überarbeitung von Repos oder Code ✔️ ✔️
Verwalten von versionsierten Wikis ✔️
Auswählen einer Wiki-Version ✔️
Aufheben der Veröffentlichung eines Codewikis ✔️

Seiten hinzufügen

Wählen Sie für beide Wiki-Typen die Option "Neue Seite " oder "Unterseite hinzufügen" aus. Weitere Informationen finden Sie unter Hinzufügen und Bearbeiten von Wiki-Seiten.

Seitensequenz und Seitenliste im Navigationsbereich

Das bereitgestellte Wiki verwaltet die Seitensequenz und die Seitenliste automatisch, wenn Sie Seiten innerhalb des Navigationsbereichs hinzufügen oder verschieben.

Um die Liste der Seiten im Navigationsbereich für einen Veröffentlichungscode als Wiki zu strukturieren, definieren Sie die ORDER-Datei im Stammverzeichnis und für jeden Unterordner oder jede übergeordnete Seite, die Unterseiten enthält.

Beide Arten von Wikis folgen derselben Dateistruktur, es ist nur, dass der Veröffentlichungscode als Wiki erfordert, dass Sie die Seitensequenz manuell Standard.

Weitere Informationen zum Arbeiten mit ORDER-Dateien finden Sie unter Wiki Git Repository-Dateien und Dateistruktur.

Seitenrevisionen und rückgängig machen ing zu einer früheren Version

Im Wiki können Sie die Überarbeitungen einer beliebigen Wiki-Seite anzeigen. Wählen Sie "Überarbeitungen " oder die Menüoption "Überarbeitungen anzeigen" aus.

Der rückgängig machen Prozess unterscheidet sich jedoch je nach Wiki-Seitentyp.

  • Wählen Sie für eine bereitgestellte Wiki-Seite die Option "Zurücksetzen" aus, wie unter "Commit zurücksetzen" auf eine bereitgestellte Wiki-Seite beschrieben.
  • Bei einer Veröffentlichung als Codewiki-Seite können Sie von einer lokalen Verzweigung aus arbeiten und eine Pullanforderung senden, um die Verzweigung zu aktualisieren, von der Sie arbeiten.

Versionsverwaltung und Aufheben der Veröffentlichung eines Wikis

Mit der Versionsverwaltung können Sie verschiedene Inhaltsversionen auf unterschiedlichen Wikis veröffentlichen, basierend auf einem versionsbasierten Verzweigung eines Git-Repositorys. Versionsverwaltung und Aufheben der Veröffentlichung eines Wikis wird nur für Wikis unterstützt, die Sie durch veröffentlichen von Code in einem Wiki erstellt haben. Weitere Informationen finden Sie unter Veröffentlichen eines Codewikis/Aufheben der Veröffentlichung eines Codewikis.

Löschen eines Projektwikis

Hinweis

Wiki-REST-APIs unterstützen das Löschen eines Projektwikis nicht. Daher müssen Sie stattdessen das Wiki-Repository löschen.

  1. Klonen Sie das Wiki-Repository, um die Sicherung aller Inhalte zu übernehmen. Die "Weitere Optionen" enthält die Klon-Wiki-URL, die zum Klonen des Wikis verwendet werden kann.

  2. Rufen Sie die Git-Repository-ID ab, die Ihr Wiki zurückgibt. Sie können die REST-API verwenden, um alle Wikis im Projekt abzurufen.

    Gibt beispielsweise GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 alle Wikis im Projekt zurück, sodass Sie auswählen können, welches gelöscht werden soll.

  3. Verwenden Sie die REST-API, um das zugrunde stehenden Git-Repository zu löschen. Verwenden Sie die Repository-ID des Projektwikis, das Sie im vorherigen Schritt gefunden haben, und überprüfen Sie die Repository-ID, sodass Sie nicht das falsche entfernen.

    Beispiel: DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1

Aktualisieren eines Wikis offline

Sie können offline oder in einer lokalen Verzweigung arbeiten, um Inhalte für ein bereitgestelltes Wiki zu aktualisieren und als Codewiki zu veröffentlichen. Weitere Informationen finden Sie unter Klonen und Aktualisieren von Wiki-Seiten offline.