Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Der Prozess zum Aktualisieren von Wiki-Offline ist identisch mit dem Entwickeln von Code in einem Git-Repository. Sie können Ihre bevorzugten Client- und Git-Befehlszeilentools verwenden, um Ihre Wiki-Seiten offline zu aktualisieren. Ausführliche Informationen zum Arbeiten mit Git-Repositorys und unterstützten Tools finden Sie in der Azure Repos Git-Dokumentation.
Die grundlegenden Schritte zum Offlineupdate von Wiki-Inhalten umfassen:
Fügen Sie Ihrer lokalen Git-Repositoryverzweigung Dateien oder Ordner hinzu.
Aktualisieren Sie die ORDER-Dateien , um die Sequenzänderungen für Seiten und Unterseiten widerzuspiegeln.
Committen und pushen Sie die Updates in Ihren lokalen Git-Branch.
Voraussetzungen
Kategorie | Anforderungen |
---|---|
Projektzugriff | Mitglied des Projekts, in dem sich die Wikis befinden. Sie können den Zugriff von Ihrem Projektadministrator bei Bedarf anfordern. |
Erlaubnisse | - Mitglied der Gruppe Mitwirkende. – Um Code als Wiki zu veröffentlichen, benötigen Sie die Berechtigung Repository erstellen. Diese Berechtigung ist standardmäßig für Mitglieder der Gruppe Projektadministratorenfestgelegt. |
Zugriffsebenen | Mindestens Grundlegender Zugriff. |
Aufgaben |
-
Grundlegendes zur zugrunde liegenden Struktur Ihres Git-Repositorys für Wikis. - Verstehen der Unterschiede zwischen einem bereitgestellten Wiki und einem veröffentlichten Code als Wiki. |
Klonen Ihres Wikis
Ihr Wiki-Repository speichert Seiten, Bilder, Anlagen und die Abfolge von Seiten und Unterseiten. Klonen Sie Ihr Wiki, um zu beginnen.
Melden Sie sich bei Ihrem Projekt (
https://dev.azure.com/<Organization>/<Project>
).Wählen Sie Ihr Wiki und dann "Weitere Aktionen " (...) aus. >Wiki klonen:
Wählen Sie im Dialogfeld "Repository klonen" das Symbol "Klon-URL in die Zwischenablage kopieren
" aus:
Fügen Sie die URL in Ihren Browser ein. Die Git-Repositoryseite wird geöffnet, auf der Sie die unter der WikiMain-Verzweigung definierten Dateien anzeigen können. Das folgende Beispiel zeigt die Dateien im Git-Repository für das CanaryBuilds-Projekt:
Wichtig
Das Feature "Git-Anmeldeinformationen generieren " ist für das Entfernen geplant. Lesen Sie die Dokumentation zur Git-Authentifizierung für alle Authentifizierungsmethoden, die Ihnen für Git-Klonvorgänge zur Verfügung stehen.
Verwenden Sie die URL, die Sie kopiert haben, um das Repository in Ihrer bevorzugten IDE zu klonen. Weitere Informationen finden Sie in den folgenden Artikeln:
Hinzufügen von Seiten zum lokalen Git-Repository
Git-Repositoryseiten werden als Markdown-Dateien (MD) formatiert. Für jede Seite, die Sie Ihrem Wiki hinzufügen möchten, erstellen Sie eine Markdown-Datei in Ihrem lokalen Branch. Nachdem Sie Seiten hinzugefügt haben, aktualisieren Sie die ORDER-Datei , um die Seitensequenz so anzupassen, dass sie die neuen Seiten enthält.
Seiten hinzufügen
Sie können Seiten oben in der Wiki-Struktur im Stammordner (\
) und auch in anderen Ordnern hinzufügen.
Erstellen Sie die Markdown-Datei (MD) mit dem Inhalt für die neue Seite. In den meisten Fällen entspricht der Dateiname dem Seitentitel. Ersetzen Sie im Dateinamen alle Leerzeichen im Titel durch Bindestriche (
-
). Weitere Informationen zum Erstellen von Seiteninhalten finden Sie unter Hinzufügen einer Wiki-Seite.Platzieren Sie die Datei im gewünschten Ordner in der Wiki-Struktur in Ihrer lokalen Verzweigung, z. B. im Stammordner. Der Stammordner des Beispielprojekts CanaryBuilds lautet
C:\Users\UserName\Source\Repos\CanaryBuilds.wiki
:Aktualisieren Sie die ORDER-Datei im selben Ordner, in dem Sie die neue Seitendatei platziert haben. Der Eintragstext für die Seite ist der Dateiname ohne die Markdown-Erweiterung (MD). Im CanaryBuilds-Projektbeispiel wird die neue Seite "Mitwirken" hinzugefügt, die dem Eintragstext " How-to-contribute" entspricht:
Welcome Roadmap How-to-contribute Home Reference
Weitere Informationen zur ORDER-Datei finden Sie unter "Page sequence" und ".order".
Hinzufügen von Unterseiten
Sie können auch Unterseiten für eine Seite in Ihrem Wiki erstellen:
Erstellen Sie einen Ordner, der als übergeordnete Seite dienen soll. Weitere Informationen finden Sie unter Repositorydateien und Ordnerstruktur.
Erstellen Sie die Markdown-Datei für jede Unterseite, und platzieren Sie die Datei im übergeordneten Seitenordner. Im CanaryBuilds-Projektbeispiel wird der Ordner " How-to-contribute" als übergeordnete Seite hinzugefügt:
Erstellen Sie eine ORDER-Datei im ordner der übergeordneten Seite, um die Sequenz für die Unterseiten zu definieren, wie sie im Wiki angezeigt werden sollen. Das Beispiel zeigt eine mögliche Reihenfolge von Unterseiten:
Request-extensions Licensing Smoke-test Coding-guidelines
Änderungen pushen
Wenn Ihre lokalen Updates bereit sind, übertragen Sie die Dateien an das Git-Repository.
Die hinzugefügten Seiten und Unterseiten werden sofort in Ihrem Wiki angezeigt. Das folgende Beispiel zeigt die Aktualisierungen für das CanaryBuilds-Projekt:
Wenn fehler im Prozess auftreten, wird die Seite in ihrer Wiki-Dateiliste mit einem Warnsymbol angezeigt: