部署项目
使用 Github Action 部署
- 建立名为
<你的 GitHub 用户名>.github.io
的储存库,若之前已将 Hexo 上传至其他储存库,将该储存库重命名即可。 - 将 Hexo 文件夹中的文件 push 到储存库的默认分支,默认分支通常名为
main
,旧一点的储存库可能名为master
。
- 将 main 分支 push 到 GitHub:
bash
$ git push -u origin main
- 默认情况下
public/
不会被上传(也不该被上传),确保.gitignore
文件中包含一行public/
。整体文件夹结构应该与 范例储存库 大致相似。
- 使用
node --version
指令检查你电脑上的 Node.js 版本,并记下该版本 (例如:v16.y.z
) - 在储存库中建立
.github/workflows/pages.yml
,并填入以下内容 (将16
替换为上个步骤中记下的版本):
yml
name: Pages
on:
push:
branches:
- main # default branch
jobs:
pages:
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- uses: actions/checkout@v2
- name: Use Node.js 16.x
uses: actions/setup-node@v2
with:
node-version: '16'
- name: Cache NPM dependencies
uses: actions/cache@v2
with:
path: node_modules
key: ${{ runner.OS }}-npm-cache
restore-keys: |
${{ runner.OS }}-npm-cache
- name: Install Dependencies
run: npm install
- name: Build
run: npm run build
- name: Deploy
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: ./public
- 当部署作业完成后,产生的页面会放在储存库中的
gh-pages
分支。 - 在储存库中前往
Settings > Pages > Source
,并将branch
改为gh-pages
。 - 前往
https://<你的 GitHub 用户名>.github.io
查看网站。
一键部署
- 安装
hexo-deployer-git
。 - 在
_config.yml
中添加以下配置(如果配置已经存在,请将其替换为如下):
yml
deploy:
type: git
repo: https://github.com/<username>/<project>
# example, https://github.com/hexojs/hexojs.github.io
branch: gh-pages
- 执行
hexo clean && hexo deploy
。 - 浏览
<GitHub 用户名>.github.io
检查你的网站能否运作。