2012-06-18 10 views
61

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

Tratamos de sacar el repositorio, crear directorios locales y mover cosas, pero cuando se comprometió, el wiki no recogió los cambios.

Respuesta

45

Estaba teniendo exactamente el mismo problema e intenté variantes de lo que probaste. Nada atascado Se le preguntó a GitHub sobre el soporte y recibió una respuesta que básicamente decía "No, pero les haremos saber a los desarrolladores que las personas están interesadas en esta característica".

Así que la respuesta breve es "No", y la respuesta larga es "No, pero tal vez en el futuro".

+6

que realmente apesta. Solo quiero usar diferentes directorios para i18n. Pero ... –

+4

La respuesta corta actual es "Sí". :) – Marco

+2

@Marco ¿Después de TRES años? ¡GitHub realmente toma en serio la solicitud de sus usuarios! : | – trejder

25

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

que era capaz de hacer lo siguiente:

  • mover un archivo de reducción del precio existente a un nuevo directorio.
  • Cree un nuevo archivo de marcado en un directorio existente (creado en el paso anterior).
  • Cree un nuevo archivo de reducción en un nuevo directorio.

En todos los casos, las páginas existentes seguían allí y se agregaron páginas nuevas.

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 qué ...).

+6

Así que, básicamente, solo para organizar sus páginas, pero no le da nada más. –

20

El wiki de github (también conocido como Gollum) utiliza directorios pero no de la manera que usted espera.

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

  • Todos los archivos aparecen en la raíz de la wiki, sin importar dónde se coloquen en el repositorio.
  • _Header, _Footer y archivos son por directorio, pero se heredan si hay ninguno presente en una carpeta secundaria.
  • Los enlaces de archivos pueden ser relativos al archivo fuente (conserve sus archivos con su contenido).

Por lo tanto, si desea directorios para el espacio de nombres, no tiene suerte. Considere usar el esquema NS-Page para el espaciado de nombres.

+4

la falta de subpáginas hace que Gollum y GitHub wiki por extensión sean una "wiki" paralizada. –

0

En realidad, todavía hay una limitación. Sí, puede agregar 1 nivel (por lo tanto, 1 subcarpeta). ¡Pero eso es todo! Refactoreé todo el diseño de la documentación, creando múltiples niveles de subcarpetas para la organización, pero eso fue un no-go.

suspiro

debo decir: Estoy consternado por esta cosa Gollum. Me sorprende que Github incluso lo haya recogido.

+0

No creo que esto sea correcto. Estaba viendo uno de los sitios wiki recomendados por git, https://github.com/showcases/projects-with-great-wikis. Hice un clon git y, por supuesto, tienen al menos tres niveles de subdirectorios. Eche un vistazo a la documentación técnica/1-trackers/ruby-tracker por ejemplo. –

+0

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 raro. Entiendo si hubo una colisión en el nombre de la página real, pero al usar la sintaxis de mediaWiki [[Link Text | WikiPage]] parece confundirse entre el texto del enlace y el nombre real del directorio. –

+0

Este formato increíblemente feo y redundante parece funcionar [PageName] (PageName) –

9

No es la solución ideal, pero la solución alternativa sería crear una barra lateral personalizada donde creará una tabla de contenidos con enlaces a sus páginas. En cualquier caso, considero que esto es mejor que las carpetas porque te permite tener un enlace a una única página en múltiples jerarquías.

+0

Ese es el enfoque que he tomado, pero deja una parte de "Páginas" que es un gran lío de páginas (más de 60 en mi proyecto). –

+0

La parte Páginas está contraída, por lo que no satura la barra lateral, afortunadamente – pd12

Cuestiones relacionadas