# 前言

一个简单的操作流程,自己也失败了很多次,不过好歹是成功了,记一下

个人使用的搭建本地环境就是 Windows 10,macOS 据说差不多

# Node.js 环境配置

首先看看有没有安装 Node.js:

node -v

如果没有的话安装 Node.js 18+,18 - 话 ShokaX 不能运行:Node.js (nodejs.org)

一般而言 npm 也是会一并安装的

装好了以后确认一下有没有成功安装:

node -v
npm -v

如果能够正确地显示版本信息,那么安装成功,Node.js 环境配置完成

# 安装 Hexo

通过 npm 包管理工具安装 Hexo:

npm install -g hexo-cli

安装完成后,确认一下 Hexo 的版本信息:

hexo -v

如果能够正确显示版本信息,安装成功,Hexo 下载安装完成。

# 部署本地 Hexo 页面

去文件资源管理器里面随便选个位置,创建一个新文件夹,然后在 CLI 把目录切换到这个文件夹:

cd C:\Users\Your_Account\Your_Blog_Files	#注意把路径改成自己电脑上的文件路径

使用 Hexo 初始化博客文件夹:

hexo init

博客文件夹初始化完成,现在已经可以尝试生成页面:

hexo g		#hexo generate 的缩写
hexo s		#hexo server 的缩写

如果没有报错,此时打开浏览器输入 localhost:4000127.0.0.1:4000 应该已经可以展示一个最基本的 Hexo 博客页面

如果想要创建一篇新的博文,可以使用 Hexo 的 new 命令:

hexo n "Your_First_Blog_Post"		#hexo new 的缩写 把标题改成自己喜欢的标题

然后可以通过 VSCode 来尝试打开文章的 Markdown 文件,或者你可以用更加专业的编辑器,直接在文件资源管理器中打开。
这部分可以随意设置,记得 Ctrl+S 保存。

设置好文章的内容之后,如果你想要更新本地的博客,可以先尝试清理之前的博客:

hexo clean

可以重复生成时使用的命令:

hexo g
hexo s

# 部署 Github Pages

打开你的 Github 创建一个新的仓库,命名为 username.github.io,此处的 username 改成你自己的 Github 用户名

在本地的博客文件夹下,找到 _config.yml ,用一个文本编辑器打开它,VSCode,Notepad 等等都可以。

直接拉到底,进行修改:

type: 'git'
repo: https://github.com/Username/BUsername.github.io.git
branch: main

修改完成后保存,可以退出

使用 npm 安装 Hexo 的 Git 部署工具:

npm install --save hexo-deployer-git

一般而言就可以成功。如果出错,请检查你的配置文件 _config.yml ,或检查你的网络情况。如果实在不行,可以尝试清空博客文件夹进行重试。

# 更新博文

想要创建新的博文,就在 CLI 中继续使用命令新建文章,然后使用各种方便的 Markdown 编辑工具,如 Typora,VSCode 等进行编辑。

创建新博文:

hexo n "new_post_example"

更新本地博客:

hexo clean
hexo g

尝试查看本地博客:

hexo s

然后在浏览器中输入 localhost:4000127.0.0.1:4000 进行预览,觉得样式满意了之后,可以同步到 Github Pages(网页端):

hexo d