Ayer中文说明

介绍

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

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

hexo-theme-ayer

GitHub地址

国内镜像

效果预览

中文说明

特性

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

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

手机端效果

打赏

本主题完全开源且免费,目前由我一个人维护,如果你觉得主题不错,你可以选择继续白嫖,也可以选择适当打赏我,不在于金额多少,而是能让我更有动力去维护这个主题。打赏请备注说明,谢谢~

微信 wechat 支付宝 alipay

安装

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

修改

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

1
theme: ayer

更新

更新主题可能会覆盖你之前改动过的config文件,建议先把config.yml里的配置备份一下,然后删掉ayer目录后重新git clone下载主题,再把配置复制进去。

1
2
cd themes/ayer
git pull

主题配置

以下是ayer主题目录下的 _config.yml文件配置,请先确保你已经读过Hexo文档。如果你在配置过程中有问题,请先擅用 搜索引擎。如果你搜不到解决方法,你可以参考:我的博客源码,按照我的一模一样配肯定是不会有问题的。如果对部分字体或颜色等有定制需求,请自行在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
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
# 侧边栏菜单
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: true

# 网易云音乐插件
music:
enable: false
# 播放器尺寸类型(1:小尺寸、2:大尺寸)
type: 1
id: 518895142 # 网易云分享的音乐ID(更换音乐请更改此配置项)
autoPlay: true # 是否开启自动播放

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

# 是否开启代码复制按钮
copy_btn: true
# 是否开启文章分享按钮
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: 1
# 打赏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

# 是否启用黑夜模式开关
darkmode: true

# 动态背景效果: 0-关闭,1-动态线条(跟随鼠标)
canvas_bg: 0

# 自定义鼠标样式,直接替换/images/mouse.cur文件
mouse:
enable: false
path: /images/mouse.cur

# 鼠标点击效果:0-关闭,1-爱心,2-爆炸烟花,3-粒子烟花
click_effect: 0

# 页面宽度自定义(不建议修改,可能造成布局混乱),article_width文章宽度,sidebar_width侧边栏宽度
layout:
article_width: 80rem
sidebar_width: 8rem

# 评论: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,换样式直接在source/images目录下替换forkme图片
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数学公式
mathjax: true

# Katex数学公式(allpost设置为false时只有头部设置math:true的文章才开启)
# 需要更换hexo渲染器,npm un hexo-renderer-marked -S && npm i hexo-renderer-markdown-it-katex -S
katex:
enable: false # true
allpost: true
copy_tex: false

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

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

#ICP备案信息尾部显示
icp:
enable: false
url: 'http://www.beian.miit.gov.cn/' # 备案链接
text: '浙ICP备88888888' # 备案信息

插件(必需)

  • 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插件市场

分类

1
hexo new page categories

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

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

标签

1
hexo new page tags

配置同分类一样

相册

1
hexo new page photos

然后将以下复制到/source/photos/index.md文件,img_url替换成图片路径,caption替换成图片名称

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
    ---
    no_toc: true
    ---

常见问题

一.本地图片引用了却无法显示

插入图片的两种方法:1.引用图床,2.引用本地图片。为了防止路径出错,建议使用图床。

1.图床

推荐使用:SM.MS聚合图床

2.本地图片

建议在hexo创建的博客目录下的source中建立一个images文件夹专门放图片,路径:你的博客目录/source/images,如果还是无法显示,请尝试在文章里用html的img标签来引用本地图片。

二.可以启动但是样式变形了

这很可能是因为你把博客部署到了服务器子目录,导致静态资源加载的路径不对,在此强烈建议你部署到根目录,github和码云都支持根目录部署,只要你把仓库名搞成和用户名一样就行了。

三.点击侧边栏页面无法显示

原因:ayer主题目录下的 config.yml 里menu属性的路径不对,这需要你根据页面路径手动配置。

以我的博客为例:

1
2
3
4
5
6
7
8
menu:
主页: /
归档: /archives
分类: /categories
标签: /tags
旅行: /tags/旅行/
摄影: http://shenyu-vip.lofter.com
关于我: /2019/about

上面的归档/archives是固定的,你不需要修改,标签分类都需要手动创建目录,旅行实际上就是一个标签页,当你在文章头部设置tags属性后就会自动生成,摄影是一个站外的绝对路径,关于我实际上就是一个正常的文章页。好了,现在一个侧边栏导航就已经配置好了。

四.为什么修改了配置却没有效果

建议每次生成站点或部署之前都用 hexo clean 命令清理一下缓存,另外你可能还需要刷新一下。

五.怎么修改大标题和站点信息

站点配置文件_config.yml是hexo站点根目录下的主配置文件(还不知道是哪里的,自己google),注意:别和ayer主题目录下的_config.yml搞混了。

修改网站各种资料,例如标题、副标题和邮箱等个人资料,请修改站点根目录下的_config.yml

以我的博客为例:

六.怎么添加百度或谷歌统计

百度统计

在ayer的config配置里的baidu_analytics填上百度统计代码中的hm.js问好后面那一串东西

谷歌统计

在ayer的config配置里的google_analytics填上谷歌统计代码的跟踪ID,即UA值(包含UA)

七.怎么查看文章的访问量

在ayer的config配置里有busuanzi选项,默认设置为enable:true,就开启了站点访问量的统计,站点尾部左下角的PV代表了当前页的访问次数,UV代表了当前站点的访问人数。注意:不蒜子统计是根据当前域名来统计的,你在本地启动的时候由于是localhost,所以数字会很大,部署到线上之后就会根据域名重新统计。

八.网易云音乐无法播放

这是由于网易云音乐对部分歌曲做了版权限制,你可以多换几首试试,配置文件里的默认歌曲 潮鳴り 是可以播放的。如果你动手能力强,也可以试试音乐播放插件 hexo-tag-aplayer,配合MetingJS可以支持对于 QQ音乐、网易云、虾米、酷狗、百度等平台的音乐播放。

九.分享链接无法打开

你需要在根目录下的_config.yml文件中把url配置成部署后的域名。

打赏
  • 版权声明: 本博客所有文章除特别声明外,著作权归作者所有。转载请注明出处!
  • Copyrights © 2015-2020 Eric Shen
  • 访问人数: | 浏览次数:

请我喝杯咖啡吧~

支付宝
微信