django-pipeline 是一個 Django 下非常方便的靜態資源管理 app,尤其是 1.2 版本之后,利用 django-staticfiles 的collectstatic 命令,在開發、部署環境下切換非常方便。
寫 codinn.com 代碼的時候,靜態資源管理方面遇到了一些煩人的事情:
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_importfrom pipeline.compilers import CompilerBaseclass SlimItCompiler(CompilerBase):"""JS compressor based on the Python library slimit()."""def compress_js(self, js):from slimit import minifyreturn 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_processcontent = 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
新聞熱點
疑難解答