You are viewing a plain text version of this content. The canonical link for it is here.
Posted to odf-commits@incubator.apache.org by bu...@apache.org on 2017/04/11 23:13:31 UTC
svn commit: r1010270 [2/13] - in /websites/staging/odftoolkit/trunk/content:
./ odftoolkit/ odftoolkit/GSoC/ odftoolkit/docs/
odftoolkit/docs/governance/ odftoolkit/odfdom/ odftoolkit/simple/
odftoolkit/simple/demo/ odftoolkit/simple/document/ odftoolk...
Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/license.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/license.html (original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/license.html Tue Apr 11 23:13:30 2017
@@ -50,7 +50,18 @@
<div id="clear"></div>
<div id="sidenav">
- <h1 id="general">General</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/index.html">About</a></li>
<li><a href="/odftoolkit/downloads.html">Downloads</a></li>
@@ -58,21 +69,21 @@
<li><a href="/odftoolkit/license.html">License</a></li>
<li><a href="/odftoolkit/privacy.html">Privacy Policy</a></li>
</ul>
-<h1 id="components">Components</h1>
+<h1 id="components">Components<a class="headerlink" href="#components" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/odfdom/index.html">ODFDOM</a></li>
<li><a href="/odftoolkit/simple/index.html">Simple API</a></li>
<li><a href="/odftoolkit/conformance/ODFValidator.html">ODF Validator</a></li>
<li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
</ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/get-involved.html">Get Involved</a></li>
<li><a href="/odftoolkit/mailing-lists.html">Mailing Lists</a></li>
<li><a href="/odftoolkit/people.html">People</a></li>
<li><a href="/odftoolkit/community-faqs.html">Community FAQs</a></li>
</ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/source.html">Source Code</a></li>
<li><a href="https://issues.apache.org/jira/browse/ODFTOOLKIT">Bug Tracker</a></li>
@@ -80,13 +91,12 @@
<li><a href="/odftoolkit/website-local.html">Website</a></li>
<li><a href="/odftoolkit/developer-faqs.html">Developer FAQs</a></li>
</ul>
-<h1 id="ppmc">PPMC</h1>
+<h1 id="ppmc">PPMC<a class="headerlink" href="#ppmc" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a></li>
-<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> <br />
-</li>
+<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> </li>
</ul>
-<h1 id="asf">ASF</h1>
+<h1 id="asf">ASF<a class="headerlink" href="#asf" title="Permanent link">¶</a></h1>
<ul>
<li><a href="http://www.apache.org">Apache Software Foundation</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
@@ -96,7 +106,18 @@
<div id="contenta">
- <p>Apache License<br></br>Version 2.0, January 2004<br></br>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p>Apache License<br></br>Version 2.0, January 2004<br></br>
<a href="http://www.apache.org/licenses/">http://www.apache.org/licenses/</a> </p>
<p>TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION</p>
<p><strong><a name="definitions">1. Definitions</a></strong>.</p>
@@ -250,7 +271,7 @@ harmless for any liability incurred by,
Contributor by reason of your accepting any such warranty or additional
liability.</p>
<p>END OF TERMS AND CONDITIONS</p>
-<h1 id="apply">APPENDIX: How to apply the Apache License to your work</h1>
+<h1 id="apply">APPENDIX: How to apply the Apache License to your work<a class="headerlink" href="#apply" title="Permanent link">¶</a></h1>
<p>To apply the Apache License to your work, attach the following boilerplate
notice, with the fields enclosed by brackets "[]" replaced with your own
identifying information. (Don't include the brackets!) The text should be
@@ -258,19 +279,20 @@ enclosed in the appropriate comment synt
recommend that a file or class name and description of purpose be included
on the same "printed page" as the copyright notice for easier
identification within third-party archives.</p>
-<div class="codehilite"><pre> Copyright [yyyy] [name of copyright owner]
+<div class="codehilite"><pre> <span class="p">:::</span><span class="n">text</span>
+ <span class="n">Copyright</span> <span class="p">[</span><span class="n">yyyy</span><span class="p">]</span> <span class="p">[</span><span class="n">name</span> <span class="n">of</span> <span class="n">copyright</span> <span class="n">owner</span><span class="p">]</span>
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
+ <span class="n">Licensed</span> <span class="n">under</span> <span class="n">the</span> <span class="n">Apache</span> <span class="n">License</span><span class="p">,</span> <span class="n">Version</span> 2<span class="p">.</span>0 <span class="p">(</span><span class="n">the</span> "<span class="n">License</span>"<span class="p">);</span>
+ <span class="n">you</span> <span class="n">may</span> <span class="n">not</span> <span class="n">use</span> <span class="n">this</span> <span class="n">file</span> <span class="n">except</span> <span class="n">in</span> <span class="n">compliance</span> <span class="n">with</span> <span class="n">the</span> <span class="n">License</span><span class="p">.</span>
+ <span class="n">You</span> <span class="n">may</span> <span class="n">obtain</span> <span class="n">a</span> <span class="n">copy</span> <span class="n">of</span> <span class="n">the</span> <span class="n">License</span> <span class="n">at</span>
- http://www.apache.org/licenses/LICENSE-2.0
+ <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">www</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">licenses</span><span class="o">/</span><span class="n">LICENSE</span><span class="o">-</span>2<span class="p">.</span>0
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
+ <span class="n">Unless</span> <span class="n">required</span> <span class="n">by</span> <span class="n">applicable</span> <span class="n">law</span> <span class="n">or</span> <span class="n">agreed</span> <span class="n">to</span> <span class="n">in</span> <span class="n">writing</span><span class="p">,</span> <span class="n">software</span>
+ <span class="n">distributed</span> <span class="n">under</span> <span class="n">the</span> <span class="n">License</span> <span class="n">is</span> <span class="n">distributed</span> <span class="n">on</span> <span class="n">an</span> "<span class="n">AS</span> <span class="n">IS</span>" <span class="n">BASIS</span><span class="p">,</span>
+ <span class="n">WITHOUT</span> <span class="n">WARRANTIES</span> <span class="n">OR</span> <span class="n">CONDITIONS</span> <span class="n">OF</span> <span class="n">ANY</span> <span class="n">KIND</span><span class="p">,</span> <span class="n">either</span> <span class="n">express</span> <span class="n">or</span> <span class="n">implied</span><span class="p">.</span>
+ <span class="n">See</span> <span class="n">the</span> <span class="n">License</span> <span class="k">for</span> <span class="n">the</span> <span class="n">specific</span> <span class="n">language</span> <span class="n">governing</span> <span class="n">permissions</span> <span class="n">and</span>
+ <span class="n">limitations</span> <span class="n">under</span> <span class="n">the</span> <span class="n">License</span><span class="p">.</span>
</pre></div>
</div>
Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/CodeGenRepo.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/CodeGenRepo.html (original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/CodeGenRepo.html Tue Apr 11 23:13:30 2017
@@ -50,7 +50,18 @@
<div id="clear"></div>
<div id="sidenav">
- <h1 id="general">General</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/index.html">About</a></li>
<li><a href="/odftoolkit/downloads.html">Downloads</a></li>
@@ -58,21 +69,21 @@
<li><a href="/odftoolkit/license.html">License</a></li>
<li><a href="/odftoolkit/privacy.html">Privacy Policy</a></li>
</ul>
-<h1 id="components">Components</h1>
+<h1 id="components">Components<a class="headerlink" href="#components" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/odfdom/index.html">ODFDOM</a></li>
<li><a href="/odftoolkit/simple/index.html">Simple API</a></li>
<li><a href="/odftoolkit/conformance/ODFValidator.html">ODF Validator</a></li>
<li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
</ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/get-involved.html">Get Involved</a></li>
<li><a href="/odftoolkit/mailing-lists.html">Mailing Lists</a></li>
<li><a href="/odftoolkit/people.html">People</a></li>
<li><a href="/odftoolkit/community-faqs.html">Community FAQs</a></li>
</ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/source.html">Source Code</a></li>
<li><a href="https://issues.apache.org/jira/browse/ODFTOOLKIT">Bug Tracker</a></li>
@@ -80,13 +91,12 @@
<li><a href="/odftoolkit/website-local.html">Website</a></li>
<li><a href="/odftoolkit/developer-faqs.html">Developer FAQs</a></li>
</ul>
-<h1 id="ppmc">PPMC</h1>
+<h1 id="ppmc">PPMC<a class="headerlink" href="#ppmc" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a></li>
-<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> <br />
-</li>
+<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> </li>
</ul>
-<h1 id="asf">ASF</h1>
+<h1 id="asf">ASF<a class="headerlink" href="#asf" title="Permanent link">¶</a></h1>
<ul>
<li><a href="http://www.apache.org">Apache Software Foundation</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
@@ -96,7 +106,18 @@
<div id="contenta">
<h1 class="title">Code Generation as a Separate Component</h1>
- <p>We are moving toward treating the code generator as a separate component. The repository <a href="http://odftoolkit.org/hg/odfdom~relaxng2template">http://odftoolkit.org/hg/odfdom~relaxng2template</a> is the new home of the code generator. It may move to its own project on this site at some point.</p>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p>We are moving toward treating the code generator as a separate component. The repository <a href="http://odftoolkit.org/hg/odfdom~relaxng2template">http://odftoolkit.org/hg/odfdom~relaxng2template</a> is the new home of the code generator. It may move to its own project on this site at some point.</p>
<p>This will be the first part of ODFDOM to be a maven-only build and release.</p>
</div>
Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/ConvenienceLayerDesignIdeas.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/ConvenienceLayerDesignIdeas.html (original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/ConvenienceLayerDesignIdeas.html Tue Apr 11 23:13:30 2017
@@ -50,7 +50,18 @@
<div id="clear"></div>
<div id="sidenav">
- <h1 id="general">General</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/index.html">About</a></li>
<li><a href="/odftoolkit/downloads.html">Downloads</a></li>
@@ -58,21 +69,21 @@
<li><a href="/odftoolkit/license.html">License</a></li>
<li><a href="/odftoolkit/privacy.html">Privacy Policy</a></li>
</ul>
-<h1 id="components">Components</h1>
+<h1 id="components">Components<a class="headerlink" href="#components" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/odfdom/index.html">ODFDOM</a></li>
<li><a href="/odftoolkit/simple/index.html">Simple API</a></li>
<li><a href="/odftoolkit/conformance/ODFValidator.html">ODF Validator</a></li>
<li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
</ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/get-involved.html">Get Involved</a></li>
<li><a href="/odftoolkit/mailing-lists.html">Mailing Lists</a></li>
<li><a href="/odftoolkit/people.html">People</a></li>
<li><a href="/odftoolkit/community-faqs.html">Community FAQs</a></li>
</ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/source.html">Source Code</a></li>
<li><a href="https://issues.apache.org/jira/browse/ODFTOOLKIT">Bug Tracker</a></li>
@@ -80,13 +91,12 @@
<li><a href="/odftoolkit/website-local.html">Website</a></li>
<li><a href="/odftoolkit/developer-faqs.html">Developer FAQs</a></li>
</ul>
-<h1 id="ppmc">PPMC</h1>
+<h1 id="ppmc">PPMC<a class="headerlink" href="#ppmc" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a></li>
-<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> <br />
-</li>
+<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> </li>
</ul>
-<h1 id="asf">ASF</h1>
+<h1 id="asf">ASF<a class="headerlink" href="#asf" title="Permanent link">¶</a></h1>
<ul>
<li><a href="http://www.apache.org">Apache Software Foundation</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
@@ -96,7 +106,18 @@
<div id="contenta">
<h1 class="title">Some Design Thoughts on ODFDOM Convenience Layer</h1>
- <h2 id="the-api-is-our-user-interface">The API is our User Interface</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h2 id="the-api-is-our-user-interface">The API is our User Interface<a class="headerlink" href="#the-api-is-our-user-interface" title="Permanent link">¶</a></h2>
<p>Since the users of ODFDOM are programmers who use our library, this means that our API is our "User Interface". Although it is not a GUI, it is a UI, and we should design it like a UI, meaning we:</p>
<ol>
<li>Consider the tasks that the user will perform</li>
@@ -104,7 +125,7 @@
<li>Identify those tasks which are more advanced and might require more steps</li>
<li>Design an interface that makes the most-common tasks very easy, while still being powerful enough for more advanced uses.</li>
</ol>
-<h2 id="some-typical-user-tasks">Some Typical User Tasks</h2>
+<h2 id="some-typical-user-tasks">Some Typical User Tasks<a class="headerlink" href="#some-typical-user-tasks" title="Permanent link">¶</a></h2>
<p>Operations such as these should be possible to do with only 10 lines code, and with no knowledge of XML or XPath or ODF. We should add to this list and discuss</p>
<p>Do we agree that these are all common tasks that should be simple to program with ODFDOM?</p>
<ol>
@@ -134,7 +155,7 @@
<li>Create a custom shape in presentation slide, set animation effect “entrance->fly in“ to the custom shape.</li>
<li>Split a large document to many small documents, each chapter beginning with “heading 1“ style will be saved as a small document.</li>
</ol>
-<h2 id="programming-data-structures-algorithms">Programming = Data structures + Algorithms</h2>
+<h2 id="programming-data-structures-algorithms">Programming = Data structures + Algorithms<a class="headerlink" href="#programming-data-structures-algorithms" title="Permanent link">¶</a></h2>
<p>We probably all saw a statement like that in our first Computer Science class. These are both essential parts of programming. But many libraries have the fault that they only have strength in the data modeling. They often have very little support for common algorithms. For example, what did the C Programming Language give us? Aside from qsort() and bsearch(), there was very little. C++ on the other hand, contained the powerful Standard Template Library (STL).</p>
<p>ODFDOM 0.7 is mainly convenience wrappers of ODF markup, raising the level of abstraction of this data. But we should also consider supporting algorithms, along the STL model. This would be quite powerful and is necessary to make the above task examples very simple for our users.</p>
<p>For example, a typical pattern of use is:</p>
@@ -162,7 +183,7 @@
<li>And of course, all the wrappers to read/write ODF content once we have the fragment that the user wants.</li>
<li>And I'm sure there are several other items to consider</li>
</ul>
-<h2 id="a-possible-direction-forward">A Possible Direction Forward</h2>
+<h2 id="a-possible-direction-forward">A Possible Direction Forward<a class="headerlink" href="#a-possible-direction-forward" title="Permanent link">¶</a></h2>
<p>I'd like us to consider doing the following:</p>
<ol>
<li>Spend a few days completing the list of user tasks that we agree should be easy to do with the ODFDOM convenience layer API.</li>
Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/Development.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/Development.html (original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/Development.html Tue Apr 11 23:13:30 2017
@@ -50,7 +50,18 @@
<div id="clear"></div>
<div id="sidenav">
- <h1 id="general">General</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/index.html">About</a></li>
<li><a href="/odftoolkit/downloads.html">Downloads</a></li>
@@ -58,21 +69,21 @@
<li><a href="/odftoolkit/license.html">License</a></li>
<li><a href="/odftoolkit/privacy.html">Privacy Policy</a></li>
</ul>
-<h1 id="components">Components</h1>
+<h1 id="components">Components<a class="headerlink" href="#components" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/odfdom/index.html">ODFDOM</a></li>
<li><a href="/odftoolkit/simple/index.html">Simple API</a></li>
<li><a href="/odftoolkit/conformance/ODFValidator.html">ODF Validator</a></li>
<li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
</ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/get-involved.html">Get Involved</a></li>
<li><a href="/odftoolkit/mailing-lists.html">Mailing Lists</a></li>
<li><a href="/odftoolkit/people.html">People</a></li>
<li><a href="/odftoolkit/community-faqs.html">Community FAQs</a></li>
</ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/source.html">Source Code</a></li>
<li><a href="https://issues.apache.org/jira/browse/ODFTOOLKIT">Bug Tracker</a></li>
@@ -80,13 +91,12 @@
<li><a href="/odftoolkit/website-local.html">Website</a></li>
<li><a href="/odftoolkit/developer-faqs.html">Developer FAQs</a></li>
</ul>
-<h1 id="ppmc">PPMC</h1>
+<h1 id="ppmc">PPMC<a class="headerlink" href="#ppmc" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a></li>
-<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> <br />
-</li>
+<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> </li>
</ul>
-<h1 id="asf">ASF</h1>
+<h1 id="asf">ASF<a class="headerlink" href="#asf" title="Permanent link">¶</a></h1>
<ul>
<li><a href="http://www.apache.org">Apache Software Foundation</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
@@ -96,14 +106,24 @@
<div id="contenta">
<h1 class="title">Development</h1>
- <p><strong>Get and Build the Source Code</strong></p>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p><strong>Get and Build the Source Code</strong></p>
<ol>
<li>Install latest Mercurial</li>
<li>
<p>Setup Mercurial (optional): <br />
Config file $Hg Install Dir\Mercurial.ini on Windows or <Hg Install Dir>/.hgrc on Unix. <br />
-Enhance the default configuration, using GIT diff and enable <a href="http://mercurial.selenic.com/wiki/Win32TextExtension">default plugin</a> avoid different line breaks in the source.<br />
-</p>
+Enhance the default configuration, using GIT diff and enable <a href="http://mercurial.selenic.com/wiki/Win32TextExtension">default plugin</a> avoid different line breaks in the source. </p>
<p>[ui]
username = your Name <a href="mailto:yourLoginName@odftoolkit.org">yourLoginName@odftoolkit.org</a>
;merge = your-merge-program (or internal:merge)</p>
@@ -134,8 +154,7 @@ Please note that by this you'll get the
</ol>
<p>ODFDOM Developers however always work on the latest changeset. <br />
Now get and install <a href="http://maven.apache.org/">Apache Maven</a>. On command line test your installation with "mvn -v".</p>
-<p>If Maven is correctly installed, change into the project directory and build with command "mvn". <br />
-</p>
+<p>If Maven is correctly installed, change into the project directory and build with command "mvn". </p>
<p><strong>Set up ODFDOM Development Environment</strong></p>
<p><strong><em>Using Eclipse IDE</em></strong></p>
<p>You can also set up your own ODFDOM development environment in Eclipse.</p>
@@ -145,12 +164,10 @@ Now get and install <a href="http://mave
<li>Open Eclipse, choose "Window->Preferences->Java->Installed JREs", add JDK 5 as a installed JRE, and check it to add to the build path of a java project by default.</li>
<li>Install Maven Plugin for Eclipse, see http://m2eclipse.sonatype.org/installing-m2eclipse.html</li>
<li>Install Mercurial Plugin for Eclipse, see http://javaforge.com/project/HGE#download</li>
-<li>Get the source code with Mercurial as described above.<br />
-</li>
+<li>Get the source code with Mercurial as described above. </li>
<li>Import ODFDOM Maven project: Choose "File->Import->Maven->Existing Maven project"</li>
</ol>
-<p><strong><em>Using Netbeans IDE</em></strong> <br />
-</p>
+<p><strong><em>Using Netbeans IDE</em></strong> </p>
<p>To establish your own ODFDOM development environment:</p>
<ol>
<li>Install <a href="http://java.sun.com/javase/downloads/index_jdk5.jsp">Java / JDK 5</a> (you might use <a href="http://java.sun.com/javase/downloads/index.jsp">JDK 6</a> if you do not recontribute)</li>
@@ -163,10 +180,8 @@ You still have the opportunity to work s
<p>Since Netbeans 6.1 the <a href="http://wiki.netbeans.org/MercurialVersionControl">Mercurial plugin</a> is part of the IDE, which help you to track the changes being made and ease providing patches. Select in the menu among 'Versioning' the desired Mercurial commands.</p>
<p>After the commitment of your changed files, you need to pull the latest updates from the server, perhaps merge them with your changes and finally push your changes to the repository using in the menu Versioning->Mercurial->Share->Push Other...
and adding <code>https://myUserName:myPassword@odftoolkit.org/hg/odfdom~developer</code></p>
-<p><strong>Command Line Tools</strong> <br />
-</p>
-<p><strong><em>Mercurial</em></strong> <br />
-</p>
+<p><strong>Command Line Tools</strong> </p>
+<p><strong><em>Mercurial</em></strong> </p>
<p><a href="http://mercurial.selenic.com/wiki/">Mercurial</a> is the version control system used for ODFDOM development.</p>
<p>Here a list of the most frequently used commands:
<pre>
@@ -230,8 +245,7 @@ Aside of <a href="http://java.sun.com/do
Note: There should be NO datatype prefix being used as 'i', 's', etc.</p>
<p><strong><em>Source Code Format</em></strong> <br />
Although Maven may support source code formatting it has not yet been enabled.
-Instead the automated formatting via the IDE is used (e.g. by Netbeans via the context menu - Format).<br />
-</p>
+Instead the automated formatting via the IDE is used (e.g. by Netbeans via the context menu - Format). </p>
<p><strong><em>Spaces</em></strong> <br />
To allow a customized indentation within the IDE based on the user's taste, the indent shall be done using TABs.
For instance, Svante uses a 4 whitespace indent by TABs configured within Netbeans.</p>
@@ -246,8 +260,7 @@ For this reason, some additional Mercuri
button to base higher APIs on the stable lower layers:</p>
<p><strong><em>Version 0.9</em></strong></p>
<ul>
-<li>Complete ODF 1.2 PKG functionality (package), e.g. <br />
-</li>
+<li>Complete ODF 1.2 PKG functionality (package), e.g. </li>
<li>Add PKG validation feature</li>
<li>Complete ODF 1.2 DOM functionality, e.g.</li>
<li>Style handling refactoring</li>
@@ -258,8 +271,7 @@ button to base higher APIs on the stable
<li>Create a lean convenient API working on the complete DOM layer, but hiding XML design details of ODF 1.2</li>
<li>Complete ODF 1.2 TEST API (largly dependent on DOC API, but should be developed in parallel)</li>
</ul>
-<p><strong><em>Version 1.0</em></strong> <br />
-</p>
+<p><strong><em>Version 1.0</em></strong> </p>
<ul>
<li>PKG performance tweaks</li>
<li>DOM performance tweaks</li>
@@ -267,14 +279,11 @@ button to base higher APIs on the stable
<li>Test coverage</li>
</ul>
<p>Please see also for <a href="https://odftoolkit.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=odfdom&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=">open tasks</a>.</p>
-<p><strong>ODFDOM Code Generator</strong><br />
-</p>
+<p><strong>ODFDOM Code Generator</strong> </p>
<p>The ODFDOM Code Generator is used to generate the core Classes for ODFDOM which are a typed mapping of the ODF elements on real Java Classes. For the future we also plan to generate ODFDOM e.g. C# ( .NET ) for other programming languages with this generator. Take a look at this page <a href="ODFDOM-Code-Generator.html">ODFDOM Code Generator</a> to see how the generator works in general (will be updated soon). We are moving toward treating the code generator as a separate component. The repository <a href="http://odftoolkit.org/hg/odfdom~relaxng2template">http://odftoolkit.org/hg/odfdom~relaxng2template</a> is the new home of the code generator. It may move to its own project on this site at some point.</p>
-<p><strong>Other Useful Pages</strong> <br />
-</p>
+<p><strong>Other Useful Pages</strong> </p>
<ul>
-<li><a href="ODFDOM-Class-Structure.html">Class Structure in ODFDOM</a><br />
-</li>
+<li><a href="ODFDOM-Class-Structure.html">Class Structure in ODFDOM</a> </li>
<li><a href="ConvenienceLayerDesignIdeas.html">Convenience Layer Design Ideas</a></li>
</ul>
</div>
Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/FrequentQuestions.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/FrequentQuestions.html (original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/FrequentQuestions.html Tue Apr 11 23:13:30 2017
@@ -50,7 +50,18 @@
<div id="clear"></div>
<div id="sidenav">
- <h1 id="general">General</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/index.html">About</a></li>
<li><a href="/odftoolkit/downloads.html">Downloads</a></li>
@@ -58,21 +69,21 @@
<li><a href="/odftoolkit/license.html">License</a></li>
<li><a href="/odftoolkit/privacy.html">Privacy Policy</a></li>
</ul>
-<h1 id="components">Components</h1>
+<h1 id="components">Components<a class="headerlink" href="#components" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/odfdom/index.html">ODFDOM</a></li>
<li><a href="/odftoolkit/simple/index.html">Simple API</a></li>
<li><a href="/odftoolkit/conformance/ODFValidator.html">ODF Validator</a></li>
<li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
</ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/get-involved.html">Get Involved</a></li>
<li><a href="/odftoolkit/mailing-lists.html">Mailing Lists</a></li>
<li><a href="/odftoolkit/people.html">People</a></li>
<li><a href="/odftoolkit/community-faqs.html">Community FAQs</a></li>
</ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/source.html">Source Code</a></li>
<li><a href="https://issues.apache.org/jira/browse/ODFTOOLKIT">Bug Tracker</a></li>
@@ -80,13 +91,12 @@
<li><a href="/odftoolkit/website-local.html">Website</a></li>
<li><a href="/odftoolkit/developer-faqs.html">Developer FAQs</a></li>
</ul>
-<h1 id="ppmc">PPMC</h1>
+<h1 id="ppmc">PPMC<a class="headerlink" href="#ppmc" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a></li>
-<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> <br />
-</li>
+<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> </li>
</ul>
-<h1 id="asf">ASF</h1>
+<h1 id="asf">ASF<a class="headerlink" href="#asf" title="Permanent link">¶</a></h1>
<ul>
<li><a href="http://www.apache.org">Apache Software Foundation</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
@@ -96,17 +106,25 @@
<div id="contenta">
<h1 class="title">Frequently asked questions</h1>
- <p><strong><em>Question:</em></strong> How to extracte featured text from a document, for example: extract all bold, italicized or underlined text from a document and any other layout evidence of emphasis like the text font size and so on?<br />
-</p>
-<p><strong><em>Answer:</em></strong> The model of ODF is for there to be "blocks" of text and each run can have an associated style reference. These style references then have definitions of exactly what text attributes they correspond to. There are two methods you can refer to.<br />
-</p>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p><strong><em>Question:</em></strong> How to extracte featured text from a document, for example: extract all bold, italicized or underlined text from a document and any other layout evidence of emphasis like the text font size and so on? </p>
+<p><strong><em>Answer:</em></strong> The model of ODF is for there to be "blocks" of text and each run can have an associated style reference. These style references then have definitions of exactly what text attributes they correspond to. There are two methods you can refer to. </p>
<ol>
<li>
<p>First identify which styles have the bold (or italics) attribute.
The document might have more than one style that defines bold text.
Find which text blocks reference that style. You can download a
- sample code <a href="http://langintro.com/odfdom_tutorials/search_by_style_09_07_22.zip">here</a>.<br />
-</p>
+ sample code <a href="http://langintro.com/odfdom_tutorials/search_by_style_09_07_22.zip">here</a>. </p>
</li>
<li>
<p>For each text block, identify the style. For the style, resolve the
Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/Layers.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/Layers.html (original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/Layers.html Tue Apr 11 23:13:30 2017
@@ -50,7 +50,18 @@
<div id="clear"></div>
<div id="sidenav">
- <h1 id="general">General</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/index.html">About</a></li>
<li><a href="/odftoolkit/downloads.html">Downloads</a></li>
@@ -58,21 +69,21 @@
<li><a href="/odftoolkit/license.html">License</a></li>
<li><a href="/odftoolkit/privacy.html">Privacy Policy</a></li>
</ul>
-<h1 id="components">Components</h1>
+<h1 id="components">Components<a class="headerlink" href="#components" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/odfdom/index.html">ODFDOM</a></li>
<li><a href="/odftoolkit/simple/index.html">Simple API</a></li>
<li><a href="/odftoolkit/conformance/ODFValidator.html">ODF Validator</a></li>
<li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
</ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/get-involved.html">Get Involved</a></li>
<li><a href="/odftoolkit/mailing-lists.html">Mailing Lists</a></li>
<li><a href="/odftoolkit/people.html">People</a></li>
<li><a href="/odftoolkit/community-faqs.html">Community FAQs</a></li>
</ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/source.html">Source Code</a></li>
<li><a href="https://issues.apache.org/jira/browse/ODFTOOLKIT">Bug Tracker</a></li>
@@ -80,13 +91,12 @@
<li><a href="/odftoolkit/website-local.html">Website</a></li>
<li><a href="/odftoolkit/developer-faqs.html">Developer FAQs</a></li>
</ul>
-<h1 id="ppmc">PPMC</h1>
+<h1 id="ppmc">PPMC<a class="headerlink" href="#ppmc" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a></li>
-<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> <br />
-</li>
+<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> </li>
</ul>
-<h1 id="asf">ASF</h1>
+<h1 id="asf">ASF<a class="headerlink" href="#asf" title="Permanent link">¶</a></h1>
<ul>
<li><a href="http://www.apache.org">Apache Software Foundation</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
@@ -96,22 +106,30 @@
<div id="contenta">
<h1 class="title">The ODFDOM Layers</h1>
- <p>The ODFDOM project's objective is to provide an easy API for reading, writing and manipulating documents of the OpenDocument format (ODF).
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<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><center><img alt="alt text" src="ODFDOM-New-Layered-Model.png" /></center></p>
-<h2 id="the-odf-package-layer">The ODF Package Layer</h2>
-<p>The ODF Package Layer provides access to all resources stored within the ODF package, such as XML streams, images or embedded objects. <br />
-</p>
+<h2 id="the-odf-package-layer">The ODF Package Layer<a class="headerlink" href="#the-odf-package-layer" title="Permanent link">¶</a></h2>
+<p>The ODF Package Layer provides access to all resources stored within the ODF package, such as XML streams, images or embedded objects. </p>
<p><strong>The ODF Package API</strong><br />
The ODF Package API covers all features from <a href="http://docs.oasis-open.org/office/v1.2/OpenDocument-v1.2-part3.html">the 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>.</p>
<p>At this layer a document is in general represented by a bundle of named resources zipped to a package.
For instance, an ODF text document like 'myVacation.odt' might contain the following files:</p>
<p><img alt="alt text" src="ODF_Package.jpg" /></p>
<p><strong><em>Note:</em></strong> All file streams aside of the '/Pictures' directory and its content are specified by the ODF standard.
-Furthermore, the file streams are similar for all types of ODF documents.<br />
-</p>
-<p>The main requirements for this layer in regard of ZIP are: <br />
-</p>
+Furthermore, the file streams are similar for all types of ODF documents. </p>
+<p>The main requirements for this layer in regard of ZIP are: </p>
<ul>
<li>Zip/unzip the file streams of the package</li>
<li>Enlist all file streams in the /META-INF/manifest.xml (similar to an
@@ -122,24 +140,22 @@ Furthermore, the file streams are simila
<p>All sources of the Package layer are organized in ODFDOM beyond <code>org.odftoolkit.odfdom.pkg.*</code></p>
<p>The following example illustrates how to add a graphic to the package level
(although not shown by an ODF application (like OpenOffice.org), as not used by the shown content):</p>
-<div class="codehilite"><pre><span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">odftoolkit</span><span class="o">.</span><span class="n">odfdom</span><span class="o">.</span><span class="n">pkg</span><span class="o">.</span><span class="n">OdfPackage</span><span class="p">;</span>
-<span class="p">[</span><span class="o">...</span><span class="p">]</span>
+<div class="codehilite"><pre><span class="n">import</span> <span class="n">org</span><span class="p">.</span><span class="n">odftoolkit</span><span class="p">.</span><span class="n">odfdom</span><span class="p">.</span><span class="n">pkg</span><span class="p">.</span><span class="n">OdfPackage</span><span class="p">;</span>
+<span class="p">[...]</span>
-<span class="sr">//</span> <span class="n">loads</span> <span class="n">the</span> <span class="n">ODF</span> <span class="n">document</span> <span class="nb">package</span> <span class="n">from</span> <span class="n">the</span> <span class="n">path</span>
-<span class="n">OdfPackage</span> <span class="n">pkg</span> <span class="o">=</span> <span class="n">OdfPackage</span><span class="o">.</span><span class="n">loadPackage</span><span class="p">(</span><span class="s">"/home/myDocuments/myVacation.odt"</span><span class="p">);</span>
+<span class="o">//</span> <span class="n">loads</span> <span class="n">the</span> <span class="n">ODF</span> <span class="n">document</span> <span class="n">package</span> <span class="n">from</span> <span class="n">the</span> <span class="n">path</span>
+<span class="n">OdfPackage</span> <span class="n">pkg</span> <span class="p">=</span> <span class="n">OdfPackage</span><span class="p">.</span><span class="n">loadPackage</span><span class="p">(</span>"<span class="o">/</span><span class="n">home</span><span class="o">/</span><span class="n">myDocuments</span><span class="o">/</span><span class="n">myVacation</span><span class="p">.</span><span class="n">odt</span>"<span class="p">);</span>
-<span class="sr">//</span> <span class="n">loads</span> <span class="n">the</span> <span class="n">image</span> <span class="n">from</span> <span class="n">the</span> <span class="n">URL</span> <span class="ow">and</span> <span class="n">inserts</span> <span class="n">the</span> <span class="n">image</span> <span class="n">in</span> <span class="n">the</span> <span class="nb">package</span><span class="p">,</span>
-<span class="sr">//</span> <span class="n">adapting</span> <span class="n">the</span> <span class="n">manifest</span>
-<span class="n">pkg</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="k">new</span> <span class="n">URI</span><span class="p">(</span><span class="s">"./myHoliday.png"</span><span class="p">),</span> <span class="s">"Pictures/myHoliday.png"</span><span class="p">,</span> <span class="s">"image/png"</span><span class="p">);</span>
-<span class="n">pkg</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="s">"/home/myDocuments/myVacation.odt"</span><span class="p">);</span>
+<span class="o">//</span> <span class="n">loads</span> <span class="n">the</span> <span class="n">image</span> <span class="n">from</span> <span class="n">the</span> <span class="n">URL</span> <span class="n">and</span> <span class="n">inserts</span> <span class="n">the</span> <span class="n">image</span> <span class="n">in</span> <span class="n">the</span> <span class="n">package</span><span class="p">,</span>
+<span class="o">//</span> <span class="n">adapting</span> <span class="n">the</span> <span class="n">manifest</span>
+<span class="n">pkg</span><span class="p">.</span><span class="n">insert</span><span class="p">(</span><span class="n">new</span> <span class="n">URI</span><span class="p">(</span>"<span class="o">./</span><span class="n">myHoliday</span><span class="p">.</span><span class="n">png</span>"<span class="p">),</span> "<span class="n">Pictures</span><span class="o">/</span><span class="n">myHoliday</span><span class="p">.</span><span class="n">png</span>"<span class="p">,</span> "<span class="n">image</span><span class="o">/</span><span class="n">png</span>"<span class="p">);</span>
+<span class="n">pkg</span><span class="p">.</span><span class="n">save</span><span class="p">(</span>"<span class="o">/</span><span class="n">home</span><span class="o">/</span><span class="n">myDocuments</span><span class="o">/</span><span class="n">myVacation</span><span class="p">.</span><span class="n">odt</span>"<span class="p">);</span>
</pre></div>
-<h2 id="the-odf-xml-layer">The ODF XML Layer</h2>
-<p>The ODF XML Layer 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>
-<p><strong>The ODF DOM API</strong><br />
-</p>
+<h2 id="the-odf-xml-layer">The ODF XML Layer<a class="headerlink" href="#the-odf-xml-layer" title="Permanent link">¶</a></h2>
+<p>The ODF XML Layer 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. </p>
+<p><strong>The ODF DOM API</strong> </p>
<p>The ODF DOM API 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. </p>
<p>At this level, all XML file streams of the document are accessible via the <a href="http://www.w3.org/DOM/">W3C DOM API</a>, but only the ODF standardized XML file streams of the document (e.g. content.xml, meta.xml) have their own classes representing their ODF XML elements. Foreign XML within a specified ODF XML file will remain in the document model in general and won't be neglected unless desired ( which still might be a future option).</p>
<p>Example of the ODF XML representing a table in ODF:</p>
@@ -148,53 +164,51 @@ Furthermore, the file streams are simila
<p>This XML would be mapped to a W3C derived ODF DOM class structure:</p>
<p><img alt="alt text" src="Table_fruits_diagramm.jpg" /></p>
<p>All sources of the typed DOM API are organized beyond <code>org.odftoolkit.odfdom.dom.*</code></p>
-<p>The sources for the ODF elements are all generated from the ODF grammar (RelaxNG schema) using the following naming conventions in the Java reference implementation: <br />
-</p>
+<p>The sources for the ODF elements are all generated from the ODF grammar (RelaxNG schema) using the following naming conventions in the Java reference implementation: </p>
<ul>
-<li>The class name is equal to the element local name using the Namespace as prefix and 'Element' as suffix (e.g. the 'draw:frame' element has the <code>DrawFrameElement</code> class).<br />
-</li>
+<li>The class name is equal to the element local name using the Namespace as prefix and 'Element' as suffix (e.g. the 'draw:frame' element has the <code>DrawFrameElement</code> class). </li>
<li>Elements are stored beyond a sub-package equal to their Namespace used by the OOo. Therefore the frame element 'draw:frame' would be generated in Java as class <code>org.odftoolkit.odfdom.dom.draw.DrawFrameElement</code>.</li>
</ul>
<p><strong><em>Note:</em></strong> The element local names 'h' and 'p' have been renamed to the classes 'Heading' and 'Paragraph' for usability reasons.</p>
<p>The following example illustrates how to add a graphic to the ODF document, that it is viewable:</p>
-<div class="codehilite"><pre><span class="nb">import</span> <span class="n">java</span><span class="o">.</span><span class="n">net</span><span class="o">.</span><span class="n">URI</span><span class="p">;</span>
-<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">odftoolkit</span><span class="o">.</span><span class="n">odfdom</span><span class="o">.</span><span class="n">OdfElement</span><span class="p">;</span>
-<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">odftoolkit</span><span class="o">.</span><span class="n">odfdom</span><span class="o">.</span><span class="n">doc</span><span class="o">.</span><span class="n">OdfDocument</span><span class="p">;</span>
-<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">odftoolkit</span><span class="o">.</span><span class="n">odfdom</span><span class="o">.</span><span class="n">doc</span><span class="o">.</span><span class="n">OdfTextDocument</span><span class="p">;</span>
-<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">odftoolkit</span><span class="o">.</span><span class="n">odfdom</span><span class="o">.</span><span class="n">doc</span><span class="o">.</span><span class="n">draw</span><span class="o">.</span><span class="n">OdfDrawImage</span><span class="p">;</span>
-<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">odftoolkit</span><span class="o">.</span><span class="n">odfdom</span><span class="o">.</span><span class="n">dom</span><span class="o">.</span><span class="n">element</span><span class="o">.</span><span class="n">draw</span><span class="o">.</span><span class="n">DrawFrameElement</span><span class="p">;</span>
-<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">odftoolkit</span><span class="o">.</span><span class="n">odfdom</span><span class="o">.</span><span class="n">dom</span><span class="o">.</span><span class="n">element</span><span class="o">.</span><span class="n">office</span><span class="o">.</span><span class="n">OfficeTextElement</span><span class="p">;</span>
-<span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">odftoolkit</span><span class="o">.</span><span class="n">odfdom</span><span class="o">.</span><span class="n">dom</span><span class="o">.</span><span class="n">element</span><span class="o">.</span><span class="n">text</span><span class="o">.</span><span class="n">TextPElement</span><span class="p">;</span>
-
-<span class="p">[</span><span class="o">...</span><span class="p">]</span>
-
-<span class="sr">//</span> <span class="n">Load</span> <span class="n">file</span>
-<span class="n">OdfTextDocument</span> <span class="n">odt</span> <span class="o">=</span> <span class="p">(</span><span class="n">OdfTextDocument</span><span class="p">)</span> <span class="n">OdfDocument</span><span class="o">.</span><span class="n">loadDocument</span><span class="p">(</span><span class="s">"ImageIn.odt"</span><span class="p">);</span>
-
-<span class="sr">//</span> <span class="n">get</span> <span class="n">root</span> <span class="n">of</span> <span class="n">all</span> <span class="n">content</span> <span class="n">of</span> <span class="n">a</span> <span class="n">text</span> <span class="n">document</span>
-<span class="n">OfficeTextElement</span> <span class="n">officeText</span> <span class="o">=</span> <span class="n">odt</span><span class="o">.</span><span class="n">getContentRoot</span><span class="p">();</span>
-
-<span class="sr">//</span> <span class="n">get</span> <span class="n">first</span> <span class="n">paragraph</span>
-<span class="n">TextPElement</span> <span class="n">firstParagraph</span> <span class="o">=</span>
- <span class="n">OdfElement</span><span class="o">.</span><span class="n">findFirstChildNode</span><span class="p">(</span><span class="n">TextPElement</span><span class="o">.</span><span class="n">class</span><span class="p">,</span> <span class="n">officeText</span><span class="p">);</span>
+<div class="codehilite"><pre><span class="n">import</span> <span class="n">java</span><span class="p">.</span><span class="n">net</span><span class="p">.</span><span class="n">URI</span><span class="p">;</span>
+<span class="n">import</span> <span class="n">org</span><span class="p">.</span><span class="n">odftoolkit</span><span class="p">.</span><span class="n">odfdom</span><span class="p">.</span><span class="n">OdfElement</span><span class="p">;</span>
+<span class="n">import</span> <span class="n">org</span><span class="p">.</span><span class="n">odftoolkit</span><span class="p">.</span><span class="n">odfdom</span><span class="p">.</span><span class="n">doc</span><span class="p">.</span><span class="n">OdfDocument</span><span class="p">;</span>
+<span class="n">import</span> <span class="n">org</span><span class="p">.</span><span class="n">odftoolkit</span><span class="p">.</span><span class="n">odfdom</span><span class="p">.</span><span class="n">doc</span><span class="p">.</span><span class="n">OdfTextDocument</span><span class="p">;</span>
+<span class="n">import</span> <span class="n">org</span><span class="p">.</span><span class="n">odftoolkit</span><span class="p">.</span><span class="n">odfdom</span><span class="p">.</span><span class="n">doc</span><span class="p">.</span><span class="n">draw</span><span class="p">.</span><span class="n">OdfDrawImage</span><span class="p">;</span>
+<span class="n">import</span> <span class="n">org</span><span class="p">.</span><span class="n">odftoolkit</span><span class="p">.</span><span class="n">odfdom</span><span class="p">.</span><span class="n">dom</span><span class="p">.</span><span class="n">element</span><span class="p">.</span><span class="n">draw</span><span class="p">.</span><span class="n">DrawFrameElement</span><span class="p">;</span>
+<span class="n">import</span> <span class="n">org</span><span class="p">.</span><span class="n">odftoolkit</span><span class="p">.</span><span class="n">odfdom</span><span class="p">.</span><span class="n">dom</span><span class="p">.</span><span class="n">element</span><span class="p">.</span><span class="n">office</span><span class="p">.</span><span class="n">OfficeTextElement</span><span class="p">;</span>
+<span class="n">import</span> <span class="n">org</span><span class="p">.</span><span class="n">odftoolkit</span><span class="p">.</span><span class="n">odfdom</span><span class="p">.</span><span class="n">dom</span><span class="p">.</span><span class="n">element</span><span class="p">.</span><span class="n">text</span><span class="p">.</span><span class="n">TextPElement</span><span class="p">;</span>
+
+<span class="p">[...]</span>
+
+<span class="o">//</span> <span class="n">Load</span> <span class="n">file</span>
+<span class="n">OdfTextDocument</span> <span class="n">odt</span> <span class="p">=</span> <span class="p">(</span><span class="n">OdfTextDocument</span><span class="p">)</span> <span class="n">OdfDocument</span><span class="p">.</span><span class="n">loadDocument</span><span class="p">(</span>"<span class="n">ImageIn</span><span class="p">.</span><span class="n">odt</span>"<span class="p">);</span>
+
+<span class="o">//</span> <span class="n">get</span> <span class="n">root</span> <span class="n">of</span> <span class="n">all</span> <span class="n">content</span> <span class="n">of</span> <span class="n">a</span> <span class="n">text</span> <span class="n">document</span>
+<span class="n">OfficeTextElement</span> <span class="n">officeText</span> <span class="p">=</span> <span class="n">odt</span><span class="p">.</span><span class="n">getContentRoot</span><span class="p">();</span>
+
+<span class="o">//</span> <span class="n">get</span> <span class="n">first</span> <span class="n">paragraph</span>
+<span class="n">TextPElement</span> <span class="n">firstParagraph</span> <span class="p">=</span>
+ <span class="n">OdfElement</span><span class="p">.</span><span class="n">findFirstChildNode</span><span class="p">(</span><span class="n">TextPElement</span><span class="p">.</span><span class="n">class</span><span class="p">,</span> <span class="n">officeText</span><span class="p">);</span>
-<span class="sr">//</span> <span class="n">XPath</span> <span class="n">alternative</span> <span class="n">to</span> <span class="n">get</span> <span class="n">the</span> <span class="n">first</span> <span class="n">paragraph</span>
+<span class="o">//</span> <span class="n">XPath</span> <span class="n">alternative</span> <span class="n">to</span> <span class="n">get</span> <span class="n">the</span> <span class="n">first</span> <span class="n">paragraph</span>
<span class="o">/*</span>
- <span class="n">XPath</span> <span class="n">xpath</span> <span class="o">=</span> <span class="n">XPathFactory</span><span class="o">.</span><span class="n">newInstance</span><span class="p">()</span><span class="o">.</span><span class="n">newXPath</span><span class="p">();</span>
- <span class="n">xpath</span><span class="o">.</span><span class="n">setNamespaceContext</span><span class="p">(</span><span class="k">new</span> <span class="n">OdfNamespace</span><span class="p">());</span>
- <span class="n">OdfFileDom</span> <span class="n">dom</span> <span class="o">=</span> <span class="n">odt</span><span class="o">.</span><span class="n">getContentDom</span><span class="p">();</span>
- <span class="n">firstParagraph</span> <span class="o">=</span> <span class="p">(</span><span class="n">TextPElement</span><span class="p">)</span> <span class="n">xpath</span><span class="o">.</span><span class="n">evaluate</span><span class="p">(</span><span class="s">"//text:p[1]"</span><span class="p">,</span> <span class="n">dom</span><span class="p">,</span> <span class="n">XPathConstants</span><span class="o">.</span><span class="n">NODE</span><span class="p">);</span>
+ <span class="n">XPath</span> <span class="n">xpath</span> <span class="p">=</span> <span class="n">XPathFactory</span><span class="p">.</span><span class="n">newInstance</span><span class="p">().</span><span class="n">newXPath</span><span class="p">();</span>
+ <span class="n">xpath</span><span class="p">.</span><span class="n">setNamespaceContext</span><span class="p">(</span><span class="n">new</span> <span class="n">OdfNamespace</span><span class="p">());</span>
+ <span class="n">OdfFileDom</span> <span class="n">dom</span> <span class="p">=</span> <span class="n">odt</span><span class="p">.</span><span class="n">getContentDom</span><span class="p">();</span>
+ <span class="n">firstParagraph</span> <span class="p">=</span> <span class="p">(</span><span class="n">TextPElement</span><span class="p">)</span> <span class="n">xpath</span><span class="p">.</span><span class="n">evaluate</span><span class="p">(</span>"<span class="o">//</span><span class="n">text</span><span class="p">:</span><span class="n">p</span><span class="p">[</span>1<span class="p">]</span>"<span class="p">,</span> <span class="n">dom</span><span class="p">,</span> <span class="n">XPathConstants</span><span class="p">.</span><span class="n">NODE</span><span class="p">);</span>
<span class="o">*/</span>
-<span class="sr">//</span> <span class="n">insert</span> <span class="n">a</span> <span class="n">frame</span>
-<span class="n">DrawFrameElement</span> <span class="n">frame</span> <span class="o">=</span> <span class="n">firstParagraph</span><span class="o">.</span><span class="n">newDrawFrameElement</span><span class="p">();</span>
+<span class="o">//</span> <span class="n">insert</span> <span class="n">a</span> <span class="n">frame</span>
+<span class="n">DrawFrameElement</span> <span class="n">frame</span> <span class="p">=</span> <span class="n">firstParagraph</span><span class="p">.</span><span class="n">newDrawFrameElement</span><span class="p">();</span>
-<span class="sr">//</span> <span class="n">insert</span> <span class="n">an</span> <span class="n">image:</span> <span class="n">This</span> <span class="n">is</span> <span class="n">a</span> <span class="n">class</span> <span class="n">from</span> <span class="n">the</span> <span class="n">Document</span> <span class="n">API</span>
-<span class="n">OdfDrawImage</span> <span class="n">image</span> <span class="o">=</span> <span class="p">(</span><span class="n">OdfDrawImage</span><span class="p">)</span> <span class="n">frame</span><span class="o">.</span><span class="n">newDrawImageElement</span><span class="p">();</span>
-<span class="n">image</span><span class="o">.</span><span class="n">newImage</span><span class="p">(</span><span class="k">new</span> <span class="n">URI</span><span class="p">(</span><span class="s">"./MySampleImage.png"</span><span class="p">));</span>
+<span class="o">//</span> <span class="n">insert</span> <span class="n">an</span> <span class="n">image</span><span class="p">:</span> <span class="n">This</span> <span class="n">is</span> <span class="n">a</span> <span class="n">class</span> <span class="n">from</span> <span class="n">the</span> <span class="n">Document</span> <span class="n">API</span>
+<span class="n">OdfDrawImage</span> <span class="n">image</span> <span class="p">=</span> <span class="p">(</span><span class="n">OdfDrawImage</span><span class="p">)</span> <span class="n">frame</span><span class="p">.</span><span class="n">newDrawImageElement</span><span class="p">();</span>
+<span class="n">image</span><span class="p">.</span><span class="n">newImage</span><span class="p">(</span><span class="n">new</span> <span class="n">URI</span><span class="p">(</span>"<span class="o">./</span><span class="n">MySampleImage</span><span class="p">.</span><span class="n">png</span>"<span class="p">));</span>
-<span class="sr">//</span> <span class="n">Save</span> <span class="n">file</span>
-<span class="n">odt</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="s">"ImageOut.odt"</span><span class="p">);</span>
+<span class="o">//</span> <span class="n">Save</span> <span class="n">file</span>
+<span class="n">odt</span><span class="p">.</span><span class="n">save</span><span class="p">(</span>"<span class="n">ImageOut</span><span class="p">.</span><span class="n">odt</span>"<span class="p">);</span>
</pre></div>
Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/MavenRepository.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/MavenRepository.html (original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/MavenRepository.html Tue Apr 11 23:13:30 2017
@@ -50,7 +50,18 @@
<div id="clear"></div>
<div id="sidenav">
- <h1 id="general">General</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/index.html">About</a></li>
<li><a href="/odftoolkit/downloads.html">Downloads</a></li>
@@ -58,21 +69,21 @@
<li><a href="/odftoolkit/license.html">License</a></li>
<li><a href="/odftoolkit/privacy.html">Privacy Policy</a></li>
</ul>
-<h1 id="components">Components</h1>
+<h1 id="components">Components<a class="headerlink" href="#components" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/odfdom/index.html">ODFDOM</a></li>
<li><a href="/odftoolkit/simple/index.html">Simple API</a></li>
<li><a href="/odftoolkit/conformance/ODFValidator.html">ODF Validator</a></li>
<li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
</ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/get-involved.html">Get Involved</a></li>
<li><a href="/odftoolkit/mailing-lists.html">Mailing Lists</a></li>
<li><a href="/odftoolkit/people.html">People</a></li>
<li><a href="/odftoolkit/community-faqs.html">Community FAQs</a></li>
</ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/source.html">Source Code</a></li>
<li><a href="https://issues.apache.org/jira/browse/ODFTOOLKIT">Bug Tracker</a></li>
@@ -80,13 +91,12 @@
<li><a href="/odftoolkit/website-local.html">Website</a></li>
<li><a href="/odftoolkit/developer-faqs.html">Developer FAQs</a></li>
</ul>
-<h1 id="ppmc">PPMC</h1>
+<h1 id="ppmc">PPMC<a class="headerlink" href="#ppmc" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a></li>
-<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> <br />
-</li>
+<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> </li>
</ul>
-<h1 id="asf">ASF</h1>
+<h1 id="asf">ASF<a class="headerlink" href="#asf" title="Permanent link">¶</a></h1>
<ul>
<li><a href="http://www.apache.org">Apache Software Foundation</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
@@ -96,7 +106,18 @@
<div id="contenta">
<h1 class="title">Maven Repository</h1>
- <p>We have an interim maven repository. So far, all that is deployed in it are the artifacts for the code generator.</p>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p>We have an interim maven repository. So far, all that is deployed in it are the artifacts for the code generator.</p>
<p>To use this, you'll need something like the following:</p>
<div class="codehilite"><pre> <span class="nt"><repositories></span>
<span class="nt"><repository></span>
Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/MultipleVersions.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/MultipleVersions.html (original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/MultipleVersions.html Tue Apr 11 23:13:30 2017
@@ -50,7 +50,18 @@
<div id="clear"></div>
<div id="sidenav">
- <h1 id="general">General</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/index.html">About</a></li>
<li><a href="/odftoolkit/downloads.html">Downloads</a></li>
@@ -58,21 +69,21 @@
<li><a href="/odftoolkit/license.html">License</a></li>
<li><a href="/odftoolkit/privacy.html">Privacy Policy</a></li>
</ul>
-<h1 id="components">Components</h1>
+<h1 id="components">Components<a class="headerlink" href="#components" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/odfdom/index.html">ODFDOM</a></li>
<li><a href="/odftoolkit/simple/index.html">Simple API</a></li>
<li><a href="/odftoolkit/conformance/ODFValidator.html">ODF Validator</a></li>
<li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
</ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/get-involved.html">Get Involved</a></li>
<li><a href="/odftoolkit/mailing-lists.html">Mailing Lists</a></li>
<li><a href="/odftoolkit/people.html">People</a></li>
<li><a href="/odftoolkit/community-faqs.html">Community FAQs</a></li>
</ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/source.html">Source Code</a></li>
<li><a href="https://issues.apache.org/jira/browse/ODFTOOLKIT">Bug Tracker</a></li>
@@ -80,13 +91,12 @@
<li><a href="/odftoolkit/website-local.html">Website</a></li>
<li><a href="/odftoolkit/developer-faqs.html">Developer FAQs</a></li>
</ul>
-<h1 id="ppmc">PPMC</h1>
+<h1 id="ppmc">PPMC<a class="headerlink" href="#ppmc" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a></li>
-<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> <br />
-</li>
+<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> </li>
</ul>
-<h1 id="asf">ASF</h1>
+<h1 id="asf">ASF<a class="headerlink" href="#asf" title="Permanent link">¶</a></h1>
<ul>
<li><a href="http://www.apache.org">Apache Software Foundation</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
@@ -96,8 +106,18 @@
<div id="contenta">
<h1 class="title">ODF Version Processing in ODFDOM</h1>
- <p>Hello everyone in this community! I'm working on ODFDOM now. This is my first to write wiki. In the future, I'll have more issues about requirements, designs and implementation details to discuss with you. Now I have a topic about ODF versions.<br />
-</p>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p>Hello everyone in this community! I'm working on ODFDOM now. This is my first to write wiki. In the future, I'll have more issues about requirements, designs and implementation details to discuss with you. Now I have a topic about ODF versions. </p>
<ul>
<li>ODFDOM now only supports ODF 1.1, and surely we'll support ODF 1.2, also one of our team members is doing that now. But do we plan to support ODF 1.0? My opinion is that although ODF 1.0 is used in not many cases before, ODF 1.0(2nd) is ISO standard ISO26300, so ODFDOM should consider the back compatible with ODF1.0, and can load/create ODF1.0 documents. Of course, if we plan to do that, it should be done as early as possible. Welcome your opinion.</li>
<li>ODFDOM should support all versions of ODF because in the practice, many ODF documents with different versions are mixed together, ODFDOM need to process them automatically for whatever ODF version. So a single code base should support all ODF versions instead of different code streams for different ODF versions.</li>
Modified: websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/ODFDOM-Class-Structure.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/ODFDOM-Class-Structure.html (original)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/odfdom/ODFDOM-Class-Structure.html Tue Apr 11 23:13:30 2017
@@ -50,7 +50,18 @@
<div id="clear"></div>
<div id="sidenav">
- <h1 id="general">General</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="general">General<a class="headerlink" href="#general" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/index.html">About</a></li>
<li><a href="/odftoolkit/downloads.html">Downloads</a></li>
@@ -58,21 +69,21 @@
<li><a href="/odftoolkit/license.html">License</a></li>
<li><a href="/odftoolkit/privacy.html">Privacy Policy</a></li>
</ul>
-<h1 id="components">Components</h1>
+<h1 id="components">Components<a class="headerlink" href="#components" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/odfdom/index.html">ODFDOM</a></li>
<li><a href="/odftoolkit/simple/index.html">Simple API</a></li>
<li><a href="/odftoolkit/conformance/ODFValidator.html">ODF Validator</a></li>
<li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
</ul>
-<h1 id="community">Community</h1>
+<h1 id="community">Community<a class="headerlink" href="#community" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/get-involved.html">Get Involved</a></li>
<li><a href="/odftoolkit/mailing-lists.html">Mailing Lists</a></li>
<li><a href="/odftoolkit/people.html">People</a></li>
<li><a href="/odftoolkit/community-faqs.html">Community FAQs</a></li>
</ul>
-<h1 id="development">Development</h1>
+<h1 id="development">Development<a class="headerlink" href="#development" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/source.html">Source Code</a></li>
<li><a href="https://issues.apache.org/jira/browse/ODFTOOLKIT">Bug Tracker</a></li>
@@ -80,13 +91,12 @@
<li><a href="/odftoolkit/website-local.html">Website</a></li>
<li><a href="/odftoolkit/developer-faqs.html">Developer FAQs</a></li>
</ul>
-<h1 id="ppmc">PPMC</h1>
+<h1 id="ppmc">PPMC<a class="headerlink" href="#ppmc" title="Permanent link">¶</a></h1>
<ul>
<li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a></li>
-<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> <br />
-</li>
+<li><a href="/odftoolkit/odftoolkit-release-guide.html">Release Guide</a> </li>
</ul>
-<h1 id="asf">ASF</h1>
+<h1 id="asf">ASF<a class="headerlink" href="#asf" title="Permanent link">¶</a></h1>
<ul>
<li><a href="http://www.apache.org">Apache Software Foundation</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
@@ -96,10 +106,20 @@
<div id="contenta">
<h1 class="title">Class Structure in ODFDOM </h1>
- <p>The Java packages reflect the layers of the ODFDOM library.</p>
-<h2 id="shared-functionality">Shared Functionality</h2>
-<p>Shared by all layers are the basic XML classes as in the <code>org.odftoolkit.odfdom</code> package, like <br />
-</p>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p>The Java packages reflect the layers of the ODFDOM library.</p>
+<h2 id="shared-functionality">Shared Functionality<a class="headerlink" href="#shared-functionality" title="Permanent link">¶</a></h2>
+<p>Shared by all layers are the basic XML classes as in the <code>org.odftoolkit.odfdom</code> package, like </p>
<ul>
<li><code>OdfElement</code>: parent of all ODFDOM elements</li>
<li><code>OdfAttribute</code>: parent of all ODFDOM attributes </li>
@@ -111,7 +131,7 @@
<li><code>org.odftoolkit.odfdom.type</code>: All datatypes defined in the ODF 1.2 specification, mostly overtaken from W3C Schema types, like AnyURI.
Helper functionality can be found at those types, like in case for AnyURI en/decode() methods.</li>
</ul>
-<h2 id="the-packagephysical-layer">The Package/Physical Layer</h2>
+<h2 id="the-packagephysical-layer">The Package/Physical Layer<a class="headerlink" href="#the-packagephysical-layer" title="Permanent link">¶</a></h2>
<p>These classes are in the <code>org.odftoolkit.odfdom.pkg</code> package to access files from the ODF package.
The classes you will find here include:</p>
<ul>
@@ -119,7 +139,7 @@ The classes you will find here include:<
<li><code>OdfPackageStream</code>: Allows you to write to a member of the ODF document as an output stream.</li>
<li><code>OdfXMLHelper</code>: Provides utility methods to parse the XML content of a package member and apply an XSLT transformation to it.</li>
</ul>
-<h2 id="the-odf-typed-dom-xml-layer">The ODF Typed DOM / XML Layer</h2>
+<h2 id="the-odf-typed-dom-xml-layer">The ODF Typed DOM / XML Layer<a class="headerlink" href="#the-odf-typed-dom-xml-layer" title="Permanent link">¶</a></h2>
<p>These classes are in general the generated DOM elements and attributes of ODF 1.2. </p>
<ul>
<li><code>org.odftoolkit.odfdom.dom.element</code>: These classes give you access to the individual ODF elements. Its sub-packages are divided by namespace, so you would find the code for a <code>draw:ellipse</code> element in the <code>org.odftoolkit.odfdom.dom.element.draw.DrawEllipseElement</code> class.</li>
@@ -131,7 +151,7 @@ The classes you will find here include:<
</ul>
<p>If you are using an IDE such as NetBeans or Eclipse, you don't have to memorize this hierarchy; the IDE can generate the proper <code>import</code> statements for you. </p>
<p>The code in these classes is generated directly from <a href="http://www.relaxng.org/">the Relax NG</a> (RNG) schema for ODF.</p>
-<h2 id="the-odf-document-convenience-functionality-layer">The ODF Document / Convenience Functionality Layer</h2>
+<h2 id="the-odf-document-convenience-functionality-layer">The ODF Document / Convenience Functionality Layer<a class="headerlink" href="#the-odf-document-convenience-functionality-layer" title="Permanent link">¶</a></h2>
<p>This is the layer that developers will use most often. A sub-level like <code>org.odftoolkit.odfdom.doc.text</code> inherits (currently) from the elements of the <code>org.odftoolkit.odfdom.dom.element.text</code> package. Aside of the namespace prefix an 'Odf' prefix is being used in the beginning. Furthermore is the namespace prefix neglected in case it already exists in the local name. The convenient class for the ODF element <code>table:table</code>, which is represented in the DOM layer by <code>org.odftoolkit.odfdom.table.TableTableElement</code>, is OdfTable and NOT OdfTableTable.
We encourage developers to create methods for these classes, based on actual use cases of the toolkit.</p>
<p>The entry point for the convenient layer should be in the future the document itself. Some example functions had been added to <code>OdfTextDocument</code> to show this, like <code>newParagraph()</code>, adding a paragraph (ie. <code>text:p</code> element) at the end of the document.</p>