Scriban语言手册中文版

Scriban是一个快速、强大、安全且轻量级的模板引擎，同时兼容liquid语法规则。
项目地址：https://github.com/scriban/scriban

这个文档是语言语法的中文翻译

原文地址：https://github.com/scriban/scriban/blob/master/doc/language.md
翻译人：Frank.Cui
Email：frank@mondol.info

本文档描述了Scriban语言的语法（在{{ 和 }}内）
在纯脚本环境中，语言的规则是相同的。

注意：本文档不描述liquid语言，如有需求可查看它的官方[liquid website](https://shopify.github.io/liquid/)

块

模板中有3种类型的文本块

• 代码块：包含Scriban代码语句
• 文本块：按原样输出的普通文本
• 转义块：可以转义代码块的文本块

代码块

由 {{ 和 }}括起来的文本是 Scriban的代码块，将由 Scriban 模板引擎进行执行。
代码中块能包含：

• 单行表达式语句：
  {{ name }}
• 或多行语句：

{{
  if !name
    name = "default"
  end
  name
}}

• 或由分号（;）分隔的多条语句，某些用例中格式更紧凑：
  {{if !name; name = "default"; end; name }}

在代码块中，空白字符对解析没有影响，但每个语句后面的行尾字符除外。 唯一的例外是使用空格来区分数组索引器和数组初始值设定项。
此外，当语句是表达式（但不是赋值表达式）时，表达式的结果将显示在模板的输出中：

{{
  x = 5     # 变量赋值，不会输出任何内容
  x         # 这个表达式输出5
  x + 1     # 这个表达式输出6
}}

56

请注意，在上面的示例中，5 和 6 之间没有换行，因为我们位于代码块内。
但您仍然可以在代码块内使用\n来主动换行，或者可以使用混合代码和文本块：

{{ x = 5 }}
{{ x }}
{{ x + 1 }}

5
6

文本块

否则，任何文本都将被视为文本块并不加修改地输出。

Hello this is {{ name }}, welcome to scriban!
______________          _____________________
文本块                   文本块

转义块

任何代码和文本块都可以通过用 {%{ 和 }%}括起来来转义，以生成文本块。
例如下面的转义：

输入：{%{Hello this is {{ name }}}%}
输出：Hello this is {{ name }}

如果要转义转义块，可以增加起始块和结束块中的 % 数量：

输入：{%%{This is an escaped block: }%} here}%%}
输出：This is an escaped block: }%} here

这允许有效地嵌套逃生块并且仍然能够逃脱它们。
例如：{%%%%{ will require an ending }%%%%}

空白控制

默认情况下，代码/转义块之前或之后的任何空格（包括Tab、换行符）都会按原样复制到输出。
Scriban 提供了两种控制空白的模式：

使用字符-

{{- 或 -}}表示贪婪模式会删除所有空白字符（包括换行符）。

例如：删除左侧的空白

This is a <       
{{- name}}> text

This is a <foo> text

例如：删除右侧的空白

This is a <{{ name -}} 
> text:

This is a <foo> text

例如：删除左、右的空白

This is a <
{{- name -}} 
> text:

This is a <foo> text

使用字符~

{{~ 或 ~}}表示非贪婪模式会删除所有空白字符（换行符除外）。

当您只想在一行上使用 scriban 语句，但希望该行完全被使用时，此模式非常方便，从输出中删除，但保持该行前后的空格完好无损。
在下面的示例中，我们想要完全删除行 {{~ for products in products ~}} 和{{~ end ~}}，但我们想要保留开头