Bereitgestellte Wikis vs. veröffentlichter Code als Wiki

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

In Azure DevOps haben Sie die folgenden Optionen zum Verwalten von Wiki-Inhalten.

Während beide Optionen den Wiki-Inhalt in Git-Repositorys beibehalten, unterscheidet sich die Art und Weise, wie Sie wiki-Inhalte hinzufügen, aktualisieren und verwalten.

Hinweis

Der Veröffentlichungscode als Wiki-Feature ist derzeit auf Azure DevOps Server 2018 und späteren Versionen verfügbar. Für ältere Versionen können Sie nur ein Wiki für Ihr Teamprojekt bereitstellen.

Menüoptionen für Wiki-Seiten

Mit einem bereitgestellten Wiki fügen Sie Seiten direkt innerhalb des Wikis hinzu und bearbeiten diese. Alle Inhaltsupdates zu einem bereitgestellten Wiki treten innerhalb des Wikis auf.

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

Die nicht verfügbaren Menüoptionen für die Wiki-Seiten werden in der folgenden Abbildung angezeigt. Wie Sie sehen können, werden mehrere Optionen für die Veröffentlichung als Codewikiseiten nicht unterstützt.

Bereitgestelltes Wiki

Provisioned wiki page menu options

Veröffentlichen von Code als Wiki

Publish code page menu options

Beispielsweise wird die Option "In Repos bearbeiten" für den Veröffentlichungscode als Wiki zum Repo-Zeichenblatt verwendet, um diese bestimmte Seite zu bearbeiten. Updates, 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 betriebsbezogene Unterschiede

Bereitgestellte Wikis und veröffentlichen als Codewikis unterstützen die folgenden Features:

In der folgenden Tabelle werden diese Vorgänge oder Features zusammengefasst, die sich je nach Wiki-Typ unterscheiden können.

Seiten hinzufügen

Wählen Sie für ein bereitgestelltes Wiki oder veröffentlichen Sie Code als Wiki aus, wählen Sie "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 im Navigationsbereich 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 jede Unterordner- oder übergeordnete Seite, die Unterseiten enthält.

Beide Arten von Wikis folgen derselben Dateistruktur, es ist nur, dass der Veröffentlichungscode als Wiki erforderlich ist, um die Seitensequenz manuell zu verwalten.

Weitere Informationen zum Arbeiten mit Auftragsdateien finden Sie unter Wiki Git-Repositorydateien und Dateistruktur.

Seiten revisionen und revertieren in eine frühere Version

Aus dem Wiki können Sie die Überarbeitungen einer beliebigen Wiki-Seite anzeigen, indem Sie Überarbeitungen auswählen oder die Menüoption "Überarbeitungen anzeigen " auswählen.

Der Revert-Prozess unterscheidet sich jedoch je nach Wiki-Seitentyp.

  • Wählen Sie für eine bereitgestellte Wiki-Seite die Option "Revert" aus, wie in "Zurücksetzen" auf eine bereitgestellte Wiki-Seite beschrieben.
  • Für eine Veröffentlichung als Code-Wiki-Seite arbeiten Sie von einer lokalen Verzweigung aus, und senden Sie eine Pullanforderung, um den Zweig zu aktualisieren, von dem Sie arbeiten.

Versionsverwaltung und Aufheben der Veröffentlichung eines Wikis

Mit Versionierung können Sie verschiedene Inhaltsversionen auf unterschiedlichen Wikis veröffentlichen, basierend auf einer versionierten Verzweigung eines Git-Repo. Die Versionsverwaltung und die Veröffentlichung von Inhalten, die Sie zuvor in einem Wiki veröffentlicht haben, wird nur für Wikis unterstützt, die Sie erstellt haben, indem Sie Code in ein Wiki veröffentlichen.

Weitere Informationen finden Sie unter Version, Auswählen oder Aufheben der Veröffentlichung eines veröffentlichten Wikis.

Projektwiki löschen

  1. Rufen Sie das Wiki ab, das der Wiki-ID oder dem angegebenen Wiki-Namen entspricht. Weitere Informationen finden Sie unter Wikis – REST-API abrufen.
GET https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis/{wikiIdentifier}?api-version=6.0

Sie können auch alle Wikis in einem Projekt oder einer Sammlung abrufen. Weitere Informationen finden Sie unter Wikis - Listen-REST-API

  1. Löschen Sie das Wiki, das der wiki-ID oder dem angegebenen Wiki-Namen entspricht. Weitere Informationen finden Sie unter Wikis - Löschen der REST-API.
DELETE https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis/{wikiIdentifier}?api-version=6.0

Aktualisieren eines Wikis durch Offlinearbeit

Sie können offline oder in einem lokalen Zweig 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.