跳转到主要内容

Diazo (xdv) 在Plone中的使用示例

项目描述

简介

此包展示了如何在Plone站点中使用collective.xdv / Diazo。它的目标是比xdv-worked-example更详细(并且可能更冗余)。

它面向开发者,并特别关注添加更复杂XSLT的工作示例。最终我们希望将代码示例包含在xdv包本身中,因为它们并非特定于Plone。

安装

在buildout中包含collective.examples.diazo。

https://svn.plone.org/svn/collective/collective.examples.diazo/trunk/buildout上有buildout。目前它不能在Mac上工作……。但您可以使用静态编译的lxml在Mac上安装collective.xdv,不要使用此处的buildout,而是通过将源代码检出至您的/src目录并更新您的buildout.cfg来运行buildout -N。

本包中的示例

我们没有单个的 静态 目录。相反,我们为每个主题都有目录。

主题

collective-xdv-example:collective.xdv产品的示例。

致谢 / 谁来反馈

在2010年Plone会议之后,在冲刺期间创建的包。

团队

  • Jamie Lentin

  • Ken Wasetis

  • Laurence Rowe

  • Peter Uittenbroek

  • Kees Hink

Collective.xdv 工作示例

最初的规则文件是从collective.xdv文档中获取的。在此基础上,我们添加了

多个主题

我们希望为“新闻”部分使用不同的主题。这通过使用指令来完成。

我们通过设置body元素的内容类的选择器来实现这一点

<theme href="theme.html" />
<theme
    href="theme-news.html"
    css:if-content="body.section-news"
    />

请注意,我们必须设置备用主题。如果不这样做,将导致未主题化的页面。

要为特定内容类型使用特定主题,您可以使用body元素的另一个类选择器,例如

<theme href="theme.html" />
<theme
    href="theme-news.html"
    css:if-content="body.portaltype-folder"
    />

您也可以以这种方式为特定模板进行主题化。

这仅在xdv >= 0.4b3上有效,而当前的KGS不包括。要强制使用正确的xdv版本,请将以下内容添加到您的buildout中

[versions]
xdv = 0.4b3

包括额外的规则文件

要包含额外的规则文件,请使用XInclude语句。您可以使用此语句将大规则文件拆分为单独的文件。

例如,这个中的规则调用另一个规则文件

<!-- Stuff that happens on all pages -->
<xi:include href="rules-standard.xml" />

这个执行的是,但仅针对Plone文档对象

<!-- Stuff that happens on Plone's Documents (standard pages) only -->
<rules css:if-content="body.portaltype-document">
    <xi:include href="rules-document.xml" />
</rules>

橙色日落主题示例

  • Orange Sunset主题是从oswd.org下载的,这是一个提供开源网页设计模板的网站。

  • 原始的静态HTML/CSS主题是由D Carter开发的,而此基于collective.xdv的主题是在2010年10月30日英国布里斯托尔Plone会议的Diazo冲刺成员的协作下开发的。

  • 条款:从oswd.org下载的zip文件中有一个CSS文件,它引用了一个不存在的license.txt文件,但作者的网站表明了DCarter开发的主题的条款。这些条款表明,此主题通常应在页脚中保留“设计由DCarter”的归属,或者应对其创作者做出贡献。更多信息请参阅:http://www.dcarter.co.uk/terms.html

  • 建议:此Diazo/xdv主题旨在为希望利用Diazo为自己的Plone网站进行主题化的开发人员和设计师提供一个良好的参考(尽管包含的rules.xml在尝试使用独立XDV(或作为WSGI管道的一部分)对任何类型的Web应用进行主题化时,可以提供有用的规则语法提示。此主题不打算直接用于对您的网站进行主题化。

希望您在构建自己的Diazo主题时,将其作为示例找到它是有用的。

安装

您显然已经安装了包含orange_sunset主题及其包含静态HTML、图像和CSS文件的目录的collective.examples.xdv产品。

一旦您通过“网站设置”->“插件”区域(点击此产品旁边的复选框,然后点击“激活”按钮)在您的Plone网站上安装了collective.examples.xdv产品

一旦激活了产品,请点击“网站设置”下的“附加配置”部分中的新“XDV主题”配置链接。

在“主题模板”字段中输入:python://collective.examples.diazo/static/orange_sunset/index.html

在“规则文件”字段中输入:python://collective.examples.diazo/static/orange_sunset/rules.xml

在“绝对URL前缀”字段中输入

/++resource++collective.examples.diazo/orange_sunset

您可以根据需要修改“域名”框以使用用于到达您的Plone网站的IP和/或端口号。它通常默认为主机上的端口:8080,但如果您的Zope运行在端口6000上,请将其更改为该端口。

请确保在顶部勾选“启用”复选框,以便将此主题应用于您的网站。

注意:请不要将 '127.0.0.1:your-port' 作为配置文件中的主题域名之一,因为 127.0.0.1 地址已被保留,这样您总是有办法返回查看未通过 Diazo 的 Plone 网站(以防您在修改规则文件时将主题破坏得太严重,导致网站无法查看。)

扩展

您可以根据需要修改此分发中的 rules.xml 文件以调整现有的主题映射规则、创建您自己的,或者做任何其他操作。

要创建您自己的主题,您可以复制/粘贴此产品 /static 目录中的 orange_sunset 目录,将新目录重命名为您新主题的唯一名称,然后在该目录下复制您希望使用的任何静态 html/css/images,以及修改您新 Diazo 主题目录中的 rules.xml 文件。我们希望这能激发您的 Diazo 主题开发!

变更日志

0.2 (2010-10-30)

  • 初始发布,PloneConf2010。

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源代码分发

collective.examples.diazo-0.2.tar.gz (45.8 kB 查看哈希值)

上传时间 源代码

由以下组织支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页