jekyll-gitbook/README.md

39 lines
1.4 KiB
Markdown
Raw Permalink Normal View History

# 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/)
## Why Jekyll with GitBook
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. 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 repo.
## How to Get Started
This theme can be used just as other [Jekyll themes][1].
[Fork][3] this repository and add your markdown posts to the `_posts` folder.
## License
This work is open sourced under the Apache License, Version 2.0.
Copyright 2019 Tao He.
[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