Metadata-Version: 1.0
Name: z3c.jbot
Version: 0.6.2
Summary: Drop-in template overrides.
Home-page: UNKNOWN
Author: Malthe Borch
Author-email: mborch@gmail.com
License: ZPL
Description: Overview
        ========
        
        The ``z3c.jbot`` (or "Just a bunch of templates") package allows easy
        customization of existing templates and images. It works on Zope 2 and
        Zope 3.
        
        The Chameleon rendering engine is supported [#]_.
        
        Use of this package adds a small (2-3 ms per request on Plone) to the
        total application response time.
        
        .. [#] To enable Chameleon on Zope 2, use the ``five.pt`` package (CMF-apps like Plone should use ``cmf.pt`` which adds full support).
        
        Usage
        -----
        
        To override a particular file, first determine its *canonical
        filename*. It's defined as the path relative to the package within
        which the file is located; directory separators are replaced with
        dots.
        
        Example:
        
        Suppose you want to override: /plone/app/layout/viewlets/logo.pt
        
        You would use the filename:   plone.app.layout.viewlets.logo.pt
        
        Simply drop the file in a directory and register that directory for
        use with jbot using a ZCML-directive::
        
        <include package="z3c.jbot" file="meta.zcml" />
        
        <browser:jbot
        directory="<path>"
        layer="<layer>" />
        
        Templates in views, viewlets and portlets
        -----------------------------------------
        
        Any template that is defined as a class-attribute can be overriden
        using jbot, e.g. those used in views, viewlets and portlets. The
        template overrides may be registered for any request layer or only a
        specific layer.
        
        CMF objects
        -----------
        
        Any skin-object (e.g. images, templates) on the file system (directory
        views) can be overridden.
        
        Author
        ------
        
        Malthe Borch <mborch@gmail.com>
        
        Changes
        =======
        
        0.6.2 (2010-02-17)
        ------------------
        
        - Downgrade log messages to debug level. In normal operation they don't contain
        any valuable information. [hannosch]
        
        - Prefer zope.site over zope.app.component if it is available. [hannosch]
        
        0.6.1 (2010-02-09)
        ------------------
        
        - Fix bungled release [optilude]
        
        0.6.0 (2010-02-09)
        ------------------
        
        - Zope 2.12 compatibility. [malthe]
        
        - Added support for automatic configuration. [malthe]
        
        - Fixed layer specialization ordering. [malthe]
        
        0.5.3 (2009-10-31)
        ------------------
        
        - ZCML-directive is now called ``jbot``. [malthe]
        
        0.5.2 (2009-10-23)
        ------------------
        
        - Fixed issue where an exception would be raised if a view was not an
        acquirer, while the context was. [gweis]
        
        0.5.1 (2009-10-19)
        ------------------
        
        - Acquisition-wrap template instance, if applicable. This fixes an
        issue on Zope 2.10 where legacy code would break.
        
        0.5 (2009-10-16)
        ----------------
        
        - Added support for CMF skin objects.
        
        0.4 (2009-10-15)
        ----------------
        
        - Added Chameleon-support.
        
        - Reimplemented override logic; the total usage cost is now reduced to
        an insignificant amount. Meanwhile, only templates that are defined
        as class-attributes (e.g. on views, viewlets and portlets) can be
        overriden.
        
        0.3 (2009-09-26)
        ----------------
        
        - Improved test coverage.
        
        - Refactored code, improving performance.
        
        - Fixed issue with multiple layers.
        
        0.2 (2008-07-14)
        ----------------
        
        - Added layer support.
        
        0.1 (2007-11-27)
        ----------------
        
        - Initial public release.
        
Keywords: page template override
Platform: UNKNOWN
Classifier: Framework :: Zope2
Classifier: Framework :: Zope3
Classifier: Programming Language :: Python
