sesion - Directorios wiki de GitHub
github tutorial (5)
En realidad, parece que github agregó soporte para directorios recientemente.
Pude hacer lo siguiente:
- Mueva un archivo de marcación existente a un nuevo directorio.
- Cree un nuevo archivo de rebaja en un directorio existente (creado en el paso anterior).
- Crea un nuevo archivo de rebajas en un nuevo directorio.
En todos los casos, las páginas existentes todavía estaban 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é ...).
¿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.
Tratamos de sacar el repositorio, crear directorios locales y mover las cosas, pero cuando nos comprometimos, el wiki no recogió los cambios.
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 horrorizado por esta cosa Gollum. Me sorprende que Github incluso lo haya recogido.
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".
Entonces la respuesta corta es "No", y la respuesta larga es "No, pero tal vez en el futuro".
La wiki de github (también conocida como Gollum ) usa directorios pero no de la manera que usted espera.
La documentación en la wiki de Gollum 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,_Footery_Sidebarson por directorio, pero se heredan si no hay ninguno presente en una carpeta secundaria. - Los enlaces de archivos pueden ser relativos al archivo fuente (mantenga sus archivos con su contenido).
Entonces, si desea directorios para el espacio de nombres, no tiene suerte. Considere usar el esquema NS-Page para el espacio de nombres.
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.