collective.xdv 1.0rc11

内容

• 导言
• 安装
• 用法
• python包中的资源
• 静态文件和css
• 使用portal css管理css"id="id7" rel="nofollow">使用portal css管理css
• 控制plone的默认css

安装

collective.xdv取决于：

• plone.transformchain 将转换挂接到发布服务器中
• plone.registry 和 plone.app.registry 来管理设置
• plone.autoform ， plone.z3cform 和 plone.app.z3cform 来呈现 控制面板
• 对于内部请求，分别为：five.globalrequest和zope.globalrequest。 Access
• xdv本身包含xdv的xdv
• lxml 执行最终转换

如果使用zc.buildout和 按照安装说明进行操作。

将collective.xdv安装到你的plone实例，找到文件 在文件系统上plone实例目录的根目录中buildout.cfg， 在文本编辑器中打开它。找到如下所示的部分：

# extends = http://dist.plone.org/release/3.3/versions.cfg
extends = versions.cfg
versions = versions

它在"extends"部分也可能有一个url，类似于注释掉的 第一行，取决于是否从 网络或本地。

要将collective.xdv添加到我们的设置中，我们需要一些稍有不同的版本 两个包中的一个，所以我们用一个版本列表扩展了基本配置 从好的py服务中，更改配置的这一部分，使其看起来 像这样：

extends =
    versions.cfg
    http://good-py.appspot.com/release/collective.xdv/1.0?plone=3.3.5
versions = versions

注意，上面url的最后一部分在 之前？ 是xdv版本 号码。当你读到这篇文章的时候，可能有一个更新的版本，所以请查看 的概述页 已知的好集。

更换 ？plone=3.3.5 与您正在使用的plone版本相同。这个 适合您的plone的依赖关系版本。

这里发生的是collective.xdv的依赖列表指定 一些新的版本为您通过良好的py网址。这样，你不必 担心得到正确的版本，BuildOut会帮你处理。

下一步是在 buildout.cfg.查找如下所示的部分：

eggs =
    Plone

如果已经有其他加载项，则此部分可能还有其他行 安装。只需在单独的行上添加collective.xdv，如下所示：

eggs =
    Plone
    collective.xdv [Zope2.10]

注意使用了[zope2.10]extra，它带来了 ZpublisherEventsBackport包与Zope 2.12的前向兼容性/ PLONE 4。如果你使用的是zope 2.12或更高版本（例如plone 4），你应该 做：

eggs =
    Plone
    collective.xdv

注意，不需要像collective.xdv那样添加zcml slug。 z3c.autoinclude自动配置自身。

一旦将这些行添加到配置文件中，就可以运行 buildout，以便系统可以为您添加和设置collective.xdv。去 命令行，并从plone实例的根目录（与 cfg位于），按如下方式运行buildout:

$ bin/buildout

您将看到类似的输出：

Getting distribution for 'collective.xdv==1.0'.
Got collective.xdv 1.0.
Getting distribution for 'plone.app.registry'.
Got plone.app.registry 1.0a1.
Getting distribution for 'plone.synchronize'.
Got plone.synchronize 1.0b1.
...

如果一切都按计划进行，现在已经安装了collective.xdv 在您的zope实例中。

接下来，启动zope，例如：

$ bin/instance fg

然后以管理员的身份转到plone中的"附加组件"控制面板，然后 安装"xdv主题支持"产品。你应该注意到一个新的 plone站点设置中的"xdv主题"控制面板。

用法

在"xdv theme"控制面板中，您可以设置以下选项：

注意，当zope处于调试模式时，主题将在 每一个请求。在非调试模式下，启动时编译一次，然后 只有在更改了控制面板的值时。

``python://my.package/mytheme/rules.xml``

1. 创建一个包并将其安装到构建中：

   # extends = http://dist.plone.org/release/3.3/versions.cfg
   extends = versions.cfg
   versions = versions
   

   6
< > >

有关详细信息，请参见构建手册

如果您最近安装了一个zopeskel，这应该可以工作。选择 简单 模式。当被问及是否要注册个人资料时，回答"是"。

然后编辑buildout.cfg以将新包（ my.theme 添加到 制定 和 鸡蛋 清单。

