下面的幾節(jié)涵蓋了可能被應(yīng)用啟用的 Jinja2 內(nèi)置的擴展。應(yīng)用也可以提供進一步 的擴展，但這不會在此描述。會有獨立的文檔來解釋那種情況下的擴展。

i18n

如果啟用來 i18n 擴展，可以把模板中的部分標記為可譯的。標記一個段為可譯的，可 以使用?trans:

<p>{% trans %}Hello {{ user }}!{% endtrans %}</p>

要翻譯一個模板表達式——比如使用模板過濾器或訪問對象的屬性——你需要綁定表達式到 一個名稱來在翻譯塊中使用:

<p>{% trans user=user.username %}Hello {{ user }}!{% endtrans %}</p>

如果你需要在?trans?標簽中綁定一個以上的表達式，用逗號來分割（?,?）:

{% trans book_title=book.title, author=author.name %}
This is {{ book_title }} by {{ author }}
{% endtrans %}

在翻譯塊中不允許使用語句，只能使用變量標簽。

為表示復(fù)數(shù)，在?trans?和?endtrans?之間用?pluralize?標簽同時指定單數(shù)和復(fù) 數(shù)形式:

{% trans count=list|length %}
There is {{ count }} {{ name }} object.
{% pluralize %}
There are {{ count }} {{ name }} objects.
{% endtrans %}

默認情況下塊中的第一個變量用于決定使用單數(shù)還是復(fù)數(shù)。如果這不奏效，你可以指定 用于復(fù)數(shù)的名稱作為?pluralize?的參數(shù):

{% trans ..., user_count=users|length %}...
{% pluralize user_count %}...{% endtrans %}

也可以翻譯表達式中的字符串。為此，有三個函數(shù):

?gettext: 翻譯一個單數(shù)字符串 -?ngettext: 翻譯一個復(fù)數(shù)字符串 -?:?gettext?的別名

例如你可以容易地這樣打印一個已翻譯的字符串:

{{ _('Hello World!') }}

你可以使用?format?過濾器來使用占位符:

{{ _('Hello %(user)s!')|format(user=user.username) }}

因為其它語言可能不會用同樣的順序使用詞匯，要使用多個占位符，應(yīng)始終用字符 串參數(shù)傳給?format?。

Changed in version 2.5.

如果激活了新樣式的 gettext 調(diào)用（?新樣式 Gettext?），使用占位符 會更加簡單:

{{ gettext('Hello World!') }}
{{ gettext('Hello %(name)s!', name='World') }}
{{ ngettext('%(num)d apple', '%(num)d apples', apples|count) }}

注意?ngettext?函數(shù)的格式化字符串自動接受?num?參數(shù)作為計數(shù)作為附加的 常規(guī)參數(shù)。

表達式語句

如果加載了表達式語句擴展，一個名為?do?的擴展即可用。它工作幾乎如同常規(guī)的變量 表達式（?{{?...?}}?），只是它不打印任何東西。這可以用于修改列表:

{% do navigation.append('a string') %}

循環(huán)控制

如果應(yīng)用啟用來?循環(huán)控制?，則可以在循環(huán)中使用?break?和?continue?。到達?break?時，循環(huán)終止。到達?continue?時，當前處理會終止并 從下一次迭代繼續(xù)。

這個循環(huán)每兩項跳過一次:

{% for user in users %}
    {%- if loop.index is even %}{% continue %}{% endif %}
    ...
{% endfor %}

同樣，這個循環(huán) 10 次迭代之后會終止處理:

{% for user in users %}
    {%- if loop.index >= 10 %}{% break %}{% endif %}
{%- endfor %}

With 語句

New in version 2.3.

如果應(yīng)用啟用了?With 語句?，將允許在模板中使用?with?關(guān)鍵 字。這使得創(chuàng)建一個新的內(nèi)作用域。這個作用域中的變量在外部是不可見的。

With 用法簡介:

{% with %}
    {% set foo = 42 %}
    {{ foo }}           foo is 42 here
{% endwith %}
foo is not visible here any longer

因為在作用域的開始設(shè)置變量很常見，你可以在 with 語句里這么做。下面的兩 個例子是等價的:

{% with foo = 42 %}
    {{ foo }}
{% endwith %}

{% with %}
    {% set foo = 42 %}
    {{ foo }}
{% endwith %}