incubator-odf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From devin...@apache.org
Subject svn commit: r795439 - in /websites/production/odftoolkit: ./ content/odftoolkit/odfdom/ProjectOverview.html
Date Wed, 07 Sep 2011 08:47:58 GMT
Author: devinhan
Date: Wed Sep  7 08:47:58 2011
New Revision: 795439

Log:
Publishing merge to odftoolkit site by devinhan

Modified:
    websites/production/odftoolkit/   (props changed)
    websites/production/odftoolkit/content/odftoolkit/odfdom/ProjectOverview.html

Propchange: websites/production/odftoolkit/
------------------------------------------------------------------------------
--- svn:mergeinfo (original)
+++ svn:mergeinfo Wed Sep  7 08:47:58 2011
@@ -1 +1 @@
-/websites/staging/odftoolkit/trunk:794771-795435
+/websites/staging/odftoolkit/trunk:794771-795438

Modified: websites/production/odftoolkit/content/odftoolkit/odfdom/ProjectOverview.html
==============================================================================
--- websites/production/odftoolkit/content/odftoolkit/odfdom/ProjectOverview.html (original)
+++ websites/production/odftoolkit/content/odftoolkit/odfdom/ProjectOverview.html Wed Sep
 7 08:47:58 2011
@@ -78,20 +78,31 @@
   <div id="contenta">
   
     
-    <p>=Project Overview=</p>
+    <h2 id="project-overview">Project Overview</h2>
 <p>The ODFDOM project's objective is to provide an easy API for reading, writing and
manipulating documents of the OpenDocument format (ODF). 
 To archive this, the ODFDOM API follows a layered approach to access documents, as layered
