建立Hexo个人博客

使用hexo和github.pages搭建博客,主题为zhaoo

文章部分功能是主题没更新之前写的,随着主题更新,功能也越来越完善,且设置起来更方便。作为记录,已有的内容不再修改,具体配置情况请根据主题而定。更多内容可以参考zhaoo主题作者博客主页:zhaoo

准备工作

github创建名为username.github.io的repository

安装git

安装Node.js

安装Hexo

新建文件夹blog,存放博客的所有内容

1
2
3
4
5
6
7
# 安装hexo
npm install hexo-cli -g
# 确认是否安装成功
hexo -v
# init
hexo init
npm install

生成的几个文件:

  • node_modules:依赖包
  • public:存放生成的页面
  • scaffolds:生成文章的一些模版
  • source:用来存放文章
  • themes:主题
  • _config.yml: 配置文件
1
hexo server

然后在浏览器输入localhost:4000即可看到生成的博客。

更换主题

hexo默认主题是landscape,可以自由更换主题:

1
2
#下载主题到themes/zhaoo路径
git clone git@github.com:izhaoo/hexo-theme-zhaoo.git themes/zhaoo

根据需求创建tags、about、categories页面:

1
2
3
hexo new page tags
hexo new page about
hexo new page categories

以上代码会在source的对应文件夹下生成index.md文件,可根据需求配置页面:

1
2
# 以tagsindex为例,将layout设置为tags布局,不同与一般的布局。
layout: tags

layout(布局)有三种:post(文章)、draft(草稿)、page(页面),默认是post

然后根据主题配置说明,配置主题的配置文件themes/zhaoo/_config.yml

关联git库

1
2
# 安装要用的插件
npm install hexo-deployer-git --save

修改blog/_config.yml配置文件:

1
2
3
4
deploy:
type: git
repo: git@github.com:username/username.github.io.git
branch: master

上述代码表示部署到指定的库中,并且默认部署到分支master。

部署的机制是将本地生成的.deploy_git文件夹里的文件,上传到远程库,并不包括配置文件和主题文件。

为了方便多终端工作,建议每次写完文章,除了deploy操作以外,将源代码也push到远程仓库保存。新建一个分支,将源文件push到这个分支里面,这样在另一台机器上只需要clone远程库,安装必要的文件就可以了。

新建文章

1
2
3
4
5
6
7
8
9
10
# 创建新的文件,默认保存在source/_post路径下
hexo new 'new blog'
# run server
hexo server
# 清除缓存
hexo clean
# 生成静态网页
hexo generate/hexo g
# 将网页部署到远程站点
hexo deploy/hexo d

scaffolds文件夹中,有三种默认布局新建时的模版,可以自定义新建文件时的格式。

tags和categories属性的值可以用列表,表示多个标签/类别。

数学公式渲染

主题更新添加了公式渲染配置的说明,方法简单快捷,可以参考。本节内容作为踩坑记录。

hexo默认的Markdown渲染器是hexo-renderer-marked,会先按照Markdown语法解析,然后才是LaTex,所以会有冲突。试了网上各种解决方法,终于遇到一个有效的方法:hexo无法显示公式的问题-DGZ’s Blog

重装插件

首先,只保留一个公式渲染器,这里保留kramed渲染器。

1
2
3
# 卸载默认的渲染器,其他的公式渲染器也卸载,只保留kramed
npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-kramed --save

修改js文件

打开bolg/node_modules/hexo-renderer-kramed/lib/renderer.js,将:

1
2
3
4
5
//change inline math rule
function formatText(text) {
// Fit kramed's rule: $ + 1 + $
return text.replace(/` (.*?) `/g, ' $ $1 $ ');
}

修改为:

1
2
3
4
// Change inline math rule
function formatText(text) {
return text;
}

安装mathjax插件

1
2
3
# 如果有hexo-math,则卸载掉
npm uninstall hexo-math --save
npm install hexo-renderer-mathjax --save

修改html文件

打开blog/node_modules/hexo-renderer-mathjax/mathjax.html,将:

1
<script src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>

修改为:

1
<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML"></script>

激活插件

在使用公式的md文件添加属性:

1
mathjax: true

部署

如果是第一次修改,修改完以后需要重新启动服务:

1
2
3
hexo clean
hexo g
hexo s

图床

众所周知,github是万能的,使用PigGo和Github搭建个人图床,参考PigGo官方文档

新建github项目

新建github项目用来存放图片,并生成token:

1
2
github头像->Settings->Developer settings->Generate new token
将repo选项打勾

配置PicGo

1

然后点击确定,并设置为默认图床。

