collective.templateengines 0.3.5

功能

collective.templateengines可以帮助你实现

• 简单、可插拔的模板语言切换。只需编写一次模板标签代码，然后使用抽象的标签插件在所有模板引擎中使用它

• 清除你的代码库中的模板引擎依赖关系

• 跨模板引擎的通用错误和警告报告机制

• 支持从PyPi存储库进行EGG部署和easy_install

• 使用标准 Zope 接口 包定义的接口

• Django 模板语言、Cheetah 和 Jinja2 的后端

• 单元测试

动机

所有模板引擎都有其不足之处。迟早你想要尝试另一个引擎，或者其他人想在你的项目中使用另一个模板引擎。本包旨在使这种过渡尽可能平滑。

安装

• 安装 collective.templateengines egg

• 安装以下任何模板引擎 egg：Django、Jinja2、Cheetah

用法

请查看 collective.easytemplate 包，了解如何支持在模板引擎之间切换以及为它们注册标签。

以下示例展示了如何通过一行更改在 Django 和 Cheetah 模板引擎之间切换。当然，模板本身也需要重构。

Cheetah

from collective.templateengines.backends import cheetah

engine = cheetah.Engine()
context = DictionaryContext({"foo":"bar"})
template, syntax_errors = engine.loadString("Show variable $foo", False)
result, evaluation_errors = template.evaluate(context)

Django

from collective.templateengines.backends import djangotemplates

engine = djangotemplates.Engine()
context = DictionaryContext({"foo":"bar"})
template, syntax_errors = engine.loadString("Show variable {{ foo }}", False)
result, evaluation_errors = template.evaluate(context)

标签

collective.templateengine 使用术语标签来引用你可以在模板引擎上下文中使用的函数。将来，标签打算扩展以涵盖模板语言结构。

collective.templateengines 不附带任何标签。要定义标签，我建议你查看 collective.easytemplate 包。

• 标签提供 collective.templateengines.interfaces.ITag 接口

• 使用 Engine.addTag() 函数将标签注册到模板引擎中。

问题

• Cheetah 架构缺乏独立的公开编译和评估阶段

• Cheetah 默认将完整的 Python 命名空间暴露给模板，这使得保护它变得困难

• Cheetah 无法遍历 Zope 函数或属性

示例

Python Template Engines 用于

• Easy Template 产品，适用于 Plone。

链接

Jinja2 模板引擎

Django 模板

Cheetah 模板引擎

源代码

• https://svn.plone.org/svn/collective/collective.templateengines/trunk

作者

mFabrik Research Oy - 招聘 Python 和 Plone 专业人士。

• mFabrik 网站

• mFabrik 移动网站

• 博客

• 更多关于 Plone 的信息

变更日志