The Django Book

block

block

Defines a block that can be overridden by child templates. See the section on template inheritance in Chapter 4 for more information.

定义一个能被�模�覆盖的区�。��第四章“模�继承�一节查看更多信�。

comment

comment

Ignores everything between {% comment %} and {% endcomment %} .

模�引擎会忽略掉 {% comment %} 和 {% endcomment %} 之间的所有内容。

cycle

cycle

Cycles among the given strings each time this tag is encountered.

轮�使用标签给出的字符串列表中的值。

Within a loop, it cycles among the given strings each time through the loop:

在一个循环内，轮�使用给定的字符串列表元素：

{% for o in some_list %}
    <tr class="{% cycle row1,row2 %}">
        ...
    </tr>
{% endfor %}

Outside of a loop, give the values a unique name the first time you call it, and then use that name each successive time through:

在循环外，在你第一次调用时，给这些字符串值定义一个���的�字，以��次�需使用这个�字就行了：

<tr class="{% cycle row1,row2,row3 as rowcolors %}">...</tr>
<tr class="{% cycle rowcolors %}">...</tr>
<tr class="{% cycle rowcolors %}">...</tr>

You can use any number of values, separated by commas. Make sure not to put spaces between the values only commas.

你�以使用任�数�的用逗�分隔的值。注���在值与值之间有空格，�是一个逗�。

debug

debug

Outputs a whole load of debugging information, including the current context and imported modules.

输出完整的调试信�，包括当�的上下文�导入的模�信�。

extends

extends

Signals that this template extends a parent template.

标记当�模�扩展一个父模�。

This tag can be used in two ways:

这个标签有两�用法：

• {% extends "base.html" %} (with quotes) uses the literal value "base.html" as the name of the parent template to extend.

• {% extends "base.html" %} （带引å�·ï¼‰ 直接使用è¦�扩展的父模æ�¿çš„å��å­— "base.html" 。

• {% extends variable %} uses the value of variable . If the variable evaluates to a string, Django will use that string as the name of the parent template. If the variable evaluates to a Template object, Django will use that object as the parent template.

• {% extends variable %} 用å�˜é‡� variable 的值æ�¥æŒ‡å®šçˆ¶æ¨¡æ�¿ã€‚如果å�˜é‡�是一个字符串，Django会把字符串的值当作父模æ�¿çš„文件å��。如果å�˜é‡�是一个 Template 对象，Django会把这个对象当作父模æ�¿ã€‚

See Chapter 4 for many usage examples.

�看第四章更多应用实例。

filter

filter

Filters the contents of the variable through variable filters.

通过��过滤器过滤��的内容。

Filters can also be piped through each other, and they can have arguments just like in variable syntax.

过滤器也�以相互传输，它们也�以有�数，就���的语法一样。

Heres a sample usage:

看这个用法实例：

{% filter escape|lower %}
    This text will be HTML-escaped, and will appear in all lowercase.
{% endfilter %}

firstof

firstof

Outputs the first variable passed that is not False . Outputs nothing if all the passed variables are False .

输出传入的第一个�是 False 的��，如果被传递��都为 False ，则什么也�输出。

Heres a sample usage:

看这个用法实例：

{% firstof var1 var2 var3 %}

This is equivalent to the following:

这等�于如下内容：

{% if var1 %}
    {{ var1 }}
{% else %}{% if var2 %}
    {{ var2 }}
{% else %}{% if var3 %}
    {{ var3 }}
{% endif %}{% endif %}{% endif %}

for

for

Loops over each item in an array. For example, to display a list of athletes given athlete_list :

轮询数组中的�一元素。例如显示一个指定的�动员的�列 athlete_list ：

<ul>
{% for athlete in athlete_list %}
    <li>{{ athlete.name }}</li>
{% endfor %}
</ul>

You can also loop over a list in reverse by using {% for obj in list reversed %} .

你也�以逆��历一个列表 {% for obj in list reversed %} 。

The for loop sets a number of variables available within the loop (see Table F-1).

for 循环设置了许多循环中�用的��（�表F-1）。

