如何将Jekyll站点的内容与代码拆分到不同分支？

核心思路是用两个独立分支分别存储代码和内容，搭配GitHub Actions自动合并构建，全程不需要接触Gem主题开发。

分支规则 #

• code分支：存储全部Jekyll主题代码，包括模板文件、样式文件、主题配置、插件配置等，不包含任何站点内容
• content分支：仅存储站点内容，包括_posts目录、_drafts目录、图片等媒体资源、独立页面Markdown文件、内容相关配置
• gh-pages分支：自动构建生成的静态站点文件，作为GitHub Pages的发布源

配置步骤 #

1. 初始化分支
   • 将现有仓库的全部文件推送到新建的code分支，将所有内容类文件移动到本地临时文件夹备份
   • 新建空的content分支，将备份的内容类文件推送至该分支
2. 添加自动构建配置
   在code分支新建.github/workflows/build-site.yml文件，填入以下配置：

   name: Build Jekyll Site
   on:
     push:
       branches:
         - code
         - content
   jobs:
     build:
       runs-on: ubuntu-latest
       steps:
         - name: 拉取code分支代码
           uses: actions/checkout@v4
           with:
             ref: code
             path: code
         - name: 拉取content分支内容
           uses: actions/checkout@v4
           with:
             ref: content
             path: content
         - name: 合并内容与代码
           run: cp -rf content/* code/
         - name: 构建Jekyll站点
           uses: actions/jekyll-build-pages@v1
           with:
             source: ./code
             destination: ./_site
         - name: 推送静态文件到gh-pages分支
           uses: peaceiris/actions-gh-pages@v4
           with:
             github_token: ${{ secrets.GITHUB_TOKEN }}
             publish_dir: ./_site
   

3. 修改GitHub Pages发布源
   进入仓库设置的Pages页面，将发布源修改为gh-pages分支的根目录。

适配你的诉求 #

• 结构清晰：代码和内容完全拆分到独立分支，两个分支的职责没有重叠，管理逻辑简单
• 试验性开发：修改代码时直接基于code分支新建特性分支开发，测试通过后再合并到code分支即可，完全不会影响content分支的内容更新；日常发布博文直接向content分支提交即可，不需要同步任何代码文件，两个分支的操作完全独立。

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