GitHub-Wiki-Verzeichnisse

Unterstützt das Wiki, das mit einem GitHub-Repo installiert wird, Verzeichnisse? Unser Wiki ist voll mit Seiten und wir suchen nach einer Möglichkeit, sie besser zu organisieren.

Wir haben versucht, das Repo abzurufen, lokale Verzeichnisse zu erstellen und Dinge zu verschieben, aber als das Wiki zurückgeschrieben wurde, hat es die Änderungen nicht übernommen.

Ich hatte genau das gleiche Problem und habe Varianten von dem ausprobiert, was Sie versucht haben. Nichts klebte fest. Ich habe den GitHub-Support danach gefragt und eine Antwort erhalten, die im Wesentlichen "Nein, aber wir werden die Entwickler wissen lassen, dass die Leute an dieser Funktion interessiert sind."

Die kurze Antwort lautet also "Nein" und die lange Antwort "Nein, aber vielleicht in der Zukunft".

Tatsächlich sieht es so aus, als hätte Github kürzlich Unterstützung für Verzeichnisse hinzugefügt.

Ich konnte Folgendes tun:

• Verschieben Sie eine vorhandene Markdown-Datei in ein neues Verzeichnis.
• Erstellen Sie eine neue Markdown-Datei in einem vorhandenen Verzeichnis (im vorherigen Schritt erstellt).
• Erstellen Sie eine neue Markdown-Datei in einem neuen Verzeichnis.

In allen Fällen waren die vorhandenen Seiten noch vorhanden und neue Seiten wurden hinzugefügt.

Die einzige Einschränkung, die bestehen bleibt, ist, dass Ihre Dateinamen eindeutig sein müssen. Wenn Sie mehr als eine Datei mit demselben Namen haben, wird nur eine davon im Wiki angezeigt (ich bin mir nicht sicher, welche ..).

Das GitHub-Wiki (auch bekannt als Gollum ) verwendet Verzeichnisse, jedoch nicht so, wie Sie es vielleicht erwarten.

Die Dokumentation im Gollum-Wiki könnte etwas Arbeit gebrauchen, aber das habe ich hauptsächlich durch Tests herausgefunden.

• Alle Dateien werden im Stammverzeichnis des Wikis angezeigt, unabhängig davon, wo sie im Repo abgelegt sind.
• _Header, _Footerund _SidebarDateien sind pro Verzeichnis, werden jedoch vererbt, wenn in einem untergeordneten Ordner keine vorhanden sind.
• Dateilinks können relativ zur Quelldatei sein (behalten Sie Ihre Dateien mit Ihrem Inhalt).

Wenn Sie also Verzeichnisse für den Namespace benötigen, haben Sie kein Glück. Erwägen Sie die Verwendung des {namespace}-{page}Schemas für den Namespace.

Dies ist keine ideale Lösung, aber die Problemumgehung besteht darin, eine benutzerdefinierte Seitenleiste zu erstellen, in der Sie ein Inhaltsverzeichnis mit Links zu Ihren Seiten erstellen. Ich finde das sowieso besser als Ordner, weil es Ihnen ermöglicht, einen Link zu einer einzelnen Seite unter mehreren Hierarchien zu haben.

Eigentlich gibt es noch eine Einschränkung. Ja, Sie können 1 Ebene hinzufügen (also 1 Unterordner). Aber das ist es! Ich habe mein gesamtes Dokumentationslayout überarbeitet und mehrere Ebenen von Unterordnern für die Organisation erstellt, aber das war ein No-Go.

Seufzer

Ich muss sagen: Ich bin entsetzt über dieses Gollum-Ding. Ich bin überrascht, dass Github es sogar aufgegriffen hat.