✏️ README.md
This commit is contained in:
parent
221c637409
commit
aad79d1baa
99
README.md
99
README.md
@ -33,10 +33,10 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
:ocean: Ayer is a clean and elegant theme for Hexo, also fast, powerful and responsive. It contains many awesome features, It's perfect for your blog, "Ayer" means "water" in Malaysian and "yesterday" in Spanish. If you have any queries or advice during the process of using, Please contact me! shenyu@hotmail.com
|
:ocean: Ayer is a clean and elegant theme for Hexo, also fast, powerful and responsive. It contains many awesome features, It's perfect for your blog, "Ayer" means "water" in Malaysian and "yesterday" in Spanish. If you have any queries or advice during the process of using, Please contact me! shenyu@hotmail.com
|
||||||
|
|
||||||
<b>注:收藏本主题请点右上角Star,谢谢~~ </b>
|
<b>注:收藏本主题请点右上角 Star,谢谢~~ </b>
|
||||||
<b>如果你想给主题添砖加瓦,可以点右上角Fork,然后给此仓库提交PR</b>
|
<b>如果你想给主题添砖加瓦,可以点右上角 Fork,然后给此仓库提交 PR</b>
|
||||||
|
|
||||||
### [Preview 预览](https://shen-yu.gitee.io)
|
### [Preview 预览](https://shen-yu.gitee.io)
|
||||||
|
|
||||||
@ -48,37 +48,38 @@
|
|||||||
|
|
||||||
## Install
|
## Install
|
||||||
|
|
||||||
### For hexo < 5.0
|
|
||||||
|
|
||||||
``` shell
|
|
||||||
git clone https://github.com/Shen-Yu/hexo-theme-ayer.git themes/ayer
|
|
||||||
```
|
|
||||||
|
|
||||||
### For hexo >= 5.0
|
### For hexo >= 5.0
|
||||||
|
|
||||||
``` shell
|
```shell
|
||||||
npm i hexo-theme-ayer -S
|
npm i hexo-theme-ayer -S
|
||||||
```
|
```
|
||||||
|
|
||||||
- If this theme is newly installed, a `_config.ayer.yml` file will be generated in the root directory after the installation is complete, and you can directly edit the `_config.ayer.yml` file for configuration.
|
- If this theme is newly installed, a `_config.ayer.yml` file will be generated in the root directory after the installation is complete, and you can directly edit the `_config.ayer.yml` file for configuration.
|
||||||
- If it is a theme upgrade, you can use the configuration method of hexo < 5.0, or you can move the original configuration file to the root directory and rename it to `_config.ayer.yml`.
|
- If it is a theme upgrade, you can use the configuration method of hexo < 5.0, or you can move the original configuration file to the root directory and rename it to `_config.ayer.yml`.
|
||||||
|
|
||||||
|
### For hexo < 5.0
|
||||||
|
|
||||||
|
```shell
|
||||||
|
git clone https://github.com/Shen-Yu/hexo-theme-ayer.git themes/ayer
|
||||||
|
```
|
||||||
|
|
||||||
## Enable
|
## Enable
|
||||||
|
|
||||||
Modify `theme` setting in `_config.yml` to `ayer`
|
Modify `theme` setting in `_config.yml` to `ayer`
|
||||||
|
|
||||||
``` yml
|
```yml
|
||||||
theme: ayer
|
theme: ayer
|
||||||
```
|
```
|
||||||
|
|
||||||
## Update
|
## Update
|
||||||
|
|
||||||
``` bash
|
```bash
|
||||||
cd themes/ayer
|
cd themes/ayer
|
||||||
git pull
|
git pull
|
||||||
```
|
```
|
||||||
|
|
||||||
## Multi Language Support
|
## Multi Language Support
|
||||||
|
|
||||||
zh-CN(中文简体) en(English) zh-TW(中文繁体) ja(日本語) es(Español) de(Deutsch) fr(Français) ru(Русский) ko(한국어) vi(Tiếng Việt) nl(Nederlands) no(norsk) pt(Português)
|
zh-CN(中文简体) en(English) zh-TW(中文繁体) ja(日本語) es(Español) de(Deutsch) fr(Français) ru(Русский) ko(한국어) vi(Tiếng Việt) nl(Nederlands) no(norsk) pt(Português)
|
||||||
|
|
||||||
English is default languge, if you want to change, modify `language` option in `_config.yml` file in your Hexo blog's root folder.
|
English is default languge, if you want to change, modify `language` option in `_config.yml` file in your Hexo blog's root folder.
|
||||||
@ -87,7 +88,7 @@ English is default languge, if you want to change, modify `language` option in `
|
|||||||
|
|
||||||
let me know if you have any questions.
|
let me know if you have any questions.
|
||||||
|
|
||||||
``` yml
|
```yml
|
||||||
# Menu-Sidebar
|
# Menu-Sidebar
|
||||||
menu:
|
menu:
|
||||||
Home: /
|
Home: /
|
||||||
@ -104,7 +105,7 @@ subtitle:
|
|||||||
enable: true
|
enable: true
|
||||||
text: A clean and elegant theme
|
text: A clean and elegant theme
|
||||||
text2: It's perfect for your hexo blog
|
text2: It's perfect for your hexo blog
|
||||||
text3: Have fun! #Supports up to three lines of text
|
text3: Have fun! #Supports up to three lines of text
|
||||||
startDelay: 0
|
startDelay: 0
|
||||||
typeSpeed: 200
|
typeSpeed: 200
|
||||||
loop: true
|
loop: true
|
||||||
@ -119,7 +120,7 @@ logo: /images/ayer-side.svg
|
|||||||
# enable: [true|false];path: [background-image];logo: [cover-logo-image]
|
# enable: [true|false];path: [background-image];logo: [cover-logo-image]
|
||||||
cover:
|
cover:
|
||||||
enable: true
|
enable: true
|
||||||
path: /images/cover1.jpg # there are some beautiful cover images in Ayer's directory: /source/images, choose your favorite image to replace it.
|
path: /images/cover1.jpg # there are some beautiful cover images in Ayer's directory: /source/images, choose your favorite image to replace it.
|
||||||
logo: /images/ayer.svg
|
logo: /images/ayer.svg
|
||||||
|
|
||||||
# ProgressBar
|
# ProgressBar
|
||||||
@ -169,7 +170,7 @@ word_count:
|
|||||||
# type:0-close reward; 1-only open in article which you have configured reward:true; 2-open in all articles
|
# type:0-close reward; 1-only open in article which you have configured reward:true; 2-open in all articles
|
||||||
reward_type: 2
|
reward_type: 2
|
||||||
# reward word
|
# reward word
|
||||||
reward_wording: 'Buy me a cup of coffee~'
|
reward_wording: "Buy me a cup of coffee~"
|
||||||
# qrcode image path
|
# qrcode image path
|
||||||
alipay: /images/alipay.jpg
|
alipay: /images/alipay.jpg
|
||||||
# qrcode image path
|
# qrcode image path
|
||||||
@ -222,9 +223,9 @@ cnzz:
|
|||||||
url: #
|
url: #
|
||||||
|
|
||||||
# Google Analytics
|
# Google Analytics
|
||||||
google_analytics: ''
|
google_analytics: ""
|
||||||
# Baidu Analytics
|
# Baidu Analytics
|
||||||
baidu_analytics: ''
|
baidu_analytics: ""
|
||||||
|
|
||||||
# Mathjax Support
|
# Mathjax Support
|
||||||
mathjax: true
|
mathjax: true
|
||||||
@ -316,11 +317,12 @@ minivaline:
|
|||||||
|
|
||||||
## Plugins
|
## Plugins
|
||||||
|
|
||||||
+ [hexo-generator-search](https://github.com/wzpan/hexo-generator-search) (for Local Search)
|
- [hexo-generator-search](https://github.com/wzpan/hexo-generator-search) (for Local Search)
|
||||||
|
|
||||||
```yml
|
```yml
|
||||||
$ npm install hexo-generator-searchdb --save
|
$ npm install hexo-generator-searchdb --save
|
||||||
```
|
```
|
||||||
|
|
||||||
Then add the plugin configuration in hexo's configuration file `_config.yml` (note: not the theme's configuration file):
|
Then add the plugin configuration in hexo's configuration file `_config.yml` (note: not the theme's configuration file):
|
||||||
|
|
||||||
```yml
|
```yml
|
||||||
@ -331,7 +333,7 @@ minivaline:
|
|||||||
format: html
|
format: html
|
||||||
```
|
```
|
||||||
|
|
||||||
+ [hexo-generator-feed](https://github.com/hexojs/hexo-generator-feed) (for RSS)
|
- [hexo-generator-feed](https://github.com/hexojs/hexo-generator-feed) (for RSS)
|
||||||
|
|
||||||
```yml
|
```yml
|
||||||
$ npm install hexo-generator-feed --save
|
$ npm install hexo-generator-feed --save
|
||||||
@ -351,18 +353,22 @@ minivaline:
|
|||||||
order_by: -date
|
order_by: -date
|
||||||
```
|
```
|
||||||
|
|
||||||
+ [hexo-generator-index-pin-top](https://github.com/netcan/hexo-generator-index-pin-top) (for Sticky Post)
|
- [hexo-generator-index-pin-top](https://github.com/netcan/hexo-generator-index-pin-top) (for Sticky Post)
|
||||||
|
|
||||||
``` bash
|
```bash
|
||||||
$ npm uninstall hexo-generator-index --save
|
$ npm uninstall hexo-generator-index --save
|
||||||
$ npm install hexo-generator-index-pin-top --save
|
$ npm install hexo-generator-index-pin-top --save
|
||||||
```
|
```
|
||||||
|
|
||||||
## Categories
|
## Categories
|
||||||
``` bash
|
|
||||||
|
```bash
|
||||||
hexo new page categories
|
hexo new page categories
|
||||||
```
|
```
|
||||||
|
|
||||||
Then paste following codes to file: /source/categories/index.md
|
Then paste following codes to file: /source/categories/index.md
|
||||||
``` md
|
|
||||||
|
```md
|
||||||
---
|
---
|
||||||
title: categories
|
title: categories
|
||||||
type: categories
|
type: categories
|
||||||
@ -371,33 +377,36 @@ layout: "categories"
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Tags
|
## Tags
|
||||||
|
|
||||||
Same as categories.
|
Same as categories.
|
||||||
|
|
||||||
## Friend Links
|
## Friend Links
|
||||||
``` bash
|
|
||||||
|
```bash
|
||||||
hexo new page friends
|
hexo new page friends
|
||||||
```
|
```
|
||||||
|
|
||||||
Then paste following codes to file: /source/friends/index.md
|
Then paste following codes to file: /source/friends/index.md
|
||||||
``` md
|
|
||||||
|
```md
|
||||||
---
|
---
|
||||||
title: friends
|
title: friends
|
||||||
type: friends
|
type: friends
|
||||||
layout: "friends"
|
layout: "friends"
|
||||||
---
|
---
|
||||||
```
|
```
|
||||||
|
|
||||||
Then edit `friends_link` in `_config.yml`
|
Then edit `friends_link` in `_config.yml`
|
||||||
|
|
||||||
## Gallery
|
## Gallery
|
||||||
|
|
||||||
Need to write in the head of the markdown, this is not a good way to write, I hope to get a better way to write on github.
|
Need to write in the head of the markdown, this is not a good way to write, I hope to get a better way to write on github.
|
||||||
|
|
||||||
``` md
|
```md
|
||||||
---
|
---
|
||||||
title: Gallery
|
title: Gallery
|
||||||
|
|
||||||
albums: [
|
albums: [["img_url", "img_caption"], ["img_url", "img_caption"]]
|
||||||
["img_url","img_caption"],
|
|
||||||
["img_url","img_caption"]
|
|
||||||
]
|
|
||||||
---
|
---
|
||||||
```
|
```
|
||||||
|
|
||||||
@ -405,19 +414,20 @@ albums: [
|
|||||||
|
|
||||||
Use Tocbot to parse the title tags (h1~h6) in the content and insert the directory.
|
Use Tocbot to parse the title tags (h1~h6) in the content and insert the directory.
|
||||||
|
|
||||||
+ ayer/_config.yml
|
- ayer/\_config.yml
|
||||||
|
|
||||||
``` bash
|
```bash
|
||||||
# Toc
|
# Toc
|
||||||
toc: true
|
toc: true
|
||||||
```
|
```
|
||||||
+ If Toc is turned on in ayer/_config.yml, then Tocbot will generate a Toc article directory in the title tag of each blog parsing content, but not all blogs require Toc, so in the Front-matter section of markdown Can be closed:
|
|
||||||
|
|
||||||
``` md
|
- If Toc is turned on in ayer/\_config.yml, then Tocbot will generate a Toc article directory in the title tag of each blog parsing content, but not all blogs require Toc, so in the Front-matter section of markdown Can be closed:
|
||||||
---
|
|
||||||
|
```md
|
||||||
|
---
|
||||||
no_toc: true
|
no_toc: true
|
||||||
---
|
---
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -433,19 +443,18 @@ This project exists thanks to all the people who contribute.
|
|||||||
|
|
||||||
[](https://starchart.cc/Shen-Yu/hexo-theme-ayer)
|
[](https://starchart.cc/Shen-Yu/hexo-theme-ayer)
|
||||||
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
<a src="https://github.com/Shen-Yu/hexo-theme-ayer">Ayer</a> by <a href="https://github.com/Shen-Yu">Eric-Shen</a> is licensed under <a rel="license" href="https://github.com/Shen-Yu/hexo-theme-ayer/blob/master/LICENSE">SATA-License</a>.
|
<a src="https://github.com/Shen-Yu/hexo-theme-ayer">Ayer</a> by <a href="https://github.com/Shen-Yu">Eric-Shen</a> is licensed under <a rel="license" href="https://github.com/Shen-Yu/hexo-theme-ayer/blob/master/LICENSE">SATA-License</a>.
|
||||||
|
|
||||||
The basic idea is, whenever using a project using SATA license, people shall star/like/+1 that project and thank the author. Just imagine Google stared your project and send you a thank-you letter because they used your project in github!
|
The basic idea is, whenever using a project using SATA license, people shall star/like/+1 that project and thank the author. Just imagine Google stared your project and send you a thank-you letter because they used your project in github!
|
||||||
<br>
|
<br>
|
||||||
|
|
||||||
本项目采用<a rel="license" href="https://github.com/Shen-Yu/hexo-theme-ayer/blob/master/LICENSE">SATA</a>开源协议,在遵守MIT许可证的前提下,你应该马不停蹄的给这个开源项目“点个赞”,比如github右上角的star,然后你应该感谢这个开源项目的作者,作者信息可以在许可证头部的版权声明部分找到。<br>
|
本项目采用<a rel="license" href="https://github.com/Shen-Yu/hexo-theme-ayer/blob/master/LICENSE">SATA</a>开源协议,在遵守 MIT 许可证的前提下,你应该马不停蹄的给这个开源项目“点个赞”,比如 github 右上角的 star,然后你应该感谢这个开源项目的作者,作者信息可以在许可证头部的版权声明部分找到。<br>
|
||||||
|
|
||||||
下面是几条SATA作者推荐的感谢途径,也是SATA包含的内容:
|
下面是几条 SATA 作者推荐的感谢途径,也是 SATA 包含的内容:
|
||||||
|
|
||||||
- 给你使用的开源项目的作者发个Email,和他交个朋友
|
- 给你使用的开源项目的作者发个 Email,和他交个朋友
|
||||||
- 提出你在使用过程中发现的BUG或者提一些建设性的意见
|
- 提出你在使用过程中发现的 BUG 或者提一些建设性的意见
|
||||||
- 告诉你的朋友们这是一个多棒的开源项目
|
- 告诉你的朋友们这是一个多棒的开源项目
|
||||||
- 当然,你也可以只是在心里默默的感激,不用让全世界都知道
|
- 当然,你也可以只是在心里默默的感激,不用让全世界都知道
|
||||||
|
Loading…
Reference in New Issue
Block a user