GitHub-Wiki-Verzeichnisse


85

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.

Antworten:


60

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".


7
Die aktuelle kurze Antwort lautet "Ja". :)
Marco

2
@ Marco Nach drei Jahren? GitHub nimmt die Anfrage seines Benutzers wirklich ernst! : |
Trejder

9
Ja, immer noch nein, fünf Jahre später
Lincoln Bergeson

1
Sechs Jahre. Übrigens, hörte Leute, die über #Microsoft stöhnten, den #GitHub zurück ins Büro. Heute habe ich zu viele Enttäuschungen und ich denke, ich kann sie jetzt ins Gesicht lachen.
DevOvercome


30

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 ..).


9
Im Grunde genommen dient es nur zum Organisieren Ihrer Seiten, bietet Ihnen aber nichts mehr.
Rene Pot

26

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.


5
Das Fehlen von Unterseiten macht das Gollum- und GitHub-Wiki zu einem verkrüppelten "Wiki".

14

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.


Das ist der Ansatz, den ich gewählt habe, aber er hinterlässt einen "Seiten" -Teil, der ein riesiges Durcheinander von Seiten darstellt (über 60 in meinem Projekt).
Jason Short

Der Pages-Teil ist
reduziert, damit

1

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.


1
Ich denke nicht, dass das richtig ist. Ich habe mir eine der von Git empfohlenen Wiki-Sites angesehen, github.com/showcases/projects-with-great-wikis . Ich habe einen Git-Klon erstellt und sicher haben sie mindestens drei Ebenen von Unterverzeichnissen. Schauen Sie sich zum Beispiel die technische Dokumentation / 1-Tracker / Ruby-Tracker an.
Ed Ost

ok, ich habe es selbst getestet und es scheint, dass gollum ein Problem mit Unterverzeichnissen hat, die den gleichen Namen haben wie sogar der Linktext. Das ist irgendwie komisch. Ich würde verstehen, wenn es eine Kollision im tatsächlichen Seitennamen gab, aber bei Verwendung der mediaWiki-Syntax [[Link Text | WikiPage]] scheint es tatsächlich zu einer Verwechslung zwischen Link Text und dem tatsächlichen Verzeichnisnamen zu kommen.
Ed Ost

Dieses unglaublich hässliche und redundante Format scheint zu funktionieren [Seitenname] (Seitenname)
Ed Ost

1
Mit gollum-lib können Seitennamen Schrägstriche aufweisen, die sich wie erwartet verhalten. Leider unterstützen weder GitHub noch das "offizielle" Sinoll-basierte Gollum-Frontend diese sinnvoll.
Gerwitz

1
Das Github-Schaufenster in Ed Osts Kommentar existiert nicht mehr. Eine Alternative fwiw quora.com/…
simesy
Durch die Nutzung unserer Website bestätigen Sie, dass Sie unsere Cookie-Richtlinie und Datenschutzrichtlinie gelesen und verstanden haben.
Licensed under cc by-sa 3.0 with attribution required.