教程

📦 准备工作

→

🔑 获取 GitHub Token

→

⚙️ 生成 Workflow

→

🚩 最后一步

→

⚠️ 注意事项

开始使用工具

📦 准备工作

一个 GitHub 账号。三个仓库：

一个用于存放 markdown 文件的仓库。像 obsidian 笔记仓库等等，为了笔记的隐私，建立一个 🔒私有仓库。
一个用于存放 quartz 配置的仓库。从 quartz 官网 clone 的配置文件，可以DIY, 比如添加自己的域名，添加自己的 logo 等等。
一个用于存放发布页文件的仓库。这个仓库用于存放发布页的文件，使用 quartz 发布后，会生成一个静态页面，然后 push 到这个仓库。

🔑 获取 GitHub Token

由于仓库是私有的，所以需要获取一个 GitHub Token。Token 用于获取 quartz 仓库和发布页仓库的权限。

在 GitHub 的 Settings -> Developer settings -> Personal access tokens -> Tokens (classic) 中创建一个 Token。
Note 任意填。为了 CI 使用，Expiration 选择 No expiration。勾选 repo 权限。
点击 Generate token按钮，生成 Token。
接下来需要将 token 用上。在 markdown 仓库的 Settings -> Secrets and variables -> Actions -> New repository secret 中添加一个secret，值为刚刚生成的 Token。名字可以随意，比如 GITHUB_TOKEN。

⚙️ 生成 GitHub Workflow 文件

在输入框 GitHub Token name 中输入名字，比如 GITHUB_TOKEN。
在输入框 MD仓库 中输入 markdown 仓库的地址。例如 https://github.com/username/markdown-repo。
在输入框 Quartz仓库 中输入 quartz 仓库的地址。例如 https://github.com/username/quartz-repo。
在输入框 Page仓库 中输入 发布页仓库的地址。例如 https://github.com/username/page-repo。
点击 下载 Workflow 文件 按钮，生成 GitHub Workflow 文件。

🚩 最后一步

在 markdown 仓库中新增一个文件夹 .github/workflows，将刚刚生成的 Workflow 文件保存到该文件夹中，取名为为 deploy.yml。