Hinzufügen und Bearbeiten von Wiki-Seiten

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

Sie können einen Titel und Inhalt zu einer Seite hinzufügen, nachdem das Wiki-Git-Repository für Ihr Teamprojekt bereitgestellt wurde. Es gibt eine parallele Bearbeitungs- und Vorschauumgebung, in der Sie die Seite bearbeiten und den Inhalt in der Vorschau anzeigen können.

Während Sie Seiten mit dem Markdown-Format erstellen, können Sie auch den Formatbereich für Rich-Text-Formatierung und das Einfügen von Bildern, Anlagen und Links verwenden.

Wiki-Startseite

Wenn Sie die Seite bearbeiten, speichern Sie sie, indem Sie STRG+S eingeben. Um mit einer benutzerdefinierten Revisionsnachricht zu speichern, wählen Sie neben Speichern aus. Weitere Verknüpfungen finden Sie unter Tastenkombinationen zum Verwalten von Wikiseiten.

Seite

Wiki-Befehlszeilentools

Befehle BESCHREIBUNG
az devops wiki show Öffnen eines Wikis
az devops wiki page show Abrufen des Inhalts einer Seite oder Öffnen einer Seite
az devops wiki page create Hinzufügen einer neuen Seite
az devops wiki page update Bearbeiten einer Seite
az devops wiki page delete Löschen einer Seite

Hinweis

Informationen zum Hinzufügen oder Bearbeiten von Seiten zu einem Wiki, das Sie aus einem Git-Repository veröffentlicht haben, finden Sie unter Veröffentlichen eines Git-Repositorys in einem Wiki. In diesem Artikel wird erläutert, wie Sie Seiten eines Wikis hinzufügen und bearbeiten, die Sie für ein Teamprojekt bereitgestellt haben.

Voraussetzungen

  • Sie müssen über ein bereitgestelltes Wiki verfügen.
  • Sie müssen Mitglied des Teamprojekts als Mitwirkender sein, um Wikiseiten hinzuzufügen oder zu aktualisieren.
  • Sie benötigen die Zugriffsebene Basic, um das Projektwiki zu bearbeiten.

Öffnen des Wikis

Stellen Sie mithilfe eines unterstützten Webbrowsers eine Verbindung mit Ihrem Projekt her, und wählen Sie Wiki aus.

Screenshot: Hervorgehobene Auswahl des Wiki-Menüs

Wenn Sie Ihr Teamprojekt wechseln müssen, wählen Sie Azure DevOps aus, um alle Teamprojekte und Teams zu durchsuchen.

Hinzufügen einer Wikiseite

Um eine weitere Seite hinzuzufügen, wählen Sie Neue Seite aus. Um eine Unterseite hinzuzufügen, öffnen Sie auch das Kontextmenü einer vorhandenen Seite, und wählen Sie Unterseite hinzufügen aus.

Geben Sie einen eindeutigen Titel mit mindestens 235 Zeichen an. Bei Seitentiteln wird die Groß-/Kleinschreibung beachtet. Weitere Titeleinschränkungen finden Sie unter Wiki Git-Repositorydateien und -Dateistruktur, Dateibenennungskonventionen.

Screenshot der ersten Wiki-Seite.

Sie können auch Tastenkombinationen verwenden, um eine neue Seite hinzuzufügen, indem Sie n drücken oder eine Unterseite hinzufügen, indem Sie c drücken. Eine vollständige Liste der Tastenkombinationen finden Sie unter Tastenkombinationen zum Verwalten von Wikiseiten.

Namenseinschränkungen für Wiki-Seitentitel

Jede Wiki-Seite entspricht einer Datei innerhalb des Wiki-Git-Repositorys. Namen, die Sie einem Wiki-Seitentitel zuweisen, müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Dateiname Der vollqualifizierte Seitenpfad sollte 235 Zeichen nicht überschreiten.
Eindeutigkeit Bei Seitentiteln wird die Groß-/Kleinschreibung beachtet, und sie müssen innerhalb der Wiki-Hierarchie eindeutig sein.
Sonderzeichen - Darf keine Unicode-Steuerelementzeichen oder Ersatzzeichen enthalten.
– Darf die folgenden druckbaren Zeichen nicht enthalten: / \ #.
: Darf nicht mit einem Punkt beginnen oder enden ..
Dateigröße Sie dürfen die Maximalgröße von 18 MB nicht überschreiten.
Dateigröße von Anlagen Darf den Höchstwert von 19 MB nicht überschreiten.

