如何让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
相关产品推荐
相关产品推荐

