[Zope-dev] XMLDocument beta release

Chimezie Thomas-Ogbuji cogbuji@fourthought.com
Mon, 15 May 2000 20:49:56 -0600


This is a multi-part message in MIME format.
--------------82F61EB55E1DA6B39CB55E19
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit


-- 
Chimezie Thomas-Ogbuji
Junior Consultant
Fourthought Inc.
(303) 583 9900 ext 104
cogbuji@fourthought.com
--------------82F61EB55E1DA6B39CB55E19
Content-Type: text/plain; charset=us-ascii;
 name="Readme.txt"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="Readme.txt"

XMLDocument beta is a collection of Zope products and python tools that
integrate XML into Zope, above and beyond the current XMLDocument product.
Like ZDOM, it is the result of a collaborative venture by Digital Creations and
Fourthought Inc.

ClobXmlDocument

This is a Zope product that wraps XML content for use in Zope.  In many
ways it behaves similarly to the original XMLDocument, except it only
creates a single Zope object upon import or creation.

XMLImporter

This python module allows users to externally import XML content into
the Zope database in a 'controlled' manner.  The user has full range
of control over import parameters.

XSLT Method

This is a Zope product that wraps an XSLT stylesheet for use in Zope.
Like a DTML method, it can be invoked on a ClobXmlDocument instance
and return the resulting XSLT transformation.

Fourthought provides custom technological solutions based on open
technologies.  4Suite is a powerful set of Python tools developed by
Fourthought for Web-based applications in areas such as Intranets,
E-Commerce and knowledge-management.  Elements of 4Suite have been adopted
as core XML technologies in Zope and in the Python XML distribution


links:

Fourthought: http://fourthought.com
4Suite: http://fourthought.com/4Suite/
DOM 2 Spec: http://www.w3.org/TR/2000/CR-DOM-Level-2-20000307/
Zope http://www.zope.org
 
contact:
consultants@fourthought.com
 


--------------82F61EB55E1DA6B39CB55E19
Content-Type: text/plain; charset=us-ascii;
 name="INSTALL.txt"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="INSTALL.txt"

Installing XMLDocument beta
---------------------------

  This document describes installing XMLDocument beta on Unix.

Important Notes

  XMLDocument requires 4DOM which is installed by the ZDOM installation.
  Simply installing ZDOM should resolve this dependency

  XMLDocument requires 4XPath and 4XSLT

  XMLDocument also requires Bison, Swig, and Flex.  The RPMs for these
  can be downloaded at the corresponding locations

  Bison
  (ftp://rpmfind.net/linux/MandrakeCooker/cooker/Mandrake/RPMS/bison-1.28-4mdk.i586.rpm)

  Swig
  ftp://rpmfind.net/linux/MandrakeCooker/cooker/Mandrake/RPMS/swig-1.1p5-4mdk.i586.rpm

  Flex (might already be installed)
  ftp://rpmfind.net/linux/MandrakeCooker/cooker/Mandrake/RPMS/flex-2.5.4a-11mdk.i586.rpm

Installing

  If necessary, install all the dependent packages (as well as Zope)

  Download this files from our FTP server (ftp.fourthought.com):

    /pub/4Suite/4Zope/XMLDocument/XMLDocument-beta.tgz
    /pub/4Suite/4Zope/XMLDocument/XMLImporter-beta.tgz
    /pub/4Suite/4Zope/XMLDocument/4Suite-Base-0.8.0beta1.tar.gz
    /pub/4Suite/4Zope/XMLDocument/4XPath-0.9.0beta2.tar.gz
    /pub/4Suite/4Zope/XMLDocument/4XSLT-0.9.0beta2.tar.gz

  Installing ClobXmLDocument and XSLTMethod:

    decompress XMLDocument-beta.tgz to a temporary directory like so:

      cd (some temporary directory)
      tar -xzf (location of downloaded file)/XMLDocument-beta.tgz

    run the stage.py script file.  By default, it installs XMLDocument
    to /usr/local/src/Zope.  If you have installed Zope in a different location
    you can specify this on the command line using the --dest option.  For example,
    if you wanted to install XMLDocument to /home/Zope you would execute the stage.py
    script like so:

    stage.py --dest=/home/Zope

  Installing XMLImporter:

    decompress XMLImporter-beta.tgz to an arbitrary directory.

    make sure (Zope install directory)/lib/python is in your PYTHONPATH

    * read the python files in test_suite for examples on how to use XMLImporter

  Installing XPath, and XSlt:

    Simply untar the appropriate packages and follow the instructions in INSTALL

  Assuming you've satisfied the dependencies, you should be done!

  questions? email: consultants@fourthought.com


--------------82F61EB55E1DA6B39CB55E19
Content-Type: text/plain; charset=us-ascii;
 name="Release.txt"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="Release.txt"

RELEASE NOTES
_______________________
XMLDocument beta supports the import and manipulation of XML files in
Zope through the use of XSLT.
See (XPath:
http://www.w3.org/TR/1999/REC-xpath-19991116, and XSLT:
http://www.w3.org/TR/1999/REC-xslt-19991116)

XMLImporter is currently used as a python based tool to input XML files
as Zope Objects.  The mapping functionality and XSLT transform are used to
manipulate the incomming XML stream into a set of Zope Objects.  The
transform is applied to the incoming XML to allow manipulation and
compression of the incomming XML.
See
http://216.164.72.7:7780/Wiki/Members/jim/ZDOM/InitialNotes
under the heading optimization.  The final set of objects created by XMLImporter
is defined by the mapping dictionary where keys are the tagNames to be
created, and the values are references to python classes.  A current limitation
of the system is that Zope must not be running during an import.

Clob XML Document is a Zope Object that represents a complete XML
document.  Interfaces are provided to edit the content of the document, and modify
how the document is displayed when viewed.  XSLTMethod is a Zope Object that applies an XSLT transform to an
object.  An XSLTMethod can be accessed as any other method of an object.  With the
ZDOM pakage installed, the XSLTMethod can be applied to any Object in the
Zope application.  Special processing is currently restricted to Clob XML
Documents.  When an XSLTMethod is applied to a Clob XML Document the
contents of the document are used as a source, not the object itself.


INSTALLATION
---------------
Please see INSTALL.txt for Installation and package dependencies

TODO
___________
1.  Allow XMLImporter to be called through the HTML interface
2.  Allow Exporting of Zope Objects to XML (expand current export
functionality)
3.  Allow XSLT special processing on other objects (through _getDom
interface)
4.  Allow external parameters into XSLTMethod
5.  Fix minor UI bugs in XSLTMethod (copy, cut, paste)
6.  Fix processing error when applying XSLT to the Zope Application


--------------82F61EB55E1DA6B39CB55E19--