自定义域名可以按照图中的设置,也可以使用别的自定义域名。第二种域名方式就是使用CDN加速的方法,CDN(Content Delivery Network)是指内容分发网络,也称为内容传送网络。

jsDelivr是一种免费的CDN加速产品,可以加速Github和NPM的资源,其中使用jsDelivr的方法访问Github资源只需要将链接改为以下格式:

1
2
https://cdn.jsdelivr.net/gh/username/repository@version/file   
# 其中的version指的是仓库版本,如果没有release版本,也可以使用分支名称

jsDelivr的更多用法可以参考官方文档

使用jsDelivr加速的自定义域名填写内容如下:

2

上传图片

将图片拖入上传区,上传成功后会自动在剪切板生成图片链接。

其他设置

其他参数设置可根据个人喜好进行设置:

3

图片上传失败问题

由于某些原因,github当作图库不是很稳定,时好时坏也是正常现象。

参考PicGo踩坑记

  • 首先检查设置的仓库名是否正确,仓库名不可包含空格,且不要出现奇怪的符号
  • 上传的图片名字不要有奇怪符号
  • 间歇性上传失败的话,可以将server的开关状态切换一下

另外,有条件的可以使用全局代理:airplane:

其他

主题的其他设置可以参考zhaoo主题文档,这里只记录一部分

访问量统计

主题默认使用的是leancloud,这里的统计是每篇文章的访问量,zhaoo主题支持leancloud,只需要按要求填写即可:

1
2
3
4
进入leancloud,创建应用(开发版)
创建ClassACL权限选择无限制
打开设置-应用keys
将AppID、AppKey、Rest API服务器地址复制到themes/_config.yml

如果想要设置本地访问不统计次数,则可以在\themes\zhaoo\layout\_partial\common\visitors.ejs中,修改以下内容:

1
2
3
4
5
6
7
8
9
$(function () {
const Counter = AV.Object.extend("Counter");
showCount(Counter);
const localhost = /http\:\/\/localhost|http\:\/\/127.0.0.1|http\:\/\/0.0.0.0/;
if (localhost.test(document.URL)) {
return;
}
addCount(Counter);
}

如果想对网站访问量统计,可以使用卜蒜子,在themes\zhaoo\layout\_partial\footer.ejs中合适的位置加入以下代码,其中的字体显示内容和风格可以自由设置:

1
2
3
4
5
6
7
<script async src="//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"</script>
<span id="busuanzi_container_site_pv">
总浏览量:<span id="busuanzi_value_site_pv" style="font-size:12px;"></span>
</span>
<span id="busuanzi_container_site_uv" >
总访客数:<span id="busuanzi_value_site_uv" style="font-size:12px;"></span>
</span>

评论功能

使用Valine,前提是主题支持:

1
2
3
4
leancloud,创建应用(开发版)
创建Class,配置默认
打开设置-应用keys
将AppID、AppKey复制到themes/_config.yml

侧边目录

zhaoo没有支持侧边目录,需要自己添加代码,使用hexo官方的toc函数。(2020.11.16主题更新,已经支持)

themes\zhaoo\layout\_partial\post\article.ejs中,最前面加以下代码:

1
2
3
4
5
6
7
8
9
10
<aside class="post-widget">
<nav id="toc" class="toc-article fixed">
<strong class="toc-title">文章目录</strong>
<%- toc(page.content, {
class: 'post-toc',
list_number: false,
max_depth: '6',
min_depth: '1'}) %>
</nav>
</aside>

然后在themes\zhaoo\source\css\_partial\post.styl中,最前面添加以下代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
.post-widget
float right
width 15%
padding-left 10px
min-hidden 1px
.toc-article.fixed
top 76px
bottom 140px
overflow-y auto
.toc-article
position fixed
overflow-x hidden
.toc-title
padding-left 20px

SEO优化

搜索引擎优化(Search Engine Optimization,SEO),是一种通过了解搜索引擎的运作规则来调整网站,以及提高目的网站在有关搜索引擎内排名的方式。

Github.pages屏蔽了百度的爬虫请求,配置较麻烦,这里仅以Google为例,使用Google Search Console,以下过程参考:hexo博客搭建(五) SEO优化

1
2
3
4
5
6
7
1、首先去google search console验证,有多种方式可选。
2、添加站点地图 sitemap
npm install hexo-generator-sitemap --save # 安装站点地图自动生成的插件
在_config.yml文件中添加以下代码:
sitemap:
path: sitemap.xml
3、部署之后可以去google search console测试。

未完待续……


参考教程

hexo官方文档

hexo史上最全搭建教程