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:
|
1
2
|
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 擴展也是分鐘的事情：
|
1
2
3
4
5
6
7
8
9
10
11
12
|
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：
|
1
|
PIPELINE_JS_COMPRESSOR = 'lib.slimit.SlimItCompiler' |
UnicodeDecodeError: 'ascii' codec can't decode byte 問題
啟用 django-pipeline 后，執行 manage.py collectstatic 如果碰到下面的錯誤提示：
|
1
2
3
|
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 文件，把出錯的那行代碼：
|
1
|
content = original_file.read() |
替換成：
|
1
|
content = original_file.read().decode('utf-8') |
用這個方法的前提是：你的 CSS 文件必須保證 utf-8 編碼，否則依然會出錯。
PS，給 Django 項目提交了一個 bug 報告：https://code.djangoproject.com/ticket/18430
