django-pipeline 是一個 Django 下非常方便的靜態(tài)資源管理 app，尤其是 1.2 版本之后，利用 django-staticfiles 的collectstatic 命令，在開發(fā)、部署環(huán)境下切換非常方便。

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

•     為了加速頁面加載速度，瀏覽器會緩存靜態(tài)文件，靜態(tài)資源更新后，瀏覽器很可能從緩存提取過期的靜態(tài)文件
•     自己寫的 CSS/JS 要手工 minify，非常麻煩
•     零碎的 CSS/JS 小文件太多
•     CSS/JS minified 之后，開發(fā)環(huán)境下調(diào)試起來很不方便

django-pipeline 通過靜態(tài)資源版本化、自動 minify、分組合并 CSS/JS 文件、兼容 django-staticfiles URL 規(guī)則以及collectstatic 命令。
slimit / jsmin

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

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

但是 jsmin 年久失修，實際使用結(jié)論是：jsmin 是有 bug 的，jQuery 開發(fā)庫用 jsmin minify 后被破壞，壓根無法正常工作。但是 jQuery 官方 minify 之后的 JS 文件再用 jsmin minify 之后卻沒有問題。

雖然有規(guī)避方案，但始終對 jsmin 不放心，索性改用 slimit，暫時還沒發(fā)現(xiàn) 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 后，執(zhí)行 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 圖標(biāo)文字時碰到了這個問題，這是 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

最新評論