Répertoires wiki de GitHub

Question

Le wiki qui s'installe avec un repo GitHub prend-il en charge les répertoires ? Notre wiki est encombré de pages, et nous cherchons un moyen de mieux les organiser.

Nous avons essayé d'extraire le dépôt, de créer des répertoires locaux et de déplacer des éléments, mais lorsque nous avons validé les modifications, le wiki ne les a pas prises en compte.

Answer 1

J'avais exactement le même problème et j'ai essayé des variantes de ce que vous avez essayé. Rien n'a fonctionné. J'ai demandé au support GitHub à ce sujet et j'ai reçu une réponse qui disait essentiellement "Non, mais nous ferons savoir aux développeurs que les gens sont intéressés par cette fonctionnalité."

Donc la réponse courte est "Non", et la réponse longue est "Non, mais peut-être dans le futur."

Answer 2

En fait, il semble que Github ait récemment ajouté la prise en charge des répertoires.

J'ai pu faire ce qui suit :

• Déplacer un fichier markdown existant vers un nouveau répertoire.
• Créez un nouveau fichier markdown dans un répertoire existant (créé à l'étape précédente).
• Créez un nouveau fichier markdown dans un nouveau répertoire.

Dans tous les cas, les pages existantes étaient toujours là et de nouvelles pages ont été ajoutées.

La seule contrainte qui demeure est que vos noms de fichiers doivent être uniques. Si vous avez plus d'un fichier avec le même nom, un seul d'entre eux apparaîtra dans le wiki (je ne suis pas sûr lequel ).

Answer 3

Le wiki GitHub (alias Gollum ) utilise les répertoires, mais pas de la manière à laquelle on pourrait s'attendre.

La documentation sur le Gollum wiki Il pourrait y avoir du travail à faire, mais c'est ce que j'ai compris, principalement par des tests.

• Tous les fichiers apparaissent dans la racine du wiki, quel que soit l'endroit où ils sont placés dans le dépôt.
• _Header , _Footer y _Sidebar sont par répertoire, mais héritées s'il y a un s'il n'y en a pas dans un dossier enfant.
• Les liens vers les fichiers peuvent être relatifs au fichier source (gardez vos fichiers avec votre contenu).

Donc, si vous voulez des répertoires pour l'espacement des noms, vous n'avez pas de chance. Envisagez d'utiliser l'option {namespace}-{page} pour l'espacement des noms.

Answer 4

Ce n'est pas la solution idéale, mais la solution de contournement consisterait à créer une barre latérale personnalisée dans laquelle on créerait une table des matières avec des liens vers vos pages. Je trouve que c'est mieux que les dossiers de toute façon parce que cela vous permet d'avoir un lien vers une seule page sous plusieurs hiérarchies.

Answer 5

En fait, il y a encore une limite. Oui, vous pouvez ajouter un niveau (donc, un sous-dossier). Mais c'est tout ! J'ai remanié toute la mise en page de ma documentation, en créant plusieurs niveaux de sous-dossiers pour l'organisation, mais cela n'a pas fonctionné.

soupir

Je dois dire : Je suis consterné par cette histoire de Gollum. Je suis même surpris que Github l'ait repris.