3-hexo使用说明

这是 3-hexo 说明文件，转载自叶落阁：https://yelog.org/2017/03/23/3-hexo-instruction/

@[toc]

前言

下面如果没有特殊说明，_config.yml 都指主题配置文件，即 3-hexo 目录下

自定义首页

可查看这篇文章： 3-hexo配置首页。

blog快捷键

可查看这篇文章： 3-hexo快捷键说明。

更换头像

两种方式：

替换 source/img/avatar.jpg 图片。

修改 _config.yml 中头像的配置记录

# 你的头像url
avatar: /img/avatar.jpg
favicon: /img/avatar.jpg

设置链接图标

如下，如果没有连接，则不展示图标。

# 链接图标，链接为空则不显示
link:
  rss: /atom.xml
  github: https://github.com/yelog
  facebook: https://www.facebook.com/faker.tops
  twitter:
  linkedin:
  instagram:
  reddit: https://www.reddit.com/user/yelog/
  weibo: http://weibo.com/u/2307534817
  email: [email protected]

开启关于页面

在 hexo 根目录执行以下，创建关于页面
```
hexo new page "about"
```
位置： source/aoubt/index.md ，根据需要进行编辑。

在主题中开启显示：修改主题根目录 _config.yml 中的 about 的 on 为 true ，如下所示：

menu:
about:  # '关于' 按钮
on: true # 是否显示
url: /about  # 跳转链接
type: 1 # 跳转类型 1：站内异步跳转 2：当前页面跳转 3：打开新的tab页

添加音乐插件

3-hexo添加音乐插件。

配置评论系统

目前添加了三种评论系统 disqus、多说、网易云跟帖、gitment、gitalk

日志： 2017-03-21：多说将于2017-06-01正式关停服务

启用评论

以 disqus 为例：

关掉其他两个评论（设置 on: false）
启用 disqus ,设置 on: true
登陆 disqus 注册，得到 shortname ，填入 shortname 。
重启 hexo 。
meta区显示评论数
开启设置 _config.yml
```
comment_count: true
# 文章标题下方显示评论数
```

评论区预加载

开启设置 _config.yml

preload_comment: false
# false: 当点击评论条等区域时再加载评论模块
# true: 页面加载时加载评论区

样式设置

代码高亮

首先要关闭 hexo 根目录下 _config.yml 中的高亮设置：

highlight:
  enable: false

配置 3-hexo主题下 _config.yml 中的高亮设置：

#可以根据提示，配置喜欢的高亮主题
highlight:
  on: true # true开启代码高亮
  lineNum: true # true显示行号
  theme: darcula
# 代码高亮主题,效果可以查看 https://highlightjs.org/static/demo/
# 支持主题：
# sublime : 参考sublime的高亮主题
# darcula : 参考idea中的darcula的主题
# atom-dark : 参考Atom的dark主题
# atom-light : 参考Atom的light主题
# github : 参考GitHub版的高亮主题
# github-gist : GitHub-Gist主题
# brown-paper : 牛皮纸效果
# gruvbox-light : gruvbox的light主题
# gruvbox-dark ： gruvbox的dark主题
# rainbow :
# railscasts :
# sunburst :
# kimbie-dark :
# kimbie-light :
# school-book : 纸张效果

MathJax 数学公式

修改 3-hexo主题下 _config.yml

# MathJax 数学公式支持
mathjax:
  on: true #是否启用
  per_page: false # 若只渲染单个页面，此选项设为false，页面内加入 mathjax: true

考虑到页面的加载速度，支持渲染单个页面。
设置 per_page: false ,在需要渲染的页面内加入 mathjax: true

注意:
由于 hexo 的 MarkDown 渲染器与 MathJax 有冲突，可能会造成矩阵等使用不正常。
所以在使用之前需要修改两个地方，编辑 node_modules\marked\lib\marked.js 脚本

# 将451行 ，这一步取消了对 \\,\{,\} 的转义(escape)
escape: /^\\([\\`*{}\[\]()# +\-.!_>])/,
改为
escape: /^\\([`*\[\]()# +\-.!_>])/,

# 将459行，这一步取消了对斜体标记 _ 的转义
em: /^\b_((?:[^_]|__)+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
改为
em:/^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,

表格样式

目前提供了 3 种样式，修改 3-hexo主题下 _config.yml

table: green_title
# table 的样式
# 为空时类似github的table样式
# green 绿色样式
# green_title 头部为青色的table样式

文章列表的hover样式

鼠标移入的背景色和文字颜色变动，设置 3-hexo主题下 _config.yml

#文章列表 鼠标移上去的样式, 为空时使用默认效果
article_list:
  hover:
    background: '#e2e0e0'  # 背景色:提供几种：'#c1bfc1'  '#fbf4a8'
    color:     # 文字颜色 提供几种：'#ffffff'
# 注意：由于颜色如果包含#，使用单引号 ' 引起来

开启字数统计

开启此功能需先安装插件，在 hexo根目录执行 npm i hexo-wordcount –save
修改 3-hexo主题下 _config.yml

word_count: true

多作者模式

可查看这篇文章： 3-hexo多作者模式。

文章排序及置顶

可查看这篇文章： 3-hexo置顶及排序问题。

关于写文章

如何写

每篇文章最好写上文集和标签，方便筛选和查看。
一般推荐一篇文章设置一个文集，一个或多个标签
categories：文集，为左侧列表
tags：标签，通过 # 来筛选
例如本篇文章的设置：

---
title: 3-hexo使用说明
date: 2017-03-23 15:13:47
categories:
  - Hexo说明
tags:
  - 3-hexo
---

写作

1.设置模板，blog 根目录 scaffolds/post.md
加入 categories ， tags 等，这样以后通过 hexo new 生成的模板就不用写这两个单词了。
当然，你也可以写入任何你每个文章中都会有的部分。

---
title: {{ title }}
date: {{ date }}
categories:
tags:
---

技巧

快捷命令

其实就通过 alias ，触发一些命令的集合
在 ~/.bashrc 文件中添加：

alias hs='hexo clean && hexo g && hexo s'  #启动本地服务
alias hd='hexo clean && hexo g && hexo d'  #部署博客

甚至你也可以加入备份文章的命令，可以自由发挥。

博客备份（快捷命令升级版）

1.为了保证我们写的文章不丢失、快速迁移博客，都需要备份我们的 blog。
2.博客根目录，执行 git init 创建 git 仓库。
3.在 github（或其他托管平台、自建远程仓库等）创建仓库并和本地仓库建立联系。
4.在 ~/.bashrc 文件中添加

alias hs='hexo clean && hexo g && hexo s'
alias hd='hexo clean && hexo g && hexo d && git add . && git commit -m "update" && git push -f'