Directorios wiki de GitHub

85

¿El wiki que se instala con un repositorio de GitHub admite directorios? Nuestro wiki está repleto de páginas y estamos buscando una forma de organizarlas mejor.

Intentamos sacar el repositorio, crear directorios locales y mover cosas, pero cuando se confirmó, la wiki no detectó los cambios.

John Livermore
fuente

Respuestas:

60

Estaba teniendo exactamente el mismo problema y probé variantes de lo que probaste. Nada atascado. Pregunté al soporte de GitHub al respecto y recibí una respuesta que básicamente decía "No, pero les haremos saber a los desarrolladores que las personas están interesadas en esta función".

Entonces, la respuesta corta es "No" y la respuesta larga es "No, pero tal vez en el futuro".

Collin M
fuente
8
La respuesta corta actual es "Sí". :)
Marco
2
@Marco ¿Después de TRES años? ¡GitHub realmente se toma en serio la solicitud de sus usuarios! : |
trejder
9
Sí, todavía no, cinco años después
Lincoln Bergeson
1
Seis años. Por cierto, escuché a la gente quejarse de que #Microsoft consiguió el #GitHub de vuelta en la oficina. Hoy tengo demasiados decepcionantes y creo que ahora puedo reírme de ellos.
DevOvercome
Podemos hacerlo de esta manera docs.gitlab.com/ee/user/project/wiki
Amrita Deb
30

En realidad, parece que github agregó soporte para directorios recientemente.

Pude hacer lo siguiente:

  • Mueva un archivo de rebajas existente a un nuevo directorio.
  • Cree un nuevo archivo de rebajas en un directorio existente (creado en el paso anterior).
  • Cree un nuevo archivo de rebajas en un directorio nuevo.

En todos los casos, las páginas existentes todavía estaban allí y se agregaron nuevas páginas.

La única restricción que queda es que los nombres de sus archivos deben ser únicos. Si tiene más de un archivo con el mismo nombre, solo uno de ellos aparecerá en la wiki (no estoy seguro de cuál ...).

Marco
fuente
9
Básicamente, es solo para organizar tus páginas, pero no te da nada más.
Rene Pot
26

La wiki de GitHub (también conocida como Gollum ) usa directorios, pero no de la forma esperada.

La documentación en la wiki de Gollum podría necesitar algo de trabajo, pero esto es lo que he descubierto principalmente a través de pruebas.

  • Todos los archivos aparecen en la raíz de la wiki sin importar dónde estén ubicados en el repositorio.
  • _Header, _Footery los _Sidebararchivos son por directorio, pero se heredan si no hay ninguno presente en una carpeta secundaria.
  • Los enlaces de archivos pueden ser relativos al archivo de origen (mantenga sus archivos con su contenido).

Entonces, si desea directorios para el espacio de nombres, no tiene suerte. Considere usar el {namespace}-{page}esquema para el espacio de nombres.

Kevin Cox
fuente
7
la falta de subpáginas convierte a Gollum y GitHub wiki por extensión en un "wiki" paralizado.
14

No es la solución ideal, pero la solución sería crear una barra lateral personalizada en la que cree una tabla de contenido con enlaces a sus páginas. De todos modos, encuentro que esto es mejor que las carpetas porque le permite tener un enlace a una sola página bajo múltiples jerarquías.

Thanh Nguyen
fuente
Ese es el enfoque que he adoptado, pero deja una parte de "Páginas" que es un gran lío de páginas (más de 60 en mi proyecto).
Jason Short
La parte de páginas está colapsada para que no desordene la barra lateral, afortunadamente
pd12
1

De hecho, todavía hay una limitación. Sí, puede agregar 1 nivel (es decir, 1 subcarpeta). ¡Pero eso es todo! Refactoricé todo el diseño de toda la documentación, creando múltiples niveles de subcarpetas para la organización, pero no fue posible.

suspiro

Debo decir: estoy horrorizado por esto de Gollum. Me sorprende que Github incluso lo haya recogido.

gjoris
fuente
2
No creo que esto sea correcto. Estaba viendo uno de los sitios wiki recomendados por git, github.com/showcases/projects-with-great-wikis . Hice un clon de git y, efectivamente, tienen al menos tres niveles de subdirectorios. Eche un vistazo a la documentación-técnica / 1-trackers / ruby-tracker, por ejemplo.
Ed Ost
ok, lo probé yo mismo y parece que gollum tiene un problema con los subdirectorios que tienen el mismo nombre que el texto del enlace. Esto es un poco extraño. Entendería si hubiera una colisión en el nombre real de la página, pero cuando se usa la sintaxis de mediaWiki [[Link Text | WikiPage]], de hecho parece confundirse entre Link Text y el nombre real del directorio.
Ed Ost
Este formato increíblemente feo y redundante parece funcionar [PageName] (PageName)
Ed Ost
1
gollum-lib permite que los nombres de página tengan barras, que se comportan como es de esperar. Desafortunadamente, ni GitHub ni la interfaz de Gollum "oficial" basada en Sinatra los apoyan con sensatez.
Gerwitz
1
Ese escaparate de github en el comentario de Ed Ost ya no existe. Una alternativa fwiw quora.com/…
simesy