0. 前言

大部分 $OIer$ 都想要一个自己的博客。当然你可以直接用 洛谷博客 或 cnblogs 等在线博客托管平台。但如果你追求更高的拓展性与美观度，那么 Hexo 应该是不二之选。

如果你要自己搭 Hexo 博客，并上传至 github 服务器，不建议网络直连。或者可以使用 gitee 国内服务器，操作类似，不过需要手持身份证照片。

1. 安装 hexo

首先它需要两个依赖软件，NodeJS和Git

可以点上面的链接去官网下载，也可以直接点快捷链接：

安装完之后，直接打开终端（PowerShell 和 cmd 都是可以的），在随便一个目录下输入

1
npm install hexo-cli -g

这就是最基本的框架，运行 hexo 指令的前提。

2. 配置框架依赖

首先新建一个文件夹，起好名字。用终端打开，输入如下指令：

1
2
hexo init .
npm install

如果你的 hexo 指令报错了，那么你可能需要这样：

把对勾点上然后点应用。如果你是 Windows 10 直接搜索脚本也是可以找到的，壳就差不多了。

你可以找到博客文件夹，找到_config.yml，根据提示个性化修改里面的内容。

3. 配主题

这才是自己搭博客的精髓呀，这里推荐：

NexT

butterfly

sakura

diaspora

配主题切记看官方文档，不要信一些其他网站。

一般主题间切换有一定成本，不建议从某个主题，除默认，更换到其他主题。建议新建文件夹重新来过。

4. 配数学公式

有些主题不直接支持数学公式。如果主题没有自己指定渲染器，那么可以尝试以下操作来支持数学公式。（办法来源于 宝硕）

先来输入两条指令换掉渲染器。

1
2
npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-markdown-it @neilsustc/markdown-it-katex --save

然后在_config.yml中添加一下内容

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# Markdown-it config
## Docs: https://github.com/celsomiranda/hexo-renderer-markdown-it/wiki
markdown:
  render:
    html: true
    xhtmlOut: false
    breaks: true
    linkify: true
    typographer: true
  plugins:
    - '@neilsustc/markdown-it-katex'
  anchors:
    level: 2
    collisionSuffix: 't'
    permalink: false
    permalinkClass: header-anchor
    permalinkSymbol: ''

然后在主题的 source 文件夹里找到 head.ejs 例如默认主题就在这里：

然后在合适的位置（大概缩进一次后）放入这两行代码：

1
2
3
<!-- KaTeX -->
<link rel="preload" href="https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/katex.min.css" as="style" onload="this.onload=null, this.rel='stylesheet'">
<noscript><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/katex.min.css"></noscript>

5. 一些正常使用时常用指令

创建一个新的文章

1
hexo new "My New Post"

More info: Writing

解释：如果你想写一篇名叫 IAKIOI 的博客，那么你可以这样:

如果你想更改，你大概能在下面的位置找到它：

如果要删除的话直接删掉文件就行。

本地预览

1
hexo server

More info: Server

解释：如果你想边写博客边预览，那么你就可以这样输入这条指令，然后保持终端打开。

然后在浏览器中输入 http://localhost:4000 就可以看了。

在更改配置文件或组件后要重新启动，否则不需要，刷新页面即可。

补充：

清除缓存，用于在更改一些配置文件或组件后防止引起混乱。

1
hexo clean

如果你的博客刚刚按照上面的步骤搭好，那么他应该是这样的：

6. 生成并上传至 github 仓库

手把手教你 github。（这里如果之前用过可以选择性跳过）

首先你登上github 官网（前提是你运气够好等得上。。）

然后按照指引注册账号。

点击新建仓库：

这个仓库名要严格 name.github.io 会方便很多，这里报错是因为我已经有这个仓库了。

然后转入输入网址https://github.com/settings/tokens/new，转入个人密钥设置，Note 随意但必填，勾选 repo ：

点新建后记下来

然后 github 方面就完成了。

本地配置

找到博客文件夹，找到_config.yml。

在里面找到

1
2
3
4
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: ''

改成

1
2
3
4
5
6
7
deploy:
  type: git
  repo: https://github.com/'yourname'/'yourname'.github.io.git
  branch: master
  name: 'yourname'
  email: 'youremail'
  token: 'yourtoken'

加单引号部分为你个人信息。

然后终端跳转到文件夹，输入指令： 

1
npm install hexo-deployer-git --save

然后你就可以尝试用 hexo g 和 hexo d 或直接 hexo g -d。

第一次上传应该会提醒输入密码，这时，要输入密钥，即 token。

应该差不多了吧。。。