Hexo搭建笔记
搭建hexo
下载并安装node.js
命令行安装cnpm
命令行安装hexo
hexo-cli: 4.3.2
- 建站
1
2
3
| hexo init <folder>
cd <folder>
npm install
|
新建完成后，指定文件夹的目录如下：
1
2
3
4
5
6
7
8
| .
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
|
- 配置主题
主题的配置应放在 themes 文件夹下
上传前删除 themes/.gitkeep
在_config.yml 修改theme为你的主题名称
Github + Hexo
新建一个仓库，名为用户名.github.io
本地hexo仓库关联远程GitHub仓库
本地仓库一些必要的修改配置
可以自动化给文章分类 pre-commit文件
1
| npm install hexo-deployer-git --save
|
url: https://all-smile.github.io/blog
root: /blog/
…
deploy:
type: ‘git’
repo: git@github.com:all-smile/blog.git #这个是你的仓库的ssh
branch: gh-pages # 要部署的分支，本教程博客源码在master分支，部署在gh-pages分支
创建 gh-pages 分支
hexo结合GitHub创建个人网站指定的分支名，hexo 内默认设置的分支也是叫这个名字
1
2
| git checkout -b gh-pages
git push -u origin gh-pages
|
远程仓库开启 github pages
指定部署分支：gh-pages
右上Setting –> Pages –> Branch –>选择gh-pages –>save
手动部署
自动部署–Github Actions
1. 设置 SSH 私钥 deploy_key
创建 SSH 部署密钥(使用git bash)
1
| ssh-keygen -t rsa -b 4096 -C "$(git config user.email)" -f gh-pages -N ""
|
您将获得 2 个文件：
gh-pages.pub是公钥
gh-pages是私钥
不要上传私钥！！！
2. 新建 .github/workflows/pages.yml 文件
文件内容如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
| name: Pages
# 触发器、分支
on:
push:
branches:
- master # default branch
jobs:
# 子任务
pages:
runs-on: ubuntu-latest # 定运行所需要的虚拟机环境
permissions:
contents: write
steps:
- uses: actions/checkout@v2
# with:
# submodules: true
# fetch-depth: 0
# 每个name表示一个步骤:step
- name: Use Node.js 16.x
uses: actions/setup-node@v2
with:
node-version: '16.14.1' # 自己正在使用的node版本即可
# - run: node -v # 查看node版本号
# 缓存依赖项: https://docs.github.com/cn/actions/using-workflows/caching-dependencies-to-speed-up-workflows
- name: Cache NPM dependencies
uses: actions/cache@v2
with:
# npm cache files are stored in `~/.npm` on Linux/macOS
path: ~/.npm
# path: node_modules
key: ${{ runner.OS }}-npm-cache
restore-keys: |
${{ runner.OS }}-npm-cache
# 查看路径 : /home/runner/work/blog/blog
# - name: Look Path
# run: pwd
# 查看文件
- name: Look Dir List
run: tree -L 3 -a
# 第一次或者依赖发生变化的时候执行 Install Dependencies，其它构建的时候不需要这一步
- name: Install Dependencies
run: npm install
- name: Look Dir List
run: tree -L 3 -a
# - name: clean theme cache
# run: git rm -f --cached themes/tenacity
# run: git submodule deinit themes/tenacity && git rm themes/tenacity
# 安装主题
- name: Install Theme
run: git submodule add https://github.com/all-smile/tenacity.git themes/tenacity
- name: Clean
run: npm run clean
- name: Build
run: npm run build
- name: Deploy
uses: peaceiris/actions-gh-pages@v3
with:
deploy_key: ${{ secrets.ACTIONS_DEPLOY_KEY }}
user_name: xxxx # 需要修改
user_email: [email protected] #需要修改
# 获取提交文章源码时的commit message，作为发布gh-pages分支的信息
commit_message: ${{ github.event.head_commit.message }}
full_commit_message: ${{ github.event.head_commit.message }}
github_token: ${{ secrets.GITHUB_TOKEN }}
# GITHUB_TOKEN不是个人访问令牌，GitHub Actions 运行器会自动创建一个GITHUB_TOKEN密钥以在您的工作流程中进行身份验证。因此，您无需任何配置即可立即开始部署
publish_dir: ./public
allow_empty_commit: true # 允许空提交
# Use the output from the `deploy` step(use for test action)
- name: Get the output
run: |
echo "${{ steps.deploy.outputs.notify }}"
|
3. 修改 _config.yml 文件中的Deploy配置
1
2
3
4
5
6
7
8
| # Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: 'git'
repo: .......
branch: gh-pages
# 默认提交信息： Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}
message: ${{ github.event.head_commit.message }} # 直接将提交消息传输到 GitHub Pages 存储库
|
上传blog时记得切换回master分支
参考