Jekyll主题Minima在GitHub Pages上显示异常求助

常见问题点及修复方式 #

• CSS路径错误：本地构建的相对路径在GitHub Pages部署后可能失效。确保自定义CSS文件放在项目的assets/css目录下，并且在_includes/head.html中用Jekyll的relative_url过滤器生成正确路径，示例代码：

  <link rel="stylesheet" href="{{ "/assets/css/style.css" | relative_url }}">
  

• 未遵守主题覆盖规则：Minima主题的默认CSS存放在主题包的assets/css路径下，你需要将CSS文件复制到项目的相同路径才能实现覆盖，不能随意放在其他目录（比如根目录下的css文件夹）。
• GitHub Pages缓存问题：平台有时会缓存旧的构建结果，可通过提交空commit强制重新构建：

  git commit --allow-empty -m "Trigger GitHub Pages rebuild"
  git push
  

• 环境版本不一致：GitHub Pages使用的Jekyll版本可能和本地存在差异，导致构建结果不同。可以在项目根目录的_config.yml中指定Jekyll版本，或者对齐GitHub Pages要求的依赖版本。

针对你已解决情况的补充 #

你提到仅做了微小CSS调整并复制了文件，问题大概率出在路径或目录结构不符合主题覆盖规范。记住Jekyll的核心规则：只有项目文件的路径和主题内置文件的路径完全匹配时，才能替换主题的默认文件。

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