summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorcewing <cris@crisewing.com>2016-06-07 11:01:36 -0700
committercewing <cris@crisewing.com>2016-06-09 11:20:56 -0700
commit5404f9cef8eacefa37a221327de6a7f66c5798eb (patch)
treee4def8d24828c4541748dc75532349edc41ba2f5
parent9b942a4bceb3efe98fbf5799d5e7aace33f9770c (diff)
downloadpyramid-5404f9cef8eacefa37a221327de6a7f66c5798eb.tar.gz
pyramid-5404f9cef8eacefa37a221327de6a7f66c5798eb.tar.bz2
pyramid-5404f9cef8eacefa37a221327de6a7f66c5798eb.zip
update information about extensible templating
-rw-r--r--docs/narr/introduction.rst26
1 files changed, 13 insertions, 13 deletions
diff --git a/docs/narr/introduction.rst b/docs/narr/introduction.rst
index b9771c5f3..53f68a2ef 100644
--- a/docs/narr/introduction.rst
+++ b/docs/narr/introduction.rst
@@ -258,19 +258,19 @@ other packages using simple wrappers.
Examples: :ref:`asset_specifications` and :ref:`overriding_assets_section`.
-Extensible templating
-~~~~~~~~~~~~~~~~~~~~~
-
-Pyramid has a structured API that allows for pluggability of "renderers".
-Templating systems such as Mako, Genshi, Chameleon, and Jinja2 can be treated
-as renderers. Renderer bindings for all of these templating systems already
-exist for use in Pyramid. But if you'd rather use another, it's not a big
-deal. Just copy the code from an existing renderer package, and plug in your
-favorite templating system. You'll then be able to use that templating system
-from within Pyramid just as you'd use one of the "built-in" templating systems.
-
-Pyramid does not make you use a single templating system exclusively. You can
-use multiple templating systems, even in the same project.
+Use *your* templates
+~~~~~~~~~~~~~~~~~~~~
+
+In Pyramid, the job of creating a ``Response`` belongs to a :term:`renderer`.
+Any templating system--Mako, Genshi, Chameleon, Jinja2--can be a renderer. In
+fact, packages exist for all of these systems. But if you'd rather use another,
+a structured API exists allowing you to create a renderer using your favorite
+templating system. You can use the templating system *you* understand, not one
+required by the framework.
+
+What's more, Pyramid does not make you use a single templating system
+exclusively. You can use multiple templating systems, even in the same
+project.
Example: :ref:`templates_used_directly`.