Come generare un sito Web dalle pagine wiki di GitHub

Question

Ho usato pagine GitHub per generare un bellissimo sito Web per il mio progetto (this one). Ora voglio mantenere aggiornata la documentazione del mio progetto e avere tutto in un unico file README.md non è probabilmente scalabile alle molte funzionalità che stiamo aggiungendo.

Così, ho pensato che il posto migliore per conservare la documentazione è il wiki GitHub, ma mi piacerebbe integrare la wiki al sito generato gh-pages, mantenendo il layout bellissimo.

Come potrei prendere il wiki GitHub e generare un sito Web HTML con un layout personalizzabile?

Answer 1

Ecco un esempio di URL per un wiki:

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

Nella stessa pagina troverete un link clone: ​​

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

quindi eseguire il file Markdown attraverso Jekyll o addirittura creare un nuovo repository al sito host basato sul Wiki.

Answer 2

È possibile includere il wiki come subtree.

BTW, GitHub Pages ora non ha più bisogno del ramo gh-pages. Creare un repository denominato your-user-name.github.io; genererà automaticamente un sito Web. Vedi GitHub Pages per maggiori dettagli.