tgext.webassets 0.0.2

关于tgext.webassets

tgext.webassets是基于WebAssets的TurboGears2资产管理扩展。

安装

tgext.webassets可以从pypi安装

pip install tgext.webassets

应该对大多数用户有效。

使用方法

要启用tgext.webassets，请将以下内容放入您的应用程序的 config/app_cfg.py

from tgext import webassets

webassets.plugme(base_config, bundles={
    'js_all': webassets.Bundle('javascript/jquery.js', 'javascript/bootstrap.min.js',
                               filters='rjsmin', output='assets/js_all.js')
})

或者您可以使用可用的 tgext.pluggable

from tgext.pluggable import plug
from tgext.webassets import Bundle

plug(base_config, 'tgext.webassets', bundles={
    'js_all': Bundle('javascript/jquery.js', 'javascript/bootstrap.min.js',
                     filters='rjsmin', output='assets/js_all.js')
})

默认情况下，tgext.webassets将在TurboGears的 static_files 路径中加载和保存资源。这通常是应用程序中的 public 目录。

然后WebAssets环境将作为 tg.app_globals.webassets 可用，您可以在模板中使用它来加载资源

<script py:for="asset_url in g.webassets.js_all.urls()" src="$asset_url"></script>

每个已注册的捆绑包都将作为模板中 g.webassets 对象的属性可用。

捆绑包

ŧgext.webassets接受 bundles 字典中的捆绑包。每个条目可以是 Bundle 实例或webassets loader，如果您想从配置文件加载捆绑包。

配置

在WebAssets 环境中可用的选项也在tgext.webassets中可用，将它们作为参数传递给 plug（在使用 tgext.webassets.plugme 时在 options 字典中）或通过 AppConfig 或 .ini 文件提供，带有 webassets. 命名空间。

某些值如果没有指定，则默认继承自您的项目配置

• debug：如果webassets处于调试模式，默认为False。

• base_dir：资产所在的目录。默认为您的项目static_files目录。

• base_url：静态资产服务的URL，默认为/。使用此选项可以通过CDN提供服务。

• cache：如果应使用webassets缓存（如果为布尔值），或默认覆盖缓存目录的路径，则默认情况下资产缓存在.webassets-cache目录中，位于base_dir内部。

内置过滤器

tgext.webassets自带内置的rjsmin和cssmin过滤器，所有webassets过滤器在所需工具可用的情况下均有效。