GitHub Pages上Jekyll忽略自定义布局问题求助

1. 对齐GitHub Pages与本地的Jekyll依赖版本 #

GitHub Pages使用固定版本的Jekyll及相关依赖，本地版本不一致可能导致构建差异：

• 在仓库根目录创建Gemfile，添加以下内容：

  source "https://rubygems.org"
  gem "github-pages", group: :jekyll_plugins
  

• 执行bundle install安装对应版本依赖，然后用bundle exec jekyll build本地构建，复现远程问题并排查。

2. 检查_config.yml配置 #

• 确认配置中是否指定了正确的主题：如果原仓库使用自定义本地主题（依赖_layouts目录），需确保_config.yml中没有覆盖主题设置，或者添加include: ["_layouts"]确保Jekyll加载该目录。
• 若原仓库使用第三方主题，需替换为GitHub Pages支持的主题，或使用remote_theme字段指定远程主题仓库。

3. 修正GitHub Pages发布路径配置 #

你的仓库名为towerofhanoi.github.io，属于用户级Pages仓库，默认应部署到根域名而非子路径：

• 进入仓库Settings -> Pages页面，将Source设置为main分支的/(root)目录，保存后重新触发构建。
• 子路径部署会导致资源路径解析错误，可能间接引发布局加载失败。

4. 排查自定义GitHub Actions构建配置 #

如果使用了自定义构建动作：

• 确保使用官方的actions/configure-pages和actions/upload-pages-artifact动作，避免自定义脚本遗漏_layouts目录的处理。
• 检查构建日志中是否有_layouts目录的读取记录，若没有，需在构建步骤中确保Jekyll能访问到该目录（比如没有被.gitignore排除）。

5. 验证仓库文件完整性 #

• 确认仓库中_layouts目录及所有布局文件已正确推送到GitHub，没有被.gitignore规则排除。
• 本地执行bundle exec jekyll build生成_site目录，将其与GitHub Pages生成的站点文件对比，查看是否缺少布局渲染后的页面内容。

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