From 2323d4898fcc2f524d230025ed6a9f17906023ab Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Fri, 21 Jan 2011 02:22:17 -0500 Subject: add caveat for PyPy and Jython users --- docs/glossary.rst | 23 ++++++++++++++++++++--- docs/narr/project.rst | 10 ++++++++++ 2 files changed, 30 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/glossary.rst b/docs/glossary.rst index 3c6f5cb1a..a53883a72 100644 --- a/docs/glossary.rst +++ b/docs/glossary.rst @@ -811,9 +811,10 @@ Glossary View handler A view handler ties together :meth:`pyramid.config.Configurator.add_route` and - :meth:`pyramid.config.Configurator.add_view` to make it more - convenient to register a collection of views as a single class when - using :term:`url dispatch`. See also :ref:`views_chapter`. + :meth:`pyramid.config.Configurator.add_view` to make it more convenient + to register a collection of views as a single class when using + :term:`url dispatch`. View handlers ship as part of the + :term:`pyramid_handlers` add-on package. Deployment settings Deployment settings are settings passed to the :term:`Configurator` as a @@ -865,3 +866,19 @@ Glossary `http://docs.pylonsproject.org/projects/pyramid_handlers/dev/ `_. + pyramid_jinja2 + :term:`Jinja2` templating system bindings for Pyramid, documented at + http://docs.pylonsproject.org/projects/pyramid_jinja2/dev/ . This + package also includes a paster template named + ``pyramid_jinja2_starter``, which creates an application package based + on the Jinja2 templating system. + + pyramid_sqla + A package which provides a Pylons-esque paster template which sports + support for :term:`view handler` application development, + :term:`SQLAlchemy` support, and other Pylons-like features. See + https://bytebucket.org/sluggo/pyramid_sqla/wiki/html/index.html for more + information. + + + diff --git a/docs/narr/project.rst b/docs/narr/project.rst index 3b9b0cb61..dafebd419 100644 --- a/docs/narr/project.rst +++ b/docs/narr/project.rst @@ -64,6 +64,16 @@ The included templates are these: URL mapping via :term:`traversal` and persistence via :term:`SQLAlchemy` +.. note:: At this time, each of these templates uses the :term:`Chameleon` + templating system, which is incompatible with both Jython and PyPy. To + use paster templates to build applications which will run on Jython and + PyPy, you can try the ``pyramid_jinja2_starter`` template which ships as + part of the :term:`pyramid_jinja2` package or the ``pyramid_sqla`` paster + template which ships with the :term:`pyramid_sqla` package (it uses Mako), + both available from :term:`PyPI`. You can also just use the above paster + templates to build a skeleton and replace the Chameleon template it + includes with a :term:`Mako` analogue. + .. index:: single: creating a project single: project -- cgit v1.2.3