Come strutturare i file wiki di GitHub?

Question

Ho clonato uno dei wiki del mio progetto GitHub a livello locale e voglio ristrutturare il file system. Per impostazione predefinita pagine diverse aggiunte al wiki sono tutti creati nella directory principale:

/wiki 
    home.md 
    wiki_page_1.md 
    ... 

voglio avere una struttura di directory simile a questo:

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

Ho cercato di strutturare i miei file wiki simile , ma non funziona per i file .md. Tuttavia, funziona per la cartella delle immagini. C'è un modo per farlo funzionare?

Answer 1

Se GitHub utilizza ancora github/gollum, quindi, come spiegato in "How can you use subdirectories in a GitHub wiki checkout?", le sottocartelle non sono supportate (o erano difettose al momento del fork).

Versioni più recenti di gollum/gollumsupports that organization, anche se recenti PR (Pull Requests) stanno ancora risolvendo i problemi che lo circondano (come PR 787).

Il OP tsega aggiunge in the comments:

cercato di esaminare il Gollum wiki me stesso e si scopre è possibile organizzare i file in directory, ma che non sarà come li accesso.

Ogni pagina è accessibile dalla radice della wiki, ad es. github.com/user/repo/wiki/file-name non github.com/user/repo/wiki/directory/file-name.

I nomi dei file devono essere univoci e, se si desidera avere titoli appropriati, devono essere in maiuscolo e tratteggiati (non sottolineati).

Answer 2

Ho appena colpito lo stesso problema e ho risolto (kinda) utilizzando una barra dei menu personalizzato , e l'utilizzo di Markdown normale, vale a dire le intestazioni ei collegamenti per creare una struttura di cartelle.