資料內(nèi)容:
基本 API 使用
本節(jié)簡(jiǎn)要介紹 Jinja2 模板的 Python API 。
最基本的方式就是通過(guò) Template 創(chuàng)建一個(gè)模板并渲染它。 如果你的模板不是從字符串加載,而是文件系
統(tǒng)或別的數(shù)據(jù)源,無(wú)論如何這都不 是推薦的方式:
>>> from jinja2 import Template
>>> template = Template('Hello {{ name }}!')
>>> template.render(name='John Doe')
u'Hello John Doe!'
通過(guò)創(chuàng)建一個(gè) Template 的實(shí)例,你會(huì)得到一個(gè)新的模板對(duì)象,提供一 個(gè)名為 render() 的方法,該方法
在有字典或關(guān)鍵字參數(shù)時(shí)調(diào)用 擴(kuò)充模板。字典或關(guān)鍵字參數(shù)會(huì)被傳遞到模板,即模板“上下文”。
如你所見(jiàn), Jinja2 內(nèi)部使用 unicode 并且返回值也是 unicode 字符串。所以確 保你的應(yīng)用里也確實(shí)使用
unicode 。
實(shí)驗(yàn)性的 Python 3 支持
Jinja 2.3 帶來(lái) Python 3 的實(shí)驗(yàn)性支持。這意味著在新版本上,所有的單元測(cè)試 都會(huì)通過(guò),但是仍有一些
小 bug 和不一致的行為。如果你發(fā)現(xiàn)任何 bug ,請(qǐng)向 Jinja bug tracker提供反饋。
也請(qǐng)記住本文檔是為 Python 2 編撰的,你會(huì)需要手動(dòng)把示例代碼轉(zhuǎn)換為 Python 3 的語(yǔ)法。