summaryrefslogtreecommitdiff
path: root/docs/api
diff options
context:
space:
mode:
authorChris McDonough <chrism@agendaless.com>2009-05-01 10:26:57 +0000
committerChris McDonough <chrism@agendaless.com>2009-05-01 10:26:57 +0000
commitba9b0e647bff1bf0c437ab204ddf11783ed698f8 (patch)
tree1952ebfdc40ae71a3bc54eb10a92a0fe1e8273ec /docs/api
parentbc0698e1ac67106346d8c006bddcb38370f7c16b (diff)
downloadpyramid-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.rst42
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``.