Hexo+Next的安装

本文是利用Hexo搭建并生成静态博客，将其托管于Github上，采用的博客主题为Next，一个热门且简洁的主题。以下是总结的简单教程。

软件准备

1
2
3

node -v
npm -v
npm config set registry https://registry.npm.taobao.org #配置国内镜像源

git环境

1 2	安装最后一步选择：Use Git from the Windows Command Prompt(添加至环境变量) git --version

Hexo的安装与使用

Hexo的安装与配置

npm install -g hexo-cli   #安装hexo
hexo -v
npm update hexo -g   #更新hexo
hexo init “文件夹路径”   #初始化文件

Hexo配置git

右键选择 Git Gui选择窗口菜单Help中的Show SSH key，在新窗口中点击Generate Key生成新key并拷贝至剪贴板
进入Github设置页面点击SSH and GPG keys，名字任意，然后粘贴上一步中的key，保存
回到文件夹，打开gitbash 输入
1
ssh -T git@github.com
如果出现用户名，则成功

打开博客根目录下的_config.yml文件，修改最后一行的配置：

deploy:
  type: git
  repo: https://github.com/用户名/用户名.github.io.git
  branch: 分支名

生成、修改、发布文章

hexo n "文章标题"   #新建博客文章
hexo clean && hexo s   #本地部署预览
hexo d -g   #上传至github云端
备注：若上传失败，可能是代理问题，cmd设置代理
set http_proxy=http://127.0.0.1:10808
set https_proxy=http://127.0.0.1:10808

主题Next配置

下载Next主题

1	git clone https://github.com/theme-next/hexo-theme-next themes/next #若失败，可在https://github.com/前加https://ghproxy.com/作为代理使用

修改根目录主站点配置文件_config.yml，找到如下代码：

1 2	## Themes: https://hexo.io/themes/ theme: landscape #此处landscape替换为next

备注：在 Hexo 中有两份主要的配置文件，其名称都是 _config.yml。其中，一份位于站点根目录下，主要包含 Hexo 本身的站点配置；另一份位于主题目录下，这份配置由主题作者提供，主要用于配置主题相关的选项。

为了描述方便，将前者/_config.yml称为站点配置文件，后者/themes/next/_config.yml称为主题配置文件。

修改语言

站点配置文件，搜索 language 后添加 zh-CN

设置MathJax引擎

安装Pandoc
卸载原有的渲染器hexo-renderer-marked，并安装hexo-renderer-pandoc
1
2
npm uninstall hexo-renderer-marked
npm install hexo-renderer-pandoc
在/themes/next/_config.yml中将 mathjax 的 enable 打开
1
2
3
4
math:
...
mathjax:
enable: true

在对应的文档头部添加MathJax标记

title: Hexo使用教程
date: 2021-06-25 23:45:57
tags: [MarkDown,教程,hexo]
categories: 软件
mathjax: true

注意：在修改配置选项时，不要更改配置的缩进；目前，NexT 的所有配置都采用2 空格的缩进；

如果配置的内容接在冒号后面，那么内容和冒号之间必须有一个空格(例如enable: true)

# Math Formulas Render Support
math:
  # Default (true) will load mathjax / katex script on demand.
  # That is it only render those page which has `mathjax: true` in Front-matter.
  # If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.
  per_page: true

  # hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.
  mathjax:
    enable: true
    # See: https://mhchem.github.io/MathJax-mhchem/
    mhchem: false

  # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) required for full Katex support.
  katex:
    enable: false
    # See: https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex
    copy_tex: false

公式示例：

行内公式\(\sin x+\sum_{i=1}^N=1\)

行间公式 \[ \begin{equation}\label{eq3} \begin{aligned} a&=\begin{bmatrix}1&2&3\end{bmatrix}\\ a&=\begin{bmatrix}1\\2\\3\end{bmatrix}\\ a&\cdot b=\sum_{i=1}^{n}a_ib_i \end{aligned} \end{equation} \] 如公式\(\eqref{eq3}\)

多端同步

拷贝整个文件夹
对应的插件安装记录在根目录中package.json文件中，下载安装好就ok

其他功能配置

首页以摘要的形式显示

在文中加入进行截断，截断前的内容将以摘要的形式显示

添加标签页面

在博客文件夹中，运行

1	hexo new page tags

编辑对应目录下的index.md文档题头，加入type: "tags"
在主题配置文件中的menu 下把tags: /tags/ || fa fa-tags取消注释

添加分类界面

同上，运行

1	hexo new page categories

然后修改md文件，加入hexo new page categories
接着在主题配置文件中取消menu下的categories的注释

设置永久短链接

安装插件
1
npm install hexo-abbrlink --save

在站点配置文件中，添加

permalink: posts/:abbrlink/
abbrlink:
  alg: crc32   #算法： crc16(default) and crc32
  rep: hex     #进制： dec(default) and hex

添加社交链接

在主题配置文件中，作出如下修改

1 2	social: GitHub: https://github.com/xiakong24 \|\| fab fa-github #\|\|后为图片，可以去Font Awesome icon官网查询对应的图标名称

添加版权信息

找到主题配置文件如下位置，并作出对应修改

creative_commons:
  license: by-nc-sa
  sidebar: false
  post: true

可能需要在文章头部加入copyright: true项

留言板功能

本博客采用的是Hexo集成Gitalk评论系统，其特性为
- 使用 GitHub 登录
- 支持多语言 [en, zh-CN, zh-TW, es-ES, fr, ru]
- 支持个人或组织
- 无干扰模式（设置 distractionFreeMode 为 true 开启）
- 快捷键提交评论（cmd|ctrl + enter）
要使用 Gitalk 需要先在 GitHub 上注册新应用，链接： https://github.com/settings/applications/new
参见1中网站进行设置，然后在主题配置文件中作出相应修改即可
在对应文档的题头加入comments: true开启或comments: false关闭评论

添加相册

参考博客Hexo NexT 博客增加瀑布流相册页面

文档中插入图片，先上传至对应的文件夹中，然后md文件中地址为photo/images/name.jpg对应引用

XiaKong' Blog

Hexo使用教程