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

寫 codinn.com 代碼的時(shí)候，靜態(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)資源版本化、自動(dòng) minify、分組合并 CSS/JS 文件、兼容 django-staticfiles URL 規(guī)則以及collectstatic 命令。
slimit / jsmin

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

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

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

雖然有規(guī)避方案，但始終對 jsmin 不放心，索性改用 slimit，暫時(shí)還沒發(fā)現(xiàn) JS 被破壞的問題。

django-pipeline 未提供對 slimit 的支持，不過 pipeline 的擴(kuò)展性還不錯(cuò)，寫一個(gè) slimit 擴(kuò)展也是分鐘的事情：

 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 文件，扔在項(xiàng)目中的某個(gè)包目錄下即可，再修改 settings：

PIPELINE_JS_COMPRESSOR = 'lib.slimit.SlimItCompiler'

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

啟用 django-pipeline 后，執(zhí)行 manage.py collectstatic 如果碰到下面的錯(cuò)誤提示：

 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)

八成是因?yàn)?CSS 文件中含有中文或其它非拉丁文字。我在使用 @font-face 圖標(biāo)文字時(shí)碰到了這個(gè)問題，這是 django staticfiles 包的一個(gè) bug，解決方法是修改 /django/contrib/staticfiles/storage.py 文件，把出錯(cuò)的那行代碼：

content = original_file.read()

替換成：

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

用這個(gè)方法的前提是：你的 CSS 文件必須保證 utf-8 編碼，否則依然會出錯(cuò)。

PS，給 Django 項(xiàng)目提交了一個(gè) bug 報(bào)告：https://code.djangoproject.com/ticket/18430

最新評論