tags: [‘hexo’,‘GitHub’]
categories: ‘精选推荐’

description: 一键发布语雀文章至 github (hexo 博客) 和 gitee 并实现 gitee pages 自动更新。

# 前言

一键发布语雀文章至 github (hexo 博客) 和 gitee 并实现 gitee pages 自动更新。

hexo 博客示例：https://alanhays.gitee.io | https://alanhays.github.io

语雀编写文章
同步语雀文章至 hexo
hexo 发布语雀文章更新博客
github actions 自动同步仓库至 gitee 并更新 pages

# 部署 hexo 博客

# 安装 git 和 node (推荐 LTS 版)

git 官网 -> https://git-scm.com/

node 官网 -> https://nodejs.org/en

# 检查安装

# 安装 hexo 博客

找到一个位置，打开 **Git Bash Here** 分别执行下面命令，其中 blog 可替换为你喜欢的名字（会在当前目录新建一个文件夹）

npm install hexo-cli -g
hexo init blog
cd blog
hexo s

# 验证博客

浏览器打开 -> http://localhost:4000/

打开后正常显示 hexo 默认博客

# hexo 常用命令

npm install hexo -g # 安装Hexo
npm update hexo -g # 升级
hexo init blog # 初始化博客 blog(选填) 创建一个名为blog的目录并初始化

命令简写
hexo n "文章名" == hexo new "文章名" # 新建文章
hexo g == hexo generate # 生成
hexo s == hexo server # 启动服务预览
hexo d == hexo deploy # 部署

hexo server # Hexo会监视文件变动并自动更新，无须重启服务器
hexo server -s # 静态模式
hexo server -p xxxx # 更改端口
hexo server -i xxx.xxx.x.x # 自定义IP
hexo clean #清除缓存

# GitHub 创建仓库

仓库名称格式你的用户名.github.io 比如我这里应该写 alanhays.github.io

# 生成秘钥 & 公钥

打开 **Git Bash Here** 执行以下命令

yourname 改为你的 GitHub 的用户名

1	git config --global user.name "yourname"

youremail 改为你的注册 GitHub 时的邮箱

1	git config --global user.email "youremail"

创建 ssh，输入命令，然后一直回车

youremail 改为你的注册 GitHub 时的邮箱

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

在文件中找到这个路径 <font style="color:rgb(0, 0, 0);">C:\Users\你的用户名\.ssh</font>

在 GitHub 的 Setting 里面，找到 SSH keys，把 id_rsa.pub（公钥） 里面的内容全部复制到 key 进去，title随便写即可。

# hexo 部署到 GitHub

在 blog 文件夹下面找到_config.yml 文件

在末尾找到 deploy 并修改（以文本格式打开 vscode 或记事本都可）

yourname 改为你的GitHub 的用户名

deploy:
  type: git
  repo: git@github.com:yourname/yourname.github.io.git
  branch: master

打开 Git Bash Here 安装 git 部署命令工具

1	npm install hexo-deployer-git --save

分别输入以下命令

1 2	hexo g hexo d

# 开启 GitHub Pages 服务

打开你的仓库 你的用户名.github.io

按照步骤操作开启 Pages

完成后等待一会，你可看到如下页面，点击 Visit site 查看你的博客

# hexo 主题配置

推荐在主题市场选择喜欢的主题，主题中都有详细的使用教程。

优质主题（排序不分先后）

主题市场 https://hexo.io/themes/

创作主题教程 https://hexo.io/zh-cn/docs/themes.html

# 同步语雀文章

项目：https://github.com/x-cold/yuque-hexo

注：教程请看项目就不赘述了

# GitHub Actions 自动同步

项目：https://github.com/yanglbme/gitee-pages-action

注：教程请看项目就不赘述了，存放 ./github/workflows/xxx.yml 位置请看本文。

# hexo 项目 GitHub Actions 存放位置

gitee 仓库依靠 GitHub Actions ./github/workflows/xxx.yml 实现

需要将 ./github/workflows/xxx.yml 放置 <font style="color:rgb(31, 35, 40);">.deploy_git/.github/workflows/xxx.yml</font>

1 2	./github/workflows/xxx.yml .deploy_git/.github/workflows/xxx.yml

如此 hexo d 命令推送时才会将 Actions 文件推送

# 总结

1. 使用下面命令同步语雀最新文章，其中 xxx… 为 token 或 key。

1	set YUQUE_TOKEN=xxx SECRET_ID=xxx SECRET_KEY=xxx && yuque-hexo sync

2. 使用以下两个命令构建和部署博客

1 2	hexo g hexo d

执行完后等待 2-3 分钟博客就更新了，如果 github 更新了，gitee 没有那么请查看 GitHub Actions 详细日志，可能因为网络不稳定导致 GitHub Actions 执行失败，请手动执行或再次推送。

# 我的实现一键更新博客（参考）

我将变量设置为用户环境变量，相对不可见，变量名不可自定义 YUQUE_TOKEN = 你的语雀 token (可读权限)

1	hexo clean && yuque-hexo sync && hexo g && hexo algolia && hexo d

# 查看 GitHub Actions 详细日志

本文采用署名 - 非商业性使用 - 相同方式共享 4.0 国际许可协议，转载请注明出处。

语雀编写文章一键自动部署博客至Github和Gitee