- Stable
3.0.0
Toggle Menu
Eleventy
1.93s
Gatsby
29.05s
Template Languages
- HTML
*.html
- Markdown
*.md
- WebC
*.webc
- JavaScript
*.11ty.js
- Liquid
*.liquid
- Nunjucks
*.njk
- Handlebars
*.hbs
- Mustache
*.mustache
- EJS
*.ejs
- Haml
*.haml
- Pug
*.pug
- TypeScript
*.ts
- JSX
*.jsx
- MDX
*.mdx
- Custom
*.*
重置模板引擎设置
有以下几种方式来告诉 Eleventy 如何处理文件:
- The file extension (importantly, this is also used to find files to process).
- Configuration options:
markdownTemplateEngine
: The default global template engine to pre-process markdown files. Usefalse
to avoid pre-processing and only transform markdown.htmlTemplateEngine
: The default global template engine to pre-process HTML files. Usefalse
to avoid pre-processing and passthrough copy the content (HTML is not transformed, so technically this could be any plaintext).
templateEngineOverride
in the template’s front matter. Should be one templating engine (liquid
) or markdown paired with another templating engine (liquid,md
). See examples below.
templateEngineOverride
示例
改变文件对应的模板引擎
如果你的文件名是 example.liquid
,经过以下设置,其不再用 liquid
引擎处理,而是用 Nunjucks(njk
)模板引擎处理:
Filename example.liquid
---
templateEngineOverride: njk
---
特殊情况:为 Markdown 配对一个模板引擎
请记住,默认情况下,Markdown 文件会被预先用 markdownTemplateEngine
参数所设置的模板引擎进行预处理。因此,为 markdown 文件设置 templateEngineOverride
参数时,务必列出你所要使用的每个模板引擎(也就是说最后一个必须是 md
)。
例如,你可能希望先用 Nunjucks(njk
)预处理,然后作为 markdown(md
) 再次处理。只有 Markdown 支持这种方式,其他模板都不可以以这种方式组合。Markdown 是这里的唯一例外。任何其它组合都会报错。
只作为 Markdown 处理,不做任何其他预处理
---
templateEngineOverride: md
---
先用 Nunjucks 预处理,再做为 Markdown 处理
---
templateEngineOverride: njk,md
---
什么也不用(即,不做转换)
赋予 false
值时,只复制模板内容而不做任何转换。
---
templateEngineOverride: false
---