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

如何让jekyll-build跳过无需构建的Jinja2模板文件?

解决Jekyll构建时Jinja2模板语法冲突的方案

方法1:修改文件扩展名

  • 将Jinja2模板文件的扩展名改为Jekyll默认不处理的类型,比如.jinja2或.txt。Jekyll会把这类文件当作静态资源直接复制到输出目录,不会尝试用Liquid解析其中的{% macro %}等语法。

方法2:通过YAML Front Matter禁用Liquid渲染

在Jinja2模板文件的最顶部添加以下配置:

---
render_with_liquid: false
---

这个配置会明确告诉Jekyll不对该文件进行Liquid渲染,保持文件内容原样输出。

方法3:在配置文件中排除目标文件

在仓库根目录的_config.yml里添加排除规则:

exclude:
  - 3171_boost_lambda2/boost-lambda2.tpl

Jekyll构建时会直接跳过这个文件,不会对其进行任何处理。如果需要用该模板生成HTML,建议先通过外部工具预编译成HTML文件后再提交到仓库,确保GitHub Pages上的HTML正常显示。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.28 14:22:03