一、基本配置
在 Hexo 中有两份主要的配置文件,其名称都是 _config.yml。 其中,一份位于站点根目录下,主要包含 Hexo 本身的配置;另一份位于主题目录下,这份配置由主题作者提供,主要用于配置主题相关的选项。
为了描述方便,在以下说明中,将前者称为 站点配置文件, 后者称为 主题配置文件。
1、站点基本设置
在站点配置文件 即博客根目录下的_config.yml
中
1 |
|
2、头像设置
2.1 设置头像
在站点配置文件 中新增avatar,值设置为头像的链接地址。地址可以是网络地址,也可以是本地地址(放置在source/images/ 目录下)
1 | #侧边栏头像设置 |
2.2 头像旋转动画
打开\themes\next\source\css_common\components\sidebar\sidebar-author.styl,在里面添加如下代码:
1 | .site-author-image { |
3、主题布局设置
在主题配置文件即在next主题目录下的_config.yml文件中将scheme设定为Pisces,可根据个人喜好设置成其他的值
1 | # Schemes |
4、菜单项设置
在主题配置文件中的menu中设置,增添一个movies
注:千万不要在这设置中文,后面的值那是查找文件的地方!
如下
1 | menu: |
这些配置都要与你主题目录下的languages文件中对应的yml文档里配置相关联。
比如你在站点根目录中的配置文件设置language为zh-Hans,那么就要进入到主题目录下的languages文件中修改zh-Hans.yml,这样才能显示出菜单项新增的中文内容
1 | menu: |
5、菜单项图标设置
在主题配置文件中对应的字段是menu_icons。格式为item name:icon name,其中item name与所配置的菜单名字对应,icon name是Font Awesome图标的名字。而 enable 可用于控制是否显示图标,你可以设置成 false 来去掉图标。
1 | menu_icons: |
新建的栏目icon,需要在Font Awesome图标库存在,例如新建的movies,在图标库中查询选择film图标,在主题配置文件的menu_icons中,更改movies: film
6、侧栏位置设置
在主题配置文件中修改主题目录下sidebar的position值
1 | sidebar: |
7、添加标签页面
前面通过修改next主题下的_config.yml文件中的menu选项,可以在主页面的菜单栏添加标签选项,但是此时点击标签,跳转的页面会显示page not found。此时我们要新建一个页面
在git bush中输入hexo new page tags
在新建的index.md文件中添加type: “tags”
1 | --- |
当要为某一篇文章添加标签,只需在blog/source/_post目录下的具体文章的tags中添加标签即可,如:
成功后为
8、侧边栏社交栏目
侧栏社交链接的修改包含两个部分,第一是链接,第二是链接图标。 两者配置均在 主题配置文件 中
(1)链接放置在 social 字段下,一行一个链接。其键值格式是 显示文本: 链接地址。
1 | # Social links |
(2)设定链接的图标,对应的字段是 social_icons。其键值格式是 匹配键: Font Awesome 图标名称, 匹配键 与上一步所配置的链接的 显示文本 相同(大小写严格匹配),图标名称 是 Font Awesome 图标的名字(不必带 fa- 前缀)。 enable 选项用于控制是否显示图标,你可以设置成 false 来去掉图标。
其中seoial_icons节点中后面的值是http://fontawesome.io/icons/ 中提供的图标的名称。之后其他链接如推特,微博等都可自行增减。
1 | # Social Icons |
9、显示当前浏览进度
主题配置文件 即themes/*/_config.yml
中scrollpercent
更改为true
,b2t
改为true
返回顶部及浏览进度显示在左侧sidebar
之下,改为false
显示在右下角
二、个性化设置
1、添加萌萌哒二次元看板娘
1.1、安装插件
npm install --save hexo-helper-live2d
1.2、配置
请向根目录的 _config.yml 文件或主题的 _config.yml 文件中添加配置.
1 |
|
1.3、配置文件
配置文件有很多方法这里主要讲我使用的方法:详情请参考如下:
1.3.1 在博客根目录下建文件夹live2d_models;
1.3.2 再在live2d_models下建文件夹<你喜欢的模型名字>;
1.3.3 再在<你喜欢的模型名字>下建json文件:<你喜欢的模型名字>.model.json;
1.4、安装模型
在命令行(即Git Bash)运行以下命令即可:
npm install --save live2d-widget-model-<你喜欢的模型名字>
模型安装
1.5、查看结果
在命令行(即Git Bash)运行以下命令, 在http://127.0.0.1:4000/
查看测试结果:
hexo clean && hexo g && hexo s
1.6、更改模型
若更改模型请从第二步更改model.use;删除第三步原有文件,重新创建,安装模型,查看结果
2、实现fork me on github
2.1、点击 这里 挑选自己喜欢的样式,并复制代码
2.2、然后粘贴刚才复制的代码到themes/*/layout/_layout.swig
文件中(放在<div class="headband"></div>
的下面),并把href改为你的github地址
2.3、若位置不对,在 img 标签中修改 style="position:fixed;top:0;right:0"
3、设置网站的图标Favicon
在EasyIcon或者Iconfont中找一张(32*32)的ico图标,并将图标名称改为favicon.ico,然后把图标放在/themes/next/source/images里,并且修改主题配置文件 :
4、首页文章添加阴影效果
打开\themes\next\source\css_custom\custom.styl,向里面加入:
1 | //文章内容添加边框阴影 |
5、网站顶部加载条
修改主题配置文件(_config.yml)将pace: false改为pace: true就行了,你还可以换不同样式的加载条,如下图:
6、统计文章阅读量
通过leanCloud统计您网站的文章阅读量
1.注册LeanCloud, 并创建一个你自己的应用;
2.点击图片右上角的设置图标进入应用界面;
3.到此,你的应用创建成功,继续表的创建,创建表,并将表的名字命名为:Counter, 如图:
4.打开设置 -> 应用key 获取App ID
和App Key
;
5.最后打开主题配置文件: themes/*/_config.yml
;
1 | leancloud_visitors: |
6.完成配置并重新编译。到此您已经成功设置了阅读量的统计
7、文章加密访问
打开themes->next->layout->_partials->head.swig文件,在以下位置插入这样一段代码:
1 | <script> |
然后在文章上写上password: ****
,如下:
8、修改链接URL
编辑 站点配置文件下的 _config.yml 文件,修改其中的 permalink字段:permalink: :category/:title/
9、文章置顶
9.1 安装插件
npm uninstall hexo-generator-index --save
npm install hexo-generator-index-pin-top --save
9.2 在需要置顶的文章中加上top即可,数值越大文章越靠前
1 | --- |
9.3 设置置顶标志
打开:/themes/*/layout/_macro/post.swig,定位到<div class="post-meta">
标签下,插入如下代码:
1 | {% if post.top %} |
如下:
10、隐藏网页底部powered By Hexo / 强力驱动
第一种方法:在主题配置文件中,找到footer
,配置如下:
1 | footer: |
第二种方法:打开themes/next/layout/_partials/footer.swig,使用<!-- -->
隐藏之间的代码即可,或者直接删除。位置如图:
11、实现统计功能
1.在根目录下安装 hexo-wordcount,运行:npm install hexo-wordcount --save
2.然后在主题配置文件中,配置如下:
1 | # Post wordcount display settings |
12、网站底部字数统计
1.在根目录下安装 hexo-wordcount,运行:npm install hexo-wordcount --save
2.然后在/themes/next/layout/_partials/footer.swig文件尾部加上:
1 | <div class="theme-info"> |
13、添加 README.md 文件
每个项目下一般都有一个 README.md 文件,但是使用 hexo 部署到仓库后,项目下是没有 README.md 文件的。
在 Hexo 目录下的 source 根目录下添加一个 README.md 文件,修改站点配置文件 _config.yml,将 skip_render 参数的值设置为skip_render: README.md
14、修改文章底部的那个带#号的标签
修改模板/themes/next/layout/_macro/post.swig,搜索 rel=”tag”>#,将 # 换成
15、添加RSS
1.站点根目录下安装插件,npm install --save hexo-generator-feed
;
2.在站点配置文件_config.yml中,添加如下内容:
1 | # Extensions |
3.然后再主题配置文件中配置rss
;
1 | rss: /atom.xml |
4.配置完之后运行:hexo clean && hexo g && hexo s
;
5.重新生成一次,你会在./public 文件夹中看到 atom.xml 文件。然后启动服务器查看是否有效,之后再部署到 Github 中
16、点击出现桃心效果
1.在路径/themes/*/source/js/src
里面新建love.js
文件并将代码复制进去;
1 | ! function (e, t, a) { |
2.在\themes\*\layout\_layout.swig
文件末尾</body>
之前添加
1 | <!-- 页面点击小红心 --> |
3.我选择的是社会主义核心价值观的特效,因为我们都是社会主义接班人!!
1 | (function() { |
17、修改文章内链接文本样式
1.修改文件 themes\*\source\css\_common\components\post\post.styl
,在末尾添加如下css样式,:
1 | // 文章内链接文本样式 |
18、在文章末尾添加“本文结束”标记
1.在路径 \themes\*\layout\_macro
中新建 passage-end-tag.swig
文件,并添加以下内容:
1 | <div> |
2.打开\themes\*\layout\_macro\post.swig
文件,在post-body
之后, post-footer
之前添加如下代码(post-footer之前两个DIV)
1 | <div> |
3.打开主题配置文件(_config.yml),在末尾添加:
1 | # 文章末尾添加“本文结束”标记 |
4.完成以上设置之后,在每篇文章之后都会添加如此效果图
19、自定义鼠标样式
打开 themes/*/source/css/_custom/custom.styl
,在里面写下如下代码:
1 | // 鼠标样式 |
20、Canvas背景
在主题配置文件中,找到Canvas配置项,可以应用NNext自带的Canvas特效,如下:
想要更改颜色和数量?修改文件:/themes/next/source/lib/canvas-nest/canvas-nest.min.js
,修改参考
21、修改内容区域的宽度
编辑主题的 source/css/_variables/custom.styl 文件,新增变量:
1
2
3
4
5// 修改成你期望的宽度
$content-desktop = 700px
// 当视窗超过 1600px 后的宽度
$content-desktop-large = 900px但是此方法不适用于 Pisces Scheme,对于 Pisces Scheme,需要同时修改
header
的宽度、.main-inner
的宽度以及.content-wrap
的宽度。例如,使用百分比(Pisces 的布局定义在source/css/_schemes/Picses/_layout.styl
中)1
2
3.header{ width: 60%; }
.container .main-inner { width: 60%; }
.content-wrap { width: calc(100% - 260px); }超过一定宽度后(一行内文字太多导致换行跨度太大),阅读体验不好,我调整的宽度为60%,各位可以自行测试进行调整
22、打赏功能
1.准备支付宝和微信二维码,存放在themes/*/source/images
2.在主题配置文件(_config.yml)中进行设置
1 | # Reward |
3.修复图片闪动bug,修改next/source/css/_common/components/post/post-reward.styl
,注释wechat:hover
和alipay:hover
23、配置Valine评论系统
1.Valine 是一款基于Leancloud的快速、简洁且高效的无后端评论系统;
2.获取Leancloud的APP ID和 APP KEY, 上面第六步设置中已经介绍了获取方法;
3.打开主题配置文件: themes/*/_config.yml
;
1 | # Valine. |
4.其他相关配置和邮件提醒方式可查看Valline详细配置官网
24、添加搜索功能
1.在根目录下安装hexo-generator-searchdb
插件,npm install hexo-generator-searchdb --save
;
2.站点配置文件中添加以下字段
1 | search: |
3.编辑主题配置文件启用本地搜索
1 | # Local search |
25、不蒜子访问统计
1.编辑 主题配置文件 themes/*/_config.yml
中的busuanzi_count
的配置项即可;
1 | busuanzi_count: |
2.找到主题调用不蒜子的swig文件\themes*\layout_third-party\analytics\busuanzi-counter.swig
3.更改域名
1 | 把原有的: |
26、添加404公益界面
1.在根目录下输入hexo new page 404
;
2.打开刚新建的页面文件,默认在 Hexo 文件夹根目录下 /source/404/index.md
;
3.将文件名index.md
改为404.html
;
4.在文件中写入内容,这里使用的是腾讯公益;
1 | --- |
5.将返回首页
的链接更改为自己的链接。
27、网页代码压缩
网上有很多相关的博文,常规的做法是使用gulp来进行压缩,但是没有成功,所以更换为hexo-neat
压缩插件进行。
1.站点根目录下安装插件npm install hexo-neat --save
;
2.修改站点配置文件,在末尾添加以下代码;
1 | # hexo-neat |
3.执行hexo clean && hexo g && hexo s
查看效果。
28、添加网站底部跳动的心
1.在主题配置文件中(themes/*/_config.yml
),更改footer
;
1 | footer: |
2.编辑标签,在/themes/*/layout/_partials/footer.swig
中,span
中增加id="heart"
;
1 | <span class="with-love" id="heart"> |
3.编辑css,在themes/*/source/css/_custom/custom.styl
中更改样式如下:
1 | // 自定义页脚跳动的心样式 |