113 lines
3.7 KiB
Markdown
113 lines
3.7 KiB
Markdown
|
<div align="right">
|
|||
|
|
語言:
|
|||
|
|
繁中
|
|||
|
|
<a title="Chinese" href="README.md">English</a>
|
|||
|
|
<a title="Chinese" href="README_zh-CN.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» 是一款簡約優雅的 [Hexo](https://hexo.io) 主題。它能讓你更專注於寫作。
|
|||
|
|
|
|||
|
|
[](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: 線上預覽
|
|||
|
|
|
|||
|
|
- **[XPoet's Blog](https://xpoet.cn/)**
|
|||
|
|
- **[keep 預覽網頁](https://keep.xpoet.cn/)**
|
|||
|
|
- **[keep 官方文檔](https://keep-docs.xpoet.cn/)**
|
|||
|
|
|
|||
|
|
## :rocket: 安装
|
|||
|
|
|
|||
|
|
如果你在使用 Hexo 5.0 或更高版本，最簡單的安裝方式是透過 npm：
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
$ cd hexo-site
|
|||
|
|
$ npm install hexo-theme-keep
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
你也可以直接 clone 整個原始碼庫：
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
$ cd hexo-site
|
|||
|
|
$ git clone https://github.com/XPoet/hexo-theme-keep themes/keep
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
安裝完成後，在 Hexo 配置文件中將 `theme` 設定為 `keep`。
|
|||
|
|
|
|||
|
|
```yml
|
|||
|
|
theme: keep
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## :wrench: 使用
|
|||
|
|
|
|||
|
|
請查看 «Keep» 官方文檔：
|
|||
|
|
|
|||
|
|
- **[Keep 官方文檔](https://keep-docs.xpoet.cn/)**
|
|||
|
|
- **[Keep 主題配置指南](https://keep-docs.xpoet.cn/usage-tutorial/configuration-guide.html)**
|
|||
|
|
- **[Keep 主題進階使用](https://keep-docs.xpoet.cn/usage-tutorial/advanced.html)**
|
|||
|
|
|
|||
|
|
不推薦直接修改 «Keep» 主題的文件。因為這可能導致錯誤（例如 git merge 衝突），並且在更新主題時修改的文件可能丟失。
|
|||
|
|
|
|||
|
|
## :dart: 更新
|
|||
|
|
|
|||
|
|
«Keep» 不定期發布新版本。你可以透過如下命令更新 «Keep»。
|
|||
|
|
|
|||
|
|
透過 npm 安裝最新版本：
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
$ cd hexo-site
|
|||
|
|
$ npm update hexo-theme-keep
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
或者透過 git 更新到最新的 master 分支：
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
$ cd themes/keep
|
|||
|
|
$ git pull
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
_如果你修改了主題原始碼：_
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
$ git add .
|
|||
|
|
$ git stash
|
|||
|
|
$ git pull
|
|||
|
|
$ git stash pop
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## :art: 貢獻
|
|||
|
|
|
|||
|
|
我們歡迎你加入 «Keep» 的開發，貢獻出你的一份力量。請看[Keep 原始碼貢獻指南](https://keep.xpoet.cn/2020/11/Keep-代码贡献指南/)。
|
|||
|
|
|
|||
|
|
## :clapper: 貢獻者
|
|||
|
|
|
|||
|
|
這個項目的存在多虧了所有的貢獻者。
|
|||
|
|
|
|||
|
|
<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: 銘謝
|
|||
|
|
|
|||
|
|
«Keep» 特别感謝這些支持我們核心基本設施的優質服務：
|
|||
|
|
|
|||
|
|
<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 允許我們存放 Git 原始碼庫及運行測試。
|
|||
|
|
|
|||
|
|
<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>
|
|||
|
|
|
|||
|
|
> jsDelivr 提供了 CDN 服務。
|
|||
|
|
|
|||
|
|
## :memo: 許可
|
|||
|
|
|
|||
|
|
[MIT](https://github.com/XPoet/picx/blob/master/LICENSE) Copyright © 2020-2021 XPoet
|