django-versioned-static 1.4.3

安装

标准的Django方式

pip install django-versioned-static

将其添加到您的 INSTALLED_APPS

INSTALLED_APPS = (
    ..
    ..,
    'versioned_static',
    ...
)

配置资产本身

STATICS_ASSETS = {
    'css': {
        'css/mycoolproject.css': {
            'media': ('screen', 'projection', 'tv'),
            'files': ('css/jquery-ui-1.8.18.custom.css', 'css/style.css',),
            'version': 1
        },
        'css/print.css': {
            'media': ('print',),
            'files': ('css/print.css',),
            'version': 1
        }
    },
    'js': {
        'js/mycoolproject.js': {
            'files': ('js/jquery-1.7.1.min.js',
                      'js/main.js'),
            'version': 1
        }
    }
}

完成！

在模板中的使用

非常简单。使用 asset 模板标签。给它静态类型（CSS或JS）和基本CSS别名。它将为您直接生成所有必要的HTML。

{% load versioned_static_tags %}
{% asset "css" "css/mycoolproject.css" %}
{% asset "css" "css/print.css" %}
{% asset "js" "js/mycoolproject.js" %}

它使用账户中的设置。在开发中（当 DEBUG = True），您将获得未版本化和未压缩的静态文件。当您关闭调试时，您将获得版本化的资产链接。

DEBUG=True时的结果:

<link type="text/css" rel="stylesheet" href="/static/css/jquery-ui-1.8.18.custom.css" media="screen,projection,tv"/>
<link type="text/css" rel="stylesheet" href="/static/css/style.css" media="screen,projection,tv"/>

<link type="text/css" rel="stylesheet" href="/static/css/print.css" media="print"/>

<script type="text/javascript" src="/static/js/jquery-1.7.1.min.js"></script>
<script type="text/javascript" src="/static/js/main.js"></script>

DEBUG=False时的结果:

<link type="text/css" rel="stylesheet" href="/static/css/mycoolproject.1.css" media="screen,projection,tv"/>

<link type="text/css" rel="stylesheet" href="/static/css/print.1.css" media="print"/>

<script type="text/javascript" src="/static/js/mycoolproject.1.js"></script>

压缩文件

此应用程序具有简单的管理命令，可帮助您为生产创建压缩文件。用法如下

django-admin.py minifystatics [(CSS/JS) ASSET_FILE]

上一个场景的实时示例

django-admin.py minifystatics css css/print.css

如果您想生成应用程序设置中的所有文件，只需运行不带任何参数的命令

django-admin.py minifystatics

默认情况下，该命令将在您的 STATIC_ROOT 中查找（因此在压缩命令之前确保您已运行collectstatic），并将其用作根路径。

注意

django-versioned-static 内部使用 YUI 库来压缩 CSS/JS 资产。