You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Jekyll Collections无法生成静态页面问题求助

解决Jekyll Collections静态页不生成的问题
  • 核心问题:你在_config.yml里配置的workshops: output: false就是导致静态页不生成的原因。Jekyll中output: false的作用是仅加载集合数据但不生成单个文档的静态页面,这也是为什么你能在workshops.markdown里遍历内容,但_site里没有对应静态文件的原因。

  • 修复步骤:

    1. 打开_config.yml,找到集合配置部分:
      collections:
        workshops:
          output: false
      
    2. 将output: false修改为output: true
    3. 重启Jekyll live-reload服务(或手动执行bundle exec jekyll build),此时_site目录下会生成对应workshops文档的静态页面,路径通常为/workshops/[文档文件名]/index.html(具体取决于你的permalink配置)
  • 额外检查项:

    • 确认contents/_workshops/下的文档格式正确,后缀为.md或.markdown,且文件头部有完整的YAML Front Matter(以---开头,包含title等必要字段)
    • 如果自定义了permalink规则,确保规则没有导致路径冲突或生成失败
    • 本地测试时可先删除_site目录再重新构建,避免缓存影响

内容的提问来源于stack exchange,提问作者van Nijnatten

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.16 19:24:53