repoze.bfg.chameleon_genshi

repoze.bfg网络框架的chameleon.genshi模板绑定

这些详细信息未由PyPI验证

项目链接

主页

项目描述

在repoze.bfg下使用Chameleon Genshi-style模板支持的绑定。有关chameleon.genshi模板语言详情，请参阅Chameleon网站。

BFG下使用repoze.bfg.chameleon_genshi的API与“Templating”章节中记录的用于chameleon.zpt模板的API相同。只有模板语言本身（Genshi与ZPT）和导入位置（r.b.chameleon_genshi与r.b.chameleon_zpt）不同。

示例

from repoze.bfg.chameleon_genshi import render_template_to_response
render_template_to_response('relative/path/to/template')

relative/path/to/template是相对于定义上述代码的包目录的相对路径。

还可以查看由repoze.bfg.chameleon_genshi包公开的render_template和get_template API，它们与repoze.bfg.chameleon_zpt中的兄弟函数具有相同的功能。

当您使用repoze.bfg.chameleon_genshi时，Genshi模板也可以用作BFG的“渲染器”。为此，最简单的方法是在您的应用的configure.zcml中使用以下ZCML：

<include package="repoze.bfg.chameleon_genshi"/>

一旦您的应用程序被配置为处理此ZCML，您可以在应用程序中的指令或ZCML view指令中指向具有.genshi文件扩展名的chameleon.genshi模板。例如

@bfg_view(renderer='templates/foo.genshi')
def someview(request):
    ....

或者

<view
  renderer="templates/foo.genshi"
  view=".views.someview"/>

如果您不想为chameleon.genshi模板使用.genshi扩展名，或者您不想使用ZCML进行注册，您可以使用“configurator”的add_renderer方法显式注册一个渲染器。为此，在BFG应用程序的run.py中，在启动时调用的函数中，使用repoze.bfg.configuration.Configurator作为config

from repoze.bfg.chameleon_genshi import renderer_factory
config.add_renderer('.cgenshi', renderer_factory)

一旦您在视图配置中将.cgenshi注册为渲染器，您可以执行以下操作

@bfg_view(renderer='templates/foo.cgenshi')
def someview(request):
    ....

杂项

默认情况下，Chameleon的Genshi XIncludes不支持解析repoze.bfg“资源指定”（例如，my_package:foo/bar.genshi）。为了激活一个理解repoze.bfg资源指定的XIncludes类，在使用任何模板之前调用repoze.bfg.chameleon_genshi.XIncludes.activate方法（例如，在处理启动时）

from repoze.bfg.chameleon_genshi import XIncludes
XIncludes.activate()

这将替换进程中所有Chameleon消费者的XIncludes辅助类。