Pläne, die diese Funktion unterstützen: Business Enterprise
Mit der Integration von Document360 und GitHub kann Ihr Team Wissensdatenbankartikel nahtlos mit GitHub Problemen verknüpfen und so eine bessere Zusammenarbeit zwischen Entwicklern und technischen Redakteuren ermöglichen. Sie können Aktualisierungen nachverfolgen, Dokumentationsaufgaben mit Codeänderungen verknüpfen und sicherstellen, dass Ihre Wissensdatenbank mit Ihrem Entwicklungsprozess synchronisiert bleibt, ohne zwischen den Plattformen wechseln zu müssen.
Konfigurieren von GitHub in Document360
So konfigurieren Sie GitHub in Document360:
Navigieren Sie in der linken Navigationsleiste des Wissensdatenbank-Portals zu ().
Navigieren Sie im linken Navigationsbereich zu > Erweiterungen > Teamzusammenarbeit.
Die GitHub Erweiterung finden Sie im Abschnitt .
Klicken Sie auf der Kachel der Erweiterung auf Verbinden .
Ein neues Installationsfenster wird geöffnet.
Wählen Sie je nach Ihren Anforderungen eine der beiden Optionen aus:
Alle Repositorys: Wählen Sie diese Option aus, um alle Repositorys zu synchronisieren.
Wählen Sie nur Repositorys aus – wählen Sie aus, ob bestimmte Repositorys basierend auf Ihren Projektanforderungen synchronisiert werden sollen.
Klicken Sie auf .
Wenn Sie nicht bei GitHubangemeldet sind, werden Sie zum Anmeldebildschirm weitergeleitet.
5. Geben Sie Ihre GitHubZugangsdaten ein und melden Sie sich an.
Sie werden zur Document360 Knowledge base portalweitergeleitet. Das -Modul wird angezeigt.
6. Wählen Sie GitHub () als Kategorietyp aus.
7. Wählen Sie das Repository aus Ihrem konfigurierten GitHubaus.
Ein Bestätigungs-Popup mit der Meldung "Ihr GitHub wurde erfolgreich initiiert" wird angezeigt.
Der Repository-Typ wird zusammen mit allen Zweigen als Artikel in Document360angelegt. Jedes Mal, wenn ein GitHub Benutzer das Repository aktualisiert, wird der Inhalt mit den zugeordneten Document360 Artikeln synchronisiert.
Sie können jede Entität in Document360 in der Kategorie GitHub durch ein Zweigsymbol () identifizieren.
Einrichten des Git-Repositorys
So konfigurieren Sie ein Git-Repository für den Inhaltszugriff in Document360,
Stellen Sie sicher, dass Ihr Git-Repository ordnungsgemäß eingerichtet und konfiguriert ist, um das Abrufen des Inhalts in das Document360-Projekt zu ermöglichen. Befolgen Sie die folgende Struktur:
Hauptordner:
In GitHubmuss das Repository einen Hauptordner mit dem Namen
docs
enthalten, in dem Sie Unterordner und Markdown-Artikel organisieren können.Dieser Ordnername muss unverändert bleiben.
Speicherung von Mediendateien:Speichern Sie alle Mediendateien in dem
.document360/assets
Ordner innerhalb des Verzeichnissesdocs
.Dieser Ordnername muss unverändert bleiben.
Wenn beispielsweise in einer Datei mit dem Namen "Was ist Document360" auf ein Bild verwiesen wird, sollte es in den
.document360/assets
Ordner verschoben werden.
Lagerung von Artikeln:Legen Sie innerhalb des Ordners
docs
ein separates Verzeichnis an, in dem Sie z.Barticles
. Ihre Artikel ablegen können.Die Artikel müssen im Markdown-Format (.md) vorliegen.
Einfügen von Mediendateien in Artikel:
Laden Sie die Mediendatei in den
.document360/assets
Ordner hoch.Verwenden Sie die folgende Syntax, um die Mediendatei in Ihren Artikel einzufügen:

Wenn Ihre Mediendatei z. B. den Namen
test.png
hat, verwenden Sie Folgendes:
Einrichtung der GitHub-Integration mit Document360
Im Folgenden finden Sie eine Schritt-für-Schritt-Videoanleitung zum nahtlosen Einrichten und Integrieren von GitHub in Document360.
Häufig gestellte Fragen
Können Teamkonten die in der GitHub-Kategorie erstellten Artikel bearbeiten oder veröffentlichen?
Teamkonten können die in der GitHub-Kategorie erstellten Artikel nicht bearbeiten oder veröffentlichen. Wenn Änderungen vorgenommen werden müssen, bearbeiten Sie das Quell-Repository auf GitHub und die Änderungen werden mit dem Document360 Artikel synchronisiert.