Sonderzeichen in Wiki-Seitentiteln

Sie können Seitentitel angeben, die eines oder mehrere dieser Sonderzeichen : < > * ? | -enthalten. Beispielsweise können Sie eine Markdowndatei als "FAQ?" oder "Einrichtungsleitfaden" benennen. Die Zeichen weisen die folgenden URI-codierten Zeichenfolgen auf:

Zeichen Codierte Zeichenfolge
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" %22

Bearbeiten und Löschen von Wiki-Seiten

Um eine vorhandene Wiki-Seite zu bearbeiten, öffnen Sie die Seite, und wählen Sie Bearbeiten aus, oder öffnen Sie das Kontextmenü, und wählen Sie Bearbeiten aus. Sie können auch die Tastenkombination e verwenden, um schnell zur Bearbeitung der aktuellen Seite zu wechseln.

Bei Codewikis können Sie eine Seite im parallelen Editor bearbeiten, indem Sie die Markdownsymbolleiste verwenden, um Ihre Inhalte zu erstellen. Diese Erfahrung ist identisch mit dem Prozess in einem Projektwiki. Sie können Auch Wiki-Seiten im Repos-Hub bearbeiten, indem Sie die Option In Repos bearbeiten verwenden.

Screenshot der Seite

Wenn Ihr Codewiki Über Verzweigungsrichtlinien verfügt, wählen Sie "In Repos bearbeiten" aus, um eine Verzweigung zu erstellen und die Bearbeitung fortzusetzen. Die Option "In Repos bearbeiten" ist speziell für Codewikis verfügbar.

Um eine Seite zu löschen, öffnen Sie das Kontextmenü in der Struktur oder der Auf der Seite, und wählen Sie Löschen aus. Bestätigen Sie den Löschvorgang im daraufhin geöffneten Dialogfeld.

Hinweis

Wenn Sie eine Seite löschen, löschen Sie auch alle Metadaten und alle unterseiten (sofern vorhanden) in der Hierarchie.

Neuanordnen einer Wiki-Seite

Sie können Seiten in der Wiki-Strukturansicht neu anordnen, damit Seiten in der gewünschten Reihenfolge und Hierarchie angezeigt werden. Sie können einen Seitentitel in der Strukturansicht ziehen und ablegen, um die folgenden Vorgänge auszuführen:

  • Ändern sie die Beziehung zwischen über- und untergeordneten Elementen einer Seite.
  • Ändern Sie die Reihenfolge der Seite innerhalb der Hierarchie.

Hinweis

Durch das Verschieben einer Seite in der Hierarchie werden möglicherweise Links von anderen Seiten unterbrochen. Sie können die Links nach dem Verschieben jederzeit manuell korrigieren. Das Neuanordnen einer Seite innerhalb einer Hierarchie hat keine Auswirkungen auf Seitenlinks.

Sie können auch Tastenkombinationen verwenden, um Seiten neu anzuordnen. Wählen Sie eine Seite aus, und drücken Sie STRG+NACH-OBEN oder STRG+NACH-UNTEN , um seitenreihenfolgen zu ändern. Um die Beziehung zwischen über- und untergeordneten Elementen einer Seite zu ändern, öffnen Sie das zugehörige Kontextmenü, und wählen Sie Verschieben aus. Das Dialogfeld Seite verschieben wird geöffnet. Wählen Sie eine übergeordnete Seite aus, unter der Sie die aktuelle Seite verschieben können.

Wiki-Seite in der Hierarchie verschieben

Eine vollständige Liste der Tastenkombinationen finden Sie unter Tastenkombinationen zum Verwalten von Wiki-Seiten.

Erstellen einer Seite zur Wiki-Startseite

Standardmäßig wird die erste Seite, die Sie hinzufügen, wenn Sie ein Wiki erstellen, als Wiki-Startseite festgelegt. Sie können Ihre Wiki-Startseite ändern, wenn eine andere Seite relevanter wird, indem Sie die Seite an den oberen Rand der Struktur ziehen und ablegen.

Nächste Schritte