條條大路通 Jinja2 。如果你不確定怎么做,用 Python egg 或 tarball 吧。
### 作為一個 Python egg (通過 easy_install)[](http://docs.jinkan.org/docs/jinja2/intro.html#python-egg-easy-install "Permalink to this headline")
你可以用?[easy_install](http://peak.telecommunity.com/DevCenter/EasyInstall)?或?[pip](http://pypi.python.org/pypi/pip)?安裝最新的版本的 Jinja2:
~~~
sudo easy_install Jinja2
sudo pip install Jinja2
~~~
這會在你的 Python 安裝中的 site-packages 目錄安裝一個 Jinja2 egg 。
(如果你在 Windows 的命令行中安裝,省略?sudo?并且確保你用管理員權限運行 命令行)
### 從 tarball 版本安裝[](http://docs.jinkan.org/docs/jinja2/intro.html#tarball "Permalink to this headline")
1. 從?[download page](http://pypi.python.org/pypi/Jinja2)?下載最新的 tarball
2. 解包 tarball
3. sudo?python?setup.py?install
注意這需要你已經安裝了 setuptools 或?[distribute](http://pypi.python.org/pypi/distribute)?,首選后者。
這會在你 Python 安裝的 site-packages 目錄安裝 Jinja2 。
### 安裝開發版本[](http://docs.jinkan.org/docs/jinja2/intro.html#id4 "Permalink to this headline")
1. 安裝?[git](http://git-scm.org/)
2. git?clone?git://github.com/mitsuhiko/jinja2.git
3. cd?jinja2
4. ln?-s?jinja2?/usr/lib/python2.X/site-packages
作為第四步的替代選擇,你也可以執行?python?setup.py?develop?,這會通過 disbribute 在開發模式下安裝包。這樣也有編譯 C 擴展的優勢。
### 加速 MarkupSafe[](http://docs.jinkan.org/docs/jinja2/intro.html#markupsafe "Permalink to this headline")
從 2.5.1 開始, Jinja2 會檢查是否安裝?[MarkupSafe](http://pypi.python.org/pypi/MarkupSafe)?模塊。如果它找到了, 它會用這個模塊的 Markup 類來代替自帶的。?MarkupSafe?替換 Jinja2 中附帶的 老的加速模塊,其優勢在于更好的安裝腳本,自動試圖安裝 C 的版本并在不可行時 漂亮地退化到純 Python 實現的版本。
MarkupSafe 的 C 實現要快得多,并推薦用于 Jinja2 自動轉義。
### 啟用調試支持模塊[](http://docs.jinkan.org/docs/jinja2/intro.html#id6 "Permalink to this headline")
默認 Jinja2 不會編譯調試支持模塊。如果你沒有 Python 頭文件或可用的編譯器, 啟用它會失敗。這當你在 Windows 上安裝 Jinja2 是很常見的情況。
由于調試模式只對 Python 2.4 是必要的,所以你不需要這么做,除非你在運行 2.4:
~~~
sudo python setup.py --with-debugsupport install
~~~
- 介紹
- 預備知識
- 安裝
- 基本 API 使用
- 實驗性的 Python 3 支持
- API
- 基礎
- Unicode
- 高層 API
- 自動轉義
- 標識符的說明
- 未定義類型
- 上下文
- 加載器
- 字節碼緩存
- 實用工具
- 異常
- 自定義過濾器
- 求值上下文
- 自定義測試
- 全局命名空間
- 低層 API
- 元 API
- 沙箱
- API
- 運算符攔截
- 模板設計者文檔
- 概要
- 變量
- 過濾器
- 測試
- 注釋
- 空白控制
- 轉義
- 行語句
- 模板繼承
- HTML 轉義
- 控制結構清單
- 導入上下文行為
- 表達式
- 內置過濾器清單
- 內置測試清單
- 全局函數清單
- 擴展
- 自動轉義擴展
- 擴展
- 添加擴展
- i18n 擴展
- 表達式語句
- 循環控制
- With 語句
- 自動轉義擴展
- 編寫擴展
- 集成
- Babel 集成
- Pylons
- TextMate
- Vim
- 從其它的模板引擎切換
- Jinja1
- Django
- Mako
- 提示和技巧
- Null-Master 退回
- 交替的行
- 高亮活動菜單項
- 訪問父級循環