al-folio 自定义域名在每次部署后被清空怎么解决【免费下载链接】al-folioA beautiful, simple, clean, and responsive Jekyll theme for academics项目地址: https://gitcode.com/GitHub_Trending/al/al-folio用 al-folio 部署到 GitHub Pages 并设置了自定义域名例如example.com后每次 GitHub Actions 完成 Deploy仓库Settings → Pages里的 Custom domain 都会被重置为空白需要反复手工填写。解决办法是在仓库main或你的 source 分支根目录提交一个CNAME文件把域名持久化到gh-pages分支里让 GitHub Pages 从该文件而不是从界面设置中读取域名。本文依据仓库内的 docs/TROUBLESHOOTING.md、docs/FAQ.md 和 docs/INSTALL.md 给出完整的操作与验证路径。先确认你遇到的是不是同一个问题TROUBLESHOOTING 文档对该问题的描述是Problem:You set a custom domain (e.g.,example.com), but it resets to blank after deployment.典型现象是GitHub Actions 的 Deploy 工作流正常完成gh-pages分支也正常更新但下一次打开仓库Settings → Pages时Custom domain 一项已经变成空白站点回落到*.github.io地址。如果还伴随 CSS/JS 全部加载失败、页面看起来是裸的那多半是url/baseurl配置问题见 docs/FAQ.md 的对应条目而不是本文处理的域名被清空问题。动手前先确认你的仓库根目录还没有CNAME文件git ls-files | grep -i ^CNAME$没有任何输出说明文件不存在正是本次要补的内容如果已有该文件但域名仍被清空则说明文件内容或所在分支不对直接进入下一节核对。根因域名只存在于界面设置构建产物里没有它al-folio 的自动部署流程见 docs/INSTALL.md 的 Enabling automatic deployment 一节是把构建输出写入gh-pages分支再由 GitHub Pages 从该分支发布。Jekyll 构建时会先清理输出目录主题模板的_config.yml虽然已经声明保留这两个文件keep_files: - CNAME - .nojekyll见 _config.yml 第 254–256 行但保留机制只能保住构建输入里本来存在的CNAME。如果你的源仓库里没有CNAME文件gh-pages分支里自然也没有GitHub Pages 每次重建后就找不到持久化的域名记录Settings 里手工填的域名随之被清空。所以文档给出的解决方案是把域名写进仓库而不是继续手工改设置。在仓库根目录创建 CNAME 文件并提交按 docs/TROUBLESHOOTING.md 的 Custom domain becomes blank after deployment 一节执行在你的仓库根目录与_config.yml同级创建文件CNAME没有扩展名文件名必须全大写。写入你的自定义域名一行一个example.com把example.com替换成你自己的域名如果需要同时保留 www 形式就再写一行。提交并推送git add CNAME git commit -m Add CNAME for custom domain git push推送会触发.github/workflows/deploy.yml的 Deploy 工作流。等它在Actions标签页跑完后GitHub Pages 会从gh-pages分支里的CNAME读取域名此后每次部署都不再清空Settings → Pages中的 Custom domain——TROUBLESHOOTING 文档明确给出的预期就是The domain will persist after future deployments.两点注意文件必须放在source 分支对 al-folio 默认模板就是main的根目录放进子目录或写错文件名都不会生效。初始的自定义域名接入包括 DNS 记录配置和_config.yml里url的写法不在本文范围内docs/INSTALL.md 的 Deployment 章节说明了部署前的配置步骤。url应指向自定义域名例如https://example.com否则即便域名不再被清空站点资源路径仍可能按.github.io生成。验证再部署一次确认域名保留TROUBLESHOOTING 文档给出的成功判据是后续部署后域名仍在可以按这个顺序核对随便改一处内容例如_config.yml里一个不影响显示的字段commit 并 push触发一次新的 Deploy。在Actions标签页确认 Deploy 工作流成功结束仓库出现更新后的gh-pages分支注意这个分支不要手工改动。再次打开Settings → PagesCustom domain 应保持为你的域名而不是空白。用浏览器以自定义域名访问站点确认页面与资源正常加载。如果第 1、2 步部署本身就失败说明问题已经变成部署错误而不是域名被清空按 docs/FAQ.md 核对_config.yml中url个人站点为https://your-github-username.github.io或https://your.custom.domain与baseurl个人/组织站点留空、不要删除该行项目页设为/your-project-name/并确认 Pages 的 Source 指向gh-pages分支。【免费下载链接】al-folioA beautiful, simple, clean, and responsive Jekyll theme for academics项目地址: https://gitcode.com/GitHub_Trending/al/al-folio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考