adelorenzo/jekyll-gitbook
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
915ac3b2ed
jekyll-gitbook/_posts/2019-04-27-why.md
HE, Tao 4c29410efa
Templates for homepage and markdown posts. 
Signed-off-by: HE, Tao <sighingnow@gmail.com>
2019-04-28 19:16:39 +08:00

876 B
Raw Blame History

title author date category layout
Why Jekyll with GitBook Tao He 2019-04-27 Jekyll post

GitBook is an amazing frontend style to present and organize contents (such as book chapters and blogs) on Web. The typical to deploy GitBook at Github Pages is building HTML files locally and then push to Github repository, usually to the gh-pages branch. However, it's quite annoying to repeat such workload and make it hard for people do version control via git for when there are generated HTML files to be staged in and out.

This theme takes style definition out of generated GitBook site and provided the template for Jekyll to rendering markdown documents to HTML, thus the whole site can be deployed to Github Pages without generating and uploading HTML bundle every time when there are changes to the original repository.