Skip to main content

Zope Page Templates

Project description

Page Templates provide an elegant templating mechanism that achieves a clean separation of presentation and application logic while allowing for designers to work with templates in their visual editing tools (FrontPage, Dreamweaver, GoLive, etc.).

Detailed Documentation

ZPT (Zope Page-Template) Architecture

There are a number of major components that make up the page-template architecture:

  • The TAL compiler and interpreter. This is responsible for compiling source files and for executing compiled templates. See the zope.tal package for more information.

  • An expression engine is responsible for compiling expressions and for creating expression execution contexts. It is common for applications to override expression engines to provide custom expression support or to change the way expressions are implemented. The zope.app.pagetemplate package uses this to implement trusted and untrusted evaluation; a different engine is used for each, with different implementations of the same type of expressions.

    Expression contexts support execution of expressions and provide APIs for setting up variable scopes and setting variables. The expression contexts are passed to the TAL interpreter at execution time.

    The most commonly used expression implementation is that found in zope.tales.

  • Page templates tie everything together. They assemble an expression engine with the TAL interpreter and orchestrate management of source and compiled template data. See zope.pagetemplate.interfaces.

Page Templates

Introduction

Page Templates provide an elegant templating mechanism that achieves a clean separation of presentation and application logic while allowing for designers to work with templates in their visual editing tools (FrontPage, Dreamweaver, GoLive, etc.).

This document focuses on usage of Page Templates outside of a Zope context, it does not explain how to write page templates as there are several resources on the web which do so.

Simple Usage

Using Page Templates outside of Zope3 is very easy and straight forward. A quick example:

>>> from zope.pagetemplate.pagetemplatefile import PageTemplateFile
>>> my_pt = PageTemplateFile('hello_world.pt')
>>> my_pt()
u'<html><body>Hello World</body></html>'

Subclassing PageTemplates

Lets say we want to alter page templates such that keyword arguments appear as top level items in the namespace. We can subclass PageTemplate and alter the default behavior of pt_getContext() to add them in:

from zope.pagetemplate.pagetemplate import PageTemplate

class mypt(PageTemplate):
    def pt_getContext(self, args=(), options={}, **kw):
       rval = PageTemplate.pt_getContext(self, args=args)
       options.update(rval)
       return options

class foo:
    def getContents(self): return 'hi'

So now we can bind objects in a more arbitrary fashion, like the following:

template = """
<html>
<body>
<b tal:replace="das_object/getContents">Good Stuff Here</b>
</body>
</html>
"""

pt = mypt()
pt.write(template)
pt(das_object=foo())

See interfaces.py.

CHANGES

3.4.0 (2007-10-02)

  • Initial release independent of the Zope 3 tree.

3.2.0 (2006-01-05)

  • Corresponds to the verison of the zope.pagetemplate package shipped as part of the Zope 3.2.0 release.

  • ZPTPage macro expansion: changed label text to match the corresponding label in Zope 2 and activated the name spaces for macro expansion in ‘read’. See http://www.zope.org/Collectors/Zope3-dev/199

  • Coding style cleanups.

3.1.0 (2005-10-03)

  • Corresponds to the verison of the zope.pagetemplate package shipped as part of the Zope 3.1.0 release.

  • Fixed apidoc and Cookie, which were using wrong descriptor class (changed to ‘property’). See http://www.zope.org/Collectors/Zope3-dev/387

  • Documentation / style / testing cleanups.

3.0.0 (2004-11-07)

  • Corresponds to the verison of the zope.pagetemplate package shipped as part of the Zope X3.0.0 release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zope.pagetemplate-3.4.0.tar.gz (16.9 kB view details)

Uploaded Source

File details

Details for the file zope.pagetemplate-3.4.0.tar.gz.

File metadata

File hashes

Hashes for zope.pagetemplate-3.4.0.tar.gz
Algorithm Hash digest
SHA256 92e1a76f281edbdfa3f985b697e7c6b0eda3a61a8450f3d4c40b5786068a07a7
MD5 df044cf724aed1ebb30181e40a27bddc
BLAKE2b-256 8bf6a546795651bc3a9699bd26f80babdd80336f7ad078705d766934d71b3351

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page