cybertools/composer/layout
helmutm 49102961e5 work in progress: layout managememnt
git-svn-id: svn://svn.cy55.de/Zope3/src/cybertools/trunk@2893 fd906abe-77d9-0310-91a1-e0d9ade77398
2008-09-19 10:26:11 +00:00
..
browser work in progress: layout managememnt 2008-09-19 09:43:30 +00:00
__init__.py created composer.layout package 2008-07-15 11:53:56 +00:00
base.py work in progress: layout managememnt 2008-09-19 10:26:11 +00:00
configure.zcml created composer.layout package 2008-07-15 11:53:56 +00:00
interfaces.py work in progress: layout managememnt 2008-09-19 10:26:11 +00:00
README.txt work in progress: layout managememnt 2008-09-19 09:43:30 +00:00
region.py work in progress: layout management: repurpose layout instance; provide page (top-level view) that in turn invokes a top-level layout view 2008-07-31 16:07:54 +00:00
tests.py created composer.layout package 2008-07-15 11:53:56 +00:00

=================
Layout Management
=================

  ($Id$)

Let's start with some basic setup; the traversable adapter is needed for
rendering the page templates.

  >>> from zope import component
  >>> from zope.interface import Interface
  >>> from zope.traversing.adapters import DefaultTraversable
  >>> component.provideAdapter(DefaultTraversable, (Interface,))

For testing we define a simple content class.

  >>> class Document(object):
  ...     text = ''

The layout management is controlled by a global utility, the layout
manager.

  >>> from cybertools.composer.layout.base import LayoutManager, LayoutInstance
  >>> from cybertools.composer.layout.interfaces import ILayout

  >>> manager = LayoutManager()
  >>> component.provideUtility(manager)

The layouts themselves are also specified as utilities.

  >>> #from cybertools.composer.layout.browser.liquid.default import css
  >>> #component.provideUtility(css, ILayout, name='css')

  >>> from cybertools.composer.layout.browser.liquid.default import body
  >>> component.provideUtility(body, ILayout, name='body.liquid')

  >>> from cybertools.composer.layout.browser.default import footer
  >>> component.provideUtility(footer, ILayout, name='footer.default')

In addition we have to provide at least one layout instance adapter that
connects a layout with the client object.

  >>> component.provideAdapter(LayoutInstance, (object,))


Browser Views
=============

  >>> from cybertools.composer.layout.browser.view import Page
  >>> from zope.publisher.browser import TestRequest

  >>> page = Page(Document(), TestRequest())

  >>> page()
  u'<!DOCTYPE ...>...<html ...>...</html>...'