Jekyll Collections无法生成静态页面问题求助
解决Jekyll Collections静态页不生成的问题
核心问题:你在
_config.yml里配置的workshops: output: false就是导致静态页不生成的原因。Jekyll中output: false的作用是仅加载集合数据但不生成单个文档的静态页面,这也是为什么你能在workshops.markdown里遍历内容,但_site里没有对应静态文件的原因。修复步骤:
- 打开
_config.yml,找到集合配置部分:collections: workshops: output: false - 将
output: false修改为output: true - 重启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
相关产品推荐
相关产品推荐