if

if

The {% if %} tag evaluates a variable, and if that variable is true (i.e., it exists, is not empty, and is not a false Boolean value), the contents of the block are output:

{% if %} 标签测试一个��，若��为真（�其存在��空，且�是一个为�的布尔值），区�中的内容就会被输出：

{% if athlete_list %}
    Number of athletes: {{ athlete_list|length }}
{% else %}
    No athletes.
{% endif %}

If athlete_list is not empty, the number of athletes will be displayed by the {{ athlete_list|length }} variable.

若 athlete_list �空，�� {{ athlete_list|length }} 就会显示�动员的数�。

As you can see, the if tag can take an optional {% else %} clause that will be displayed if the test fails.

正如你所�， if 标签有�选的 {% else %} 从�，若�件��立则显示该从�。

if tags may use and , or , or not to test a number of variables or to negate a given variable:

if 语��使用 and � or 和 not �测试��或者对给定的����：

{% if athlete_list and coach_list %}
    Both athletes and coaches are available.
{% endif %}

{% if not athlete_list %}
    There are no athletes.
{% endif %}

{% if athlete_list or coach_list %}
    There are some athletes or some coaches.
{% endif %}

{% if not athlete_list or coach_list %}
    There are no athletes or there are some coaches (OK, so
    writing English translations of Boolean logic sounds
    stupid; it's not our fault).
{% endif %}

{% if athlete_list and not coach_list %}
    There are some athletes and absolutely no coaches.
{% endif %}

if tags dont allow and and or clauses within the same tag, because the order of logic would be ambiguous. For example, this is invalid:

��许 and 和 or �时出现在一个 if 语�中，因为这样会有逻辑上的问题。例如这样是有语病的：

{% if athlete_list and coach_list or cheerleader_list %}

If you need to combine and and or to do advanced logic, just use nested if tags, for example:

如果你需��时使用 and 和 or �实现较高级的逻辑，�以用嵌套的 if 标签�实现。例如：

{% if athlete_list %}
    {% if coach_list or cheerleader_list %}
        We have athletes, and either coaches or cheerleaders!
    {% endif %}
{% endif %}

Multiple uses of the same logical operator are fine, as long as you use the same operator. For example, this is valid:

��使用�一逻辑符是�以的。例如这样是正确的：

{% if athlete_list or coach_list or parent_list or teacher_list %}

ifchanged

ifchanged

Checks if a value has changed from the last iteration of a loop.

检查循环中一个值从最近一次��其是�改�。

The ifchanged block tag is used within a loop. It has two possible uses:

ifchanged 语��用于循环中，其作用有两个：

It checks its own rendered contents against its previous state and only displays the content if it has changed. For example, this displays a list of days, only displaying the month if it changes:

它会把�渲染的内容与�一次作比较，�生�化时�显示它。例如，下��显示一个日期列表，�有月份改�时�会显示它：

<h1>Archive for {{ year }}</h1>

{% for date in days %}
    {% ifchanged %}<h3>{{ date|date:"F" }}</h3>{% endifchanged %}
    <a href="{{ date|date:"M/d"|lower }}/">{{ date|date:"j" }}</a>
{% endfor %}

If given a variable, it checks whether that variable has changed:

如果给的是一个��，就会检查它是��生改�。

{% for date in days %}
    {% ifchanged date.date %} {{ date.date }} {% endifchanged %}
    {% ifchanged date.hour date.date %}
        {{ date.hour }}
    {% endifchanged %}
{% endfor %}

The preceding shows the date every time it changes, but it only shows the hour if both the hour and the date have changed.

��那个例�中日期�次�生�化时就会显示出�，但�有�时和日期都�生�化时�会显示�时。

ifequal

ifequal

Outputs the contents of the block if the two arguments equal each other.

如果两个�数相等，就输出该区�的内容。

Heres an example:

举个例�：

{% ifequal user.id comment.user_id %}
    ...
{% endifequal %}

As in the {% if %} tag, an {% else %} clause is optional.

正如 {% if %} 标签一样， {% else %} 语�是�选的。

The arguments can be hard-coded strings, so the following is valid:

�数也�以是硬编�的字符串，所以下�这�写法是正确的：

{% ifequal user.username "adrian" %}
    ...
{% endifequal %}

It is only possible to compare an argument to template variables or strings. You cannot check for equality with Python objects such as True or False . If you need to test if something is true or false, use the if tag instead.

�以用�比较的�数��于模���或者字符串（实际上整数和�数也是�以的——译注），你�能检查诸如 True or False 等Python对象是�相等。如果你需�测试�值的真�，�以用 if 标签。

ifnotequal

ifnotequal

Just like ifequal , except it tests that the two arguments are not equal.

和 ifequal 类似，�过它是用�测试两个�数是 � 相等的。

include

include

Loads a template and renders it with the current context. This is a way of including other templates within a template.

加载一个模�，并用当�上下文对它进行渲染，这是在一个模�中包�其他模�的一�方法。

The template name can be either a variable or a hard-coded (quoted) string, in either single or double quotes.

模���以是一个��或者是一个硬编�（引�引起�的）的字符串，引��以是�引�或者�引�。

This example includes the contents of the template "foo/bar.html" :

这个例�包�了 "foo/bar.html" 模�的内容：

{% include "foo/bar.html" %}

This example includes the contents of the template whose name is contained in the variable template_name :

这个例�包�了�字由�� template_name 指定的模�的内容：

{% include template_name %}

load

load

Loads a custom template library. See Chapter 10 for information about custom template libraries.

读入一个自定义的模�库。第�章里有关于自定义模�的相关信�资料

now

now

Displays the date, formatted according to the given string.

根�给定的格�字符串显示当�日期。

This tag was inspired by, and uses the same format as, a PHPs date() function (http://php.net/date). Djangos version, however, has some custom extensions.

这个标签��于PHP中的 date() 函数（ http://php.net/date ），并使用与其相�的格�语法，但是Django对其�了扩展。

Table F-2 shows the available format strings.

表F-2显示了�用的格�字符串。

Heres an example:

看这个例�：

It is {% now "jS F Y H:i" %}

Note that you can backslash-escape a format string if you want to use the raw value. In this example, f is backslash-escaped, because otherwise f is a format string that displays the time. The o doesnt need to be escaped, because its not a format character:

记�，如果你想用一个字符串的原始值的�，你�以用�斜线进行转义。在这个例�中，f被用�斜线转义了，如果�转义的�f就是显示时间的格�字符串。o�用转义，因为它本�就�是一个格�字�。

It is the {% now "jS o\f F" %}

This would display as It is the 4th of September.

这样就会显示�“It is the 4th of September�。

regroup

regroup

Regroups a list of alike objects by a common attribute.

把一列相似的对象根��一个共有的属性�新分组。

This complex tag is best illustrated by use of an example. Say that people is a list of Person objects that have first_name , last_name , and gender attributes, and youd like to display a list that looks like this:

�解释清这个��的标签，最好�举个例�。比如， people 是包� Person 对象的一个列表， 这个对象拥有 first_name � last_name 和 gender 属性，你想这样显示这个列表：

* Male:
    * George Bush
    * Bill Clinton
* Female:
    * Margaret Thatcher
    * Condoleezza Rice
* Unknown:
    * Pat Smith

The following snippet of template code would accomplish this dubious task:

下�这段模�代�就�以完�这个看起�很��的任务：

{% regroup people by gender as grouped %}
<ul>
{% for group in grouped %}
    <li>{{ group.grouper }}
    <ul>
        {% for item in group.list %}
        <li>{{ item }}</li>
        {% endfor %}
    </ul>
    </li>
{% endfor %}
</ul>

As you can see, {% regroup %} populates a variable with a list of objects with grouper and list attributes. grouper contains the item that was grouped by; list contains the list of objects that share that grouper . In this case, grouper would be Male , Female , and Unknown , and list is the list of people with those genders.

如你所�， {% regroup %} 构造了一个列表��，列表中的�个对象都有 grouper 和 list 属性。 grouper 包�分组所��的属性， list 包�一系列拥有共�的 grouper 属性的对象。这样 grouper 就会是 Male � Female 和 Unknown ， list 就是属于这几�性别的人们。

Note that {% regroup %} does not work when the list to be grouped is not sorted by the key you are grouping by! This means that if your list of people was not sorted by gender, youd need to make sure it is sorted before using it, that is:

记�，如果被分组的列表�是按照�一列排好�的�，你就�能用 {% regroup %} 在这一列上进行�新分组�就是说如果人的列表�是按照性别排好�的�，在用它之�就�先对它排�，�：

{% regroup people|dictsort:"gender" by gender as grouped %}

spaceless

spaceless

Removes whitespace between HTML tags. This includes tab characters and newlines.

去除HTML标签之间的空白符�，包括制表符和�行符。

Heres an example:

例如：

{% spaceless %}
    <p>
        <a href="foo/">Foo</a>
    </p>
{% endspaceless %}

This example would return this HTML:

返回结果如下：

<p><a href="foo/">Foo</a></p>

Only space between tags is removed not space between tags and text. In this example, the space around Hello wont be stripped:

仅仅 标签 之间的空白符被删掉，标签和文本之间的空白符是�会被处�的。在下�这个例�中， Hello 两边的空白符是�会被截掉的：

{% spaceless %}
    <strong>
        Hello
    </strong>
{% endspaceless %}

ssi

ssi

Outputs the contents of a given file into the page.

把一个指定的文件的内容输出到页�上。

Like a simple include tag, {% ssi %} includes the contents of another file which must be specified using an absolute path in the current page:

�include标签一样， {% ssi %} 会包��外一个文件的内容，这个文件必须以�对路径指明：

{% ssi /home/html/ljworld.com/includes/right_generic.html %}

If the optional parsed parameter is given, the contents of the included file are evaluated as template code, within the current context:

如果指定了�选的parsed�数的�，包�进�的文件的内容会被当作模�代�，并用当�的上下文�渲染：

{% ssi /home/html/ljworld.com/includes/right_generic.html parsed %}

Note that if you use {% ssi %} , youll need to define ALLOWED_INCLUDE_ROOTS in your Django settings, as a security measure.

注�，如果你�使用 {% ssi %} 的�，为了安全起�，你必须在Django�置文件中定义ALLOWED_INCLUDE_ROOTS。

Most of the time {% include %} works better than {% ssi %} ; {% ssi %} exists mostly for backward compatibility.

大多数情况下 {% include %} 比 {% ssi %} 更好用， {% ssi %} 的存在通常是为了��兼容。

templatetag

templatetag

Outputs one of the syntax characters used to compose template tags.

输出组�模�标签的语法字符。

Since the template system has no concept of escaping, to display one of the bits used in template tags, you must use the {% templatetag %} tag.

模�系统没有转义的概念，所以�显示一个组�模�标签的字符的�，你必须使用 {% templatetag %} 标签。

The argument tells which template bit to output (see Table F-3).

�数用�标明�显示的字符（��表F-3）。

url

url

Returns an absolute URL (i.e., a URL without the domain name) matching a given view function and optional parameters. This is a way to output links without violating the DRY principle by having to hard-code URLs in your templates:

根�所给视图函数和�选�数，返回一个�对的URL（就是�带域�的URL）。由于没有在模�中对URL进行硬编�，所以这�输出链接的方法没有��DRY原则。

{% url path.to.some_view arg1,arg2,name1=value1 %}

The first argument is a path to a view function in the format package.package.module.function . Additional arguments are optional and should be comma-separated values that will be used as positional and keyword arguments in the URL. All arguments required by the URLconf should be present.

第一个��是按package.package.module.function形�给出的指�一个view函数的路径。那些�选的�用逗�分隔的附加�数被用�URL中的�置和关键���。所有URLconf需�的�数都应该是存在的。

For example, suppose you have a view, app_name.client , whose URLconf takes a client ID. The URLconf line might look like this:

例如，�设你有一个view，app_name.client，它的URLconf包�一个client ID�数。URLconf对应行�能看起��这样：

('^client/(\d+)/$', 'app_name.client')

If this applications URLconf is included into the projects URLconf under a path such as this:

如果这个应用的URLconf�下�一样被包�在项目的URLconf里：

('^clients/', include('project_name.app_name.urls'))

then, in a template, you can create a link to this view like this:

那么，在模�中，你�以�这样创建一个指�那个view的link连接：

{% url app_name.client client.id %}

The template tag will output the string /clients/client/123/ .

模�标签将输出字符串/clients/client/123/

widthratio

widthratio，寬度的比率

For creating bar charts and such, this tag calculates the ratio of a given value to a maximum value, and then applies that ratio to a constant.

為了畫出長�圖，這個標籤計算一個給定值相�於最大值的比率，然後將這個比率給定一個常數

Heres an example:

一些实例：

<img src="bar.gif" height="10" width="{% widthratio this_value max_value 100 %}" />

If this_value is 175 and max_value is 200, the image in the preceding example will be 88 pixels wide (because 175/200 = .875; .875 * 100 = 87.5, which is rounded up to 88).

add

Example:

例如：

{{ value|add:"5" }}

Adds the argument to the value.

�数与被处�数�相加的结果.

addslashes

Example:

例如：

{{ string|addslashes }}

Adds backslashes before single and double quotes. This is useful for passing strings to JavaScript, for example.

给�感字符添加斜线(转义). 举例,�将一个字符串传递给 JavaScript 时.

capfirst

Example:

例如：

{{ string|capfirst }}

Capitalizes the first character of the string.

将字符串的首字�大写

center

Example:

例如：

{{ string|center:"50" }}

Centers the string in a field of a given width.

在一个给定的长度让字符串居中

cut

Example:

例如：

{{ string|cut:"spam" }}

Removes all values of the argument from the given string.

把给定字符串中包�的所有�数值删除掉。

date

Example:

{{ value|date:"F j, Y" }}

Formats a date according to the given format (same as the now tag).

把一个date类型按照给定的格å¼�输出（与”now”标签用法一样）。

default

Example:

例如：

{{ value|default:"(N/A)" }}

If the value is unavailable, use the given default.

如果���存在，使用默认值

default_if_none

Example:

例如：

{{ value|default_if_none:"(N/A)" }}

If the value is None , use the given default.

如果��值为None，使用默认值

dictsort

Example:

例如：

{{ list|dictsort:"foo" }}

Takes a list of dictionaries and returns that list sorted by the property given in the argument.

接�一个字典列表,返回按给定�数的属性排��的列表.

dictsortreversed

Example:

例�:

{{ list|dictsortreversed:"foo" }}

Takes a list of dictionaries and returns that list sorted in reverse order by the property given in the argument.

接�一个字典列表,返回按给定�数的属性逆�排��的列表

divisibleby

Example:

{% if value|divisibleby:"2" %}
    Even!
{% else %}
    Odd!
{% else %}

Returns True if the value is divisible by the argument.

如果值能够被给定的�数整除的�，返回“True�。

escape

Example:

例如：

{{ string|escape }}

Escapes a strings HTML. Specifically, it makes these replacements:

按照以下的规则，转义一个HTML字符串：

• "&" to "&"

• < to "&lt;"

• > to "&gt;"

• '"' (double quote) to '&quot;'

• "'" (single quote) to '&#39;'

filesizeformat

Example:

{{ value|filesizeformat }}

Formats the value like a human-readable file size (i.e., '13 KB' , '4.1 MB' , '102 bytes' , etc).

将值格å¼�化为 ‘å�¯è¯»æ€§å¥½çš„’ 文件大å°�(比如 ‘13 KB’, ‘4.1 MB’, ‘102bytes’ 等等).

first

Example:

{{ list|first }}

Returns the first item in a list.

返回列表中的第一个元素.

fix_ampersands

Example:

{{ string|fix_ampersands }}

Replaces ampersands with &amp; entities.

将 & 符�替�为 &amp; 实体

floatformat

Examples:

{{ value|floatformat }}
{{ value|floatformat:"2" }}

When used without an argument, rounds a floating-point number to one decimal place but only if theres a decimal part to be displayed, for example:

将一个浮点数四èˆ�五入到å°�数点å�Ž1ä½� — 如果根本没有å°�æ•°,å°�数部分ä¸�会显示.

• 36.123 gets converted to 36.1 .

• 36.15 gets converted to 36.2 .

• 36 gets converted to 36 .

If used with a numeric integer argument, floatformat rounds a number to that many decimal places:

如果使用�一个数字的整数�数，“floatformat�轮数， 许多�数�：

• 36.1234 with floatformat:3 gets converted to 36.123 .

• 36 with floatformat:4 gets converted to 36.0000 .

If the argument passed to floatformat is negative, it will round a number to that many decimal places but only if theres a decimal part to be displayed:

• 36.1234 with floatformat:-3 gets converted to 36.123 .

• 36 with floatformat:-4 gets converted to 36 .

Using floatformat with no argument is equivalent to using floatformat with an argument of -1 .

get_digit

Example:

{{ value|get_digit:"1" }}

Given a whole number, returns the requested digit of it, where 1 is the rightmost digit, 2 is the second-to-rightmost digit, and so forth. It returns the original value for invalid input (if the input or argument is not an integer, or if the argument is less than 1). Otherwise, output is always an integer.

�供一个完整的数, 返回该数中被请求的数字,其中 1 是最�边的数, 2 是从�边数第二个数字等等. 若输入值�法(若输入或�数�是整数, 或者�数�于1)则返回其原始值. �则输出就总是整数.

join

Example:

例�：

{{ list|join:", " }}

Joins a list with a string, like Pythons str.join(list) .

用一个字符串将一个列表连接起�,类似 Python 的 str.join(list).

length

Example:

例�：

{{ list|length }}

Returns the length of the value.

返回对象的长度

length_is

Example:

{% if list|length_is:"3" %}
    ...
{% endif %}

Returns a Boolean of whether the values length is the argument.

若值的长度与�数相等,返回 True, �则返回 False.

linebreaks

Example:

{{ string|linebreaks }}

Converts newlines into <p> and <br /> tags.

把�行符转��<p>和<br />标签。

linebreaksbr

Example:

{{ string|linebreaksbr }}

Converts newlines into <br /> tags.

把æ¯�个新行转æ�¢ä¸º”<br />”标签

linenumbers

Example:

{{ string|linenumbers }}

Displays text with line numbers.

带行�显示文本

ljust

Example:

{{ string|ljust:"50" }}

Left-aligns the value in a field of a given width.

在给定宽度的域内将文本左对�.

lower

Example:

{{ string|lower }}

Converts a string into all lowercase.

把一个给定的字符串转���写。

make_list

Example:

{% for i in number|make_list %}
    ...
{% endfor %}

Returns the value turned into a list. For an integer, its a list of digits. For a string, its a list of characters.

将值转化为一个列表.对一个整数,它是一个数字的列表.对一个字符串,这是一个字符的列表

phone2numeric

Example:

{{ string|phone2numeric }}

Converts a phone number (possibly containing letters) to its numerical equivalent. For example, '800-COLLECT' will be converted to '800-2655328' .

将一个电è¯�å�·ç �(å�¯èƒ½åŒ…å�«å­—æ¯�)转化等价的数字值.比如: ‘800-COLLECT’ 将被转化为 ‘800-2655328’.

The input doesnt have to be a valid phone number. This will happily convert any string.

输入�一定�是一个�法��. 它�以转化任�字符串.

pluralize

Example:

The list has {{ list|length }} item{{ list|pluralize }}.

Returns a plural suffix if the value is not 1. By default, this suffix is 's' .

如果值ä¸�是 1 çš„è¯�返回 ‘s’ 用于 ‘1 vote’ vs. ‘2 votes’ è¿™ç§�场å�ˆ

Example:

You have {{ num_messages }} message{{ num_messages|pluralize }}.

For words that require a suffix other than 's' , you can provide an alternate suffix as a parameter to the filter.

Example:

You have {{ num_walruses }} walrus{{ num_walrus|pluralize:"es" }}.

For words that dont pluralize by simple suffix, you can specify both a singular and plural suffix, separated by a comma.

Example:

You have {{ num_cherries }} cherr{{ num_cherries|pluralize:"y,ies" }}.

pprint

Example:

{{ object|pprint }}

A wrapper around Pythons built-in pprint.pprint for debugging, really.

pprint.pprint 和一个å°�装器— 仅用于调试.

random

Example:

{{ list|random }}

Returns a random item from the list.

返回�机的从列表中返回一个元素

removetags

Example:

{{ string|removetags:"br p div" }}

Removes a space-separated list of [X]HTML tags from the output.

从输出中删除�空格分隔的 [X]HTML标签 列表

rjust

Example:

{{ string|rjust:"50" }}

Right-aligns the value in a field of a given width.

在给定宽度的域内将文本�对�.

slice

Example:

{{ some_list|slice:":2" }}

Returns a slice of the list.

返回一个列表的片段

Uses the same syntax as Pythons list slicing. See http://diveintopython.org/native_data_types/lists.html#odbchelper.list.slice for an introduction.

使用与 Python 的 list 相�的语法, �阅 http://diveintopython.org/native_data_types/lists.html#odbchelper.list.slice 以了解更详细的信�.

slugify

Example:

{{ string|slugify }}

Converts to lowercase, removes nonword characters (alphanumerics and underscores), and converts spaces to hyphens. It also strips leading and trailing whitespace.

转化为�写, 移去���字符(字�数字和下划线),将空白转化为连字符,去除��空白.

stringformat

Example:

{{ number|stringformat:"02i" }}

Formats the variable according to the argument, a string formatting specifier. This specifier uses Python string-formatting syntax, with the exception that the leading % is dropped.

æ ¹æ�®ç»™å®šå�‚æ•°(一个格å¼�字符串)æ ¼å¼�化一个å�˜é‡�, 这个格å¼�字符串使用 Python 字符串格å¼�化语法, 例外之处是 “%” è¿�算符被çœ�ç•¥.

See http://docs.python.org/lib/typesseq-strings.html for documentation of Python string formatting.

�阅 http://docs.python.org/lib/typesseq-strings.html 以了解 Python 格�字符串

striptags

Example:

{{ string|striptags }}

Strips all [X]HTML tags.

过滤掉[X]HTML标签.

time

Example:

{{ value|time:"P" }}

Formats a time according to the given format (same as the now tag).

按指定的样�（样�定义�now标签）�格�化一个时间对象

timesince

Examples:

{{ datetime|timesince }}
{{ datetime|timesince:"other_datetime" }}

Formats a date as the time since that date (e.g., 4 days, 6 hours).

æ ¼å¼�化一个日期,这个日期是从给定日期到现在的天数和å°�时数(比如: “4 days, 6 hours”).

Takes an optional argument that is a variable containing the date to use as the comparison point (without the argument, the comparison point is now ). For example, if blog_date is a date instance representing midnight on 1 June 2006, and comment_date is a date instance for 08:00 on 1 June 2006, then {{ comment_date|timesince:blog_date }} would return 8 hours.

接å�—一个å�¯é€‰çš„å�‚数，该å�‚数是一个包å�«æ¯”较日期的å�˜é‡�（该å�‚数默认值是 now). 举例æ�¥è¯´ï¼Œ 如果 blog_date 是一个日期实例表示 2006-06-01 å�ˆå¤œï¼Œ 而 comment_date 是一个日期实例表示 2006-06-01 早上8点，那么 {{ comment_date|timesince:blog_date }} 将返回 “8 hours”.

timeuntil

Examples:

{{ datetime|timeuntil }}
{{ datetime|timeuntil:"other_datetime" }}

Similar to timesince , except that it measures the time from now until the given date or datetime. For example, if today is 1 June 2006 and conference_date is a date instance holding 29 June 2006, then {{ conference_date|timeuntil }} will return 28 days.

类似 timesince, å�ªæ˜¯å®ƒæ¯”较当å‰�时间直到给定日期时间。举例æ�¥è¯´ï¼Œå¦‚果今天是 2006-06-01 而 conference_date 是 2006-06-29, 那么 {{ conference_date|timeuntil }} 将返回 “28 days”.

Takes an optional argument that is a variable containing the date to use as the comparison point (instead of now ). If from_date contains 22 June 2006, then {{ conference_date|timeuntil:from_date }} will return 7 days.

接å�—一个å�¯é€‰çš„å�‚数，该å�‚数是一个包å�«æ¯”较日期的å�˜é‡�（该å�‚数默认值是 now). 举例æ�¥è¯´ï¼Œ 如果 from_date 是一个日期实例表示 2006-06-22， 那么 {{ conference_date|timeuntil:from_date }} 会返回 “7 days”.

