115 lines
3.8 KiB
Markdown
115 lines
3.8 KiB
Markdown
<div align="right">
|
|
Language:
|
|
English
|
|
<a title="Chinese" href="README_zh-CN.md">简中</a>
|
|
<a title="Chinese" href="README_zh-TW.md">繁中</a>
|
|
|
|
</div>
|
|
|
|
<a href="https://xpoet.cn"><img align="center" alt="Keep" src="https://cdn.jsdelivr.net/gh/XPoet/image-hosting@master/hexo-theme-keep/keep-logo-slogan.svg"></a>
|
|
|
|
# hexo-theme-keep
|
|
|
|
«Keep» is a simple and elegant [Hexo](https://hexo.io) theme. It makes you more focused on writing.
|
|
|
|
[](https://github.com/XPoet/hexo-theme-ils/blob/master/LICENSE)
|
|
[](https://github.com/XPoet/hexo-theme-ils/releases)
|
|
[](https://www.npmjs.com/package/hexo-theme-keep)
|
|
[](https://hexo.io)
|
|
[](https://hexo.io)
|
|
[](https://www.jsdelivr.com/package/npm/hexo-theme-keep)
|
|
|
|
## :star2: Online Preview
|
|
|
|
- **[XPoet's Blog](https://xpoet.cn/)**
|
|
- **[Keep demo website](https://keep.xpoet.cn/)**
|
|
- **[Keep official document](https://keep-docs.xpoet.cn/)**
|
|
|
|
## :rocket: Installation
|
|
|
|
If you're using Hexo 5.0 or later, the simplest way to install is through npm:
|
|
|
|
```sh
|
|
$ cd hexo-site
|
|
$ npm install hexo-theme-keep
|
|
```
|
|
|
|
Or you can clone the entire repository:
|
|
|
|
```sh
|
|
$ cd hexo-site
|
|
$ git clone https://github.com/XPoet/hexo-theme-keep themes/keep
|
|
```
|
|
|
|
After the installation, open Hexo config file and set `theme` variable to `keep`.
|
|
|
|
```yml
|
|
theme: keep
|
|
```
|
|
|
|
## :wrench: Usage
|
|
|
|
Please see the official documents of «Keep».
|
|
|
|
- **[Keep official document](https://keep-docs.xpoet.cn/)**
|
|
- **[Keep theme configuration guide](https://keep-docs.xpoet.cn/usage-tutorial/configuration-guide.html)**
|
|
- **[Keep theme advanced usage](https://keep-docs.xpoet.cn/usage-tutorial/advanced.html)**
|
|
|
|
It is not recommended to directly modify any files in the «Keep» theme. Because this may cause errors (e.g. merge conflicts), and the modified files may be discarded when upgrading the theme.
|
|
|
|
## :dart: Update
|
|
|
|
«Keep» releases new versions from time to time. You can update Keep by the following command.
|
|
|
|
Install the latest version throuth npm:
|
|
|
|
```sh
|
|
$ cd hexo-site
|
|
$ npm update hexo-theme-keep
|
|
```
|
|
|
|
Or update to latest master branch:
|
|
|
|
```sh
|
|
$ cd themes/keep
|
|
$ git pull
|
|
```
|
|
|
|
_If you modified theme source code:_
|
|
|
|
```sh
|
|
$ git add .
|
|
$ git stash
|
|
$ git pull
|
|
$ git stash pop
|
|
```
|
|
|
|
## :art: Contributing
|
|
|
|
We welcome you to join the development of «Keep». Please see [contributing guide](https://keep.xpoet.cn/2020/11/Keep-代码贡献指南/).
|
|
|
|
## :clapper: Contributors
|
|
|
|
This project exists thanks to all the people who contribute.
|
|
|
|
<a href="https://github.com/XPoet/hexo-theme-keep/graphs/contributors">
|
|
<img src="https://opencollective.com/hexo-theme-keep/contributors.svg?width=880">
|
|
</a>
|
|
|
|
## :sparkling_heart: Thanks
|
|
|
|
«Keep» send special thanks to these great services that sponsor our core infrastructure:
|
|
|
|
<a href="https://github.com"><img height="38" src="https://cdn.jsdelivr.net/gh/XPoet/image-hosting@master/hexo-theme-keep/GitHub-LOGO.5sq0168mirg0.png"></a>
|
|
|
|
> GitHub allows us to host the Git repository and run the test suite.
|
|
|
|
<a href="https://www.jsdelivr.com"><img height="38" src="https://cdn.jsdelivr.net/gh/XPoet/image-hosting@master/hexo-theme-keep/jsDelivr-LOGO.png"></a>
|
|
|
|
> Thanks jsDelivr for providing public CDN service.
|
|
|
|
## :memo: License
|
|
|
|
[MIT](https://github.com/XPoet/picx/blob/master/LICENSE) Copyright © 2020-2021 XPoet
|
|
|