Ayer中文说明

Note
字数统计: 1.9k字   |   阅读时长≈ 7分钟
  1. 介绍
  2. 特性
  3. 安装
  4. 修改
  5. 更新
  6. 主题配置

介绍

Ayer 是一个干净且优雅的Hexo主题，自带响应式，加载速度很快，该有的功能都有，可配置项也很多，非常适合作为你的博客主题，主题内还附送了6张精美的高清壁纸。欢迎使用和Star支持，如果你在使用过程中有任何疑问或者建议，欢迎联系我！如果你的博客采用了本主题，欢迎在下面评论区留下地址哦~

Ayer 在马来语中是“水”的意思，在西班牙语中是“昨天”的意思。

hexo-theme-ayer

GitHub地址

国内镜像

效果预览

中文说明

特性

  1. 干净且优雅，文章内容美观易读
  2. 首页封面全屏平铺，扁平化设计，简洁又不失高大上
  3. 响应式设计，博客在桌面端、平板、手机等设备上均能很好的展现
  4. 首页封面和文案可以任意更换，主题内附送6张精美高清壁纸
  5. 时间轴式的归档页
  6. 侧边栏可以点击显示或隐藏
  7. 支持文章置顶和文章打赏
  8. 支持文章字数和阅读时长统计
  9. 支持 MathJax 数学公式
  10. TOC 目录在文章页悬浮，跳转更方便
  11. 可设置阅读文章时做密码验证（hexo-blog-encrypt）
  12. Valine和Gitalk评论模块（推荐配合leancloud使用 Valine）
  13. 集成了不蒜子、百度统计、Google Analytics、CNZZ等统计功能
  14. 支持Github Ribbons

如果想体验手机端浏览效果，可以扫一下二维码：

手机端效果

安装

1
2
# 国内用户如果速度较慢，可以把github地址替换为：https://gitee.com/shen-yu/hexo-theme-ayer.git
git clone https://github.com/Shen-Yu/hexo-theme-ayer.git themes/ayer

修改

将博客根目录下的 _config.yml 里的 theme 值修改成 ayer

1
theme: ayer

更新

1
2
cd themes/ayer
git pull

主题配置

以下是ayer主题目录下的 _config.yml文件配置。如果你在配置过程中有问题，请先擅用 搜索引擎。如果你搜不到解决方法，你可以参考：我的博客源码，按照我的一模一样配肯定是不会有问题的。如果对部分字体或颜色等有定制需求，请自行在css文件进行修改，主题本身已经很符合审美，自定义配置项也很多，不建议改得花里胡哨，过大的字体和库都会影响博客加载速度。如果还有问题或者建议，那么请在评论区给我留言~

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
# 侧边栏菜单
menu:
  主页: /
  归档: /archives
  分类: /categories
  标签: /tags
  摄影: http://shenyu-vip.lofter.com
  旅行: /tags/旅行/
  关于我: /2019/about

# 站点次标题和打字动效
# https://github.com/mattboldt/typed.js
subtitle:
  enable: true  # 是否开启动效
  text: 面朝大海，春暖花开  # 显示的文字
  text2: 愿你一生努力，一生被爱   # 滚动播放，如果不需要可以留空
  text3: 想要的都拥有，得不到的都释怀  # 最多支持三段文字
  startDelay: 0   # 延迟时间
  typeSpeed: 200  # 打字速度
  loop: true  # 是否循环
  backSpeed: 100  # 回退速度
  showCursor: true  # 是否显示光标

# 网站图标和侧边栏logo
favicon: /favicon.ico
logo: /images/ayer-side.svg

# 封面配置
# enable-是否启用封面；path-封面背景图；logo-封面logo
cover:
  enable: true
  path: /images/cover1.jpg  # /source/images目录下附送多张精美壁纸，可任意更换
  logo: /images/ayer.svg  # 如果不要直接设置成false

# 页面顶部进度条  
progressBar: ture

# 文章配置
# 文章太长，截断按钮文字(在需要截断的行增加此标记：<!--more-->)
excerpt_link: 阅读更多...
# 如果你嫌每篇文章手动加more标记比较麻烦，又不想在首页全文显示，可以把excerpt_all设置成true，这样首页只会显示文章归档
excerpt_all: false

# 是否开启文章分享按钮
share_enable: true
# 国内的社交平台(If you are not in China, maybe you prefer to set:false)
share_china: true
# 文章分享文字
share_text: 分享

# 分页文字
nav_text:
  page_prev: 上一页
  page_next: 下一页
  post_prev: 上一篇
  post_next: 下一篇

# 文章页是否显示目录
toc: true

# 文章中的图片是否支持点击放大
image_viewer: true