title

Example:

{{ string|titlecase }}

Converts a string into title case.

按标题格�转化一个字符串

truncatewords

Example:

{{ string|truncatewords:"15" }}

Truncates a string after a certain number of words.

将一个字符串截短为指定数目的��.

truncatewords_html

Example:

{{ string|truncatewords_html:"15" }}

Similar to truncatewords , except that it is aware of HTML tags. Any tags that are opened in the string and not closed before the truncation point are closed immediately after the truncation.

This is less efficient than truncatewords , so it should be used only when it is being passed HTML text.

unordered_list

Example:

<ul>
    {{ list|unordered_list }}
</ul>

Recursively takes a self-nested list and returns an HTML unordered list without opening and closing <ul> tags.

递归的接å�—一个自嵌套的列表并返回一个HTMLæ— åº�列表(此列表å�¯ä¸�是pythob语义中的列表) — å�ªæ˜¯æ²¡æœ‰å¼€å§‹å’Œç»“æ�Ÿçš„<ul>标签

The list is assumed to be in the proper format. For example, if var contains ['States', [['Kansas', [['Lawrence', []], ['Topeka', []]]], ['Illinois', []]]] , then {{ var|unordered_list }} would return the following:

å�‡å®šè¯¥åˆ—表是å�ˆé€‚çš„æ ¼å¼�. 举例æ�¥è¯´, 如果 var 的值为 [‘States’, [[‘Kansas’, [[‘Lawrence’, []], [‘Topeka’, []]]], [‘Illinois’, []]]], 那么 {{ var|unordered_list }} 就会返回:

