In Huntersxy

纸上得来终觉浅,绝知此事要躬行

  1. 1. 一、环境准备
  2. 2. 二、环境检查
  3. 3. 三、安装并运行 Hexo
  4. 4. 四、关联 Git 仓库
  5. 5. 五、写文章、换主题
  6. 6. 六、上传到 GitHub
  7. 7. 常见错误

今天把博客程序重新部署了(浪费一个下午的时间),我宣布本站原地复活。

接下来是部署过程 😁(文章末尾有报错解决方案)

一、环境准备

首先下载 Node.js 和 Git,并注册好 GitHub 账号。

找一个合适的地方存放文件,我这里选择 G:/blog/rbqhub/,建好目录后在 GitHub 新建仓库:

  1. 打开 https://github.com/ 登录,点击右上角加号 → New repository
  2. 进入 Settings → GitHub Pages → Source,选择 master branch,刷新即可

二、环境检查

输入以下命令确认环境正常:

1
2
3
node -v         # 查看 Node.js 版本
git --version # 查看 Git 版本
npm -v # 查看 npm 版本

三、安装并运行 Hexo

1
npm install -g hexo-cli

然后 cd 到目标目录:

1
2
3
4
cd G:/blog/rbqhub/
hexo init myblog # 创建博客,myblog 可换成你喜欢的名字
cd myblog
npm install # 安装依赖

此时 rbqhub 文件夹下会生成 myblog 目录,包含以下内容:

  • node_modules/ — 依赖包
  • scaffolds/ — 生成文章的模板
  • source/ — 存放文章
  • themes/ — 主题
  • _config.yml — 配置文件

安装完毕后运行看看:

1
2
hexo g   # 生成静态页面
hexo s # 本地启动服务器

访问 http://localhost:4000/ 即可预览,然后就可以打开 Hexo 官方文档 使劲魔改了。

四、关联 Git 仓库

配置身份信息:

1
2
git config --global user.name "yourname"     # 换成你的 GitHub 用户名
git config --global user.email "youremail" # 换成你的 GitHub 邮箱

创建 SSH 密钥:

1
ssh-keygen -t rsa -C "youremail"

输入后会提示设置密码,想设就设,不想设直接回车。然后打开 C:\Users\你的用户名\.ssh\id_rsa.pub,将内容复制到 GitHub 的部署密钥中。

验证连接:

1
ssh -T git@github.com

修改 _config.yml,将 Hexo 和 GitHub 关联:

1
2
3
4
deploy:
type: git
repo: git@github.com:yourname/yourname.github.io.git
branch: master

五、写文章、换主题

这里不再赘述,请查阅 Hexo 官方文档。

推荐使用 hexo-admin 插件 管理文章。

六、上传到 GitHub

1
2
3
hexo clean
hexo g
hexo d

或者一条命令搞定:

1
hexo generate -d -f

上传完成后访问 你的用户名.github.io 即可查看!

常见错误

hexo : 无法加载文件 C:\Users\xxx\AppData\Roaming\npm\hexo.ps1,因为在此系统上禁止运行脚本。

解决方案: Win10/11 下更改 PowerShell 执行策略:打开 设置 → 搜索 power → 允许本地 PowerShell 在不签名的情况下运行 → 勾选并应用。

本文作者 : Huntersxy
本文使用 署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0) 协议
本文链接 : https://blog.xiey.work/2022/10/01/20221001/

本文最后更新于 天前,文中所描述的信息可能已发生改变