本文档面向主题开发者:说明 Tera 模板语法、全局变量与内置函数。站点运营者(写 Markdown、配 everkm.yaml)请从 概念与架构 与 快速开始 开始;主题结构与 JsRender 见 主题开发。
分隔符
模板文件通常为普通的HTML文件,内部使用特定的分隔符包裹模板语法。系统有以下3种分隔符
{{和}}:用于表达式结果输出{%和%}:用于模板结构控制{#和#}:用于注释
原始内容
raw区块内的所有内容均不被模板解析,原样输出。
{% raw %}
Hello {{ name }}
{% endraw %}
空白控制
模板控制语句会保留换行(\n),如果需要去除两端空白,需要使用{%- 或 -%}分隔符,例如:
{% set my_var = 2 %}
{{ my_var }}
输出
2
多了第一行换行。如果需要输出在一行,使用如下代码
{% set my_var = 2 -%}
{{ my_var }}
注释
模板注释需要使用{# 和 #}包裹,内部的任何内容都不作输出。