<li>States
<ul>
        <li>Kansas
        <ul>
                <li>Lawrence</li>
                <li>Topeka</li>
        </ul>
        </li>
        <li>Illinois</li>
</ul>
</li>

upper

Example:

例�：

{{ string|upper }}

Converts a string into all uppercase.

将一个字符串全部字�改为大写。

urlencode

Example:

例�：

<a href="{{ link|urlencode }}">linkage</a>

Escapes a value for use in a URL.

转义该值以用于 URL.

urlize

Example:

例�：

{{ string|urlize }}

Converts URLs in plain text into clickable links.

将URLs由纯文本�为�点击的链接。

urlizetrunc

Example:

例�：

{{ string|urlizetrunc:"30" }}

Converts URLs into clickable links, truncating URLs to the given character limit.

将URLs�为�点击的链接，按给定字��截短URLs。

wordcount

wordcount

Example:

例如：

{{ string|wordcount }}

Returns the number of words.

返回��数。

wordwrap

wordwrap

Example:

例如：

{{ string|wordwrap:"75" }}

Wraps words at a specified line length.

在指定长度将文字�行。

yesno

yesno

Example:

例如：

{{ boolean|yesno:"Yes,No,Perhaps" }}

Given a string mapping values for True , False , and (optionally) None , returns one of those strings according to the value (see Table F-4).

�供一个字符串�数对应� true, false 和 (�选的) None, 根�被处�的值返回相应的字符串: