Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kaiiiz/hexo-theme-book
[No Longer Maintained] A simple, elegant, book-like hexo theme with some useful features.
https://github.com/kaiiiz/hexo-theme-book
blog hexo theme
Last synced: 3 months ago
JSON representation
[No Longer Maintained] A simple, elegant, book-like hexo theme with some useful features.
- Host: GitHub
- URL: https://github.com/kaiiiz/hexo-theme-book
- Owner: kaiiiz
- License: mit
- Archived: true
- Created: 2019-04-15T06:47:12.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-06-21T12:39:10.000Z (over 1 year ago)
- Last Synced: 2024-05-20T09:18:56.541Z (8 months ago)
- Topics: blog, hexo, theme
- Language: SCSS
- Homepage: https://kaiiiz.github.io/hexo-theme-book-demo/
- Size: 152 KB
- Stars: 299
- Watchers: 5
- Forks: 45
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hexo-themes - kaiiiz/hexo-theme-book - like hexo theme with some useful features.|158| (Content)
README
A simple, elegant, book-like hexo theme with some useful features.
## ⚠ Notice
> WARNING: this project is no longer maintained, and may have bugs and security issues. Feel free to fork and modify it yourself if you like it. To find the same theme maintained by other developers, check out [Useful Forks](https://useful-forks.github.io/?repo=kaiiiz/hexo-theme-book).
## 💿 Installation
```
git clone https://github.com/kaiiiz/hexo-theme-book.git themes/book
```
If you don't have scss renderer, follow this:
```
npm install hexo-renderer-scss --save
```
Modify `theme` entry in `_config.yml`
```
theme: book
```
### Change markdown renderer
For better render quality, I suggest that you should change the default renderer.
The detail, see [change markdown renderer](https://github.com/kaiiiz/hexo-theme-book/wiki/Change-markdown-renderer)
## 🎈 Update
Jump into the theme folder, run `git pull`. If you use `/source/_data/book.yml`, please note the diffrence of updated `_config.yml`.
### Smooth Update
For smoothly updating, I recommand to create a config file named `book.yml` in `/source/_data` folder (If it doesn't exist, create one)
> **Notice: source folder is under your hexo working directory, not the theme one!**
Copy the contents of `/themes/book/_config.yml` to `/source/_data/book.yml`, it will replace the contents of config in `/themes/book/_config.yml`. Now you can configure it independently and also, you can update theme more smoothly.
## ⚒ Configurations
The detail of config, see [Configurations](https://github.com/kaiiiz/hexo-theme-book/wiki/Configuration)
## 🎁 Features
**External Library Integration:**
Comments system:
* [utterances](https://github.com/utterance/utterances)
* [disqus](https://disqus.com/)
* [gitalk](https://github.com/gitalk/gitalk)
Others:
* [zooming](https://github.com/kingdido999/zooming)
* [google analytics](https://analytics.google.com/)
**Code Syntax Highlight:**
Using the built-in systax highlight system ([highlight.js](https://highlightjs.org/)) supported from hexo itself, so no other configuration is needed.
However, there are multiple themes integrated from [tomorrow-theme](https://github.com/chriskempson/tomorrow-theme). You can change the theme in `_config.yml`.
| Normal | Night | Night Eighties | Night Blue | Night Bright
| --- | --- | --- | --- | --- |
|  |  |  |  | 
**Powerful and Fully-Customized Sidebar Menu:**
Checkout [Menu Realtime Demo](https://kaiiiz.github.io/hexo-theme-book-demo/demo/menu-realtime/)
**Responsive Layout:**
Book will adapt to different viewpoints in order to give you the best reading experience.
