建立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

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

1
2
3
4
leancloud,创建应用(开发版),可以和访问量统计使用一个应用
创建Class,配置默认
打开设置-应用keys
将AppID、AppKey复制到themes/_config.yml

设置邮箱提醒

如果想要在别人评论后,能够收到提醒,就需要设置邮箱提醒了。这里使用Valine-Admin插件,参考官方教程设置:

  1. 进入Leancloud对应的valine应用中,

  2. 点击云引擎—设置,添加环境变量,添加自定义环境变量,保存。

    如果使用QQ邮箱,密码需要使用QQ邮箱的授权码。

  3. 设置好环境变量以后,选择Web—部署—Git部署,填写代码库https://github.com/zhaojun1998/Valine-Admin,分支使用master,部署。

此外,由于LeanCloud免费版有休眠策略,需要使用自定义计时器让容器一直保持运行状态。

具体使用方法:

  • 创建两个定时任务,第一个定时器选self_wake函数,Cron表达式填0 */20 7-23 * * ?,表示每天的7-23点每20分钟访问一次。
  • 第二个定时器选resend_mails函数,Cron表达式填0 0 8 * * ?,表示每天早8点检查过去24小时内漏发的通知邮件并补发。

更新设置以后,重新部署一下即可,至此,可以收到邮件的评论提醒,此外还可以设置邮件的回执格式等。

设置微信提醒

如果想使用微信提醒,前提是配置好邮箱提醒。

使用Server酱设置微信提醒,首先需要根据Server酱的使用教程获取到SCKEY,在LeanCloud中添加自定义环境变量,nameSCKEYvalueSCKEY的值,保存,重新部署。这样配置完后,在Server酱官网进行测试,应该能够收到微信提醒。

设置别人评论收到微信提醒,需要在主题的JS文件中添加代码(参考链接),往 https://sctapi.ftqq.com/SENDKEY.send 发 HTTP 请求,就可以收到消息啦。具体设置,根据不同主题而定,对于zhaoo主题,在zhaoo\layout\_partial\comments下的valine.ejs文件中,添加以下代码:

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
// 添加代码以后的文件
<% if (theme.valine.appId && theme.valine.appKey) { %>
<div id="valine"></div>
<script defer src="//unpkg.com/valine/dist/Valine.min.js"></script>
<script>
window.onload = function () {
var loadValine = function () {
new Valine({
el: '#valine',
app_id: "<%= theme.valine.appId %>",
app_key: "<%= theme.valine.appKey %>",
placeholder: "<%= theme.valine.placeholder %>",
avatar: "<%= theme.valine.avatar %>",
pageSize: "<%= theme.valine.pageSize %>",
lang: "<%= theme.valine.lang %>",
});
}
if ( <%- theme.comments.button %> ) {
$("#comments-btn").on("click", function () {
$(this).hide();
loadValine();
//从这里开始添加代码
var title1="text=Live and Learn有新评论啦~ --by Valine" //自定义标题
var SCKEY_Server="" //填写SCKEY的值
var ValineButton=document.getElementsByClassName("vsubmit vbtn")[0];
function send_valine_Server(){
var text="desp=";
var pageurl=document.URL;
var ptime=new Date();
var vnick=document.getElementsByClassName("vnick vinput")[0].value;
var veditor=document.getElementsByClassName("veditor vinput")[0].value;
var data=text+"|昵称"+"|评论内容"+"|跳转链接"+"|评论时间"+"\n"+"|----|----|----|----|"+"\n"+"|"+vnick+"|"+veditor+"|"+pageurl+"|" +ptime.toLocaleString()+"|";
var httpRequest = new XMLHttpRequest();//第一步:创建需要的对象
httpRequest.open('POST', 'https://sctapi.ftqq.com/'+SCKEY_Server+'.send', true); //第二步:打开连接
httpRequest.setRequestHeader("Content-type","application/x-www-form-urlencoded");//设置请求头 注:post方式必须设置请求头(在建立连接后设置请求头)
httpRequest.send(title1+"&"+data);//发送请求 将请头体体写在send中
};
ValineButton.onclick=send_valine_Server;
// 添加代码结束
});
} else {
loadValine();
}
};

</script>
<% } %>

至此,收到评论以后就能够收到微信提醒。

侧边目录

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测试。

continue……


参考教程

hexo官方文档

hexo史上最全搭建教程

查看评论