本節簡要介紹 Jinja2 模板的 Python API 。
最基本的方式就是通過?[Template](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Template "jinja2.Template")?創建一個模板并渲染它。 如果你的模板不是從字符串加載,而是文件系統或別的數據源,無論如何這都不 是推薦的方式:
~~~
>>> from jinja2 import Template
>>> template = Template('Hello {{ name }}!')
>>> template.render(name='John Doe')
u'Hello John Doe!'
~~~
通過創建一個?[Template](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Template "jinja2.Template")?的實例,你會得到一個新的模板對象,提供一 個名為?[render()](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Template.render "jinja2.Template.render")?的方法,該方法在有字典或關鍵字參數時調用 擴充模板。字典或關鍵字參數會被傳遞到模板,即模板“上下文”。
如你所見, Jinja2 內部使用 unicode 并且返回值也是 unicode 字符串。所以確 保你的應用里也確實使用 unicode 。
- 介紹
- 預備知識
- 安裝
- 基本 API 使用
- 實驗性的 Python 3 支持
- API
- 基礎
- Unicode
- 高層 API
- 自動轉義
- 標識符的說明
- 未定義類型
- 上下文
- 加載器
- 字節碼緩存
- 實用工具
- 異常
- 自定義過濾器
- 求值上下文
- 自定義測試
- 全局命名空間
- 低層 API
- 元 API
- 沙箱
- API
- 運算符攔截
- 模板設計者文檔
- 概要
- 變量
- 過濾器
- 測試
- 注釋
- 空白控制
- 轉義
- 行語句
- 模板繼承
- HTML 轉義
- 控制結構清單
- 導入上下文行為
- 表達式
- 內置過濾器清單
- 內置測試清單
- 全局函數清單
- 擴展
- 自動轉義擴展
- 擴展
- 添加擴展
- i18n 擴展
- 表達式語句
- 循環控制
- With 語句
- 自動轉義擴展
- 編寫擴展
- 集成
- Babel 集成
- Pylons
- TextMate
- Vim
- 從其它的模板引擎切換
- Jinja1
- Django
- Mako
- 提示和技巧
- Null-Master 退回
- 交替的行
- 高亮活動菜單項
- 訪問父級循環