diff options
| author | Chris McDonough <chrism@agendaless.com> | 2009-05-01 10:26:57 +0000 |
|---|---|---|
| committer | Chris McDonough <chrism@agendaless.com> | 2009-05-01 10:26:57 +0000 |
| commit | ba9b0e647bff1bf0c437ab204ddf11783ed698f8 (patch) | |
| tree | 1952ebfdc40ae71a3bc54eb10a92a0fe1e8273ec /docs/api | |
| parent | bc0698e1ac67106346d8c006bddcb38370f7c16b (diff) | |
| download | pyramid-ba9b0e647bff1bf0c437ab204ddf11783ed698f8.tar.gz pyramid-ba9b0e647bff1bf0c437ab204ddf11783ed698f8.tar.bz2 pyramid-ba9b0e647bff1bf0c437ab204ddf11783ed698f8.zip | |
Merge "c-free" branch to trunk.
Diffstat (limited to 'docs/api')
| -rw-r--r-- | docs/api/template.rst | 42 |
1 files changed, 8 insertions, 34 deletions
diff --git a/docs/api/template.rst b/docs/api/template.rst index 8685073c3..026f1673a 100644 --- a/docs/api/template.rst +++ b/docs/api/template.rst @@ -3,16 +3,13 @@ :mod:`repoze.bfg` Built-in Templating Facilties =============================================== -Four templating facilities are provided by :mod:`repoze.bfg` "out of -the box": :term:`ZPT` -style, :term:`Genshi` -style, text templating, -and :term:`XSLT` templating. +Two templating facilities are provided by :mod:`repoze.bfg` "out of +the box": :term:`ZPT` -style and text templating. -ZPT-style, Genshi-style, and text templates are in :mod:`repoze.bfg` -are supported by the :term:`Chameleon` (nee :term:`z3c.pt`) templating -engine, which contains alternate implementations of both the ZPT and -Genshi language specifications. - -XSLT templating is supported by the use of :term:`lxml`. +ZPT-style and text templates are in :mod:`repoze.bfg` are supported by +the :term:`Chameleon` (nee :term:`z3c.pt`) templating engine, which +contains an alternate implementation of the ZPT language +specification. Below is API documentation for each of those facilities. Each facility is similar to the other, but to use a particular facility, @@ -20,8 +17,8 @@ you must import the API function from a specific module. For instance, to render a ZPT-style template to a response, you would import the ``render_template_to_response`` function from ``repoze.bfg.chameleon_zpt`` while you would import -``render_template_to_response`` from ``repoze.bfg.chameleon_genshi`` -in order to render a Genshi-style template to a response. While these +``render_template_to_response`` from ``repoze.bfg.chameleon_text`` in +order to render a text-style template to a response. While these functions have the same name, each will only operate on template files that match the style in which the template file itself is written. If you need to import API functions from two templating facilities within @@ -31,7 +28,6 @@ statement, e.g.: .. code-block:: python from repoze.chameleon_zpt import render_template as zpt_render - from repoze.chameleon_genshi import render_template as genshi_render from repoze.chameleon_text import render_template as text_render :mod:`repoze.bfg.chameleon_zpt` @@ -48,17 +44,6 @@ statement, e.g.: .. note:: For backwards compatibility purposes, these functions may also be imported from ``repoze.bfg.template``. -:mod:`repoze.bfg.chameleon_genshi` ----------------------------------- - -.. automodule:: repoze.bfg.chameleon_genshi - - .. autofunction:: get_template - - .. autofunction:: render_template - - .. autofunction:: render_template_to_response - :mod:`repoze.bfg.chameleon_text` ---------------------------------- @@ -70,17 +55,6 @@ statement, e.g.: .. autofunction:: render_template_to_response -:mod:`repoze.bfg.xslt` ----------------------- - -.. automodule:: repoze.bfg.xslt - - .. autofunction:: get_transform - - .. autofunction:: render_transform - - .. autofunction:: render_transform_to_response - .. note:: For backwards compatibility purposes, these functions may also be imported from ``repoze.bfg.template``. |
