Freigeben über


Bereitgestelltes Wiki im Vergleich zur Veröffentlichung als Codewiki

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

Sie können Ihre Wiki-Inhalte in einem Teamprojektwiki oder als Codewiki veröffentlicht verwalten. Mit einem als Codewiki veröffentlichten Wiki können Sie mehrere versionsierte Wikis verwalten, 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

Das als Codewiki-Feature veröffentlichte 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 als Codewiki veröffentlichten Code können Sie Inhalte aus Repos oder Code hinzufügen, bearbeiten und aktualisieren.

Die folgende Abbildung zeigt Optionen für ein bereitgestelltes Wiki. Einige dieser Optionen werden für die als Codewikiseiten veröffentlichten Optionen nicht unterstützt.

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

Beispielsweise gelangen Sie mit der Option "In Repos bearbeiten" für das als Codewiki veröffentlichte Option zur Seite "Repository ", 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.

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 ein als Codewiki veröffentlichtes Element 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 das als Codewiki veröffentlichte Wiki erfordert, dass Sie die Seitensequenz manuell verwalten müssen.

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

Seitenrevisionen und Wiederherstellen 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 Wiederherstellungsvorgang 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 als Codewiki-Seite veröffentlichten Seite arbeiten Sie von einer lokalen Verzweigung aus, und senden Sie eine Pullanforderung, um die Verzweigung zu aktualisieren, von der Sie gerade 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. Sie können ein Wiki nur dann versionieren und wiederveröffentlicht, wenn Sie es durch Veröffentlichen von Code in einem Wiki erstellt haben. Weitere Informationen finden Sie unter 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.