Start updating docs for ooxml branch

git-svn-id: https://svn.apache.org/repos/asf/poi/branches/ooxml@634994 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Nick Burch 2008-03-08 16:02:19 +00:00
parent 5f7b99ac45
commit 1758164953

View File

@ -63,16 +63,20 @@
<section><title>Purpose</title> <section><title>Purpose</title>
<p> <p>
The POI project consists of APIs for manipulating various file formats The POI project consists of APIs for manipulating various file formats
based upon Microsoft's OLE 2 Compound Document format using pure Java. In short, you can based upon Microsoft's OLE 2 Compound Document format, and Office OpenXML format, using
read and write MS Excel files using Java. Soon, you'll be able to read and write pure Java. In short, you can read and write MS Excel files using Java. In addition,
Word files using Java. POI is your Java Excel solution as well as your Java Word solution. you can read and write MS Word and MS PowerPoint files using Java. POI is your Java Excel
However, we have a complete API for porting other OLE 2 Compound Document formats and welcome solution (for Excel 97-2007). However, we have a complete API for porting other OLE 2
others to participate. Compound Document formats and welcome others to participate.
</p> </p>
<p> <p>
OLE 2 Compound Document Format based files include most Microsoft Office OLE 2 Compound Document Format based files include most Microsoft Office
files such as XLS and DOC as well as MFC serialization API based file formats. files such as XLS and DOC as well as MFC serialization API based file formats.
</p> </p>
<p>
Office OpenXML Format based files include the new (2007+) xml based file formats,
including Microsoft office files such as XLSX, DOCX and PPTX.
</p>
<p> <p>
As a general policy we try to collaborate as much as possible with other projects to As a general policy we try to collaborate as much as possible with other projects to
provide this functionality. Examples include: <link href="http://xml.apache.org/cocoon">Cocoon</link> for provide this functionality. Examples include: <link href="http://xml.apache.org/cocoon">Cocoon</link> for
@ -87,7 +91,7 @@
We'll tackle this on a component level. POI refers to the whole project. We'll tackle this on a component level. POI refers to the whole project.
</p> </p>
<p> <p>
So why should you use POIFS or HSSF? So why should you use POIFS, HSSF or XSSF?
</p> </p>
<p> <p>
You'd use POIFS if you had a document written in OLE 2 Compound Document Format, probably written using You'd use POIFS if you had a document written in OLE 2 Compound Document Format, probably written using
@ -96,8 +100,10 @@
we say that POIFS is the most complete and correct implementation of this file format to date! we say that POIFS is the most complete and correct implementation of this file format to date!
</p> </p>
<p> <p>
You'd use HSSF if you needed to read or write an Excel file using Java (XLS). You can also read and modify You'd use HSSF if you needed to read or write an Excel file using Java (XLS). You'd use
spreadsheets using this API, although right now writing is more mature. XSSF if you need to read or write an OOXML Excel file using Java (XLSX). The combined
SS interface allows you to easily read and write all kinds of Excel files (XLS and XLSX)
using Java.
</p> </p>
</section> </section>
</section> </section>
@ -113,9 +119,12 @@
pure Java. It supports both read and write functionality. All of our components ultimately rely on it by pure Java. It supports both read and write functionality. All of our components ultimately rely on it by
definition. Please see <link href="./poifs/index.html">the POIFS project page</link> for more information.</p> definition. Please see <link href="./poifs/index.html">the POIFS project page</link> for more information.</p>
</section> </section>
<section><title>HSSF for Excel Documents</title> <section><title>HSSF and XSSF for Excel Documents</title>
<p>HSSF is our port of the Microsoft Excel 97(-2003) file format (BIFF8) to pure Java. It supports read and write <p>HSSF is our port of the Microsoft Excel 97(-2007) file format (BIFF8) to pure
capability. Please see <link href="./hssf/index.html">the HSSF project page</link> for more information.</p> Java. XSSF is our port of the Microsoft Excel XML (2007+) file format (OOXML) to
pure Java. They both supports read and write capability. Please see
<link href="./hssf/index.html">the HSSF+XSSF project page</link> for more
information.</p>
</section> </section>
<section><title>HWPF for Word Documents</title> <section><title>HWPF for Word Documents</title>
<p>HWPF is our port of the Microsoft Word 97 file format to pure <p>HWPF is our port of the Microsoft Word 97 file format to pure