diff options
| author | cewing <cris@crisewing.com> | 2016-06-07 11:01:36 -0700 |
|---|---|---|
| committer | cewing <cris@crisewing.com> | 2016-06-09 11:20:56 -0700 |
| commit | 5404f9cef8eacefa37a221327de6a7f66c5798eb (patch) | |
| tree | e4def8d24828c4541748dc75532349edc41ba2f5 | |
| parent | 9b942a4bceb3efe98fbf5799d5e7aace33f9770c (diff) | |
| download | pyramid-5404f9cef8eacefa37a221327de6a7f66c5798eb.tar.gz pyramid-5404f9cef8eacefa37a221327de6a7f66c5798eb.tar.bz2 pyramid-5404f9cef8eacefa37a221327de6a7f66c5798eb.zip | |
update information about extensible templating
| -rw-r--r-- | docs/narr/introduction.rst | 26 |
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`. |
