web-dev-qa-db-fra.com

Répertoires wiki GitHub

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

Nous avons essayé d'extraire le référentiel, de créer des répertoires locaux et de déplacer des éléments, mais une fois renvoyé, le wiki ne détectait pas les modifications.

72
John Livermore

J'avais exactement le même problème et j'ai essayé des variantes de ce que vous avez essayé. Rien n'est bloqué. A demandé au support GitHub à ce sujet et a reçu une réponse qui disait essentiellement "Non, mais nous allons informer les 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 à l'avenir."

50
Collin M

En fait, il semble que github ait récemment pris en charge les répertoires. 

J'ai pu faire ce qui suit: 

  • Déplacez un fichier de démarquage existant vers un nouveau répertoire.
  • Créez un nouveau fichier de démarquage dans un répertoire existant (créé à l'étape précédente). 
  • Créez un nouveau fichier de démarquage 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 reste est que vos noms de fichiers doivent être uniques. Si vous avez plusieurs fichiers portant le même nom, un seul d'entre eux apparaîtra sur le wiki (je ne sais pas lequel ..). 

26
Marco

Le wiki github (aka Gollum ) utilise des répertoires, mais pas comme vous le souhaiteriez.

La documentation sur le Gollum wiki pourrait utiliser un peu de travail, mais c’est ce que j’ai compris grâce à des tests.

  • Tous les fichiers apparaissent dans la racine du wiki, peu importe où ils sont placés dans le référentiel.
  • Les fichiers _Header, _Footer et _Sidebar sont par répertoire, mais hérités s’il existe none dans un dossier enfant.
  • Les liens de fichiers peuvent être relatifs au fichier source (conservez vos fichiers avec votre contenu).

Donc, si vous voulez des répertoires pour les noms, vous n'avez pas de chance. Pensez à utiliser le schéma NS-Page pour le namespacing.

24
Kevin Cox

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

11
Thanh Nguyen

En fait, il y a toujours une limitation. Oui, vous pouvez ajouter 1 niveau (donc, 1 sous-dossier). Mais c'est tout! J'ai refactoré toute la mise en page de ma documentation, créant plusieurs niveaux de sous-dossiers pour l'organisation, mais ce n'était pas possible. 

soupir

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

0
gjoris