z3c.resourceinclude 0.3.1

概述

该包能够包含以下类型的资源

• 层叠样式表 (.css)

• 动态样式表 (.kss)

• JavaScript (.js)

用法

该包与浏览器资源一起运行，这些资源可以是单独注册的或使用资源目录工厂注册的。

一个简单的例子

<configure xmlns="http://namespaces.zope.org/zope"
          xmlns:browser="http://namespaces.zope.org/browser">

  <include package="z3c.resourceinclude" file="meta.zcml" />
  <include package="z3c.resourceinclude" />

  <browser:resource name="example.css" file="example.css" />

  <browser:resourceInclude
       layer="zope.publisher.interfaces.browser.IDefaultBrowserLayer"
       include="example.css"
   />

</configure>

此注册意味着每当请求提供 IDefaultBrowserLayer 时，名为‘example.css’的资源将被包含在页面上。

要渲染包含相关资源的HTML片段，提供了一个内容提供者，请参阅 z3c/resourceinclude/provide.py。您也可以使用视图中的一个

<browser:viewlet
   name="resourceinclude"
   class="z3c.resourceinclude.viewlets.CacheOneHourViewlet"
   permission="zope.View" />

提供了一个方便的方法来要求给定的资源层

>>> from z3c.resourceinclude import include
>>> include(IMyLayer)

排序

资源按其注册的顺序包含；即处理ZCML指令的顺序。

按照一般建议，样式表在JavaScript之前包含。动态样式表最后包含。

合并

不在‘devmode’下，资源收集器将自动合并资源，根据内容（sha摘要）给出文件名。这有一个副作用，即合并的资源被设置为永远不会过期。