# https://github.com/willin/hexo-wordcount
# 是否开启字数统计(关闭请设置enable为false)
# 也可以单独在md文件里Front-matter设置`no_word_count: true`属性，来自定义关闭字数统计
word_count:
  enable: true
  # 只在文章详情显示(不在首页显示)
  only_article_visit: true

# 打赏
# 打赏type设定：0-关闭打赏； 1-文章对应的md文件里有reward:true属性，才有打赏； 2-默认开启所有文章均有打赏，如果有些文章你不需要，请在文章对应的md文件里设置no_reward:true
reward_type: 2
# 打赏wording
reward_wording: '请我喝杯咖啡吧~'
# 支付宝二维码图片地址，跟你设置logo的方式一样。比如：/images/alipay.jpg
alipay: /images/alipay.jpg
# 微信二维码图片地址
weixin: /images/wechat.jpg

# 版权声明
# 版权声明type设定：0-关闭版权声明； 1-文章对应的md文件里有copyright: true属性，才有版权声明； 2-所有文章均有版权声明
copyright_type: 2

# 是否启用搜索
search: true

# RSS订阅(先安装hexo-generator-feed插件，再去博客根目录config进行配置)
rss: /atom.xml

# 评论：1、Valine(推荐)；2、Gitalk

# 1、Valine[一款快速、简洁且高效的无后端评论系统](https://github.com/xCss/Valine)
# 启用Valine必须先创建leancloud应用， 注册账号后获取 id|key 填入即可
leancloud:  
  enable: true
  app_id: #
  app_key: #
# Valine配置(如果有些文章你想关闭评论，请在文章对应的md文件里设置no_valine:true)
valine:
  enable: true # 是否启用
  verify: false # 是否开启防垃圾评论验证
  notify: false # 是否开启邮件提醒(https://valine.js.org/notify.html)
  avatar: mp # 头像样式(https://valine.js.org/avatar.html)
  placeholder: 给我的文章加点评论吧~ # placeholder

# 2、Gitalk(https://github.com/gitalk/gitalk)
gitalk:
  enable: false # true
  clientID: # GitHub Application Client ID
  clientSecret: # Client Secret
  repo: # Repository name
  owner: # GitHub ID
  admin: # GitHub ID
  
# GitHub Ribbons封面右上角的forkme(https://github.blog/2008-12-19-github-ribbons/)
github: 
  # (关闭请设置为false)
  url: https://github.com/Shen-Yu/hexo-theme-ayer

# fancybox(仅用于相册展示，若需要可配置albums)
fancybox: true

# 访问量统计(不蒜子)
busuanzi:
  enable: true

# 友盟cnzz统计(url填js代码src链接)
cnzz:
  enable: true
  url: #

# Google Analytics
google_analytics: ''
# 百度统计
baidu_analytics: ''

# 数学公式
mathjax: true

# 网站成立年份(默认为 2019，若填入年份小于当前年份，则显示为 2018-2019 类似的格式)
since: 2019

#是否显示页脚信息(建议保留，有助于本主题的推广)
pageFooter: true

插件

  • hexo-generator-searchdb 搜索

    1
    npm install hexo-generator-searchdb --save

    然后将以下配置复制到你博客根目录下的 _config.yml 里（注意不是ayer目录下的）:

    1
    2
    3
    4
    5
    # hexo-generator-searchdb
    search:
      path: search.xml
      field: post
      format: html

  • hexo-generate-feed RSS

    1
    npm install hexo-generator-feed --save

    然后将以下配置复制到你博客根目录下的 _config.yml 里（注意不是ayer目录下的）:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    feed:
        type: atom
        path: atom.xml
        limit: 20
        hub:
        content:
        content_limit: 140
        content_limit_delim: ' '
        order_by: -date

  • hexo-generator-index-pin-top

    1
    2
    npm uninstall hexo-generator-index --save
    npm install hexo-generator-index-pin-top --save

分类

1
hexo new page categories

然后将以下复制到_posts/categories/index.md文件

1
2
3
4
5
---
title: categories
type: "categories"
layout: "categories"
---

标签

1
hexo new page tags

配置同分类一样

相册

需要在文章顶部配置

1
2
3
4
5
6
7
8
---
title: Gallery

albums: [
        ["img_url","img_caption"],
        ["img_url","img_caption"]
        ]
---

文章目录

用Tocbot解析文章标题并生成目录

  • 将以下配置复制到你ayer目录下的 _config.yml 里：

    1
    2
    # Toc
     toc: true

  • 当然你可能并不想所有文章都生成悬浮目录，你可以在文章顶部的配置中加一行来进行关闭：

    1
    2
    3
    ---
    toc: false
    ---
打赏
表情 | 预览
Powered By Valine
v1.3.10

谢谢你的喜欢~

支付宝
微信