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" />
这个执行的是
<!-- 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 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 2cd8c68f7f0c1024250215ff7e1cfacc035fdbbca39e2bf394770fa83428a3d6 |
|
MD5 | 4dfb8c6a88f7737cce1ea4969579bbf6 |
|
BLAKE2b-256 | afa3c72255525f64cacd9260bfffe3dda3b44433dd1c4097e82f9fdb04206a2a |