1. 在新创建的包中编辑setup.py < > >

   安装所需的列表应该是：

   # extends = http://dist.plone.org/release/3.3/versions.cfg
   extends = versions.cfg
   versions = versions
   

   7

   重新运行构建：

   $ bin/buildout
   

   1. 在新创建的包中编辑configure.zcml < > >

      在 <；configure/>； 标记中添加资源目录。请注意，您可以 需要添加 浏览器 命名空间，如图所示。

      < Buff行情> < DL>
      <；配置

      xmlns= http://namespaces.zope.org/zope " xmlns:browser="http://namespaces.zope.org/browser" xmlns:i18n="http://namespaces.zope.org/i18n" xmlns:genericsetup="http://namespaces.zope.org/genericsetup" i18n_domain="my.theme">；

      < DL>
      <；常规设置：注册表配置文件
      name="默认" title="我的主题" directory="配置文件/默认" description="安装my.theme包" 提供="products.genericsetup.interfaces.extension" /gt；
      <；浏览器：资源目录
      name="我的主题" directory="静态" /gt；

      <；/配置>；

      在这里，我们使用包名 my.theme 作为资源目录 姓名。根据需要进行调整。

      1. 在configure.zcml旁边添加一个 static 目录
      2. 将主题和规则文件放入此目录。
      < > >

      例如，您可能有一个 theme.html 引用 子目录 images/ 和子目录 css/ 中的样式表。地点 这个文件和新创建的 static 中的两个目录 目录。

      确保主题使用相对URL（例如 <；img src="images/foo.jpg" />； ） 参考它的资源。这意味着您可以从 文件系统并以其华丽的外观查看它。

      同时在那里放置一个 rules.xml 文件。参见xdv文档 有关其语法的详细信息。你可以从一些非常简单的规则开始 您只想测试：

      # extends = http://dist.plone.org/release/3.3/versions.cfg
      extends = versions.cfg
      versions = versions
      

      9

      这些规则将拉入 <；title/>； 标记（即浏览器窗口的 title），标记 <；base/>； （某些plone url工作所必需的 正确），以及plone的样式表。

      有关更多有用的规则，请参见下面的内容。

      1. 创建安装配置文件
      < > >

      上面为 <；genericsetup:registerprofile/>； 标记生成的代码 包含对目录profiles/default的引用。你可能需要 如果还不存在，则在configure.zcml旁边创建它。 创建一个新目录profiles并在其中创建另一个目录 默认值

      在此目录中，添加名为metadata.xml的文件，其中包含：

      extends =
          versions.cfg
          http://good-py.appspot.com/release/collective.xdv/1.0?plone=3.3.5
      versions = versions
      

      0

      当my.theme通过 稍后打开附加控制面板。

      同时创建一个名为registry.xml的文件剩余内容：

      extends =
          versions.cfg
          http://good-py.appspot.com/release/collective.xdv/1.0?plone=3.3.5
      versions = versions
      

      1

      将 my.theme 替换为您自己的包名，并将 rules.xml 替换为 主题.html 视情况而定。

      此文件配置XDV控制面板后面的设置。

      提示：如果您玩过控制面板并想导出 设置，您可以在zmi中的 portal_setup 工具中创建快照。 检查创建的registry.xml文件，并选择 与 collective.xdv 相关。您应该去掉 <；field/>； 标记 在导出中，这样您就只剩下 <；record/>； 和 <；value/>； 标记 如上图所示。

      另外，在profiles/default目录中添加一个cssregistry.xml 配置 门户css 工具：

      extends =
          versions.cfg
          http://good-py.appspot.com/release/collective.xdv/1.0?plone=3.3.5
      versions = versions
      

      2

      这显示了如何在现有样式表上设置条件，以及 注册一个全新的。我们在这里将applyprefix设置为true 上面解释过。这只适用于plone 4.b3及更高版本。更早 版本，只需取出即可。

      1. 测试
      < > >

      启动zope并进入你的plone站点。你的新包裹应该显示为 可安装在附加产品控制面板中。安装时，它应该 将collective.xdv作为依赖项安装，并将其预配置为使用您的主题 和规则集。默认情况下，主题未启用，因此您需要转到 打开控制面板。

      现在，您可以比较您的未接触主题、未设置样式的plone站点和 使用以下URL为网站设置主题：

      • http://localhost:8080 （或任何配置为样式的 （领域）为一个风格的巴隆。如果您使用上面的示例规则，这将 看起来几乎与主题完全相同，但是带有 <；title/>； 标记 （通常显示在网页浏览器的标题栏中）取自plone。
      • http://127.0.0.1:8080（假设这是plone所在的端口 （奔跑）为一个没有风格的扑通声。
      • http://localhost:8080/+resource++my.theme/theme.html的原始版本 主题。这是一个静态资源，几乎就像 在文件系统上打开。