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。你可以 也可以使用其中一个viewlet:

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

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

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

订购

资源按注册顺序排列；即 ZCML指令的处理顺序。

样式表包含在javascripts之前 建议。最后包括动态样式表。

合并

当不在“devmode”中时，资源收集器将自动合并 资源，根据内容给它们一个文件名（sha 文摘）。这样做的副作用是将合并的资源设置为 永不过期。