20 lines
876 B
Markdown
20 lines
876 B
Markdown
---
|
|
title: Why Jekyll with GitBook
|
|
author: Tao He
|
|
date: 2019-04-27
|
|
category: Jekyll
|
|
layout: 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][1]
|
|
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][1] without generating and uploading HTML bundle every time when there are
|
|
changes to the original repository.
|
|
|
|
[1]: https://pages.github.com |