design is the robust foundation for a well-designed modular structure.</p>
-<p>The two ODFDOM layers are:
-<em> '''The ODF Package Layer''':<br/>Provides access to all resources stored
within the ODF package, such as XML streams, images or embedded objects. This layer covers
all features from the [http://docs.oasis-open.org/office/v1.2/OpenDocument-v1.2-part3.html
third part of the ODF 1.2 specification] defining the ODF Package features. The ODF 1.2 package
features are build on top technologies as [http://www.pkware.com/documents/APPNOTE/APPNOTE_6.2.0.txt
ZIP package handling], [http://www.w3.org/TR/2002/REC-xmlenc-core-20021210/ W3C encryption],
[http://www.w3.org/TR/2008/REC-xmldsig-core-20080610/ W3C signature] and [http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/
W3C metadata].
-</em> '''The ODF XML Layer''':<br/>Provides all the features of an office format,
such as tables, images, numbering etc. All features are defined in [http://docs.oasis-open.org/office/v1.2/OpenDocument-v1.2-part1.html
the first part of the ODF 1.2 specification] describing the ODF XML schema. This layer consists
of two APIs representing two different views on the features:
-<strong> ''The low-level DOM API'':<br/>Gives access to the XML, the elemental
parts of the ODF schema features. With this API it is easy to manipulate all specified XML
nodes extending the platform and language independent DOM API [http://www.w3.org/DOM/ DOM
API standardized by the W3C] - best-known by its implementation through the browsers. It extends
the DOM API using a typed DOM. For every ODF XML element and ODF XML attribute defined by
the ODF grammar (the RelaxNG schema) a unique class exists, providing methods for their allowed
children. The purpose is to provide the user a corset to easily write valid ODF without consulting
the spec constantly. This API is very consistent as instead of laboriously writing all these
classes, the sources were generated directly from the ODF schema. This generation guarantees
complete coverage of the ODF specification on one side and an easy and accurate upgrade to
future ODF specifications on the other. 
-</strong> ''The high-level Document API'':<br/>Provides a different much more
high level view on the ODF schema features. This API is concerned about usability, hiding
all ODF XML implementation details from the user, covering frequent user scenarios. For example,
changing the content of a certain spreadsheet cell (e.g. Add 'Hello World' to a spreadsheet
cell positioned at 'B2'). While in the ODF DOM API in general each class represents an ODF
XML node, here a class covers multiple underlying ODF XML elements (&amp; their attributes).
Think of puzzle piece consisting of multiple smaller pieces. Therefore the typed DOM tree
is being mapped to feature tree.<br/></p>
-<p><center> [[image: ODFDOM-New-Layered-Model.png]]</center></p>
-<br/>
-
-<p>ODFDOM is part of the [http://odftoolkit.org ODF Toolkit project]. Development is
discussed on the [http://odftoolkit.org/projects/odfdom/lists dev mailing list], users should
ask their questions on the [http://odftoolkit.org/projects/odfdom/lists users mailing list].
-<br/></p>
-<p style="margin: 25px 0px; text-align:center">[[layers|'''More detailed information
about ODFDOM layers''']].</p>
+<p>The two ODFDOM layers are: <br />
+</p>
+<p><strong>-The ODF Package Layer</strong>:<br />
+  Provides access to all resources stored within the ODF package, such as XML streams, images
or embedded objects. This layer covers all features from the <a href="http://docs.oasis-open.org/office/v1.2/OpenDocument-v1.2-part3.html">third
part of the ODF 1.2 specification</a> defining the ODF Package features. The ODF 1.2
package features are build on top technologies as <a href="http://www.pkware.com/documents/APPNOTE/APPNOTE_6.2.0.txt">ZIP
package handling</a>, <a href="http://www.w3.org/TR/2002/REC-xmlenc-core-20021210/">W3C
encryption</a>, <a href="http://www.w3.org/TR/2008/REC-xmldsig-core-20080610/">W3C
signature</a> and <a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/">W3C
metadata</a>.     <br />
+</p>
+<p><strong>-The ODF XML Layer</strong>:<br/>Provides all the features
of an office format, such as tables, images, numbering etc. All features are defined in <a
href="http://docs.oasis-open.org/office/v1.2/OpenDocument-v1.2-part1.html">the first part
of the ODF 1.2 specification</a> describing the ODF XML schema. This layer consists
of two APIs representing two different views on the features: <br />
+</p>
+<ul>
+<li>
+<p><em>The low-level DOM API</em>: <br />
+Gives access to the XML, the elemental parts of the ODF schema features. With this API it
is easy to manipulate all specified XML nodes extending the platform and language independent
DOM API <a href="http://www.w3.org/DOM/">DOM API standardized by the W3C</a> -
best-known by its implementation through the browsers. It extends the DOM API using a typed
DOM. For every ODF XML element and ODF XML attribute defined by the ODF grammar (the RelaxNG
schema) a unique class exists, providing methods for their allowed children. The purpose is
to provide the user a corset to easily write valid ODF without consulting the spec constantly.
This API is very consistent as instead of laboriously writing all these classes, the sources
were generated directly from the ODF schema. This generation guarantees complete coverage
of the ODF specification on one side and an easy and accurate upgrade to future ODF specifications
on the other. <br />
+</p>
+</li>
+<li>
+<p><em>The high-level Document API</em>: <br />
+Provides a different much more high level view on the ODF schema features. This API is concerned
about usability, hiding all ODF XML implementation details from the user, covering frequent
user scenarios. For example, changing the content of a certain spreadsheet cell (e.g. Add
'Hello World' to a spreadsheet cell positioned at 'B2'). While in the ODF DOM API in general
each class represents an ODF XML node, here a class covers multiple underlying ODF XML elements
(&amp; their attributes). Think of puzzle piece consisting of multiple smaller pieces.
Therefore the typed DOM tree is being mapped to feature tree.  <br />
+</p>
+</li>
+</ul>
+<p><img alt="alt text" src="ODFDOM-New-Layered-Model.png" /></p>
+<p>ODFDOM is part of <a href="http://incubator.apache.org/odftoolkit/">Apache
ODF Toolkit project</a>. Development is discussed on <a href="mailto:odf-dev@incubator.apache.org">the
dev mailing list</a>, users should ask their questions on <a href="mailto:odf-users@incubator.apache.org">the
users mailing list</a>.</p>
+<p><strong><em><a href="Layers.html">More detailed information about
ODFDOM layers</a></em></strong>.</p>
   </div>
 
   <div id="footera">



Mime
View raw message