2019-04-28 11:15:43 +00:00
|
|
|
# Jekyll GitBook
|
|
|
|
|
|
|
|
Make Jelly site have a GitBook look!
|
|
|
|
|
|
|
|
## Demo
|
|
|
|
|
2021-02-03 05:28:13 +00:00
|
|
|
Live demo on Github Pages: [https://sighingnow.github.io/jekyll-gitbook](https://sighingnow.github.io/jekyll-gitbook)
|
|
|
|
|
|
|
|
[![Jekyll Themes](https://img.shields.io/badge/featured%20on-JekyllThemes-red.svg)](https://jekyll-themes.com/jekyll-gitbook/)
|
2019-04-28 11:15:43 +00:00
|
|
|
|
|
|
|
## Why Jekyll with GitBook
|
|
|
|
|
|
|
|
GitBook is an amazing frontend style to present and organize contents (such as book chapters
|
2019-04-28 11:49:18 +00:00
|
|
|
and blogs) on Web. The typical to deploy GitBook at [Github Pages][1]
|
2019-04-28 11:15:43 +00:00
|
|
|
is building HTML files locally and then push to Github repository, usually to the `gh-pages`
|
|
|
|
branch. 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
|
2019-04-28 11:49:18 +00:00
|
|
|
to [Github Pages][1] without generating and uploading HTML bundle every time when there are
|
2019-04-28 11:15:43 +00:00
|
|
|
changes to the original repo.
|
|
|
|
|
|
|
|
## How to Get Started
|
|
|
|
|
|
|
|
This theme can be used just as other [Jekyll themes][1].
|
|
|
|
|
2019-04-28 11:49:18 +00:00
|
|
|
[Fork][3] this repository and add your markdown posts to the `_posts` folder.
|
2019-04-28 11:15:43 +00:00
|
|
|
|
2019-04-28 11:16:58 +00:00
|
|
|
## License
|
|
|
|
|
|
|
|
This work is open sourced under the Apache License, Version 2.0.
|
|
|
|
|
|
|
|
Copyright 2019 Tao He.
|
|
|
|
|
2019-04-28 11:49:18 +00:00
|
|
|
[1]: https://pages.github.com
|
|
|
|
[2]: https://pages.github.com/themes
|
2021-02-03 05:28:13 +00:00
|
|
|
[3]: https://github.com/sighingnow/jekyll-gitbook/fork
|