Diretórios wiki do GitHub

O wiki que é instalado com um repositório GitHub oferece suporte a diretórios? Nosso wiki está repleto de páginas, e estamos procurando uma maneira de organizá-las melhor.

Tentamos puxar o repo, criar diretórios locais e mover as coisas, mas quando confirmado de volta, o wiki não pegou as mudanças.

Eu estava tendo exatamente o mesmo problema e tentei variantes do que você tentou. Nada travou. Perguntei ao suporte do GitHub sobre isso e recebeu uma resposta que basicamente dizia "Não, mas vamos deixar os desenvolvedores saberem que as pessoas estão interessadas neste recurso."

Portanto, a resposta curta é "Não" e a resposta longa é "Não, mas talvez no futuro".

Na verdade, parece que o github adicionou suporte para diretórios recentemente.

Consegui fazer o seguinte:

• Mova um arquivo markdown existente para um novo diretório.
• Crie um novo arquivo markdown em um diretório existente (criado na etapa anterior).
• Crie um novo arquivo de redução em um novo diretório.

Em todos os casos, as páginas existentes ainda estavam lá e novas páginas foram adicionadas.

A única restrição que permanece é que os nomes dos arquivos devem ser exclusivos. Se você tiver mais de um arquivo com o mesmo nome, apenas um deles aparecerá no wiki (não tenho certeza de qual ..).

O wiki do GitHub (também conhecido como Gollum ) usa diretórios, mas não da maneira que você espera.

A documentação no wiki Gollum pode dar certo, mas isso é o que descobri principalmente por meio de testes.

• Todos os arquivos aparecem na raiz do wiki, não importa onde sejam colocados no repo.
• _Header, _Footere os _Sidebararquivos são por diretório, mas são herdados se não houver nenhum presente em uma pasta filho.
• Os links de arquivo podem ser relativos ao arquivo de origem (mantenha seus arquivos com seu conteúdo).

Portanto, se você deseja diretórios para namespacing, não tem sorte. Considere usar o {namespace}-{page}esquema de namespacing.

Não é a solução ideal, mas a solução alternativa seria criar uma barra lateral personalizada onde você cria um índice analítico com links para suas páginas. Acho que isso é melhor do que pastas, porque permite que você tenha um link para uma única página em várias hierarquias.

Na verdade, ainda existe uma limitação. Sim, você pode adicionar 1 nível (portanto, 1 subpasta). Mas é isso! Refatorei todo o layout de minha documentação, criando vários níveis de subpastas para organização, mas não foi possível.

suspiro

Devo dizer: estou chocado com essa coisa do Gollum. Estou surpreso que o Github o tenha pego.