Hexo配置过程

Hexo 配置过程

配置目标

一期目标

  • 启用 tag, category 等页面.
  • 使用 MathJax 渲染 LaTeX 公式.
  • 使用 Gitalk 作为评论系统.
    • 使用 MD5 的标签, 以规避由于文章标题过长而无法正常创建 GitHub issue 的问题.

二期目标

  • 在网站内保存图片等文件, 而非使用第三方图床.

闹了半天, 原来直接把图片存在 /source 目录的随意子目录下, 然后引用相对链接即可…

步骤

开始使用 Hexo

这部分内容有很多其他的博主都介绍过了, 我参考了这几篇文章:

HEXO博客搭建日记 - 青鸟晴空 - 博客园

教你免费搭建个人博客,Hexo&Github

这些文章介绍了下载安装 Node.js 到生成 Hexo 静态博客, 并部署到 GitPage 的步骤.

补充说一点, 我使用的是 NexT 主题 . 在配置网站语言为简体中文的时候, 应在 Hexo 的 _config.yml 里配置 language:language: zh-CN. 尽管依据国际标准应为 zh-Hans , 但是在 /theme/next/languages/ 目录下只有 zh-CN.yml 文件…

启用 “tags” 页面

要使用 tags 页面, 先得确保 主题 的 _config.yml 文件里 menu: 项中 tags 选项被启用. 例如

1
2
3
4
5
6
7
8
9
menu:
home: / || home
#about: /about/ || user
tags: /tags/ || tags
#categories: /categories/ || th
archives: /archives/ || archive
#schedule: /schedule/ || calendar
#sitemap: /sitemap.xml || sitemap
#commonweal: /404/ || heartbeat

|| 前的部分表示路径, 后面表示在页面上显示的图标, 使用的是 font-awesome.

然后, 需要创建一个 “Page” 类型的页面.

1
hexo new page "tags"

之后会在 /source/ 目录下出现一个 tags/ 目录, 里面有一个 index.md 文件. 其内容为:

1
2
3
4
---
title: tags
date: 2018-07-25 21:21:00
---

需要稍微修改一下,

1
2
3
4
5
6
---
title: 标签
date: 2018-07-25 21:21:00
type: "tags"
comments: false
---

conmments: false 表示在此页面禁用评论功能.

在发布的博文的 front-matter 中使用

1
2
3
4
5
6
---
tags:
- tagname1
- tagname2
...
---

来给文章添加标签.

其他同理.

启用 MathJax

根据 NexT 提供的 文档

$$ Hello \; MathJax $$

启用 Gitalk

Blog

参考资料

NexT 已适配MathJax

NexT 添加Gitalk

NexT 官网

NexT 使用文档

Gitalk 官网