Package README (CVS ver. 1.3)

AT Dyn Document
===============

Please read INSTALL.txt for a list of requirements before installing this
product!

The DARK SIDE of content management
===================================

AT Dyn Document gives you some abilities that are considered as bad and evil
from some persons. You should avoid using it to solve all your problems. Use
it as a quick and maybe dirty hack to solve small problems. Dynamic content
inside a document is against the Zen of a CMS.

Also read http://www.python.org/doc/Humor.html#yoda

About
=====

AT Dyn Document is an extension for ATContentTypes. It's an ATDocument like type
that supports TAL code as additional feature. You can use TALES expressions
to add dynamic parts to an ordinary document. It works a little bit like CMF
Dynamic Document. To be honest the heart of AT Dyn Document is copied from CMF
Dynamic Document but internally it works slightly different.

Comparing AT Dyn Document with CMF Dynamic Document
===================================================

Same
----

* TAL code (TALES expressions) inside an ordinary document

* Uses a customized PageTemplate class

Differs
-------

* Doesn't store the PageTemplate persistent. It's generated per request.

* An AT Dyn Document can store macros but the macros can't be accessed from
  other templates or AT Dyn Documents. Use a Page Template to store macros.

* AT Dyn Document can serv different content types like html, reSt, stx, plain
  text and python source with markup.

* AT Dyn Document has a validator that validates the code inside the body text.
  It's using the TALGenerator and HTMLParser and not the mxTidy validator so it
  won't find all HTML errors but common problems like false TALES expressions,
  unclosed tags and false nesting of tags.

* The name spaces differs:

  * 'template' points to the internal Page Template used for the body text.
    (CMF DD: The CMF DD object)

  * 'here' points to the AT Dyn Document object.
    (CMF DD: The context in which the object was called)

  * 'context' points to the context in which the AT Dyn Document was called
    (CMF DD: not present)


Reporting bugs / feature requests
=================================

Please use the bug tracker in the collective at
http://sf.net/projects/collective!
The url is http://sourceforge.net/tracker/?atid=645337&group_id=55262&func=brow-
se