hexo, link start!

核心参考文档

hexo官方文档：详细的官方文档，但是英文
hexo官方中文文档：中文官方文档
hexo 超细安装步骤，零基础教程（一）：本地化部署：讲解了hexo 的本地化安装步骤
Hexo 博客搭建并部署到 GitHub Pages(2024最新详细版)：讲解了本地安装到github部署的完整步骤
使用 Hexo+GitHub 搭建个人免费博客教程（小白向）：补充了设置git的ssh密钥、绑定域名

步骤

安装git和node.js

git下载地址
Node.js下载安装及环境配置

安装hexo

安装hexo命令npm install -g hexo
查看hexo版本命令hexo v或hexo -version
通过查看hexo版本检查是否安装成功

初始化hexo

初始化hexo命令hexo init [folder]
这条命令会新建一个网站。 如果没有设置 folder ，Hexo 默认在目前的文件夹建立网站。

安装主题

浏览hexo主题，选择主题。
不同主题安装方式可能有些许不同。

next主题

1. 在 theme 文件夹下，建立你要使用的主题的同名文件夹，比如 theme/next。
2. cd 到 theme 文件夹，或者直接在 theme 文件夹里右键运行 Git Bash。
3. 输入获取主题的命令git clone https://github.com/theme-next/hexo-theme-next next

fluid主题

执行命令npm install --save hexo-theme-fluid。
在博客目录下创建_config.fluid.yml，将主题的_config.yml 内容复制过去。

指定主题

打开安装文件夹下_config.yml 文件，修改 theme 后面的名字为刚才安装的主题。

theme: fluid  # 指定主题
language: zh-CN  # 指定语言，会影响主题显示的语言，按需修改

部署hexo

清除缓存文件命令hexo clean，建议写完文章后执行一次
生成public文件命令hexo g，写完文章执行
启动 hexo 本地化预览命令hexo s
首次使用主题的「关于页」需要手动创建：hexo new page about

部署到 GitHub Pages

登录 GitHub，新建一个 Repository，Repository name一定要是 用户名.github.io
打开博客目录下的_config.yml，填写deploy模块：repository填写刚才仓库的URL
安装 Git 插件npm install hexo-deployer-git --save
输入命令hexo d进行部署。

常用命令

hexo new "name"       # 新建文章
hexo new page "name"  # 新建页面
hexo g                # 生成页面
hexo d                # 部署
hexo g -d             # 生成页面并部署
hexo s                # 本地预览
hexo clean            # 清除缓存和已生成的静态文件
hexo help             # 帮助
hexo clean && hexo g && hexo s #清除、生成、本地预览
hexo clean && hexo g && hexo d #清除、生成、部署

遇到的问题

在参考网上文章进行部署时遇到了一些小问题。

ssh: Connection refused

在参考使用 Hexo+GitHub 搭建个人免费博客教程（小白向）设置ssh密钥时，输入ssh -T git@github.com出现了报错ssh: connect to host github.com port 22: Connection refused。参考文章坑：ssh: connect to host github.com port 22: Connection refused，转而使用命令ssh -T -p 443 git@ssh.github.com，问题解决了。

hexo d运行失败

卡在deploy这一步好久，输入hexo d后一直弹出You have to configure the deployment settings in _config.yml first!。阅读提示后才发现是_config.yml文件中repo:我写成了repository:。改正后就可以正常运行了。

碎碎念

为什么打算搭建个人博客呢？
之前一直使用飞书文档进行记录，飞书文档优点很多，使用简单、共享方便、协作编辑、多端使用体验都很好。但学校要停止飞书服务了，害怕文档丢失。
使用框架搭建博客很方便快捷。文档内容检索也很强大。内容全都由自己管理，妈妈再也不用担心我的文档丢失啦。同时有一个个人博客听起来很酷，于是就弄了一个博客。在博客上看文字可比本地看markdown文件高级舒服多了。