如何在GitHub Pages上使用官方支持列表外的Jekyll主题？

好问题！GitHub Pages默认只支持官方列出的那十几个主题，但其实有两种靠谱的方案能用上你心仪的其他Jekyll主题，我自己实操过多次，下面给你一步步拆解：

方案一：直接嵌入主题核心文件（适合无特殊插件需求的主题） #

这种方法是把主题的关键文件直接放到你的GitHub Pages仓库里，绕开官方主题的限制，步骤如下：

• 找到你想要的Jekyll主题（比如从主题仓库或RubyGems获取），下载主题的完整源码包。
• 复制主题中的核心目录：_layouts、_includes、_sass，以及assets文件夹到你的GitHub Pages仓库根目录。注意：如果你的仓库已经有同名目录，先备份好自己的文件，再合并主题内容。
• 打开仓库根目录的_config.yml，删除原来的theme: xxx配置项（因为不再使用官方主题）。如果所选主题有专属配置参数（比如导航栏、配色），按照主题文档添加到_config.yml中。
• 本地运行bundle exec jekyll serve测试，确保页面能正常渲染，没有报错。
• 把所有修改推送到GitHub仓库，等待GitHub Pages完成构建，就能看到新主题的效果了。

方案二：本地构建静态文件后推送（适合依赖特殊插件的复杂主题） #

如果你的目标主题需要使用GitHub Pages不支持的Jekyll插件，这种方法更合适，思路是本地生成完整的静态页面，再推送到GitHub：

• 在本地环境安装Jekyll和目标主题，按照主题文档完成配置，确保bundle exec jekyll serve能正常运行并渲染页面。
• 在仓库根目录创建.gitignore文件，添加以下内容，避免提交临时文件：

  _site/
  .jekyll-cache/
  .bundle/
  Gemfile.lock
  

• 运行bundle exec jekyll build，生成的静态页面会存放在_site目录中。
• 根据你的站点类型推送静态文件：
  • 个人/组织站点（如username.github.io）：将_site内的所有内容推送到main分支。
  • 项目站点：将_site内的所有内容推送到gh-pages分支。
• 进阶技巧：可以用GitHub Actions实现自动构建。创建.github/workflows/jekyll.yml文件，编写构建脚本，这样每次提交源码，Actions会自动生成静态文件并推送到对应分支，省去手动构建的麻烦。

注意事项 #

• 方案一中，要确认主题没有依赖GitHub Pages禁用的插件，否则会导致构建失败。GitHub Pages支持的插件列表可以在官方文档中查到。
• 直接嵌入主题文件后，主题不会自动更新，需要你定期手动同步主题的最新版本。
• 无论用哪种方案，本地测试都是必不可少的，可以提前发现问题，避免推送到GitHub后出现构建错误。

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