¿Cómo estructurar los archivos wiki de GitHub?
filesystems (2)
He clonado uno de los wiki de mi proyecto GitHub localmente, y quiero reestructurar el sistema de archivos. Por defecto, todas las páginas agregadas a la wiki se crean en el directorio principal:
/wiki
home.md
wiki_page_1.md
...
Quiero tener una estructura de directorio similar a esta:
/wiki
/setup
setup_procedures.md
index.md
/development
index.md
tools.md
/images
front_page.png
He intentado estructurar mis archivos wiki de manera similar, pero no funciona para los archivos .md
. Sin embargo, funciona para la carpeta de imágenes. ¿Hay alguna manera de hacer que esto funcione?
Acabo de encontrar el mismo problema y lo resolví (un poco) con una barra de menú personalizada y con Markdown normal, es decir, encabezados y enlaces para crear una estructura de carpetas.
Si GitHub sigue utilizando github/gollum , entonces, como se explica en " ¿Cómo se pueden usar los subdirectorios en un checkout de wiki de GitHub? ", Las subcarpetas no son compatibles (o tenían errores al momento de la bifurcación).
Las versiones más recientes de gollum/gollum compatibles con esa organización , a pesar de que las PR (solicitudes de extracción) recientes aún están solucionando los problemas que la rodean (como PR 787 ).
La agrega en los comentarios :
Traté de buscar en la wiki de Gollum y resulta que puedes organizar tus archivos en directorios, pero no será así como accedas a ellos .
Se accede a cada página desde la raíz de la wiki , por ejemplo,
github.com/user/repo/wiki/file-name
nogithub.com/user/repo/wiki/directory/file-name
.Los nombres de los archivos deben ser únicos, y si desea tener los títulos adecuados, deben escribirse en mayúsculas y guiones (sin subrayar).