In Huntersxy

Hi, nice to meet you.

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

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

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

一、环境准备

首先下载 Node.jsGit,并注册好 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/

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