it-swarm.com.de

Wie strukturiere ich GitHub-Wiki-Dateien?

Ich habe eines der Wiki meines GitHub-Projekts lokal geklont und möchte das Dateisystem neu strukturieren. Standardmäßig werden alle dem Wiki hinzugefügten Seiten im übergeordneten Verzeichnis erstellt:

/wiki
     home.md
     wiki_page_1.md
     ...

Ich möchte eine ähnliche Verzeichnisstruktur haben:

/wiki
  /setup
    setup_procedures.md
    index.md
  /development
    index.md
    tools.md
  /images
    front_page.png

Ich habe versucht, meine Wiki-Dateien ähnlich zu strukturieren, aber es funktioniert nicht für die .md-Dateien. Es funktioniert jedoch für den Bilderordner. Gibt es eine Möglichkeit, diese Arbeit zu machen?

17
tsega

Wenn GitHub immer noch github/gollum verwendet, werden Unterordner, wie in " Wie können Sie Unterverzeichnisse in einer GitHub-Wiki-Prüfung verwenden? " erläutert, zum Zeitpunkt der Verzweigung nicht unterstützt (oder waren fehlerhaft) ).

Neuere Versionen von gollum/gollumunterstützen diese Organisation , obwohl die jüngsten PR (Pull Requests) immer noch Probleme beheben (wie PR 787 ).

Das OP tsega fügt in den Kommentaren hinzu :

ich habe versucht, mich im Gollum-Wiki umzusehen, und es stellte sich heraus, dass Sie Ihre Dateien unter Verzeichnissen organisieren können, aber so greifen Sie nicht darauf zu .

Auf jede Seite wird vom Stammverzeichnis des Wikis aus zugegriffen , z. github.com/user/repo/wiki/file-name nicht github.com/user/repo/wiki/directory/file-name.

Die Dateinamen sollten eindeutig sein. Wenn Sie die richtigen Titel verwenden möchten, müssen Sie diese in Großbuchstaben und mit einem Strich versehen (nicht unterstrichen).

13
VonC

Ich bin gerade auf das gleiche Problem gestoßen und habe es (irgendwie) gelöst, indem ich eine benutzerdefinierte Menüleiste und ein reguläres Markdown verwendet habe, d. H. Überschriften und Links, um eine Ordnerstruktur zu erstellen.

1
Felipe Almeida