Ñò
°›—Ic @ s¿ d Z d d k Z d d k Z d d k Z y d d k l Z Wn# e j
o d d k l Z n Xd d k Z d d k l Z d d k
Z
d d k Z
d d d d d d
d g Z d d
d d d d d d d d d g Z
e i e ƒ Z d „ Z d- d d d d „ Z d d d d d „ Z d d d d „ Z d d d d d d „ Z d d d d d „ Z d e f d „ ƒ YZ d e f d „ ƒ YZ d e f d! „ ƒ YZ d e f d" „ ƒ YZ h Z xÑ e i d# ƒ D]À Z y e i! ƒ Z" e" e e i# ` -- Routes url generator
object
- :class:`translator` -- Gettext translator object configured for
current locale
- :func:`ungettext` -- Unicode capable version of gettext's ngettext
function (handles plural translations)
- :func:`_` -- Unicode capable gettext translate function
- :func:`N_` -- gettext no-op function to mark a string for
translation, but doesn't actually translate
Configuring the template language
---------------------------------
The template engine is created in the projects
``config/environment.py`` and attached to the ``app_globals`` (g)
instance. Configuration options can be directly passed into the
template engine, and are used by the render functions.
.. warning::
Don't change the variable name on :data:`app_globals` that the
template loader is attached to if you want to use the render_*
functions that :mod:`pylons.templating` comes with. The render_*
functions look for the template loader to render the template.
Legacy Buffet templating plugin and render functions
====================================================
The Buffet object is styled after the original Buffet module that
implements template language neutral rendering for CherryPy. This
version of Buffet also contains caching functionality that utilizes
`Beaker middleware `_ to provide template
language neutral caching functionality.
A customized version of
`BuffetMyghty `_ is
included that provides a template API hook as the ``pylonsmyghty``
engine. This version of BuffetMyghty disregards some of the TurboGears
API spec so that traditional Myghty template names can be used with
``/`` and file extensions.
The render functions are intended as the primary user-visible rendering
commands and hook into Buffet to make rendering content easy.
iÿÿÿÿN( t StringIO( t literalt Buffett MyghtyTemplatePlugint rendert
render_genshit
render_jinja2t render_makot render_responset ct configt gt ht requestt sessiont
translatort ungettextt _t N_c C sM t i i ƒ } t i i ƒ } | i d ƒ p | d } t d | d | d | d | d | d | i d ƒ p
t i i ƒ d
t i i ƒ d t i i ƒ d t i i ƒ d
t i
i ƒ d t i i d t i i
d t i i ƒ
} t i d } d t i i j p$ d | j o. | d t i i j o t i i ƒ | d ( t def_nameR. R4 ( s5 /usr/lib/python2.6/site-packages/pylons/templating.pyR@ ( s
R1 R2 R3 ( R8 ( R. RB R1 R2 R3 R4 R@ ( ( RB R. R4 s5 /usr/lib/python2.6/site-packages/pylons/templating.pyt render_mako_def s
t xhtmlc s@ ‡ ‡ ‡ f d † } t ˆ | d | d | d | d d d ˆ ƒS( sÊ Render a template with Genshi
Accepts the cache options ``cache_key``, ``cache_type``, and
``cache_expire`` in addition to method which are passed to Genshi's
render function.
c sX ˆ p h } | i t ƒ ƒ | d i i ˆ ƒ } t | i | i d ˆ d d ƒ ƒ S( NR t methodt encoding( R9 R" t
genshi_loadert loadR t generateR R) ( R= R> ( R? R. RE ( s5 /usr/lib/python2.6/site-packages/pylons/templating.pyR@ C s
R1 R2 R3 R0 RE ( R8 ( R. R? R1 R2 R3 RE R@ ( ( R. R? RE s5 /usr/lib/python2.6/site-packages/pylons/templating.pyR 9 s
c
s1 ‡ ‡ f d † } t ˆ | d | d | d | ƒS( s{ Render a template with Jinja2
Accepts the cache options ``cache_key``, ``cache_type``, and
``cache_expire``.
c sF ˆ p h } | i t ƒ ƒ | d i i ˆ ƒ } t | i | ƒ S( NR ( R9 R" t
jinja2_envR; R R ( R= R> ( R? R. ( s5 /usr/lib/python2.6/site-packages/pylons/templating.pyR@ ^ s
R1 R2 R3 ( R8 ( R. R? R1 R2 R3 R@ ( ( R. R? s5 /usr/lib/python2.6/site-packages/pylons/templating.pyR U s
t BuffetErrorc B s e Z d Z RS( s Buffet Exception( t __name__t
__module__t __doc__( ( ( s5 /usr/lib/python2.6/site-packages/pylons/templating.pyRK o s c B sM e Z d Z d d d d „ Z d d d „ Z d d e d d d d d „ Z RS( sù Buffet style plug-in template rendering
Buffet implements template language plug-in support modeled highly
on the `Buffet Project
`_ from which this
class inherits its name.
c K sm | d j o
h } n | | _ | | _ | | _ h | _ t i d ƒ | i o | i | | | n d S( sS Initialize the Buffet renderer, and optionally set a default
engine/optionss Initialized Buffet objectN( R) t default_enginet
template_roott default_optionst enginesR R t prepare( t selfRO RP RQ R
( ( s5 /usr/lib/python2.6/site-packages/pylons/templating.pyt __init__} s
c K s t i | d ƒ } | p t d | ƒ ‚ n | p | } | i | d d ƒ } t d | d | d | ƒ d | ƒ | i | `_ method
is called so that the ``template_root`` and options can be set.
Template engines can also be aliased if you wish to use
multiplate configurations of the same template engines, or
prefer a shorter name when rendering a template with the engine
of your choice.
s9 Please install a plugin for "%s" to use its functionalitys .extra_vars_funct enginet extra_vars_funct optionst roots/ Adding %s template language for use with BuffetN( t available_enginesR R) t TemplateEngineMissingt popR RR R R ( RT t engine_nameRP t aliasR
t EngineRW ( ( s5 /usr/lib/python2.6/site-packages/pylons/templating.pyRS ‹ s
c
su | o | i o
| i } n | i i | ƒ ‰ ˆ p t d | ƒ ‚ n | ‰ | d j oÔ ˆ d j o
h ‰ n x2 d D]* } | ˆ j o ˆ i | ƒ ˆ | t i i ˆ d | ƒ ‰ ˆ i t i i d
ƒ i d
ƒ ‰ n d ˆ j o ˆ d d j o ˆ d =n | d j p | d j p
| d j oå | p
d } n | p
d } n | d j o
d } n ‡ ‡ ‡ ‡ f d † } ˆ }
ˆ i d t ƒ o |
d 7}
n ˆ i d t ƒ o |
ˆ d 7}
n t i d ˆ ƒ t i i |
ƒ } | i | d | d | d | ƒ} | St i d ˆ | ƒ ˆ d i ˆ d ˆ ˆ S( s™ Render a template using a template engine plug-in
To use templates it is expected that you will attach data to be
used in the template to the ``c`` variable which is available
in the controller and the template.
When porting code from other projects it is sometimes easier to
use an exisitng dictionary which can be specified with
``namespace``.
``engine_name``
The name of the template engine to use, which must be
'prepared' first.
``template_name``
Name of the template to render
``include_pylons_variables``
If a custom namespace is specified this determines whether
Pylons variables are included in the namespace or not.
Defaults to ``True``.
``namespace``
A custom dictionary of names and values to be substituted
in the template.
Caching options (uses Beaker caching middleware)
``cache_key``
Key to cache this copy of the template under.
``cache_type``
Valid options are ``dbm``, ``file``, ``memory``, or
``ext:memcached``.
``cache_expire``
Time in seconds to cache this template with this
``cache_key`` for. Or use 'never' to designate that the
cache should never expire.
The minimum key required to trigger caching is
``cache_expire='never'`` which will cache the template forever
seconds with no key.
All other keyword options are passed directly to the template
engine used.
s' No engine with that name configured: %st pylonsmyghtyt output_encodingt encoding_errorst disable_unicodet _global_argsRV t
allow_globalssI You must specify ``namespace`` when ``include_pylons_variables`` is FalseR t makoRY t .t formatR# R$ R% c s* t i d ˆ ƒ ˆ d i ˆ d ˆ ˆ S( Ns Cached render running for %sRV R> ( R R R ( ( t
engine_configR5 t full_pathRX ( s5 /usr/lib/python2.6/site-packages/pylons/templating.pyR7 s t fragmentt _frags Using render cache for %sR' R& R( s$ Rendering template %s with engine %sR> N( s output_encodings encoding_errorss disable_unicode( RO RR R t ExceptionR) R\ R" t interpretert global_argst keyst init_paramsRK R9 t
startswitht ost patht sept joint replacet lstript FalseR R R R+ R, R- R ( RT R] R. t include_pylons_variablesR5 R1 R3 R2 RX t keyt interpR= R7 t tfilet mycache( ( R5 Ri RX Rj s5 /usr/lib/python2.6/site-packages/pylons/templating.pyR £ s~ .
#
%
N( RL RM RN R) RU RS t TrueR ( ( ( s5 /usr/lib/python2.6/site-packages/pylons/templating.pyR t s
R[ c B s e Z d Z RS( s+ Exception to toss when an engine is missing( RL RM RN ( ( ( s5 /usr/lib/python2.6/site-packages/pylons/templating.pyR[ % s c B sG e Z d Z d Z d d d „ Z d „ Z d e d d d d d „ Z RS( sÓ Myghty Template Plugin
This Myghty Template Plugin varies from the official BuffetMyghty
in that it will properly populate all the default Myghty variables
needed and render fragments.
t mytc C sŠ | d j o
h } n h } x< | i ƒ D]. \ } } | i d ƒ o | | | d Ra Rb Rc t bufRo t
optional_args( ( s5 /usr/lib/python2.6/site-packages/pylons/templating.pyR D s"
N( RL RM RN t extensionR) RU R‰ Ry R ( ( ( s5 /usr/lib/python2.6/site-packages/pylons/templating.pyR * s s python.templating.engines( t DistributionNotFoundi R` t files4 Unable to load template engine entry point: '%s': %si c
O sò | i d t ƒ } | i d d ƒ } t | ƒ } | i ƒ } t d | i d d ƒ d | i d d ƒ d | i d d ƒ ƒ } t i d | | ƒ | o5 | i ƒ } t i i | | d | d | d | | St i i d | d | d | d | | S(
s Render a template and return it as a string (possibly Unicode)
Optionally takes 3 keyword arguments to use caching supplied by
Buffet.
Examples:
.. code-block:: python
content = render('/my/template.mako')
print content
content = render('/my/template2.myt', fragment=True)
.. admonition:: Note
Not all template languages support the concept of a fragment.
In those template languages that do support the fragment
option, this usually implies that the template will be rendered
without extending or inheriting any site skin.
Rk Rh R3 R2 R1 s. Render called with %s args and %s keyword argsR5 R. N(
R\ Ry R) t listR R R R t buffetR ( t argst kargsRk Rh R> t
cache_argsRV ( ( s5 /usr/lib/python2.6/site-packages/pylons/templating.pyR s s c O s» t i t i i t d ƒ t i i ƒ } t | | Ž } t | t
ƒ o
| | _ n
| | _ | i
d ƒ } | i
d ƒ } | o! d t i i | f | i d | sj ,<#±2
'