examples - github wiki tags

Cómo generar un sitio web desde las páginas wiki de GitHub

Question

He usado las páginas de GitHub para generar un hermoso sitio web para mi proyecto ( este ). Ahora quiero mantener actualizada la documentación de mi proyecto, y tener todo en un solo archivo README.md probablemente no sea escalable a las muchas características que estamos agregando.

Entonces, pensé que el mejor lugar para guardar la documentación es la wiki de GitHub, pero me gustaría integrar la wiki al sitio generado por las páginas gh, manteniendo el hermoso diseño.

¿Cómo tomaría el wiki de GitHub y generaría un sitio web HTML con un diseño personalizable?

Answer 1

Aquí hay una URL de ejemplo para un wiki:

http://github.com/antirez/redis/wiki

En la misma página encontrarás un enlace de clonación:

git clone http://github.com/antirez/redis.wiki

Luego, ejecute los archivos de Markdown a través de Jekyll o incluso cree un nuevo repositorio en el sitio host basado en el Wiki.

Answer 2

Podrías incluir tu wiki como subtree .

Por cierto, las páginas de GitHub ya no necesitan la rama gh-pages . Cree un repositorio llamado your-user-name.github.io ; Se generará automáticamente a un sitio web. Vea las páginas de GitHub para más detalles.