从零使用Hexo框架搭建个人博客小记

拥有个人博客真的是一件很酷的事呢！

这篇博客面向非科班、有相关知识、但不会建站的小白（说的大概是我了）。配置过程会以概要的方式梳理一遍，提点一下每个步骤的思路和难点。

前言

平台: Windows

博客采用Hexo框架搭建，搭建过程理论上可以完全参照Hexo中文文档进行配置。

Hexo框架需要额外配置主题才能有好看的界面，我博客的主题是Volantis，理论上可以完全参照Volantis中文文档进行配置。

具体过程还可以参照知乎帖子从零开始搭建个人博客（超详细），或者自行B站、百度。

我基本全称跟着文档操作，几乎没有遇到坑

环境准备

安装git: Git - 安装 Git

安装Nodejs: Node.js

此处可以修改一下npm的全局安装路径和缓存路径

npm config set prefix "D:\nodejs\node_global"
npm config set cache "D:\nodejs\node_cache"

安装Hexo:
```
npm install -g hexo-cli
```
-g表示全局安装，即安装在上一步设置的node_global文件夹中

建站

运行以下命令，在文件夹中间建立站点

$ hexo init <folder>
$ cd <folder>
$ npm install

运行成功后，会生成如下目录

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

此处需要注意的是: /source为存放资源的根目录。例如网页中的资源路径/img/test.png相当于/source/img/test.png。

修改配置

请参照官方文档修改_config.yml

如果使用主题，这一步可以省略，主题的配置文件会覆盖这里的配置。

测试

运行hexo g生成静态网页，运行hexo s启动本地服务器

输出如下

$ hexo s
INFO  Validating config
INFO
============================================================
  Volantis 5.8.0
  Docs: https://volantis.js.org/
  Repo: https://github.com/volantis-x/hexo-theme-volantis/
============================================================
INFO  Start processing
INFO  Checking environment configuration...
INFO  Hexo is running at http://localhost:4000/ . Press Ctrl+C to stop.
INFO  Check environment configuration success!

http://localhost:4000/为本地服务器地址

安装主题

主题配置难度真不高，但阅读文档的过程很漫长。想要拥有个性化的博客，这一步是必须迈过的。请认真阅读每个主题的官方文档并进行配置。
主题的配置文件通常命名为_config.<theme name>.yml，例如Volantis主题的配置文件为_config.volantis.yml

值得注意的是：使用到的图片等素材选用图床还是本地图片，请根据需求自行斟酌。

Volantis主题

该主题里里外外（封面、文档页面、侧边栏、字体、插件···）均可自定义，请参照Volantis中文文档修改_config.volantis.yml中的字段。

部署

部署到GitHub

注册Github账号
配置ssh
建立名为username.github.io的仓库，其中username替换为账户名称

在_config.yml中找到如下片段（若没有，请自行添加），并根据自己的仓库信息修改

deploy:
  type: git
  repository: git@github.com:username/username.github.io.git  #你的仓库地址
  branch: main

运行hexo d将本地网站部署到GitHub上
访问username.github.io就能看到你的博客啦！

发布文章

将新写的博文如test.md放入/source/_post，使用hexo p & hexo d或hexo d -g即可发布

Hexo-Github发布流程图

本地部署

老师让我们本地部署，姑且提一句：本地可以使用IIS部署，也可以使用nginx部署。
IIS的使用就不用教了吧~~~

草稿的使用

这里补充一个使用技巧：在官方文档中提供了草稿draft的概念，可以在_drafts文件夹中写文章，然后使用hexo publish命令将草稿发布到_posts文件夹中。
下面引用官方文档的说明：

创建使用draft模板创建草稿

$ hexo new [layout] <title>

……刚刚提到了 Hexo 的一种特殊布局：draft，这种布局在建立时会被保存到 source/_drafts 文件夹，您可通过 publish 命令将草稿移动到 source/_posts 文件夹，该命令的使用方式与 new 十分类似，您也可在命令中指定 layout 来指定布局。