Directorios wiki de GitHub

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

Pude hacer lo siguiente:

• Mueve un archivo markdown existente a un nuevo directorio.
• Cree un nuevo archivo markdown en un directorio existente (creado en el paso anterior).
• Cree un nuevo archivo markdown en un nuevo directorio.

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

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

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

La documentación en el 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 del wiki sin importar dónde se encuentren en el repositorio.
• _Header, _Footer y _Sidebar los archivos son por directorio, pero heredados si hay ninguno presente en una carpeta secundaria.
• Los enlaces de archivos pueden ser relativos al archivo de origen (mantenga 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 espacio de nombres.

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

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

suspiro

Debo decir: Estoy horrorizado por esta cosa Gollum. Me sorprende que Github lo haya recogido.