Directory wiki di GitHub

Il wiki che si installa con un repository GitHub supporta le directory? La nostra wiki è ingombra di pagine e stiamo cercando un modo per organizzarle meglio.

Abbiamo provato a tirare il repository, creare directory locali e spostare le cose, ma una volta eseguito il commit, il wiki non ha rilevato le modifiche.

Avevo lo stesso identico problema e ho provato varianti di ciò che hai provato. Niente bloccato. Ho chiesto supporto a GitHub e ho ricevuto una risposta che diceva essenzialmente "No, ma faremo sapere agli sviluppatori che le persone sono interessate a questa funzione".

Quindi la risposta breve è "No" e la risposta lunga è "No, ma forse in futuro".

In realtà, sembra che github abbia recentemente aggiunto il supporto per le directory.

Sono stato in grado di fare quanto segue:

• Sposta un file markdown esistente in una nuova directory.
• Crea un nuovo file markdown in una directory esistente (creata nel passaggio precedente).
• Crea un nuovo file markdown in una nuova directory.

In tutti i casi, le pagine esistenti erano ancora lì e sono state aggiunte nuove pagine.

L'unico vincolo che rimane è che i nomi dei file devono essere univoci. Se hai più di un file con lo stesso nome, solo uno di essi verrà visualizzato nel wiki (non sono sicuro di quale ..).

Il wiki di GitHub (noto anche come Gollum ) utilizza le directory ma non nel modo in cui ci si potrebbe aspettare.

La documentazione sul wiki di Gollum potrebbe richiedere del lavoro, ma questo è ciò che ho capito principalmente tramite test.

• Tutti i file vengono visualizzati nella radice del wiki, indipendentemente da dove si trovano nel repository.
• _Header, _FooterE _Sidebarfile sono per-directory, ma ereditati se non c'è nessuno presente in una cartella del bambino.
• I collegamenti ai file possono essere relativi al file di origine (mantieni i tuoi file con il tuo contenuto).

Quindi, se vuoi directory per lo spazio dei nomi, sei sfortunato. Considera l'idea di utilizzare{namespace}-{page} schema per la spaziatura dei nomi.

Non è la soluzione ideale, ma la soluzione alternativa sarebbe creare una barra laterale personalizzata in cui creare un sommario con collegamenti alle tue pagine. Trovo che questo sia comunque migliore delle cartelle perché ti consente di avere un collegamento a una singola pagina sotto più gerarchie.

In realtà, c'è ancora una limitazione. Sì, puoi aggiungere 1 livello (quindi 1 sottocartella). Ma è tutto! Ho modificato il layout dell'intera documentazione, creando più livelli di sottocartelle per l'organizzazione, ma non è stato possibile.

sospiro

Devo dire: sono sconvolto da questa cosa di Gollum. Sono sorpreso che Github l'abbia persino preso.