一 變量
1. 變量的形式是：{{ variable }}，當模板引擎碰到變量時，引擎使用變量的值替代變量；
2. 使用“.”能夠訪問變量的屬性；
3. 當模板引擎碰到“.”的時候，查找順序是：
a) 字典查找，foo['var']；
b) 屬性查找，foo.bar；
c) 方法產找，foo.fun()；
d) 列表索引查找，foo[bar]
4.如果模板中使用的某個變量不存在，那么模板系統將使用setting.py中 變量TEMPLATE_STRING_IF_INVALID的值進行替代，在默認情況下，該變量的值是''。
二、過濾器
1.可以通過過濾器來修改變量的顯示，過濾器的形式是：{{ variable | filter }}，管道符號'|'代表使用過濾器
2.過濾器能夠采用鏈式的方式使用，例如：{{ text | escape | linebreaks }}
3.過濾器還可以帶參數，例如： {{ bio|truncatewords:30 }}
4.過濾器的參數中如果帶有空格，那么需要用引號引起來，例如：{{ list | join : ", "}}
5.django中30個內建的過濾器
(1)add
使用形式為：{{ value | add: "2"}}
意義：將value的值增加2
(2)addslashes
使用形式為：{{ value | addslashes }}
意義：在value中的引號前增加反斜線
(3)capfirst
使用形式為：{{ value | capfirst }}
意義：value的第一個字符轉化成大寫形式
(4)cut
使用形式為：{{ value | cut:arg}}， 例如，如果value是“String with spaces” arg是" "那么輸出是"Stringwithspaces"
意義：從給定value中刪除所有arg的值
(5)date
使用形式為：：
(a) {{ value | date:"D d M Y" }}，例如，如果value是一個datetime對象(datetime.datetime.now())那么輸出將是字符串"Wed 09 Jan 2008"
(b) {{ value | date }}，這種形式沒有格式化字符串，這時候，格式化字符串會自動采用DATE_FORMAT所設置的形式。
意義：將日期格式數據按照給定的格式輸出
(6)default
使用形式：{{ value | default: "nothing" }}，例如，如果value是“”，那么輸出將是nothing
意義：如果value的意義是False，那么輸出使用缺省值
(7)default_if_none
使用形式：{{ value | default_if_none:"nothing" }}，例如，如果value是None，那么輸出將是nothing
意義：如果value是None，那么輸出將使用缺省值
(8)dictsort
意義：如果value的值是一個字典，那么返回值是按照關鍵字排序的結果
使用形式：{{ value | dictsort:"name"}}，例如，
如果value是：
[
{'name': 'zed', 'age': 19}, {'name': 'amy', 'age': 22}, {'name': 'joe', 'age': 31}, ] 那么，輸出是： [ {'name': 'amy', 'age': 22}, {'name': 'joe', 'age': 31}, {'name': 'zed', 'age': 19}, ] (9)dictsortreversed 意義：如果value的值是一個字典，那么返回值是按照關鍵字排序的結果的反序 使用形式：與上述(8)完全相同。 (10)divisibleby 使用形式：{{ value | divisibleby:arg}}，如果value是21，arg是3，那么輸出將是True 意義：如果value能夠被arg整除，那么返回值將是True (11)escape 使用形式：{{ value | escape}} 意義：替換value中的某些字符，以適應HTML格式，包括： < is converted to < > is converted to > ' (single quote) is converted to ' " (double quote) is converted to " & is converted to & escape僅僅在輸出的時候才起作用，所以escape不能夠用在鏈式過濾器的中間， 他應該總是最后一個過濾器，如果想在鏈式過濾器的中間使用，那么可以使用force_escape (12)escapejs 使用形式：{{ value | escapejs }} 意義：替換value中的某些字符，以適應JAVASCRIPT和JSON格式。 (13)filesizeformat 使用形式：{{ value | filesizeformat }} 意義：格式化value，使其成為易讀的文件大小，例如：13KB，4.1MB等。 (14)first 使用形式：{{ value | first }} 意義：返回列表中的第一個Item，例如，如果value是列表['a','b','c']，那么輸出將是'a'。 (15)floatformat 使用形式：{{ value | floatformat}}或者{{value|floatformat:arg}}， arg可以是正數也可以是負數。沒有參數的floatformat相當於floatformat:-1 (1)如果不帶arg，那么引擎會四舍五入，同時最多只保留一位小數。
| 34.23234 | {{ value|floatformat }} | 34.2 |
| 34.00000 | {{ value|floatformat }} | 34 |
| 34.26000 | {{ value|floatformat }} | 34.3 |
(2)如果arg是正數，那么引擎會四舍五入，同時保留arg位的小數。
| 34.23234 | {{ value|floatformat:3 }} | 34.232 |
| 34.00000 | {{ value|floatformat:3 }} | 34.000 |
| 34.26000 | {{ value|floatformat:3 }} | 34.260 |
(3)如果arg是負數，那么引擎會四舍五入，如果有小數部分，那么保留arg位小數；否則，則沒有任何小數部分。
| 34.23234 | {{ value|floatformat:"-3" }} | 34.232 |
| 34.00000 | {{ value|floatformat:"-3" }} | 34 |
| 34.26000 | {{ value|floatformat:"-3" }} | 34.26 |
(16)get_digit
使用形式：{{ value | get_digit:"arg"}}，例如，如果value是123456789，arg是2，那么輸出是8
意義：給定一個數字，返回，請求的數字，記住：1代表最右邊的數字，如果value不是合法輸入，
那么會返回所有原有值。
(17)iriencode
使用形式：{{value | iriencode}}
意義：如果value中有非ASCII字符，那么將其進行抓化成URL中適合的編碼，如果value已經進行過URLENCODE，
改操作就不會再起作用。
(18)join
使用形式：{{ value | join:"arg"}}，如果value是['a','b','c']，arg是'//'那么輸出是a//b//c
意義：使用指定的字符串連接一個list，作用如同python的str.join(list)
(19)last
使用形式：{{ value | last }}
意義：返回列表中的最后一個Item
(20)length
使用形式：{{ value | length }}
意義：返回value的長度。
(21)length_is
使用形式：{{ value | length_is:"arg"}}
意義：返回True，如果value的長度等於arg的時候，例如：如果value是['a','b','c']，arg是3，那么返回True
(22)linebreaks
使用形式：{{value|linebreaks}}
意義：value中的"\n"將被<br/>替代，並且整個value使用</p>包圍起來，從而適和HTML的格式
(23)linebreaksbr
使用形式：{{value |linebreaksbr}}
意義：value中的"\n"將被<br/>替代
(24)linenumbers
使用形式：{{value | linenumbers}}
意義：顯示的文本，帶有行數。
(25)ljust
使用形式：{{value | ljust}}
意義：在一個給定寬度的字段中，左對齊顯示value
(25)center
使用形式：{{value | center}}
意義：在一個給定寬度的字段中，中心對齊顯示value
(25)rjust
使用形式：{{value | rjust}}
意義：在一個給定寬度的字段中，右對齊顯示value
(26)lower
使用形式：{{value | lower}}
意義：將一個字符串轉換成小寫形式
(27)make_list
使用形式：{{value | make_list}}
意義：將value轉換成一個list，對於字符串，轉換成字符list；對於整數，轉換成整數list
例如value是Joel，那么輸出將是[u'J',u'o',u'e',u'l']；value是123，那么輸出將是[1,2,3]
(28)pluralize
使用形式：{{value | pluralize}}，或者{{value | pluralize:"es"}}，或者{{value | pluralize:"y,ies"}}
意義：如果value不是1，則返回一個復數后綴，缺省的后綴是's'
(29)random
使用形式：{{value | random}}
意義：從給定的list中返回一個任意的Item
(30)removetags
使用形式：{{value | removetags:"tag1 tag2 tag3..."}}
意義：刪除value中tag1,tag2....的標簽。例如，如果value是<b>Joel</b> <button>is</button> a <span>slug</span> tags是"b span"，那么輸出將是：Joel <button>is</button> a slug (31)safe 使用形式：{{value | safe}} 意義：當系統設置autoescaping打開的時候，該過濾器使得輸出不進行escape轉換
(32)safeseq
與上述safe基本相同，但有一點不同的就是：safe是針對字符串，而safeseq是針對多個字符串組成的sequence
(33)slice
使用形式：{{some_list | slice:":2"}}
意義：與python語法中的slice相同，:2表示第一的第二個元素
(34)slugify
使用形式：{{value | slugify}}
意義：將value轉換成小寫形式，同事刪除所有分單詞字符，並將空格變成橫線
例如：如果value是Joel is a slug，那么輸出將是joel-is-a-slug
(35)stringformat
這個不經常用，先不說
(36)striptags
使用形式：{{value | striptags}}
意義：刪除value中的所有HTML標簽
(37)time
使用形式：{{value | time:"H:i"}}或者{{value | time}}
意義：格式化時間輸出，如果time后面沒有格式化參數，那么輸出按照TIME_FORMAT中設置的進行。
(38)title
轉換一個字符串成為title格式。
(39)truncatewords
使用形式：{{value | truncatewords:2}}
意義：將value切成truncatewords指定的單詞數目
例如，如果value是Joel is a slug 那么輸出將是：Joel is ...
(40)truncatewords_html
使用形式同(39)
意義：truncation點之前如果某個標簽打開了，但是沒有關閉，那么在truncation點會立即關閉。
因為這個操作的效率比truncatewords低，所有只有在value是html格式時，才考慮使用。
(41)upper
轉換一個字符串為大寫形式
(42)urlencode
將一個字符串進行URLEncode
(43)urlize
意義：將一個字符串中的URL轉化成可點擊的形式。
使用形式：{{ value | urlize }}
例如，如果value是Check out www.djangoproject.com，那么輸出將是： Check out <a href="http://www.djangoproject.com">www.djangoproject.com</a> (44)urlizetrunc 使用形式：{{ value | urlizetrunc:15}} 意義：與(43)相同，但是有一點不同就是現實的鏈接字符會被truncate成特定的長度，后面以...現實。 (45)wordcount 返回字符串中單詞的數目 (46)wordwrap 使用形式：{{value | wordwrap:5}} 意義：按照指定的長度包裝字符串 例如，如果value是Joel is a slug，那么輸出將會是： Joel is a slug (47)timesince 使用形式：{{value | timesince:arg}} 意義：返回參數arg到value的天數和小時數 例如，如果 blog_date 是一個日期實例表示 2006-06-01 午夜， 而 comment_date 是一個日期實例表示 2006-06-01 早上8點，
那么 {{ comment_date|timesince:blog_date }} 將返回 "8 hours".
(48)timeuntil
使用形式：{{value | timeuntil}}
意義：與(47)基本相同，一個不同點就是，返回的是value距離當前日期的天數和小時數。
三、標簽
1.標簽的形式是：{% tag %}，標簽要比變量復雜
2.標簽的作用
(1)在輸出時創建一些文本
(2)通過執行循環和一些邏輯來實現控制流
(3)裝載一些外部信息進入模板
3.內建標簽
(1)autoescape
使用形式：
{% autoescape off %}
(內容)
{% endautoescape %}
意義：當某塊內容不需要自動轉義的時候，這樣寫就可以了。當然如果塊內某些地方需要轉義的話，調用filter也可以。
(2)block
使用形式：
{% block %}
(定義塊內容)
{% endblock %}
意義：定義一個塊，該塊能夠被繼承他的子孫模板重寫
(3)comment
使用形式：
{% comment %}
(內容)
{% endcomment %}
意義：模板系統會忽略該標簽內部的所有內容。
(4)cycle
使用形式：
例如:
<tr class="{% cycle list%}">
...
</tr>
意義：在循環時輪流使用給定的字符串列表中的值。
(5)extends
使用形式：{% extends "base.html" %}或者{% extends variable %}變量可以是一個字符串，也可以是一個模板對象。
意義：表示本模板要對指定的父模板進行擴展。
(6)filter
使用形式：
{%filter force_escape|lower%}
(內容)
{%endfilter%}
意義：將filter 標簽圈定的內容執行過濾器操作。
(7)firstof
使用形式：{%firstof var1 var2 var3%}
意義：輸出第一個值不等於False的變量
等價於：
{% if var1 %} {{ var1 }} {% else %} {% if var2 %} {{ var2 }} {% else %} {% if var3 %} {{ var3 }} {% endif %} {% endif %} {% endif %} (8)for 使用形式： {% for variable in list/dict %} (使用variable) {% endfor%} 意義：循環list中的每個值，進行相應的輸出 注意：(a)也可以反向遍歷{% for variable in list/dict reversed %} (b)也可以{% for x, y in points %} points中的每個元素為 (x,y) (c)也可以{% for key,value in data.items %} data是一個dictionary for loop中定義的一些內建變量 forloop.counter 當前的迭代器數目(從1開始) forloop.counter0 當前的迭代器數目(從0開始) forloop.revcounter 當前的反向迭代器數目(從1開始) forloop.revcounter0 當前的反向迭代器數目(從0開始) forloop.first 值為True，如果是第一次通過迭代器 forloop.last 值為True，如果是最后一次通過迭代器 forloop.parentloop 對於嵌套循環，這是當前循環的上一層循環 (9)for ... empty 使用形式如下： {% for varibale in list %} (內容1) {% empty %} (內容2) {% endfor %} 意義：當list是空的時候，能夠執行內容2，其形式等同於，先if判斷list是否存在，然后在根據情況做什么操作。 (10)if 使用形式如下 ： {% if variable %} (內容1) {% else %} (內容2) {% endif %} 注意：variable中可以使用and or 或者not，但是有一條必須記住，就是不允許and 和 or一起使用 (11)ifchanged 使用形式： (a)如果直接檢測循環變量是否變化，那么使用： {% ifchanged %} (內容) {% endifchanged %} (b)如果檢測循環變量的某個dot變量，例如循環變量是date，那么檢測date.hour，那么使用： {% ifchanged date.hour%} (內容) {% endifchanged %} (c)ifchanged也可以加上一個{% else %}語句 意義：檢測本次循環的值和上一次循環的值一樣不一樣，只能用在循環里面。 (12)ifequal 使用形式： {% ifequal variable1 variable2 %} ... {% endifequal %} 意義：判斷兩個變量是否相等。 (13)ifnotequal 使用與(12)相同 (14)include 使用形式：{% include "foo/bar.html" %}或者{% include template_name %} 意義：將另外一個模板文件中的內容添加到該文件中。注意區別extend是繼承。 (15)now 使用形式：{% now "jS F Y H:i "%}，注意存在需要轉義的情況例如{% now "jS o\f F" %}，因為f是格式化字符串 具體的格式化字符串如下所示
| a | 'a.m.' or 'p.m.' (Note that this is slightly different than PHP's output, because this includes periods to match Associated Press style.) | 'a.m.' |
| A | 'AM' or 'PM'. | 'AM' |
| b | Month, textual, 3 letters, lowercase. | 'jan' |
| B | Not implemented. | |
| d | Day of the month, 2 digits with leading zeros. | '01' to '31' |
| D | Day of the week, textual, 3 letters. | 'Fri' |
| f | Time, in 12-hour hours and minutes, with minutes left off if they're zero. Proprietary extension. | '1', '1:30' |
| F | Month, textual, long. | 'January' |
| g | Hour, 12-hour format without leading zeros. | '1' to '12' |
| G | Hour, 24-hour format without leading zeros. | '0' to '23' |
| h | Hour, 12-hour format. | '01' to '12' |
| H | Hour, 24-hour format. | '00' to '23' |
| i | Minutes. | '00' to '59' |
| I | Not implemented. | |
| j | Day of the month without leading zeros. | '1' to '31' |
| l | Day of the week, textual, long. | 'Friday' |
| L | Boolean for whether it's a leap year. | True or False |
| m | Month, 2 digits with leading zeros. | '01' to '12' |
| M | Month, textual, 3 letters. | 'Jan' |
| n | Month without leading zeros. | '1' to '12' |
| N | Month abbreviation in Associated Press style. Proprietary extension. | 'Jan.', 'Feb.', 'March', 'May' |
| O | Difference to Greenwich time in hours. | '+0200' |
| P | Time, in 12-hour hours, minutes and 'a.m.'/'p.m.', with minutes left off if they're zero and the special-case strings 'midnight' and 'noon' if appropriate. Proprietary extension. | '1 a.m.', '1:30 p.m.', 'midnight','noon', '12:30 p.m.' |
| r | RFC 2822 formatted date. | 'Thu, 21 Dec 2000 16:01:07+0200' |
| s | Seconds, 2 digits with leading zeros. | '00' to '59' |
| S | English ordinal suffix for day of the month, 2 characters. | 'st', 'nd', 'rd' or 'th' |
| t | Number of days in the given month. | 28 to 31 |
| T | Time zone of this machine. | 'EST', 'MDT' |
| U | Not implemented. | |
| w | Day of the week, digits without leading zeros. | '0' (Sunday) to '6' (Saturday) |
| W | ISO-8601 week number of year, with weeks starting on Monday. | 1, 53 |
| y | Year, 2 digits. | '99' |
| Y | Year, 4 digits. | '1999' |
| z | Day of the year. | 0 to 365 |
| Z | Time zone offset in seconds. The offset for timezones west of UTC is always negative, and for those east of UTC is always positive. |
(16)spaceless
使用形式：{% spaceless %}
(內容)
{% endspaceless %}
意義：刪除包圍內容中的所有tab或者回車字符。
(17)template
使用形式：{% templatetag %}
意義：模板系統本身沒有轉義的概念，因此如果要輸出一個像“{%”這樣的東東，就需要采用這種方式，否則就會語法錯誤
其參數有：
| openblock | {% |
| closeblock | %} |
| openvariable | {{ |
| closevariable | }} |
| openbrace | { |
| closebrace | } |
| opencomment | {# |
| closecomment | #} |
(18)with
使用形式：
{% with "expensive var1" as var2 %}
{% endwith %}
意義：當一個變量的訪問消耗很大的模板解析時，可以用另外一個變量替換它，這種替換只有在with內部有效。
(19)url
使用形式：{% url path.to.some_view arg1,arg2 %}
意義：給定某個module中函數的名字，給定參數，那么模板引擎給你一個URL，從而避免硬編碼URL到代碼中
注意：前提是URLconf中存在相應的映射,如果URLconf中沒有該映射，那么會拋出異常，
這是可以選擇使用
{% url path.to.view arg1 ,arg2 as the url %}
<a href="{{ the_url }}">Link to optional stuff</a> 其實這相當於 {% url path.to.view as the_url %} {% if the_url %} <a href="{{ the_url }}">Link to optional stuff</a> {% endif %}