使用Al Folio模板的Github Pages部署后格式丢失、标签页404求助

1. 修正_config.yml的路径配置 #

• 打开项目根目录的_config.yml文件，修改以下字段：
  • url: 设置为你的Github Pages根地址，例如https://你的用户名.github.io
  • baseurl: 如果是项目站点（仓库名不是用户名.github.io），填写/仓库名称；如果是用户/组织站点，留空即可
• 修改后提交代码到仓库

2. 切换到GitHub Actions部署方式 #

Al Folio官方推荐用GitHub Actions部署，分支部署容易出问题：

• 进入仓库的「Settings」→「Pages」页面
• 将「Source」选项从「Deploy from a branch」切换为「GitHub Actions」
• 系统会自动匹配Al Folio的部署流程，若未自动生成，手动添加.github/workflows/deploy.yml文件（可从Al Folio官方仓库复制）

3. 统一页面与资源的链接格式 #

• 所有页面链接必须带上{{ site.baseurl }}前缀，比如关于页链接要写成{{ site.baseurl }}/about/，而非直接/about/
• CSS、JS、图片等静态资源的引用也要添加该前缀，例如{{ site.baseurl }}/assets/css/main.css

4. 重新触发部署并清除缓存 #

• 进入仓库的「Actions」页面，找到最新的部署任务，点击「Re-run jobs」重新部署
• 访问站点时按Ctrl+F5强制刷新浏览器，清除本地缓存

5. 排查部署状态与权限 #

• 在「Settings」→「Pages」页面查看部署状态，若有错误日志，根据日志提示修复问题
• 确保仓库是公开的，私有仓库需要开通Github Pages付费权限才能正常访问

内容的提问来源于stack exchange，提问作者kevin k