incubator-odf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r795346 [2/17] - in /websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document: ./ cookbook/ javadoc/ javadoc/META-INF/ javadoc/index-files/ javadoc/org/ javadoc/org/odftoolkit/ javadoc/org/odftoolkit/simple/ javadoc/org/odftoolk...
Date Tue, 06 Sep 2011 02:11:17 GMT
Added: websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/ReleaseNotes.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/ReleaseNotes.html (added)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/ReleaseNotes.html Tue Sep  6 02:11:09 2011
@@ -0,0 +1,235 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You 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
+
+       http://www.apache.org/licenses/LICENSE- 2.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.
+-->
+
+<link href="/odftoolkit/css/odf.css" rel="stylesheet" type="text/css">
+
+<title>Simple API Release Notes</title>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+
+</head>
+
+<body>
+  <div id="banner">
+   <!-- <div id="bannerleft"><a alt="Apache ODF Toolkit (incubating)" href="http://incubator.apache.org/odftoolkit/">
+      <img id="logo" alt="Apache ODF Toolkit (Incubating)" src="/odftoolkit/images/ooo-logo.png"/></a></div> -->
+    <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+      <img id="asf-logo" alt="Apache Incubator" src="/odftoolkit/images/apache-incubator-logo.png"/></a></div>
+   <div id="bannercenter"><br/>&nbsp;&nbsp;&nbsp;&nbsp;Apache ODF Toolkit (incubating)</div>
+  </div>
+  <div id="clear"></div>
+  
+  <div id="sidenav">
+    <h1 id="general">General</h1>
+<ul>
+<li><a href="/odftoolkit/index.html">About</a></li>
+<li><a href="http://incubator.apache.org/projects/odftoolkit.html">Incubator page</a></li>
+<li><a href="/odftoolkit/license.html">License</a></li>
+</ul>
+<h1 id="components">Components</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">Conformance Tools</a></li>
+<li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
+</ul>
+<h1 id="community">Community</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>
+<ul>
+<li><a href="/odftoolkit/source.html">Source Code</a></li>
+<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>
+<ul>
+<li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a><br />
+</li>
+</ul>
+<h1 id="asf">ASF</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>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a></li>
+</ul>
+  </div>
+  <div id="contenta">
+  
+    <h1 class="title">Simple API Release Notes</h1>
+    <h2 id="what_is_the_simple_java_api_for_odf">What is the Simple Java API for ODF?</h2>
+<p>The Simple Java API for ODF is an easy-to-use, high-level Java API for creating, modifying and extracting data from ODF 1.2 documents.  It is written in pure Java and does not require that you install any document editor on your system.  The Simple Java API for ODF is a high level abstraction of the lower-level <a href="http://incubator.apache.org/odftoolkit/odfdom/index.html">ODFDOM API</a>.</p>
+<h2 id="new_release_066">New Release 0.6.6</h2>
+<p>We are pleased to announce the release of the Simple Java API for ODF version 0.6.6 on Auguest 12th. The improvements in this version include:</p>
+<ul>
+<li>Two critical bugs in the Navigation API are fixed, as well as
+    several other issues.</li>
+<li>Page columns,  a page layout feature in text documents, are supported.</li>
+<li>Unit test coverage rate increased.  This work improves the stability of our API.</li>
+</ul>
+<p>You can download it here. The full release notes can be found here. </p>
+<p>You are welcomed to give us any feedback by Bugzilla, eMail or forum. </p>
+<h2 id="project_roadmap_and_schedule">Project roadmap and schedule</h2>
+<p>The Simple Java API for ODF adhears to the "Release Early and Often" development philosophy.  We will target a monthly release, for the end of each month.  Code that is ready makes it into that month's release.  Code that is not yet ready will wait.</p>
+<p>Proposed Roadmap:</p>
+<ul>
+<li>Version 0.2 at the end of Oct, 2010 with the high-level methods
+    migrated from ODFDOM and organized in new package structure;</li>
+<li>Version 0.3 at the end of Nov, 2010 with high-level style API;</li>
+<li>Version 0.4 at the end of Jan, 2011 with additional high-level text methods;</li>
+<li>Version 0.5 at the end of March, 2011 with text box and fields methods;</li>
+<li>Version 0.6 at the end of May, 2011 with chart methods;</li>
+<li>Version 0.6.6 at the middle of August, 2011 with bugs fixed;</li>
+</ul>
+<p>More work will be started in Apache.</p>
+<h1 id="frequently_asked_questions">Frequently Asked Questions</h1>
+<h3 id="for_users">For Users</h3>
+<h4 id="how_to_download_and_install">How to download and install</h4>
+<p>You can get Simple Java API for ODF as binary distribution from the [http://odftoolkit.org/projects/simple/downloads download] area. There you'll find Javadocs as well. To obtain source code, please refer to [[#download_source|development section]]. </p>
+<h3 id="how_to_start_development">How to start development</h3>
+<p>I suggest you to start from an overview of this project. [[PackageLayer|This page]] will give you an overall introduction of the package structures. After that, you can go to the [http://simple.odftoolkit.org/cookbook/ Cookbook] and [http://simple.odftoolkit.org/ Demos] to read some code samples. And then, you can start your own program to manipulate ODF document.</p>
+<p>If you are familar with ODFDOM, [http://odftoolkit.org/projects/simple/pages/PackageLayer#APIchanges Here] are the API changes from ODFDOM.</p>
+<h3 id="prerequisites">Prerequisites</h3>
+<p>In addition to the Simple Java API JAR file you will need to download and install the following runtime prerequisite:</p>
+<ul>
+<li>JDK version 1.6</li>
+<li>[https://oss.sonatype.org/content/groups/public/org/odftoolkit/odfdom-java/0.8.7/odfdom-java-0.8.7.jar ODFDOM 0.8.7]</li>
+<li>The Apache Xerces 2.9.1 or higher version. (download from [http://xerces.apache.org/mirrors.cgi Apache Xerces web site])</li>
+</ul>
+<h4 id="code_examples">Code examples</h4>
+<h1 id="you-can-find-sample-codes-from-our-httpsimpleodftoolkitorg-cookbook-and-httpsimpleodftoolkitorg-demos">You can find sample codes from our [http://simple.odftoolkit.org/ Cookbook] and [http://simple.odftoolkit.org/ Demos].</h1>
+<p>The Simple Java API for ODF uses Bugzilla to track the defects. You can report defects [http://odftoolkit.org/bugzilla/buglist.cgi?product=simple&amp;order=bugs.bug_id here].</p>
+<p>===For Developers===</p>
+<h3 id="how_to_download_source">How to download source</h3>
+<p>First, install [http://mercurial.selenic.com/wiki/ latest Mercurial]</p>
+<p>Second, setup Mercurial (optional):<br />Config file <Hg Install Dir>Mercurial.ini on Windows or <Hg Install Dir>/.hgrc on Unix.
+Enhance the default configuration, using GIT diff and enable [http://mercurial.selenic.com/wiki/Win32TextExtension default plugin] avoid different line breaks in the source.<br /></p>
+<div class="codehilite"><pre><span class="k">[ui]</span>
+<span class="na">username</span> <span class="o">=</span> <span class="s">your Name &lt;yourLoginName@odftoolkit.org&gt;</span>
+<span class="c">;merge = your-merge-program (or internal:merge)</span>
+
+<span class="k">[diff]</span>
+<span class="na">git</span> <span class="o">=</span> <span class="s">1</span>
+
+<span class="k">[defaults]</span>
+<span class="na">diff</span><span class="o">=</span><span class="s">-p -U 8</span>
+
+<span class="k">[extensions]</span>
+<span class="c"># Enables mercurial EOL extension for line break handling</span>
+<span class="c"># See http://mercurial.selenic.com/wiki/EolExtension (bundled since 1.5.4)</span>
+<span class="na">eol</span> <span class="o">=</span>
+
+<span class="c"># It&#39;ll remove unknown files and empty directories by default. </span>
+<span class="c"># Usually you call &#39;hg update -C&#39; and &#39;hg purge&#39; in sequence</span>
+<span class="c"># See http://mercurial.selenic.com/wiki/PurgeExtension  (bundled)</span>
+<span class="na">hgext.purge</span><span class="o">=</span>
+
+<span class="k">[eol]</span>
+<span class="c"># Converts mixed line ending within a file to LF (Unix) format </span>
+<span class="c"># before adding the file to the source repository</span>
+<span class="c"># See http://mercurial.selenic.com/wiki/EolExtension</span>
+<span class="na">only-consistent</span> <span class="o">=</span> <span class="s">False</span>
+</pre></div>
+
+
+<p>Now, get the source code from the Simple project [http://www.selenic.com/mercurial/wiki/ Mercurial] repository. Please see below for a short introduction to using Mercurial on odftoolkit.org. There's also a more general <a href="{{project help page SourceControl}}">help</a> on how to use source control systems on odftoolkit.org. The command <br /><pre>
+hg clone https://hg.odftoolkit.org/hg/simple~code-base</pre>will download the repository into a new directory. <br />Please note that by this you'll get the latest changeset. If you for example want stable release 0.2, you may want to use<br /><pre>hg clone https://odftoolkit.org/hg/simple~code-base -r v0.2</pre>Developers however always work on the latest changeset.</p>
+<p>====How to build and run the unit tests=====
+After the source code is checked out, now get and install [http://maven.apache.org/ Apache Maven]. 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".</p>
+<p>==Communications==
+You can subscribe to the project's mailing lists from [http://odftoolkit.org/projects/simple/lists this page].  The "users" list is for discussions about using the toolkit, and the "dev" list is for discussing the development of the toolkit.  Active developers should also subscribe to the "issues" and "commit" mailing lists so they will receive those automatic notifications.</p>
+<p>==Easy entry level tasks==
+TBD</p>
+<p>==<span id="Design_of_the_API">Design of the API</span>==
+The design principle is "make it easy for users to locate the functions they want".</p>
+<p>org.odftoolkit.simple.Document is the abstract base class which the specific document classes are derived from:  TextDocument, SpreadsheetDocument, PresentationDocument, GraphicsDocument and ChartDocument.</p>
+<p>For each document type  we have a subpackage that contain additional classes related to that kind of documents.  So org.odftoolkit.simple.chart has classes related to chart, org.odftoolkit.simple.text has classes related to text content,  and org.odftoolkit.simple.presentation has classes related to presentation documents.</p>
+<p>Besides the packages for different document types, there are additional packages defined for important common ODF features which are available across all kinds of documents, such as table, meta and style. </p>
+<p>There is another package named org.odftoolkit.simple.common, which contains functions that are not related with a specific document type nor a specific feature. For example, the text extractor functions are put in this package.</p>
+<p>==How to contribute patches==
+If you want to contribute a patch to this project, following below steps:</p>
+<ul>
+<li>Step 1. Create an issue in
+    [http://odftoolkit.org/bugzilla/buglist.cgi?product=simple&amp;order=bugs.bug_id
+    bugzilla], or write a comment to a related open issue, to describe
+    what functions you want to provide.</li>
+<li>Step 2. Go through "[[#Design_of_the_API|Design of the API]]" to make sure your contribution will follow it.</li>
+<li>Step 3. Check out the source code following the steps in [[#download_source|development selection]], and add your
+    contribution codes, including the source code and the unit tests.
+    Every public method should have a corresponding unit test method.
+    The
+    [http://odftoolkit.org/projects/odfdom/pages/Development#Coding_Guidelines
+    code guidelines] are same as ODFDOM.</li>
+<li>Step 4. Test your contribution with Mecurial command to make sure all the unit tests pass.  mvn</li>
+<li>Step 5. Generate a patch with hg commands.  hg commit -A -u "Developer:xxx" -m "#bug XY# Description of changes"  hg export -a
+    -g -o ../myChanges.patch</li>
+<li>Step 6. Upload your patch to bugzilla.</li>
+<li>Step 7. Refactor your patch if you get comments from reviewers.</li>
+</ul>
+<h2 id="how_to_review_patches">How to review patches</h2>
+<p>As a reviewer, you need to carefully read the source code, run the unit tests, to make sure the new contributed code won't hurt the quality of this project.
+<em>Step 1. Write a comment to [http://odftoolkit.org/bugzilla/buglist.cgi?product=simple&amp;order=bugs.bug_id bugzilla], saying you would like to review this patch.
+</em>Step 2. Check out the source code following the steps in [[#download_source|development selection]], and download the patch.
+<em>Step 3. Merge the patch to the source code with Mecurial command:
+ hg import --no-commit ../someFile.patch
+</em>Step 4. Carefully read the code to make sure the code follows the "[[#Design_of_the_API|Design of the API]]", the code can reach the goal and the code won't bring other problems.
+<em>Step 5. Carefully check the unit test code to make sure every public method has been enough tested.
+</em>Step 6. Run the unit tests with Maven command to see if all the unit tests pass:
+ mvn
+<em>Step 7. Write comment to bugzilla if you think anything needs to be improved.
+</em>Step 8. Repeat step 2 to 7 after the contributor improves the patch.
+*Step 9. Push the patch to repository with Mecurial command if you think the patch is good enough:
+ hg commit -A -u "Developer:xxx Reviewer:yyy" -m "#bug XY# Description of changes"
+ hg push https://<your user id>:<your password>@odftoolkit.org/hg/simple~code-base</p>
+<h2 id="reference_material">Reference material</h2>
+<h3 id="odf">ODF</h3>
+<p>The current draft of the OASIS ODF 1.2 standard can be downloaded [http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=office#odf12 here].</p>
+<h3 id="commands_line_tools">Commands line tools</h3>
+<p><em>[http://odftoolkit.org/projects/odfdom/pages/Development#Mercurial Here] is a list of the most frequently used commands for Mercurial.
+</em>[http://odftoolkit.org/projects/odfdom/pages/Development#Maven Here] is a list of the most frequently used commands for Maven.</p>
+  </div>
+
+  <div id="footera">
+    <div id="poweredby">
+      <p><img src="/odftoolkit/images/feather-small.gif"/><br/>Powered by the Apache CMS.</p>
+    </div>
+    <div id="copyrighta">
+      <p>
+	Apache "ODF Toolkit" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+	Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+	decision making process	have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+	not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+	yet to be fully endorsed by the ASF.</p>
+      <p>
+	Copyright &copy; 2011 The Apache Software Foundation Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+	<a href="/openofficeorg/contact.html">Contact Us</a>
+	<br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+	<br />Other names appearing on the site may be trademarks of their respective owners.
+      </p>
+    </div>
+  </div>
+
+</body>
+</html>

Added: websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/Requirements.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/Requirements.html (added)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/Requirements.html Tue Sep  6 02:11:09 2011
@@ -0,0 +1,306 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You 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
+
+       http://www.apache.org/licenses/LICENSE- 2.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.
+-->
+
+<link href="/odftoolkit/css/odf.css" rel="stylesheet" type="text/css">
+
+<title></title>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+
+</head>
+
+<body>
+  <div id="banner">
+   <!-- <div id="bannerleft"><a alt="Apache ODF Toolkit (incubating)" href="http://incubator.apache.org/odftoolkit/">
+      <img id="logo" alt="Apache ODF Toolkit (Incubating)" src="/odftoolkit/images/ooo-logo.png"/></a></div> -->
+    <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+      <img id="asf-logo" alt="Apache Incubator" src="/odftoolkit/images/apache-incubator-logo.png"/></a></div>
+   <div id="bannercenter"><br/>&nbsp;&nbsp;&nbsp;&nbsp;Apache ODF Toolkit (incubating)</div>
+  </div>
+  <div id="clear"></div>
+  
+  <div id="sidenav">
+    <h1 id="general">General</h1>
+<ul>
+<li><a href="/odftoolkit/index.html">About</a></li>
+<li><a href="http://incubator.apache.org/projects/odftoolkit.html">Incubator page</a></li>
+<li><a href="/odftoolkit/license.html">License</a></li>
+</ul>
+<h1 id="components">Components</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">Conformance Tools</a></li>
+<li><a href="/odftoolkit/xsltrunner/ODFXSLTRunner.html">XSLT Runner</a></li>
+</ul>
+<h1 id="community">Community</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>
+<ul>
+<li><a href="/odftoolkit/source.html">Source Code</a></li>
+<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>
+<ul>
+<li><a href="/odftoolkit/ppmc-faqs.html">PPMC FAQs</a><br />
+</li>
+</ul>
+<h1 id="asf">ASF</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>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a></li>
+</ul>
+  </div>
+  <div id="contenta">
+  
+    
+    <p>==Function analysis==
+This page is used to analysis the functions and requirements, and discuss the priority and the project plan.</p>
+<p><strong>TOC</strong></p>
+<p>===Requirements Tracking===
+Below are requirements from our users.</p>
+<p>====Requirements for table (2010.12.20)====
+<em>getRowList/getColumnList, if there is a row element with 65535 repeate number, then get row list will return a list which contains 65535 row element, it is not necessary and time consuming.
+</em>memory leak, because of using static map variables (Recorded in bugzilla, 2010.12.21)
+<em>use SAX API to get the content/style element as required, rather than load whole dom tree to memory, which might cause out of memory exception if many large document has been loaded in the same time.
+</em>create row/column/cell with/without repeat number(for example,if i want to create 10 rows, how to implement it ? with 10 row element or 1 row element with 10 repeate number)
+<em>append row/column with/without previous row/column style, there should be a flag for setting it.
+</em>cell format type can be auto calculated according to the style of cell</p>
+<p>====Requirements for section and text box (2010.12.20)====
+<em>repeating sections of data. Repeating section may be to clone a section of a template multiple times for different data. So identify an element(s) in the document and be able to clone it and add it into the document. Think like a block of text in a document (maybe a table or a paragraph) that we grab, copy, repeat x times, and then modify a bookmark inside each section.
+</em>text boxes that get a name at design time and something we can call it programmatically and then do something with it (delete, modify, etc.)
+*embedded text tagging with multiple levels - tag a paragraph and then tag a section of text within it - so we can turn stuff off, do repeats, and do repeats within the sections.</p>
+<p>===Functions Collection===
+Follow are functions collected from a perspective of an Office software user.</p>
+<p>====Cut/copy/paste/selection====
+Select something, cut or copy it, and paste to somewhere else. These operations are easily made in Office softwares, but are hard done in APIs. The functions include:
+<em>Create a selection
+</em>Create a position
+<em>Cut a selection
+</em>Copy a selection
+<em>Paste a selection to some position
+</em>Delete a selection
+Part of these functions have been implemented with package org.odftoolkit.simple.common.navigation</p>
+<p>{|- border="1"
+!Functions
+!Plan and status
+|-
+|Create a "selection"
+|
+|-
+|Create a "position"
+|
+|-
+|Cut a selection
+|
+|-
+|Copy a selection
+|
+|-
+|Paste a selection
+|
+|-
+|Delete a selection
+|
+|}</p>
+<p>====Navigator/document map====
+With these functions, users can easily go to a certain place in the whole document. These functions can provide methods to get a certain heading, get a certain image, get a certain table and so on. The functions include:
+<em>Return a list of main features, such as heading,paragraphs,graphics,table,bookmark,sections,hyperlinks,reference,index,comments,text frames, and draw objects.
+</em>get next or previous feature, for example, there is a table under a paragraph, then the API can allow users to get next table after this paragraph.
+Part of these functions have been implemented with getTableList() in org.odftoolkit.simple.Document.</p>
+<p>====Fields====
+With this feature, users can create fields in the document. The available fields include:
+<em>Fields are used to insert information about the current document, for example, file name, template, statistics, user data, date, and time.
+</em>The references or referenced fields that are referenced fields within the same document or within sub-documents of a master document.
+*Variable fields which are dynamic content to the document.</p>
+<p>The functions include:
+<em>Add a field
+</em>Edit a field
+<em>Navigator among fields
+</em>Delete a field</p>
+<p>====Frame====
+With frame, users can create a layout of one or more columns of text and objects. The functions include:
+<em>Set properties to a frame, including names
+</em>Delete a frame
+<em>Navigator among frames
+</em>Add caption</p>
+<p>=====Text frame=====
+The functions include:
+<em>Add a text frame
+</em>Search a text frame by name</p>
+<p>=====Graphics=====
+With graphics, users can insert a picture or create with shapes. The functions include:
+<em>Insert a picture from file
+</em>Create shapes
+<em>Navigator among images and shapes
+</em>Delete images or shapes
+<em>Set properties
+</em>Add caption</p>
+<p>====Section====
+Sections are named blocks of text, including graphics or objects. With section, users can:
+<em>To prevent text from being edited.
+</em>To show or hide text.
+<em>To reuse text and graphics from other Lotus? Symphony? documents.
+</em>To insert sections of text that uses a different column layout than the current page style.
+*Add caption</p>
+<p>The functions include:
+<em>Create Section
+</em>Delete Section
+<em>Copy and paste section
+</em>Navigator through sections
+*Set properties of section</p>
+<p>====Bullet &amp; numbering====
+To create bullet and numbering. The functions include:
+<em>Create bullet to paragraphs, including graphics bullets
+</em>create numbering to paragraphs
+*Set the style properties</p>
+<p>====Heading====
+To create heading of a document. The functions include:
+<em>Create headings
+</em>Set styles of headings
+*Set outline numbering</p>
+<p>====Table of Content====
+To create a TOC at some place.</p>
+<p>====Header/footer====
+With these function, you can set header and footer.
+<em>Set header and footer
+</em>Set the styles of header and footer</p>
+<p>====Footnote/endnote====
+With these function, you can create footnote or endnote in your document.
+<em>Add the footnote and the endnote
+</em>Find the footnote and endnote
+*Delete the foontnote and endnote</p>
+<p>====Hyperlinks====
+With these function, you can create a hyperlink in your document.
+<em>Add a hyperlink
+</em>Delete a hyperlink
+*Find hyperlinks</p>
+<p>====Break====
+With these function, you can add break characters in your document.
+<em>Add breaks
+</em>Delete breaks
+*Find breaks</p>
+<p>====Page numbering====
+With these function, you can add page numbering in your document.
+<em>Add page numbering
+</em>Delete page numbering</p>
+<p>====Comment====
+With this function, you can add comment to your document.
+<em>Add comments
+</em>Navigation among comments
+*delete comments</p>
+<p>====Document bookmark====
+To create bookmark
+<em>Add bookmark
+</em>Navigation through bookmarks
+*Delete bookmarks</p>
+<p>====Fontwork====
+To create a fontwork
+<em>Add frontwork
+</em>Delete fontwork
+*Navigation through fontwork</p>
+<p>====Chart====
+To create a chart
+<em>Add chart
+</em>Update chart properties
+<em>Update style setting of chart
+</em>Navigation through chart
+*Delete chart</p>
+<p>====OLE object====
+To operate OLE object
+<em>Add a OLE object
+</em>Navigation through OLE object
+<em>Delete OLE object
+</em>Update OLE object properties</p>
+<p>====Layout and columns====
+To edit the layout and columns properties
+*Set properties of layout</p>
+<p>====Table====
+To provide functions to manipulate table. Following functions have been provided:
+<em>create table
+</em>insert row/column
+<em>access cell
+</em>styles handling
+<em>merge cell
+</em>delete row/column
+<em>numbering format
+</em>insert formula</p>
+<p>=====Filter and validity=====
+To provide filter/validity functions to data in a table
+<em>Add/delete/update filter
+</em>Add/delete/update validity</p>
+<p>=====Group=====
+To group rows or columns
+<em>Add group
+</em>Delete group</p>
+<p>=====Data pilot=====
+To create or delete data pilot in a spreadsheet document.
+<em>Create data pilot
+</em>Delete data pilot</p>
+<p>=====Split=====
+To split a cell</p>
+<p>====Slide====
+To manipulate slides. Following functions have been provided:
+<em>Add/delete slides
+</em>Navigation through slides
+*Merge slides</p>
+<p>=====Master Slide=====
+To manipulate master slides
+*update styles of master slides</p>
+<p>=====Animation=====
+To manipulate the animation settings.
+<em>Set effects
+</em>Set order
+*Remove animation setting</p>
+<p>====Page setup====
+To define the page setup.
+<em>Set page orientation
+</em>Set page margin</p>
+  </div>
+
+  <div id="footera">
+    <div id="poweredby">
+      <p><img src="/odftoolkit/images/feather-small.gif"/><br/>Powered by the Apache CMS.</p>
+    </div>
+    <div id="copyrighta">
+      <p>
+	Apache "ODF Toolkit" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+	Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+	decision making process	have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+	not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+	yet to be fully endorsed by the ASF.</p>
+      <p>
+	Copyright &copy; 2011 The Apache Software Foundation Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+	<a href="/openofficeorg/contact.html">Contact Us</a>
+	<br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+	<br />Other names appearing on the site may be trademarks of their respective owners.
+      </p>
+    </div>
+  </div>
+
+</body>
+</html>

Added: websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Cell Range.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Cell Range.html (added)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Cell Range.html Tue Sep  6 02:11:09 2011
@@ -0,0 +1,66 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You 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
+
+       http://www.apache.org/licenses/LICENSE- 2.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.
+-->
+
+<link href="/odftoolkit/css/odf.css" rel="stylesheet" type="text/css">
+
+<title></title>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+
+</head>
+
+<body>
+  <div id="banner">
+   <!-- <div id="bannerleft"><a alt="Apache ODF Toolkit (incubating)" href="http://incubator.apache.org/odftoolkit/">
+      <img id="logo" alt="Apache ODF Toolkit (Incubating)" src="/odftoolkit/images/ooo-logo.png"/></a></div> -->
+    <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+      <img id="asf-logo" alt="Apache Incubator" src="/odftoolkit/images/apache-incubator-logo.png"/></a></div>
+   <div id="bannercenter"><br/>&nbsp;&nbsp;&nbsp;&nbsp;Apache ODF Toolkit (incubating)</div>
+  </div>
+  <div id="clear"></div>
+  
+  <div id="content">
+  
+    
+    
+  </div>
+
+  <div id="footera">
+    <div id="poweredby">
+      <p><img src="/odftoolkit/images/feather-small.gif"/><br/>Powered by the Apache CMS.</p>
+    </div>
+    <div id="copyrighta">
+      <p>
+	Apache "ODF Toolkit" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+	Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+	decision making process	have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+	not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+	yet to be fully endorsed by the ASF.</p>
+      <p>
+	Copyright &copy; 2011 The Apache Software Foundation Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+	<a href="/openofficeorg/contact.html">Contact Us</a>
+	<br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+	<br />Other names appearing on the site may be trademarks of their respective owners.
+      </p>
+    </div>
+  </div>
+
+</body>
+</html>

Added: websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Cell.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Cell.html (added)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Cell.html Tue Sep  6 02:11:09 2011
@@ -0,0 +1,394 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You 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
+
+       http://www.apache.org/licenses/LICENSE- 2.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.
+-->
+
+<link href="/odftoolkit/css/odf.css" rel="stylesheet" type="text/css">
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<title>Cell</title>
+ <link type="text/css" rel="stylesheet" href="cookbook.css"/>
+<link rel="stylesheet" href="../images/style.css" type="text/css" />
+<script type="text/javascript">
+
+var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-22366020-1']);
+_gaq.push(['_trackPageview']);
+
+(function() {
+var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+})();
+
+</script>
+
+
+</head>
+
+<body>
+  <div id="banner">
+   <!-- <div id="bannerleft"><a alt="Apache ODF Toolkit (incubating)" href="http://incubator.apache.org/odftoolkit/">
+      <img id="logo" alt="Apache ODF Toolkit (Incubating)" src="/odftoolkit/images/ooo-logo.png"/></a></div> -->
+    <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+      <img id="asf-logo" alt="Apache Incubator" src="/odftoolkit/images/apache-incubator-logo.png"/></a></div>
+   <div id="bannercenter"><br/>&nbsp;&nbsp;&nbsp;&nbsp;Apache ODF Toolkit (incubating)</div>
+  </div>
+  <div id="clear"></div>
+  
+  <div id="content">
+  
+    
+    
+<div id="page" align="center">
+<div id="content" style="width:920px" class="contentpanel">
+<div id="topheader">
+<div class="topright"> </div>
+</div>
+<div id="menu">
+<div align="left" class="smallwhitetext"> <a href="../index.html" class="home"> </a> <a href="../downloads.html" class="download"></a> <a href="../documents.html" class="document"></a> <a href="../demo/index.html" class="sample"> </a> </div>
+</div>
+<div id="subcontent" align ="left">
+<div align="left" class="titletext"> <span >
+<a href="../documents.html">Documents</a> > 
+<a href="index.html">Cookbook</a> ><a href="Cell.html">Cell</a>
+</span>
+</div>
+<div class="navigation">
+ <ul>
+  <li><a href="Column and Row.html">previous</a></li>
+  <li><a href="Cell Range.html">next</a></li>
+ </ul>
+</div>
+<br/>
+<div class="contenttitle" id="Get Cell">
+<br/>
+<a href="#Get Cell" >Get Cell</a>
+<hr/>
+</div>
+<div class="bodytext">
+If you want to get the specified cell in a table,you can use the getCellByPosition method of Table.
+</div>
+<div class="bodytext">
+The first parameter is the column index,the second parameter is the row index.
+</div>
+<br/><pre class='code' id="code0">
+         <span class='javaclass'>TextDocument</span> document = (<span class='javaclass'>TextDocument</span>) <span class='javaclass'>TextDocument</span>.loadDocument(filePath);<br/>
+	 <span class='javaclass'>Table</span> table=document.getTableByName("stringTable");<br/>
+	 <span class='javaclass'>Cell</span> cell=table.getCellByPosition(1, 1);<br/>
+</pre>
+<br/><div class="bodytext">
+If you are manipulating a spreadsheet,you can get the cell by its address:
+</div>
+<br/><pre class='code' id="code1">
+	 <span class='javaclass'>Table</span> sheet1 = document.getTableByName("Sheet1");<br/>
+	 <span class='javaclass'>Cell</span> odsCell=sheet1.getCellByPosition("A1");<br/>
+</pre>
+<br/><div class="bodytext">
+If you want to get a cell from a row,you can specify the index of the cell in the row.
+</div>
+<br/><pre class='code' id="code2">
+	 <span class='javaclass'>Row</span> row=table.getRowByIndex(1);<br/>
+	 <span class='javaclass'>Cell</span> cell2=row.getCellByIndex(1);<br/>
+	 <span class='javaclass'>System</span>.out.println(cell2.getStringValue());<br/>
+</pre>
+<br/><div class="bodytext">
+What can I do if I have a Cell instance and want to know which column and row it belongs to ?
+</div>
+<div class="bodytext">
+The code below shows how you can do that:
+</div>
+<br/><pre class='code' id="code3">
+	 <span class='javaclass'>Row</span> row1=cell.getTableRow();<br/>
+	 <span class='javaclass'>Column</span> column1=cell.getTableColumn();<br/>
+</pre>
+<br/><div class="contenttitle" id="Control Cell Attributes">
+<br/>
+<a href="#Control Cell Attributes" >Control Cell Attributes</a>
+<hr/>
+</div>
+<div class="bodytext">
+Use the getStyleName() method you can get the style name of the cell.
+</div>
+<div class="bodytext">
+If you want to change the style,it must be set when you set the display text.
+</div>
+<br/><pre class='code' id="code4">
+	 <span class='javaclass'>String</span> cellSytle=cell.getStyleName();<br/>
+	 cell.setDisplayText("content", cellSytle);<br/>
+</pre>
+<br/><div class="bodytext">
+What can I do if I want to control the display alignment of the cell?
+</div>
+<div class="bodytext">
+You can set the horizontal and vertical alignment to do so.
+</div>
+<div class="bodytext">
+The code below shows how to get and set the alignment.You can refer to the javadoc about the alignment type.
+</div>
+<br/><pre class='code' id="code5">
+	  <span class='javaclass'>StyleTypeDefinitions</span>.<span class='javaclass'>HorizontalAlignmentType</span> horizontalAlign=cell.getHorizontalAlignmentType();<br/>
+	  <span class='javaclass'>StyleTypeDefinitions</span>.<span class='javaclass'>VerticalAlignmentType</span> verticalAlign=cell.getVerticalAlignmentType();<br/>
+	  cell.setHorizontalAlignment(<span class='javaclass'>StyleTypeDefinitions</span>.<span class='javaclass'>HorizontalAlignmentType</span>.<span class='javaclass'>CENTER</span>);<br/>
+	  cell.setVerticalAlignment(<span class='javaclass'>StyleTypeDefinitions</span>.<span class='javaclass'>VerticalAlignmentType</span>.<span class='javaclass'>BOTTOM</span>);<br/>
+</pre>
+<br/><div class="bodytext">
+If the content of the cell is too long,you can set the wrap option of the cell.
+</div>
+<br/><pre class='code' id="code6">
+	   cell.setTextWrapped(<span class='basic'>true</span>);<br/>
+</pre>
+<br/><div class="bodytext">
+If don't know the cell is wrapped or not,you can use the method:
+</div>
+<br/><pre class='code' id="code7">
+	   <span class='basic'>boolean</span> isTextWrapped=cell.isTextWrapped();<br/>
+</pre>
+<br/><div class="bodytext">
+If you want to set the background color of the cell,be care that the color type is org.odftoolkit.odfdom.type.Color.
+</div>
+<br/><pre class='code' id="code8">
+	    <span class='javaclass'>Color</span> cellBackgroundColor=cell.getCellBackgroundColor();<br/>
+	    cell.setCellBackgroundColor(<span class='javaclass'>Color</span>.valueOf("#000000"));<br/>
+</pre>
+<br/><div class="bodytext">
+How can I control the spanned number of the column/row:
+</div>
+<br/><pre class='code' id="code9">
+	    <span class='basic'>int</span> spannedNum=cell.getcgetColumnSpannedNumber();<br/>
+	    cell.setColumnSpannedNumber(spannedNum);<br/>
+	    <span class='basic'>int</span> rowSpannedNum=cell.getRowSpannedNumber();<br/>
+	    cell.setRowSpannedNumber(rowSpannedNum);<br/>
+</pre>
+<br/><div class="bodytext">
+For column,maybe you want to know the column repeated number:
+</div>
+<br/><pre class='code' id="code10">
+	    <span class='basic'>int</span> repeatedNum=cell.getColumnsRepeatedNumber();<br/>
+	    cell.setColumnsRepeatedNumber(repeatedNum);<br/>
+</pre>
+<br/><div class="bodytext">
+How about formatting a cell's content? You can set the format string of the cell to do so.
+</div>
+<div class="bodytext">
+For example you want to format the date to yyyy-MM-dd ,you can:
+</div>
+<br/><pre class='code' id="code11">
+	      <span class='javaclass'>String</span> cellFormatStr=cell.getFormatString();<br/>
+	      cell.setDateValue(<span class='modifier'>new</span> <span class='javaclass'>GregorianCalendar</span>(2010,5,1));<br/>
+	      cell.setFormatString("yyyy-<span class='javaclass'>MM</span>-dd");<br/>
+</pre>
+<br/><div class="bodytext">
+Be care that the setFormatString only works for float, date and percentage.
+</div>
+<div class="bodytext">
+You may be confused by the difference between getFormatString and getFormula,the difference is that:
+</div>
+<div class="bodytext">
+For the setFormula method,it just sets as a formula attribute,the cell value will not be calculated.
+</div>
+<br/><pre class='code' id="code12">
+	      <span class='javaclass'>String</span> formula=cell.getFormula();<br/>
+	      cell.setFormula(formula);    <br/>
+</pre>
+<br/><div class="bodytext">
+How can I clear the content of the cell?
+</div>
+<div class="bodytext">
+RemoveContent remove all of the cell while the removeTextContent only remove the text content of the cell.
+</div>
+<br/><pre class='code' id="code13">
+	   cell.removeContent();<br/>
+	   cell.removeTextContent();<br/>
+</pre>
+<br/><div class="contenttitle" id="Get&Set Cell Value Type">
+<br/>
+<a href="#Get&Set Cell Value Type" >Get&Set Cell Value Type</a>
+<hr/>
+</div>
+<div class="bodytext">
+	 The cell value can have different types,for the setValueType method:	 the parameter can be 	 <ul><li>"boolean"</li>	 <li>"currency"</li>	 <li>"date"</li>	 <li>"float"</li>         <li>"percentage"</li>	 <li>"string"</li>	 <li>"time"</li>	 <li>"void"</li>	 </ul>	 If the parameter type is not a valid cell type, an IllegalArgumentException will be thrown.
+</div>
+<br/><pre class='code' id="code14">
+	   <span class='javaclass'>String</span> valueType=cell.getValueType();<br/>
+	   cell.setValueType(valueType);<br/>
+</pre>
+<br/><div class="bodytext">
+For the following getXXXValue() method:it gets the cell value as xxx type.An IllegalArgumentException will be thrown if the cell type is not xxx.
+</div>
+<div class="contenttitle2" id="Get&Set boolean type Cell">
+<br/>
+<a href="#Get&Set boolean type Cell" >Get&Set boolean type Cell</a>
+<hr/>
+</div>
+<div class="bodytext">
+	For setBooleanValue method:it sets the cell value as a boolean and sets the value type to be boolean.
+</div>
+<br/><pre class='code' id="code15">
+	   <span class='basic'>boolean</span> booleanValue=cell.getBooleanValue();<br/>
+	   cell.setBooleanValue(booleanValue);<br/>
+</pre>
+<br/><div class="contenttitle2" id="Get&Set currency type Cell">
+<br/>
+<a href="#Get&Set currency type Cell" >Get&Set currency type Cell</a>
+<hr/>
+</div>
+<div class="bodytext">
+For the following getting methods,if the value type is not "currency", an IllegalArgumentException will be thrown.
+</div>
+<div class="bodytext">
+The currency code of the cell is like "USD", "EUR", "CNY", and the currency symbol is like "$"
+</div>
+<br/><pre class='code' id="code16">
+	   <span class='javaclass'>String</span> currencyCode=cell.getCurrencyCode();  <br/>
+	   cell.setCurrencyCode("<span class='javaclass'>USD</span>");<br/>
+</pre>
+<br/><div class="bodytext">
+You can also set currency value and currency format.Please note the overall format includes the symbol character, for example: $#,##0.00.
+</div>
+<br/><pre class='code' id="code17">
+	   cell.setCurrencyValue(100.00, "<span class='javaclass'>USD</span>");<br/>
+	   cell.setCurrencyFormat("$", "$#,##0.00");<br/>
+</pre>
+<br/><div class="contenttitle2" id="Get&Set date type Cell">
+<br/>
+<a href="#Get&Set date type Cell" >Get&Set date type Cell</a>
+<hr/>
+</div>
+<br/><pre class='code' id="code18">
+	   <span class='javaclass'>Calendar</span> dateValue=cell.getDateValue(); <br/>
+	   cell.setDateValue(<span class='modifier'>new</span> <span class='javaclass'>GregorianCalendar</span>(2010,5,1));<br/>
+</pre>
+<br/><div class="contenttitle2" id="Get&Set float type Cell">
+<br/>
+<a href="#Get&Set float type Cell" >Get&Set float type Cell</a>
+<hr/>
+</div>
+<br/><pre class='code' id="code19">
+	  <span class='basic'>double</span> floatValue=cell.getDoubleValue();  <br/>
+	  cell.setDoubleValue(<span class='modifier'>new</span> <span class='javaclass'>Double</span>(22.99f));<br/>
+</pre>
+<br/><div class="contenttitle2" id="Get&Set percentage type Cell">
+<br/>
+<a href="#Get&Set percentage type Cell" >Get&Set percentage type Cell</a>
+<hr/>
+</div>
+<br/><pre class='code' id="code20">
+	  <span class='basic'>double</span> percentageValue=cell.getPercentageValue();<br/>
+	  cell.setPercentageValue(0.89);<br/>
+</pre>
+<br/><div class="contenttitle2" id="Get&Set string type Cell">
+<br/>
+<a href="#Get&Set string type Cell" >Get&Set string type Cell</a>
+<hr/>
+</div>
+<div class="bodytext">
+If the cell type is not string, the display text will be returned.
+</div>
+<br/><pre class='code' id="code21">
+	  <span class='javaclass'>String</span> stringValue=cell.getStringValue();   <br/>
+	  cell.setStringValue("simple");<br/>
+</pre>
+<br/><div class="contenttitle2" id="Deal with the Time Value">
+<br/>
+<a href="#Deal with the Time Value" >Deal with the Time Value</a>
+<hr/>
+</div>
+<div class="bodytext">
+If you want to get the string type of time value,you can format it:
+</div>
+<br/><pre class='code' id="code22">
+	  cell.setTimeValue(<span class='javaclass'>Calendar</span>.getInstance());<br/>
+	  <span class='javaclass'>SimpleDateFormat</span> simpleFormat = <span class='modifier'>new</span> <span class='javaclass'>SimpleDateFormat</span>("'<span class='javaclass'>PT</span>'<span class='javaclass'>HH</span>'H'mm'M'ss'S'");<br/>
+          <span class='javaclass'>String</span>  timeString= simpleFormat.format(cell.getTimeValue().getTime());<br/>
+</pre>
+<br/><div class="contenttitle2" id="Something about Display Text">
+<br/>
+<a href="#Something about Display Text" >Something about Display Text</a>
+<hr/>
+</div>
+<div class="bodytext">
+          Please note the display text in ODF viewer might be different from the value set by this method,	  because the displayed text in ODF viewer is calculated and set by editor. 
+</div>
+<br/><pre class='code' id="code23">
+	  <span class='javaclass'>String</span> displayText=cell.getDisplayText();<br/>
+	  cell.setDisplayText(displayText);<br/>
+</pre>
+<br/><div class="contenttitle" id="Set image">
+<br/>
+<a href="#Set image" >Set image</a>
+<hr/>
+</div>
+<div class="bodytext">
+		From version 0.5.5, we support high level APIs for images.	    You can use following codes to set an image to a cell.
+</div>
+<br/><pre class='code' id="code24">
+	    <span class='javaclass'>Image</span> myImage = cell.setImage(<span class='modifier'>new</span> <span class='javaclass'>URI</span>("http://www.xxx.com/a.jpg"));<br/>
+</pre>
+<br/><div class="bodytext">
+	    You can use following codes to access an image in a cell.
+</div>
+<br/><pre class='code' id="code25">
+	    <span class='javaclass'>Image</span> image = cell.getImage();<br/>
+	    <span class='javaclass'>String</span> imagename = image.getName();<br/>
+	    <span class='javaclass'>FrameRectangle</span> rect = image.getRectangle();<br/>
+	    rect.setX(1);<br/>
+	    rect.setY(1);<br/>
+	    image.setRectangle(rect);<br/>
+</pre>
+<br/><br/> 
+<div class="navigation">
+ <ul>
+  <li><a href="Column and Row.html">previous</a></li>
+  <li><a href="Cell Range.html">next</a></li>
+  <li><a href="#">top</a></li>
+ </ul>
+</div>
+<br/>
+</div>
+<div id="footer" class="smallgraytext"> <a href="../index.html">Home</a> | <a href="../index.html">About Us</a> | <a href="mailto:Daisy@odftoolkit.org">Contact Us</a> </div>
+</div>
+</div>
+
+
+  </div>
+
+  <div id="footera">
+    <div id="poweredby">
+      <p><img src="/odftoolkit/images/feather-small.gif"/><br/>Powered by the Apache CMS.</p>
+    </div>
+    <div id="copyrighta">
+      <p>
+	Apache "ODF Toolkit" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+	Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+	decision making process	have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+	not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+	yet to be fully endorsed by the ASF.</p>
+      <p>
+	Copyright &copy; 2011 The Apache Software Foundation Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+	<a href="/openofficeorg/contact.html">Contact Us</a>
+	<br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+	<br />Other names appearing on the site may be trademarks of their respective owners.
+      </p>
+    </div>
+  </div>
+
+</body>
+</html>

Added: websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Charts.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Charts.html (added)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Charts.html Tue Sep  6 02:11:09 2011
@@ -0,0 +1,243 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You 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
+
+       http://www.apache.org/licenses/LICENSE- 2.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.
+-->
+
+<link href="/odftoolkit/css/odf.css" rel="stylesheet" type="text/css">
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<title>Charts</title>
+ <link type="text/css" rel="stylesheet" href="cookbook.css"/>
+<link rel="stylesheet" href="../images/style.css" type="text/css" />
+<script type="text/javascript">
+
+var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-22366020-1']);
+_gaq.push(['_trackPageview']);
+
+(function() {
+var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+})();
+
+</script>
+
+
+</head>
+
+<body>
+  <div id="banner">
+   <!-- <div id="bannerleft"><a alt="Apache ODF Toolkit (incubating)" href="http://incubator.apache.org/odftoolkit/">
+      <img id="logo" alt="Apache ODF Toolkit (Incubating)" src="/odftoolkit/images/ooo-logo.png"/></a></div> -->
+    <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+      <img id="asf-logo" alt="Apache Incubator" src="/odftoolkit/images/apache-incubator-logo.png"/></a></div>
+   <div id="bannercenter"><br/>&nbsp;&nbsp;&nbsp;&nbsp;Apache ODF Toolkit (incubating)</div>
+  </div>
+  <div id="clear"></div>
+  
+  <div id="content">
+  
+    
+    
+<div id="page" align="center">
+<div id="content" style="width:920px" class="contentpanel">
+<div id="topheader">
+<div class="topright"> </div>
+</div>
+<div id="menu">
+<div align="left" class="smallwhitetext"> <a href="../index.html" class="home"> </a> <a href="../downloads.html" class="download"></a> <a href="../documents.html" class="document"></a> <a href="../demo/index.html" class="sample"> </a> </div>
+</div>
+<div id="subcontent" align ="left">
+<div align="left" class="titletext"> <span >
+<a href="../documents.html">Documents</a> > 
+<a href="index.html">Cookbook</a> ><a href="Charts.html">Charts</a>
+</span>
+</div>
+<div class="navigation">
+ <ul>
+  <li><a href="Cell Range.html">previous</a></li>
+  <li><a href="Style Handling.html">next</a></li>
+ </ul>
+</div>
+<br/>
+<div class="contenttitle" id="Overview">
+<br/>
+<a href="#Overview" >Overview</a>
+<hr/>
+</div>
+<div class="bodytext">
+	    Since 0.6, Simple ODF provides methods to manipulate charts in text document, spreadsheet document and presentation document.		You can create, update and delete charts with these methods.
+</div>
+<div class="contenttitle" id="Create charts">
+<br/>
+<a href="#Create charts" >Create charts</a>
+<hr/>
+</div>
+<div class="bodytext">
+		We all know, a chart is associated with a table. In order to create a chart, you must determine the data set of this chart.		The data set can be a cell range of a table, for example:
+</div>
+<br/><pre class='code' id="code0">
+		<span class='javaclass'>CellRangeAddressList</span> cellRange = <span class='javaclass'>CellRangeAddressList</span>.valueOf("A.A1:A.B3");<br/>
+		<span class='javaclass'>DataSet</span> dataSet = <span class='modifier'>new</span> <span class='javaclass'>DataSet</span>(cellRange, spreadsheetDoc, <span class='basic'>true</span>, <span class='basic'>true</span>, <span class='basic'>false</span>);<br/>
+</pre>
+<br/><div class="bodytext">
+		Or a two dimensional array, for example:
+</div>
+<br/><pre class='code' id="code1">
+		<span class='basic'>int</span> row = 2, column = 3;<br/>
+		<span class='basic'>double</span>[][] data = <span class='modifier'>new</span> <span class='basic'>double</span>[column][row];<br/>
+		<span class='javaclass'>String</span>[] labels = <span class='modifier'>new</span> <span class='javaclass'>String</span>[row];<br/>
+		<span class='javaclass'>String</span>[] legends = <span class='modifier'>new</span> <span class='javaclass'>String</span>[column];<br/>
+		<span class='javaclass'>DataSet</span> dataset = <span class='modifier'>new</span> <span class='javaclass'>DataSet</span>(labels, legends, data);<br/>
+</pre>
+<br/><div class="bodytext">
+		You should also use rectangle to define the position and the size of this chart. For example: 
+</div>
+<br/><pre class='code' id="code2">
+		<span class='javaclass'>Rectangle</span> rect = <span class='modifier'>new</span> <span class='javaclass'>Rectangle</span>();<br/>
+		rect.x = 2000;<br/>
+		rect.y = 2700;<br/>
+		rect.width = 15000;<br/>
+		rect.height = 8000;<br/>
+		rect.y = 110000;<br/>
+</pre>
+<br/><div class="bodytext">
+		Then you can create a chart:
+</div>
+<br/><pre class='code' id="code3">
+		spreadsheetDoc.createChart("<span class='javaclass'>Page</span> <span class='javaclass'>Visit</span>", dataSet,rect);<br/>
+</pre>
+<br/><div class="bodytext">
+		There are some shortcut methods to create charts, for example, below codes show how to create a chart in a text document:
+</div>
+<br/><pre class='code' id="code4">
+		<span class='javaclass'>Chart</span> chart = textDoc.createChart(<br/>
+				"<span class='javaclass'>Page</span> <span class='javaclass'>Visit</span>", spreadsheetDoc,<br/>
+				cellRange, <span class='basic'>true</span>, <span class='basic'>true</span>, <span class='basic'>false</span>, rect);<br/>
+</pre>
+<br/><div class="bodytext">
+		If you want to create a chart in a spreadsheet document, you need to specify a cell to be the anchor of this chart, for example: 
+</div>
+<br/><pre class='code' id="code5">
+		spreadsheetDoc.createChart("<span class='javaclass'>Page</span> <span class='javaclass'>Visit</span>", spreadsheetDoc, cellRange,<br/>
+				<span class='basic'>true</span>, <span class='basic'>true</span>, <span class='basic'>false</span>, rect, spreadsheetDoc.getTableByName("C")<br/>
+						.getCellByPosition("D10"));<br/>
+</pre>
+<br/><div class="bodytext">
+		If you want to create a chart in a presentation document, you can use the existing layout of a slide, which means, you don't need to specify		a rectangle. The layouts that could contain a chart include: TITLE_PLUS_CHART, TITLE_PLUS_2_CHART, TITLE_LEFT_CHART_RIGHT_OUTLINE,		TITLE_PLUS_3_OBJECT, and TITLE_PLUS_4_OBJECT. For example:
+</div>
+<br/><pre class='code' id="code6">
+		<span class='javaclass'>Slide</span> slide = presentationDoc.newSlide(2, "Slide3",<br/>
+				<span class='javaclass'>SlideLayout</span>.TITLE_PLUS_2_CHART);<br/>
+		chart = slide.createChart("<span class='javaclass'>Count</span> of <span class='javaclass'>Visits</span>", spreadsheetDoc,<br/>
+				cellRange, <span class='basic'>true</span>, <span class='basic'>true</span>, <span class='basic'>false</span>, <span class='basic'>null</span>);<br/>
+</pre>
+<br/><div class="contenttitle" id="Update charts">
+<br/>
+<a href="#Update charts" >Update charts</a>
+<hr/>
+</div>
+<div class="bodytext">
+		You can update charts properties, for example, the title, axis title, chart type, whether to apply 3D effect, whether to use legend with API.		For example:
+</div>
+<br/><pre class='code' id="code7">
+		chart.setChartTitle("<span class='javaclass'>New</span> title");<br/>
+		chart.setAxisTitle("<span class='javaclass'>Hour</span>", "<span class='javaclass'>Number</span>");<br/>
+		chart.setChartType(<span class='javaclass'>ChartType</span>.<span class='javaclass'>AREA</span>);<br/>
+		chart.setApply3DEffect(<span class='basic'>true</span>);<br/>
+		chart.setUseLegend(<span class='basic'>true</span>);<br/>
+</pre>
+<br/><div class="bodytext">
+		You can update the data set too. For example:
+</div>
+<br/><pre class='code' id="code8">
+		chart.setChartData(<span class='modifier'>new</span> <span class='javaclass'>DataSet</span>(<span class='javaclass'>CellRangeAddressList</span>.valueOf("A.A1:A.C4"), spreadsheetDoc, true, true, true));<br/>
+</pre>
+<br/><div class="contenttitle" id="Get and delete charts">
+<br/>
+<a href="#Get and delete charts" >Get and delete charts</a>
+<hr/>
+</div>
+<div class="bodytext">
+		You can get charts by title e.g.
+</div>
+<br/><pre class='code' id="code9">
+		chart = textDoc.getChartByTitle("<span class='javaclass'>New</span> title").get(0);<br/>
+</pre>
+<br/><div class="bodytext">
+		You can also get a chart by its unique ID. The unique ID of a chart in Simple ODF API is the path of the chart document (relative to the ODF document package).		The unique ID can be gotten with method:
+</div>
+<br/><pre class='code' id="code10">
+		<span class='javaclass'>String</span> chartid = chart.getChartID();<br/>
+		chart = textDoc.getChartById(chartid);<br/>
+</pre>
+<br/><div class="bodytext">
+		You can also get the count of charts in this document.
+</div>
+<br/><pre class='code' id="code11">
+		<span class='basic'>int</span> count = textDoc.getChartCount();<br/>
+</pre>
+<br/><div class="bodytext">
+		You can delete a chart by ID or by title, e.g.
+</div>
+<br/><pre class='code' id="code12">
+		textDoc.deleteChartById(chartid);<br/>
+		textDoc.deleteChartByTitle("<span class='javaclass'>New</span> title");<br/>
+</pre>
+<br/><br/> 
+<div class="navigation">
+ <ul>
+  <li><a href="Cell Range.html">previous</a></li>
+  <li><a href="Style Handling.html">next</a></li>
+  <li><a href="#">top</a></li>
+ </ul>
+</div>
+<br/>
+</div>
+<div id="footer" class="smallgraytext"> <a href="../index.html">Home</a> | <a href="../index.html">About Us</a> | <a href="mailto:Daisy@odftoolkit.org">Contact Us</a> </div>
+</div>
+</div>
+
+
+  </div>
+
+  <div id="footera">
+    <div id="poweredby">
+      <p><img src="/odftoolkit/images/feather-small.gif"/><br/>Powered by the Apache CMS.</p>
+    </div>
+    <div id="copyrighta">
+      <p>
+	Apache "ODF Toolkit" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+	Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+	decision making process	have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+	not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+	yet to be fully endorsed by the ASF.</p>
+      <p>
+	Copyright &copy; 2011 The Apache Software Foundation Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+	<a href="/openofficeorg/contact.html">Contact Us</a>
+	<br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+	<br />Other names appearing on the site may be trademarks of their respective owners.
+      </p>
+    </div>
+  </div>
+
+</body>
+</html>

Added: websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Column and Row.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Column and Row.html (added)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Column and Row.html Tue Sep  6 02:11:09 2011
@@ -0,0 +1,66 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You 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
+
+       http://www.apache.org/licenses/LICENSE- 2.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.
+-->
+
+<link href="/odftoolkit/css/odf.css" rel="stylesheet" type="text/css">
+
+<title></title>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+
+</head>
+
+<body>
+  <div id="banner">
+   <!-- <div id="bannerleft"><a alt="Apache ODF Toolkit (incubating)" href="http://incubator.apache.org/odftoolkit/">
+      <img id="logo" alt="Apache ODF Toolkit (Incubating)" src="/odftoolkit/images/ooo-logo.png"/></a></div> -->
+    <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+      <img id="asf-logo" alt="Apache Incubator" src="/odftoolkit/images/apache-incubator-logo.png"/></a></div>
+   <div id="bannercenter"><br/>&nbsp;&nbsp;&nbsp;&nbsp;Apache ODF Toolkit (incubating)</div>
+  </div>
+  <div id="clear"></div>
+  
+  <div id="content">
+  
+    
+    
+  </div>
+
+  <div id="footera">
+    <div id="poweredby">
+      <p><img src="/odftoolkit/images/feather-small.gif"/><br/>Powered by the Apache CMS.</p>
+    </div>
+    <div id="copyrighta">
+      <p>
+	Apache "ODF Toolkit" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+	Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+	decision making process	have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+	not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+	yet to be fully endorsed by the ASF.</p>
+      <p>
+	Copyright &copy; 2011 The Apache Software Foundation Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+	<a href="/openofficeorg/contact.html">Contact Us</a>
+	<br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+	<br />Other names appearing on the site may be trademarks of their respective owners.
+      </p>
+    </div>
+  </div>
+
+</body>
+</html>

Added: websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Fields.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Fields.html (added)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Fields.html Tue Sep  6 02:11:09 2011
@@ -0,0 +1,280 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You 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
+
+       http://www.apache.org/licenses/LICENSE- 2.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.
+-->
+
+<link href="/odftoolkit/css/odf.css" rel="stylesheet" type="text/css">
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<title>Fields</title>
+ <link type="text/css" rel="stylesheet" href="cookbook.css"/>
+<link rel="stylesheet" href="../images/style.css" type="text/css" />
+<script type="text/javascript">
+
+var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-22366020-1']);
+_gaq.push(['_trackPageview']);
+
+(function() {
+var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+})();
+
+</script>
+
+
+</head>
+
+<body>
+  <div id="banner">
+   <!-- <div id="bannerleft"><a alt="Apache ODF Toolkit (incubating)" href="http://incubator.apache.org/odftoolkit/">
+      <img id="logo" alt="Apache ODF Toolkit (Incubating)" src="/odftoolkit/images/ooo-logo.png"/></a></div> -->
+    <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+      <img id="asf-logo" alt="Apache Incubator" src="/odftoolkit/images/apache-incubator-logo.png"/></a></div>
+   <div id="bannercenter"><br/>&nbsp;&nbsp;&nbsp;&nbsp;Apache ODF Toolkit (incubating)</div>
+  </div>
+  <div id="clear"></div>
+  
+  <div id="content">
+  
+    
+    
+<div id="page" align="center">
+<div id="content" style="width:920px" class="contentpanel">
+<div id="topheader">
+<div class="topright"> </div>
+</div>
+<div id="menu">
+<div align="left" class="smallwhitetext"> <a href="../index.html" class="home"> </a> <a href="../downloads.html" class="download"></a> <a href="../documents.html" class="document"></a> <a href="../demo/index.html" class="sample"> </a> </div>
+</div>
+<div id="subcontent" align ="left">
+<div align="left" class="titletext"> <span >
+<a href="../documents.html">Documents</a> > 
+<a href="index.html">Cookbook</a> ><a href="Fields.html">Fields</a>
+</span>
+</div>
+<div class="navigation">
+ <ul>
+  <li><a href="TextExtractor.html">previous</a></li>
+  <li><a href="Manipulate Metadata.html">next</a></li>
+ </ul>
+</div>
+<br/>
+<div class="contenttitle" id="Variable Field">
+<br/>
+<a href="#Variable Field" >Variable Field</a>
+<hr/>
+</div>
+<div class="bodytext">
+			You can use the following code to create a variable field, and set the value.
+</div>
+<br/><pre class='code' id="code0">
+			<span class='javaclass'>TextDocument</span> doc = <span class='javaclass'>TextDocument</span>.newTextDocument();<br/>
+			<span class='javaclass'>Paragraph</span> paragraph = doc.addParagraph("test_con_variable:");<br/>
+			<span class='javaclass'>VariableField</span> simpleVariableField = <span class='javaclass'>Fields</span>.createSimpleVariableField(doc, "test_con_variable");<br/>
+			simpleVariableField.updateField("true", paragraph.getOdfElement());<br/>
+</pre>
+<br/><div class="bodytext">
+			Following code can be used to set value to variable field, and append it to an ODF element.
+</div>
+<br/><pre class='code' id="code1">
+			simpleVariableField.updateField("user variable content", null);<br/>
+			simpleVariableField.displayField(paragraph.getOdfElement());<br/>
+</pre>
+<br/><div class="contenttitle" id="Condition Field">
+<br/>
+<a href="#Condition Field" >Condition Field</a>
+<hr/>
+</div>
+<div class="bodytext">
+			Following code can be used to create a condition field.
+</div>
+<br/><pre class='code' id="code2">
+			<span class='javaclass'>Paragraph</span> newParagraph = doc.addParagraph("<span class='javaclass'>Condition</span> <span class='javaclass'>Field</span> <span class='javaclass'>Test</span>:");<br/>
+			<span class='javaclass'>ConditionField</span> conditionField = <span class='javaclass'>Fields</span>.createConditionField(newParagraph.getOdfElement(), "test_con_variable == \"true\"",<br/>
+					"trueText", "falseText");<br/>
+</pre>
+<br/><div class="contenttitle" id="Hidden Field">
+<br/>
+<a href="#Hidden Field" >Hidden Field</a>
+<hr/>
+</div>
+<div class="bodytext">
+			Following code can be used to create a hidden field.
+</div>
+<br/><pre class='code' id="code3">
+			newParagraph = doc.addParagraph("<span class='javaclass'>Hide</span> <span class='javaclass'>Text</span> <span class='javaclass'>Field</span> <span class='javaclass'>Test</span>:");<br/>
+			conditionField = <span class='javaclass'>Fields</span>.createHiddenTextField(newParagraph.getOdfElement(), "test_con_variable == \"true\"", "hiddenText");<br/>
+</pre>
+<br/><div class="contenttitle" id="Cross Reference Field">
+<br/>
+<a href="#Cross Reference Field" >Cross Reference Field</a>
+<hr/>
+</div>
+<div class="bodytext">
+			Following code can be used to create a reference field.
+</div>
+<br/><pre class='code' id="code4">
+			<span class='javaclass'>OdfElement</span> newTextSpanElement = ((<span class='javaclass'>TextPElement</span>)doc.addParagraph("<span class='javaclass'>Reference</span> <span class='javaclass'>Content</span>:").getOdfElement()).newTextSpanElement();<br/>
+			newTextSpanElement.setTextContent("<span class='javaclass'>This</span> is a test reference content.");<br/>
+			<span class='javaclass'>ReferenceField</span> referenceField = <span class='javaclass'>Fields</span>.createReferenceField(newTextSpanElement, "test-ref");<br/>
+</pre>
+<br/><div class="bodytext">
+			Following code can be used to append a reference field.
+</div>
+<br/><pre class='code' id="code5">
+			referenceField.appendReferenceTo(doc.addParagraph("<span class='javaclass'>User</span> <span class='javaclass'>Reference</span> <span class='javaclass'>Field</span>:").getOdfElement(), <span class='javaclass'>ReferenceField</span>.<span class='javaclass'>DisplayType</span>.<span class='javaclass'>TEXT</span>);<br/>
+</pre>
+<br/><div class="contenttitle" id="Chapter Field">
+<br/>
+<a href="#Chapter Field" >Chapter Field</a>
+<hr/>
+</div>
+<div class="bodytext">
+			Following code can be used to create a chapter field.
+</div>
+<br/><pre class='code' id="code6">
+			<span class='javaclass'>ChapterField</span> chapterField = <span class='javaclass'>Fields</span>.createChapterField(doc.addParagraph("<span class='javaclass'>Chapter</span>:").getOdfElement());<br/>
+</pre>
+<br/><div class="contenttitle" id="Title and Subject Field">
+<br/>
+<a href="#Title and Subject Field" >Title and Subject Field</a>
+<hr/>
+</div>
+<div class="bodytext">
+			Following code can be used to create a title field.
+</div>
+<br/><pre class='code' id="code7">
+			<span class='javaclass'>TitleField</span> titleField = <span class='javaclass'>Fields</span>.createTitleField(doc.addParagraph("<span class='javaclass'>The</span> <span class='javaclass'>Title</span>:").getOdfElement());<br/>
+</pre>
+<br/><div class="bodytext">
+			Following code can be used to create a subject field.
+</div>
+<br/><pre class='code' id="code8">
+			<span class='javaclass'>SubjectField</span> subjectField = <span class='javaclass'>Fields</span>.createSubjectField(doc.addParagraph("<span class='javaclass'>The</span> <span class='javaclass'>Subject</span>:").getOdfElement());<br/>
+</pre>
+<br/><div class="contenttitle" id="Author Field">
+<br/>
+<a href="#Author Field" >Author Field</a>
+<hr/>
+</div>
+<div class="bodytext">
+			Following code can be used to create a author initial field and a author name field.
+</div>
+<br/><pre class='code' id="code9">
+			<span class='javaclass'>AuthorField</span> authorField = <span class='javaclass'>Fields</span>.createAuthorInitialsField(doc.addParagraph("<span class='javaclass'>The</span> initials of the author :").getOdfElement());<br/>
+			authorField = <span class='javaclass'>Fields</span>.createAuthorNameField(doc.addParagraph("<span class='javaclass'>Author</span>:").getOdfElement());<br/>
+</pre>
+<br/><div class="contenttitle" id="Page Number Field">
+<br/>
+<a href="#Page Number Field" >Page Number Field</a>
+<hr/>
+</div>
+<div class="bodytext">
+			Following code can be used to create a current page number field.
+</div>
+<br/><pre class='code' id="code10">
+			<span class='javaclass'>PageNumberField</span> numberField = <span class='javaclass'>Fields</span>.createCurrentPageNumberField(doc.addParagraph("<span class='javaclass'>Current</span> <span class='javaclass'>Page</span> <span class='javaclass'>Number</span>:").getOdfElement());<br/>
+			numberField.setNumberFormat(<span class='javaclass'>NumberFormat</span>.UPPERCASE_LATIN_ALPHABET);<br/>
+			numberField.setDisplayPage(<span class='javaclass'>DisplayType</span>.NEXT_PAGE);<br/>
+</pre>
+<br/><div class="bodytext">
+			Following code can be used to create a previous page number and a next page number field.
+</div>
+<br/><pre class='code' id="code11">
+			numberField = <span class='javaclass'>Fields</span>.createPreviousPageNumberField(doc.addParagraph("<span class='javaclass'>Previous</span> <span class='javaclass'>Page</span> <span class='javaclass'>Number</span>:").getOdfElement());<br/>
+			numberField = <span class='javaclass'>Fields</span>.createNextPageNumberField(doc.addParagraph("<span class='javaclass'>Next</span> <span class='javaclass'>Page</span> <span class='javaclass'>Number</span>:").getOdfElement());<br/>
+</pre>
+<br/><div class="contenttitle" id="Page Number Field">
+<br/>
+<a href="#Page Number Field" >Page Number Field</a>
+<hr/>
+</div>
+<div class="bodytext">
+			Following code can be used to create a page count field, and set the number format.
+</div>
+<br/><pre class='code' id="code12">
+			<span class='javaclass'>PageCountField</span> countField = <span class='javaclass'>Fields</span>.createPageCountField(doc.addParagraph("<span class='javaclass'>Page</span> <span class='javaclass'>Count</span>:").getOdfElement());<br/>
+			countField.setNumberFormat(<span class='javaclass'>NumberFormat</span>.UPPERCASE_LATIN_ALPHABET);<br/>
+</pre>
+<br/><div class="contenttitle" id="Date Field">
+<br/>
+<a href="#Date Field" >Date Field</a>
+<hr/>
+</div>
+<div class="bodytext">
+			Following code can be used to create a date field, and set the format.
+</div>
+<br/><pre class='code' id="code13">
+			<span class='javaclass'>DateField</span> dateField = <span class='javaclass'>Fields</span>.createDateField(doc.addParagraph("<span class='javaclass'>Date</span>:").getOdfElement());<br/>
+			dateField.formatDate("yy-<span class='javaclass'>MM</span>-dd");<br/>
+</pre>
+<br/><div class="contenttitle" id="Time Field">
+<br/>
+<a href="#Time Field" >Time Field</a>
+<hr/>
+</div>
+<div class="bodytext">
+			Following code can be used to create a time field, and set the format.
+</div>
+<br/><pre class='code' id="code14">
+			<span class='javaclass'>TimeField</span> timeField = <span class='javaclass'>Fields</span>.createTimeField(doc.addParagraph("<span class='javaclass'>Time</span>:").getOdfElement());<br/>
+			timeField.formatTime("<span class='javaclass'>HH</span>:mm:ss a");<br/>
+</pre>
+<br/><br/> 
+<div class="navigation">
+ <ul>
+  <li><a href="TextExtractor.html">previous</a></li>
+  <li><a href="Manipulate Metadata.html">next</a></li>
+  <li><a href="#">top</a></li>
+ </ul>
+</div>
+<br/>
+</div>
+<div id="footer" class="smallgraytext"> <a href="../index.html">Home</a> | <a href="../index.html">About Us</a> | <a href="mailto:Daisy@odftoolkit.org">Contact Us</a> </div>
+</div>
+</div>
+
+
+  </div>
+
+  <div id="footera">
+    <div id="poweredby">
+      <p><img src="/odftoolkit/images/feather-small.gif"/><br/>Powered by the Apache CMS.</p>
+    </div>
+    <div id="copyrighta">
+      <p>
+	Apache "ODF Toolkit" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+	Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+	decision making process	have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+	not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+	yet to be fully endorsed by the ASF.</p>
+      <p>
+	Copyright &copy; 2011 The Apache Software Foundation Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+	<a href="/openofficeorg/contact.html">Contact Us</a>
+	<br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+	<br />Other names appearing on the site may be trademarks of their respective owners.
+      </p>
+    </div>
+  </div>
+
+</body>
+</html>

Added: websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Manipulate Cell Range.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Manipulate Cell Range.html (added)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Manipulate Cell Range.html Tue Sep  6 02:11:09 2011
@@ -0,0 +1,66 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You 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
+
+       http://www.apache.org/licenses/LICENSE- 2.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.
+-->
+
+<link href="/odftoolkit/css/odf.css" rel="stylesheet" type="text/css">
+
+<title></title>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+
+</head>
+
+<body>
+  <div id="banner">
+   <!-- <div id="bannerleft"><a alt="Apache ODF Toolkit (incubating)" href="http://incubator.apache.org/odftoolkit/">
+      <img id="logo" alt="Apache ODF Toolkit (Incubating)" src="/odftoolkit/images/ooo-logo.png"/></a></div> -->
+    <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+      <img id="asf-logo" alt="Apache Incubator" src="/odftoolkit/images/apache-incubator-logo.png"/></a></div>
+   <div id="bannercenter"><br/>&nbsp;&nbsp;&nbsp;&nbsp;Apache ODF Toolkit (incubating)</div>
+  </div>
+  <div id="clear"></div>
+  
+  <div id="content">
+  
+    
+    
+  </div>
+
+  <div id="footera">
+    <div id="poweredby">
+      <p><img src="/odftoolkit/images/feather-small.gif"/><br/>Powered by the Apache CMS.</p>
+    </div>
+    <div id="copyrighta">
+      <p>
+	Apache "ODF Toolkit" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+	Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+	decision making process	have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+	not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+	yet to be fully endorsed by the ASF.</p>
+      <p>
+	Copyright &copy; 2011 The Apache Software Foundation Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+	<a href="/openofficeorg/contact.html">Contact Us</a>
+	<br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+	<br />Other names appearing on the site may be trademarks of their respective owners.
+      </p>
+    </div>
+  </div>
+
+</body>
+</html>

Added: websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Manipulate Cell.html
==============================================================================
--- websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Manipulate Cell.html (added)
+++ websites/staging/odftoolkit/trunk/content/odftoolkit/simple/document/cookbook/Manipulate Cell.html Tue Sep  6 02:11:09 2011
@@ -0,0 +1,66 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You 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
+
+       http://www.apache.org/licenses/LICENSE- 2.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.
+-->
+
+<link href="/odftoolkit/css/odf.css" rel="stylesheet" type="text/css">
+
+<title></title>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+
+</head>
+
+<body>
+  <div id="banner">
+   <!-- <div id="bannerleft"><a alt="Apache ODF Toolkit (incubating)" href="http://incubator.apache.org/odftoolkit/">
+      <img id="logo" alt="Apache ODF Toolkit (Incubating)" src="/odftoolkit/images/ooo-logo.png"/></a></div> -->
+    <div id="bannerright"><a alt="Apache Incubator" href="http://incubator.apache.org">
+      <img id="asf-logo" alt="Apache Incubator" src="/odftoolkit/images/apache-incubator-logo.png"/></a></div>
+   <div id="bannercenter"><br/>&nbsp;&nbsp;&nbsp;&nbsp;Apache ODF Toolkit (incubating)</div>
+  </div>
+  <div id="clear"></div>
+  
+  <div id="content">
+  
+    
+    
+  </div>
+
+  <div id="footera">
+    <div id="poweredby">
+      <p><img src="/odftoolkit/images/feather-small.gif"/><br/>Powered by the Apache CMS.</p>
+    </div>
+    <div id="copyrighta">
+      <p>
+	Apache "ODF Toolkit" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator.
+	Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and
+	decision making process	have stabilized in a manner consistent with other successful ASF projects. While incubation status is
+	not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has
+	yet to be fully endorsed by the ASF.</p>
+      <p>
+	Copyright &copy; 2011 The Apache Software Foundation Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+	<a href="/openofficeorg/contact.html">Contact Us</a>
+	<br />Apache and the Apache feather logos are trademarks of The Apache Software Foundation.
+	<br />Other names appearing on the site may be trademarks of their respective owners.
+      </p>
+    </div>
+  </div>
+
+</body>
+</html>



Mime
View raw message