Mehrere GitHub-Ordner synchronisieren
6 min
wenn sie mehrere ordner in ihrem repository haben, die sie für ihre dokumentation verwenden, können sie sie jetzt alle mit archbee synchronisieren erinnerung daran, wie man archbee und github integriert falls sie eine gedächtnisstütze benötigen, wie man die beiden integriert https //docs archbee com/github#jjpev , finden sie hier eine vollständige anleitung dazu bis jetzt konnten sie die archbee yaml datei nur in einem einzigen ordner und für ein einziges dokumentationsprojekt verwenden jetzt können sie dies mit mehreren ordnern tun wenn archbee eine archbee yaml datei im hauptverzeichnis des repositorys oder in einem anderen ordner findet, verwenden wir diese zur organisation des inhalts es ist dieselbe datei in allen ordnern, in denen sie dokumente gespeichert haben hier ist ein beispiel dafür, wie sie ihr git repository einrichten und konfigurieren können, sodass archbee den inhalt abrufen und sauber in unserer software strukturieren kann > archbee git repository https //github com/dragosbulugean/slate repository einrichten verweisen sie auf unser oben erwähntes archbee repository wenn das system eine archbee yaml datei im root des repositories findet, wie diese hier https //github com/dragosbulugean/slate/blob/master/ archbee yaml , dann nutzen wir diese, um den inhalt zu organisieren falls nicht, setzen wir einfach einige standardwerte erstellen sie eine yaml datei für mehrere ordner erstellen sie eine archbee yaml datei mit der folgenden variablen struktur s ie müssen die datei im root ordner ihres repository bzw ihrer repositories ablegen stellen sie sicher, dass die datei dort bleibt, da dies ihr standardpfad für alle anderen ordner ist root /docs eigenschaft definiert, wo sich das verzeichnis mit den dokumenten befindet (kann ersetzt werden durch docspath /docs ) structure summary summary md rekonstruiert den dokumentenbaum im linken navigationsbereich in archbee wenn keiner vorhanden ist, betrachten wir die ordner als kategorien und ahmen die dateistruktur darin nach assets assets der assets ordner ist relativ zu docspath archbee lädt alle in diesem ordner gefundenen dateien hoch # dies wird alle code dateien aus deinem repository einschließen shadowdocs definiert die code dateien/ordner, die als shadow docs eingeschlossen werden sollen publishspace boolean, setze auf true um den space nach jedem commit im produktionsportal zu veröffentlichen unten ist ein beispiel einer archbee yaml konfigurationsdatei mit dem standard pfad (ordner) archbee yaml root /docs structure summary summary md assets assets publishspace true headerincludes | \<script> document getelementbyid("demo") innerhtml = "hello javascript!"; \</script> beispiel einer archbee yaml konfigurationsdatei mit unterpfaden root folderx structure summary summary md assets assets publishspace true headerincludes | \<script> document getelementbyid("demo") innerhtml = "hello javascript!"; \</script> wenn du fertig bist, gehe zurück zu archbee und prüfe, ob du im dropdown menü mehrere ordner auswählen kannst wir empfehlen außerdem, dass du eine summary md datei erstellst diese datei rekonstruiert den dokumentenbaum im linken navigationsbereich in archbee und hilft dir, deine inhalte gut zu organisieren sieh dir unten ein beispiel für eine summary md datei an summary md \[introduction]\(1 md) \## table of contents \ \[init]\(init md) \ \[configure app]\(config md) \ \[config database]\(config database md) \ \[config redis]\(config redis md) \ \[config elastic search]\(config es md) \ \[swagger]\(swagger v2 json) synchronisierung in archbee wenn sie einen neuen space erstellen und ihr repository auswählen, werden änderungen automatisch in archbee synchronisiert wenn das nicht automatisch funktioniert, können sie die synchronisierung erzwingen, indem sie zu space einstellungen > github integration > navigieren und auf die schaltfläche mit repo synchronisieren klicken
Have a question?
Our super-smart AI, knowledgeable support team and an awesome community will get you an answer in a flash.
To ask a question or participate in discussions, you'll need to authenticate first.