介紹Python的Django架構中的靜態資源管理器django-pipeline

django-pipeline 是一個 Django 下非常方便的靜態資源管理 app，尤其是 1.2 版本之後，利用 django-staticfiles 的collectstatic 命令，在開發、部署環境下切換非常方便。

寫 codinn.com 代碼的時候，靜態資源管理方面遇到了一些煩人的事情：

• 為了加速頁面載入速度，瀏覽器會緩衝靜態檔案，靜態資源更新後，瀏覽器很可能從緩衝提取到期的靜態檔案
• 自己寫的 CSS/JS 要手工 minify，非常麻煩
• 零碎的 CSS/JS 小檔案太多
• CSS/JS minified 之後，開發環境下調試起來很不方便

django-pipeline 通過靜態資源版本化、自動 minify、分組合并 CSS/JS 檔案、相容 django-staticfiles URL 規則以及collectstatic 命令。
slimit / jsmin

圖個省心，我通常使用 jsmin/cssmin 這兩個 Python minifier:

 PIPELINE_JS_COMPRESSOR = 'pipeline.compressors.jsmin.JSMinCompressor'  PIPELINE_CSS_COMPRESSOR = 'pipeline.compressors.cssmin.CssminCompressor'

但是 jsmin 年久失修，實際使用結論是：jsmin 是有 bug 的，jQuery 開發庫用 jsmin minify 後被破壞，壓根無法正常工作。但是 jQuery 官方 minify 之後的 JS 檔案再用 jsmin minify 之後卻沒有問題。

雖然有規避方案，但始終對 jsmin 不放心，索性改用 slimit，暫時還沒發現 JS 被破壞的問題。

django-pipeline 未提供對 slimit 的支援，不過 pipeline 的擴充性還不錯，寫一個 slimit 擴充也是分鐘的事情：

 from __future__ import absolute_import  from pipeline.compilers import CompilerBase  class SlimItCompiler(CompilerBase):    """   JS compressor based on the Python library slimit   (http://pypi.python.org/pypi/slimit/).   """    def compress_js(self, js):      from slimit import minify      return minify(js)

將以上代碼儲存成 slimit 檔案，扔在項目中的某個包目錄下即可，再修改 settings：

PIPELINE_JS_COMPRESSOR = 'lib.slimit.SlimItCompiler'

UnicodeDecodeError: 'ascii' codec can't decode byte 問題

啟用 django-pipeline 後，執行 manage.py collectstatic 如果碰到下面的錯誤提示：

 File ".../ENV/local/lib/python2.7/site-packages/django/contrib/staticfiles/storage.py", line 226, in post_process    content = pattern.sub(converter, content)  UnicodeDecodeError: 'ascii' codec can't decode byte 0xef in position 0: ordinal not in range(128)

八成是因為 CSS 檔案中含有中文或其它非拉丁文字。我在使用 @font-face 表徵圖文字時碰到了這個問題，這是 django staticfiles 包的一個 bug，解決方案是修改 /django/contrib/staticfiles/storage.py 檔案，把出錯的那行代碼：

content = original_file.read()

替換成：

 content = original_file.read().decode('utf-8')

用這個方法的前提是：你的 CSS 檔案必須保證 utf-8 編碼，否則依然會出錯。

PS，給 Django 項目提交了一個 bug 報告：https://code.djangoproject.com/ticket/18430

