==============================
Migrating Epoz 0.X to epoz 1.0
==============================

Using Zope2 (w/o CMF or Plone)
------------------------------

epoz 1.0 has a totally different approach than Epoz 0.X. While the old
Epoz provided a global python function called 'Epoz' that was callable
from Python Script, DTML and ZPT. We have done away with that
triple-code generation in the epoz 1.0 tree for good reasons.

epoz 1.0 mainly consists of a filesystem-based layer. The editor
application itself is a combination of ECMAScripts and a Page Template
macro. This way, the same code not only works in Zope2, CMF/Plone and
Zope3, but it also can be seen right off the filesystem.

In order to use epoz 1.0 in your custom Zope2 application, you will
have to make these filesystem-based ZPT macros available to your
ZODB-based Page Templates. The easiest way is to use the zope2
integration package using the FileSystemSite product. It can be
downloaded at http://zope.org/Members/philikon/FileSystemSite.

Once you have installed FileSystemSite and epoz in your Products
directory, you will see a new addable meta type called 'epoz
editor'. Add this one to the top-most folder of your Zope2
application. A common id would be 'epoz'. If you look inside the
object you just created, you will see that it provides all
filesystem-based page templates and ECMAScript files to the ZODB.

You can now create a page template and use the macro defined in
'epozmacros.html'. See API.txt for more information on what macros are
exposed and what slots you can fill.

Using Plone
-----------

XXX
