Jekyll多子站点共享内容管理：方案优化及替代方案咨询

一、资产重复问题的解决方法 #

针对本地构建需保留资产、线上构建需排除重复资产的需求，可通过以下方式实现：

1. 利用环境变量区分构建逻辑 #

Jekyll支持通过JEKYLL_ENV环境变量区分开发/生产环境，结合命令行参数或配置文件动态调整资产处理规则：

• 本地构建：直接执行常规构建命令，保留本地assets文件夹用于渲染：

  bundle exec jekyll build
  

• 线上构建：通过环境变量触发生产模式，同时将assets文件夹加入排除列表，避免打包重复资产：

  JEKYLL_ENV=production bundle exec jekyll build --exclude assets
  

  也可在_config.yml中通过条件配置动态修改资产路径，例如：

  # _config.yml
  {% if jekyll.environment == "production" %}
  asset_url: "https://main.org/assets"
  exclude:
    - assets
  {% else %}
  asset_url: "/assets"
  {% endif %}
  

  这样本地开发时使用相对路径指向本地资产，线上自动切换到组织主站的统一资源地址，同时跳过本地资产的构建。

2. 确认资产文件夹的构建行为 #

默认情况下，Jekyll会处理assets文件夹内的内容并输出到构建目录。只要在生产构建时将assets加入exclude列表，该文件夹就不会被构建打包，彻底避免线上资产重复。

二、适合该组织架构的其他部署方案 #

除Jekyll主题方案外，以下几种方案也能满足"子团队仅维护纯文本内容"的目标：

1. Monorepo集中管理 #

将组织主站、所有子站点及共享资源（模板、主题、数据）放在同一个Git仓库中，通过目录划分：

• 共享资源放在/shared目录，子站点通过Jekyll的include或import语法引用这些资源
• 每个子站点单独配置_config.yml，构建时针对子目录执行构建命令
• 优势：资源集中管理，子团队无需处理跨仓库操作；劣势：仓库体积会随子站点增加变大，但纯文本内容影响有限

2. GitHub Actions自动化构建流程 #

将共享主题作为独立仓库，子站点仅维护内容，通过GitHub Actions完成自动构建部署：

• 子站点提交内容后，Actions自动拉取最新的共享主题资源
• 在构建步骤中替换资产路径为组织主站地址，并排除本地资产文件夹
• 最后将构建产物部署到对应GitHub Pages子站点（main.org/SUB1）
• 优势：子团队完全无需接触主题维护，仅需提交内容；劣势：需要配置和维护Actions工作流

3. Headless CMS驱动的静态生成 #

用Headless CMS统一管理所有子站点的纯文本内容，共享主题模板单独维护：

• 内容编辑者在CMS中提交子站点内容，无需接触Git或Jekyll
• 配置Webhook，内容更新时触发构建流程：拉取对应子站点内容+共享模板，生成静态页面后部署到对应路径
• 优势：内容维护门槛极低；劣势：需要额外搭建和维护CMS服务

4. Jekyll Remote Theme方案 #

使用Jekyll的remote_theme功能，直接引用组织的主题仓库：

• 子站点仅需在_config.yml中配置remote_theme: 你的组织名/共享主题仓库，无需子模块或本地主题文件
• 本地开发时可将主题克隆到本地，临时修改theme配置为本地路径，确保资产正常渲染；线上构建自动拉取最新远程主题
• 优势：简化子站点配置，避免Git子模块的复杂度；劣势：本地开发需额外步骤克隆主题

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