DEV Community
·
如何使用Quartz、GitHub和Cloudflare创建博客
内容提要
本文介绍了如何在GitHub Pages上使用Quartz创建自定义域名的静态网站，包括安装依赖、Fork Quartz、配置本地环境、设置GitHub Actions进行部署，以及在Cloudflare上配置自定义域名，确保所有设置正确后即可上线网站。
关键要点
-
介绍如何在GitHub Pages上使用Quartz创建自定义域名的静态网站。
-
第一步是安装依赖，使用包管理器安装node、git和gh。
-
可以选择Fork Quartz作为模板，推荐使用Fork以便于同步更新。
-
创建Fork后，命名为用户名.github.io以初始化GitHub Pages。
-
在本地设置Quartz，克隆仓库并安装依赖，创建测试文件。
-
在仓库中设置GitHub Actions进行部署，添加deploy.yml文件。
-
在GitHub设置中选择GitHub Actions作为构建和部署源，并启用HTTPS。
-
在Cloudflare上注册自定义域名，添加CNAME记录指向username.github.io。
-
确保Cloudflare的SSL/TLS设置为Full，以避免重定向错误。
-
在GitHub Pages中验证自定义域名，确保DNS检查成功。
-
在本地配置quartz.config.ts文件，更新baseUrl属性为自定义域名。
-
完成所有设置后，检查自定义域名是否正常上线，并在Cloudflare中启用代理状态。
延伸解读
选择Fork的优势
在使用Quartz创建博客时，选择Fork而非模板的方式可以更方便地同步更新。Fork允许用户在进行修改的同时，轻松处理更新时的合并冲突，这对于长期维护博客尤为重要。
Cloudflare配置注意事项
在Cloudflare上设置自定义域名时，确保SSL/TLS设置为Full，以避免因HTTPS设置不当导致的重定向错误。这是确保网站正常访问的关键步骤，尤其是在使用GitHub Pages时。
GitHub Actions的部署流程
配置GitHub Actions进行自动部署是确保博客更新及时的重要手段。通过设置deploy.yml文件，用户可以在每次推送代码时自动构建和部署网站，提升工作效率。
延伸问答
如何在GitHub Pages上使用Quartz创建博客？
首先安装依赖，Fork Quartz，命名为用户名.github.io，然后在本地设置Quartz并创建测试文件，最后配置GitHub Actions进行部署。
在Cloudflare上如何配置自定义域名？
在Cloudflare上注册域名，添加CNAME记录指向username.github.io，并确保SSL/TLS设置为Full。
如何在GitHub上设置GitHub Actions进行部署？
在仓库的/.github/workflows/目录中添加deploy.yml文件，并在GitHub设置中选择GitHub Actions作为构建和部署源。
Fork Quartz有什么好处？
Fork Quartz可以更容易地同步更新，管理修改时的合并冲突也更简单。
如何验证自定义域名是否正常工作？
在GitHub Pages中检查自定义域名设置，确保DNS检查成功，并访问自定义域名确认是否上线。
在本地如何设置Quartz？
克隆仓库，安装依赖，创建测试文件，并使用npx quartz build --serve命令预览博客。
