web-dev-qa-db-fra.com

Comment structurer les fichiers wiki GitHub?

J'ai cloné localement un des wiki de mon projet GitHub et je souhaite restructurer le système de fichiers. Par défaut, les différentes pages ajoutées au wiki sont toutes créées dans le répertoire parent:

/wiki
     home.md
     wiki_page_1.md
     ...

Je veux avoir une structure de répertoire semblable à celle-ci:

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

J'ai essayé de structurer mes fichiers wiki de la même manière, mais cela ne fonctionne pas pour les fichiers .md. Cependant, cela fonctionne pour le dossier images. Y at-il un moyen de faire ce travail?

githubfilesystemswiki
17
tsega

Si GitHub utilise toujours github/gollum , alors, comme expliqué dans " Comment pouvez-vous utiliser les sous-répertoires d'une commande de wiki GitHub? ", Les sous-dossiers ne sont pas pris en charge (ou ont heure de la fourche).

Les versions plus récentes de gollum/gollum _ { soutient cette organisation , bien que les dernières PR (demandes d'extraction) résolvent toujours des problèmes qui y sont résolus (comme PR 787 ).

Le OP tsega ajoute dans les commentaires :

essayé de consulter moi-même le wiki de Gollum et il s’avère que vous pouvez organiser vos fichiers sous des répertoires, mais ce ne sera pas comme cela que vous y accéderez .

Chaque page est accessible à partir de la racine du wiki , par exemple. github.com/user/repo/wiki/file-name pas github.com/user/repo/wiki/directory/file-name.

Les noms de fichiers doivent être uniques et si vous voulez avoir les titres appropriés, vous devez les mettre en majuscule et en pointillés (non soulignés).

13
VonC

Je viens de frapper le même problème et je l'ai résolu (un peu) en utilisant un barre de menus personnalisée , et en utilisant Markdown, c'est-à-dire des en-têtes et des liens pour créer une structure de dossiers.

1
Felipe Almeida