JM Lafferty Associates, Inc.

Downloads +

Available Downloads

- Use the links below to download Apache POI releases from one of our mirrors. - You should verify the integrity - of the files using the signatures and checksums available from this page. + This page provides instructions on how to download and verify Apache POI release artifacts.

Latest stable release: Apache POI 3.5
Release Archive
The latest stable release is Apache POI 3.5
Archives of all prior releases

Apache POI releases are available under the Apache License, Version 2.0. See the NOTICE file contained in each release artifact for applicable copyright attribution notices. -

+ To insure that you have downloaded the true release you should verify the integrity + of the files using the signatures and checksums available from this page. +

28 September 2009 - POI 3.5-FINAL available - +

28 September 2009 - POI 3.5-FINAL available

The Apache POI team is pleased to announce the release of 3.5 FINAL. This release brings many improvements including support for the new OOXML formats introduced in Office 2007, such as XLSX and DOCX.

@@ -81,11 +82,11 @@

Verify - +

Verify

It is essential that you verify the integrity of the downloaded files using the PGP or MD5 signatures. - Please read Verifying Apache HTTP Server Releases for more information on why you should verify our releases. + Please read Verifying Apache HTTP Server Releases + for more information on why you should verify our releases. This page provides detailed instructions which you can use for POI artifacts.

The PGP signatures can be verified using PGP or GPG. First download the KEYS file as well as the .asc signature files @@ -93,20 +94,55 @@ rather than from a mirror. Then verify the signatures using

- % pgpk -a KEYS - % pgpv poi-X.Y.Z.jar.asc +% pgpk -a KEYS +% pgpv poi-X.Y.Z.jar.asc

- % pgp -ka KEYS - % pgp poi-X.Y.Z.jar.asc +% pgp -ka KEYS +% pgp poi-X.Y.Z.jar.asc

- % gpg --import KEYS - % gpg --verify poi-X.Y.Z.jar.asc +% gpg --import KEYS +% gpg --verify poi-X.Y.Z.jar.asc + +

Sample verification of poi-bin-3.5-FINAL-20090928.tar.gz

+ +% gpg --import KEYS +gpg: key 12DAE9BE: "Glen Stampoultzis <glens at apache dot org>" not changed +gpg: key 4CEED75F: "Nick Burch <nick at gagravarr dot org>" not changed +gpg: key 84B5A42E: "Rainer Klute <rainer.klute at gmx dot de>" not changed +gpg: key F5BB52CD: "Yegor Kozlov <yegor.kozlov at gmail dot com>" not changed +gpg: Total number processed: 4 +gpg: unchanged: 4 +% gpg --verify poi-bin-3.5-FINAL-20090928.tar.gz.asc +gpg: Signature made Mon Sep 28 10:28:25 2009 PDT using DSA key ID F5BB52CD +gpg: Good signature from "Yegor Kozlov <yegor.kozlov at gmail dot com>" +gpg: aka "Yegor Kozlov <yegor at dinom dot ru>" +gpg: aka "Yegor Kozlov <yegor at apache dot org>" +Primary key fingerprint: 7D77 0C77 6CE7 754E E6AF 23AA 6934 0A02 F5BB 52CD +% gpg --fingerprint F5BB52CD +pub 1024D/F5BB52CD 2007-06-18 [expires: 2012-06-16] + Key fingerprint = 7D77 0C77 6CE7 754E E6AF 23AA 6934 0A02 F5BB 52CD +uid Yegor Kozlov <yegor.kozlov at gmail dot com> +uid Yegor Kozlov <yegor at dinom dot ru> +uid Yegor Kozlov <yegor at apache dot org> +sub 4096g/7B45A98A 2007-06-18 [expires: 2012-06-16]

Release Archives +

+ Apache POI became a top level project in June 2007 and POI 3.0 aritfacts were re-released. + Prior to that date POI was a sub-project of Apache Jakarta. +

Binary Artifacts
Source Artifacts
Keys
Artifacts from prior to 3.0

diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml index a0cd7b8b80..87ed8c990b 100644 --- a/src/documentation/content/xdocs/faq.xml +++ b/src/documentation/content/xdocs/faq.xml @@ -20,89 +20,90 @@ - - - My code uses some new feature, compiles fine but fails when live with a "MethodNotFoundException" - - -

You almost certainly have an older version of POI - on your classpath. Quite a few runtimes and other packages - will ship an older version of POI, so this is an easy problem - to hit without your realising.

The best way to identify the offending earlier jar file is - with a few lines of java. These will load one of the core POI - classes, and report where it came from.

- -ClassLoader classloader = org.apache.poi.poifs.filesystem.POIFSFileSystem.class.getClassLoader(); -URL res = classloader.getResource("org/apache/poi/poifs/filesystem/POIFSFileSystem.class"> + + + My code uses some new feature, compiles fine but fails when live with a "MethodNotFoundException" + + +

You almost certainly have an older version of POI + on your classpath. Quite a few runtimes and other packages + will ship an older version of POI, so this is an easy problem + to hit without your realising.

The best way to identify the offending earlier jar file is + with a few lines of java. These will load one of the core POI + classes, and report where it came from.

+ +ClassLoader classloader = + org.apache.poi.poifs.filesystem.POIFSFileSystem.class.getClassLoader(); +URL res = classloader.getResource( + "org/apache/poi/poifs/filesystem/POIFSFileSystem.class"); String path = res.getPath(); System.out.println("Core POI came from " + path); - - - - - - My code uses the scratchpad, compiles fine but fails to run with a "MethodNotFoundException" - - -

You almost certainly have an older version earlier on your - classpath. See the prior answer.

- - - - - Why is reading a simple sheet taking so long? - - -

You've probably enabled logging. Logging is intended only for - autopsy style debugging. Having it enabled will reduce performance - by a factor of at least 100. Logging is helpful for understanding - why POI can't read some file or developing POI itself. Important - errors are thrown as exceptions, which means you probably don't need - logging.

- - - - - What is the HSSF "eventmodel"? - - -

The SS eventmodel package is an API for reading Excel files without loading the whole spreadsheet into memory. It does - require more knowledge on the part of the user, but reduces memory consumption by more than - tenfold. It is based on the AWT event model in combination with SAX. If you need read-only - access, this is the best way to do it.

- - - - - - Why can't read the document I created using Star Office 5.1? - - -

Star Office 5.1 writes some records using the older BIFF standard. This causes some problems - with POI which supports only BIFF8.

- - - - - Why am I getting an exception each time I attempt to read my spreadsheet? - - -

It's possible your spreadsheet contains a feature that is not currently supported by POI. - If you encounter this then please create the simplest file that demonstrates the trouble and submit it to - Bugzilla.

- - - - - How do you tell if a spreadsheet cell contains a date? - - -

Excel stores dates as numbers therefore the only way to determine if a cell is - actually stored as a date is to look at the formatting. There is a helper method - in HSSFDateUtil that checks for this. - Thanks to Jason Hoffman for providing the solution.

- + + + + + + My code uses the scratchpad, compiles fine but fails to run with a "MethodNotFoundException" + + +

You almost certainly have an older version earlier on your + classpath. See the prior answer.

+ + + + + Why is reading a simple sheet taking so long? + + +

You've probably enabled logging. Logging is intended only for + autopsy style debugging. Having it enabled will reduce performance + by a factor of at least 100. Logging is helpful for understanding + why POI can't read some file or developing POI itself. Important + errors are thrown as exceptions, which means you probably don't need + logging.

+ + + + + What is the HSSF "eventmodel"? + + +

The SS eventmodel package is an API for reading Excel files without loading the whole spreadsheet into memory. It does + require more knowledge on the part of the user, but reduces memory consumption by more than + tenfold. It is based on the AWT event model in combination with SAX. If you need read-only + access, this is the best way to do it.

+ + + + + Why can't read the document I created using Star Office 5.1? + + +

Star Office 5.1 writes some records using the older BIFF standard. This causes some problems + with POI which supports only BIFF8.

+ + + + + Why am I getting an exception each time I attempt to read my spreadsheet? + + +

It's possible your spreadsheet contains a feature that is not currently supported by POI. + If you encounter this then please create the simplest file that demonstrates the trouble and submit it to + Bugzilla.

+ + + + + How do you tell if a spreadsheet cell contains a date? + + +

Excel stores dates as numbers therefore the only way to determine if a cell is + actually stored as a date is to look at the formatting. There is a helper method + in HSSFDateUtil that checks for this. + Thanks to Jason Hoffman for providing the solution.

+ case HSSFCell.CELL_TYPE_NUMERIC: double d = cell.getNumericCellValue(); // test if a date! @@ -114,94 +115,93 @@ System.out.println("Core POI came from " + path); cellText = cal.get(Calendar.MONTH)+1 + "/" + cal.get(Calendar.DAY_OF_MONTH) + "/" + cellText; - } - - - - - I'm trying to stream an XLS file from a servlet and I'm having some trouble. What's the problem? - - -

- The problem usually manifests itself as the junk characters being shown on - screen. The problem persists even though you have set the correct mime type. -

- The short answer is, don't depend on IE to display a binary file type properly if you stream it via a - servlet. Every minor version of IE has different bugs on this issue. -

- The problem in most versions of IE is that it does not use the mime type on - the HTTP response to determine the file type; rather it uses the file extension - on the request. Thus you might want to add a - .xls to your request - string. For example - http://yourserver.com/myServelet.xls?param1=xx. This is - easily accomplished through URL mapping in any servlet container. Sometimes - a request like - http://yourserver.com/myServelet?param1=xx&dummy=file.xls is also - known to work. - -

- To guarantee opening the file properly in Excel from IE, write out your file to a - temporary file under your web root from your servelet. Then send an http response - to the browser to do a client side redirection to your temp file. (Note that using a - server side redirect using RequestDispatcher will not be effective in this case) -

- Note also that when you request a document that is opened with an - external handler, IE sometimes makes two requests to the webserver. So if your - generating process is heavy, it makes sense to write out to a temporary file, so that multiple - requests happen for a static file. -

- None of this is particular to Excel. The same problem arises when you try to - generate any binary file dynamically to an IE client. For example, if you generate - pdf files using - FOP, you will come across many of the same issues. - -

- - - - - - I want to set a cell format (Data format of a cell) of a excel sheet as ###,###,###.#### or ###,###,###.0000. Is it possible using POI ? - - -

- Yes. You first need to get a DataFormat object from the workbook and call getFormat with the desired format. Some examples are here. -

- - - - - I want to set a cell format (Data format of a cell) of a excel sheet as text. Is it possible using POI ? - - -

- Yes. This is a built-in format for excel that you can get from DataFormat object using the format string "@". Also, the string "text" will alias this format. -

- - - - - How do I add a border around a merged cell? - - -

Add blank cells around where the cells normally would have been and set the borders individually for each cell. - We will probably enhance HSSF in the future to make this process easier.

- - - - - I am using styles when creating a workbook in POI, but Excel refuses to open the file, complaining about "Too Many Styles". - - -

You just create the styles OUTSIDE of the loop in which you create cells.

GOOD:

- + } + + + + + + I'm trying to stream an XLS file from a servlet and I'm having some trouble. What's the problem? + + +

+ The problem usually manifests itself as the junk characters being shown on + screen. The problem persists even though you have set the correct mime type. +

+ The short answer is, don't depend on IE to display a binary file type properly if you stream it via a + servlet. Every minor version of IE has different bugs on this issue. +

+ The problem in most versions of IE is that it does not use the mime type on + the HTTP response to determine the file type; rather it uses the file extension + on the request. Thus you might want to add a + .xls to your request + string. For example + http://yourserver.com/myServelet.xls?param1=xx. This is + easily accomplished through URL mapping in any servlet container. Sometimes + a request like + http://yourserver.com/myServelet?param1=xx&dummy=file.xls is also + known to work. +

+ To guarantee opening the file properly in Excel from IE, write out your file to a + temporary file under your web root from your servelet. Then send an http response + to the browser to do a client side redirection to your temp file. (Note that using a + server side redirect using RequestDispatcher will not be effective in this case) +

+ Note also that when you request a document that is opened with an + external handler, IE sometimes makes two requests to the webserver. So if your + generating process is heavy, it makes sense to write out to a temporary file, so that multiple + requests happen for a static file. +

+ None of this is particular to Excel. The same problem arises when you try to + generate any binary file dynamically to an IE client. For example, if you generate + pdf files using + FOP, you will come across many of the same issues. +

+ + + + + + I want to set a cell format (Data format of a cell) of a excel sheet as ###,###,###.#### or ###,###,###.0000. Is it possible using POI ? + + +

+ Yes. You first need to get a DataFormat object from the workbook and call getFormat with the desired format. Some examples are here. +

+ + + + + I want to set a cell format (Data format of a cell) of a excel sheet as text. Is it possible using POI ? + + +

+ Yes. This is a built-in format for excel that you can get from DataFormat object using the format string "@". Also, the string "text" will alias this format. +

+ + + + + How do I add a border around a merged cell? + + +

Add blank cells around where the cells normally would have been and set the borders individually for each cell. + We will probably enhance HSSF in the future to make this process easier.

+ + + + + I am using styles when creating a workbook in POI, but Excel refuses to open the file, complaining about "Too Many Styles". + + +

You just create the styles OUTSIDE of the loop in which you create cells.

GOOD:

+ HSSFWorkbook wb = new HSSFWorkbook(); HSSFSheet sheet = wb.createSheet("new sheet"); HSSFRow row = null; @@ -214,7 +214,8 @@ System.out.println("Core POI came from " + path); cell.setCellValue("X"); cell.setCellStyle(style); - // Orange "foreground", foreground being the fill foreground not the font color. + // Orange "foreground", + // foreground being the fill foreground not the font color. style = wb.createCellStyle(); style.setFillForegroundColor(HSSFColor.ORANGE.index); style.setFillPattern(HSSFCellStyle.SOLID_FOREGROUND); @@ -234,42 +235,44 @@ System.out.println("Core POI came from " + path); // Write the output to a file FileOutputStream fileOut = new FileOutputStream("workbook.xls"); wb.write(fileOut); - fileOut.close(); - -

BAD:

- + fileOut.close(); + +

BAD:

+ HSSFWorkbook wb = new HSSFWorkbook(); HSSFSheet sheet = wb.createSheet("new sheet"); HSSFRow row = null; for (int x = 0; x < 1000; x++) { - // Aqua background - HSSFCellStyle style = wb.createCellStyle(); - style.setFillBackgroundColor(HSSFColor.AQUA.index); - style.setFillPattern(HSSFCellStyle.BIG_SPOTS); - HSSFCell cell = row.createCell((short) 1); - cell.setCellValue("X"); - cell.setCellStyle(style); + // Aqua background + HSSFCellStyle style = wb.createCellStyle(); + style.setFillBackgroundColor(HSSFColor.AQUA.index); + style.setFillPattern(HSSFCellStyle.BIG_SPOTS); + HSSFCell cell = row.createCell((short) 1); + cell.setCellValue("X"); + cell.setCellStyle(style); - // Orange "foreground", foreground being the fill foreground not the font color. - style = wb.createCellStyle(); - style.setFillForegroundColor(HSSFColor.ORANGE.index); - style.setFillPattern(HSSFCellStyle.SOLID_FOREGROUND); + // Orange "foreground", + // foreground being the fill foreground not the font color. + style = wb.createCellStyle(); + style.setFillForegroundColor(HSSFColor.ORANGE.index); + style.setFillPattern(HSSFCellStyle.SOLID_FOREGROUND); - // Create a row and put some cells in it. Rows are 0 based. - row = sheet.createRow((short) k); + // Create a row and put some cells in it. Rows are 0 based. + row = sheet.createRow((short) k); - for (int y = 0; y < 100; y++) { - cell = row.createCell((short) k); - cell.setCellValue("X"); - cell.setCellStyle(style); - } + for (int y = 0; y < 100; y++) { + cell = row.createCell((short) k); + cell.setCellValue("X"); + cell.setCellStyle(style); + } } // Write the output to a file FileOutputStream fileOut = new FileOutputStream("workbook.xls"); wb.write(fileOut); - fileOut.close(); - - + fileOut.close(); + + + diff --git a/src/documentation/content/xdocs/guidelines.xml b/src/documentation/content/xdocs/guidelines.xml new file mode 100644 index 0000000000..485d6db8fb --- /dev/null +++ b/src/documentation/content/xdocs/guidelines.xml @@ -0,0 +1,197 @@ + + + + + +

+ Apache POI - Contribution Guidelines + + + + + + +

+ + + +

Introduction +

Disclaimer +

+ Any information in here that might be perceived as legal information is + informational only. We're not lawyers, so consult a legal professional + if needed. +

The Licensing +

+ The POI project is OpenSource + and developed/distributed under the + Apache Software License. Unlike other licenses this license allows + free open source development; however, it does not require you to release + your source or use any particular license for your source. If you wish + to contribute to POI (which you're very welcome and encouraged to do so) + then you must agree to release the rights of your source to us under this + license. +

Publicly Available Information on the file formats +

+ In early 2008, Microsoft made a fairly complete set of documentation + on the binary file formats freely and publicly available. These were + released under the Open + Specification Promise, which does allow us to use them for + building open source software under the + Apache Software License. +

+ You can download the documentation on Excel, Word, PowerPoint and + Escher (drawing) from + http://www.microsoft.com/interop/docs/OfficeBinaryFormats.mspx. + Documentation on a few of the supporting technologies used in these + file formats can be downloaded from + http://www.microsoft.com/interop/docs/supportingtechnologies.mspx. +

+ Previously, Microsoft published a book on the Excel 97 file format. + It can still be of plenty of use, and is handy dead tree form. Pick up + a copy of "Excel 97 Developer's Kit" from your favourite second hand + book store. +

+ The newer Office Open XML (ooxml) file formats are documented as part + of the ECMA / ISO standardisation effort for the formats. This + documentation is quite large, but you can normally find the bit you + need without too much effort! This can be downloaded from + http://www.ecma-international.org/publications/standards/Ecma-376.htm, + and is also under the OSP. +

+ It is also worth checking the documentation and code of the other + open source implementations of the file formats. +

I just signed an NDA to get a spec from Microsoft and I'd like to contribute +

+ In short, stay away, stay far far away. Implementing these file formats + in POI is done strictly by using public information. Public information + includes sources from other open source projects, books that state the + purpose intended is for allowing implementation of the file format and + do not require any non-disclosure agreement and just hard work. + We are intent on keeping it + legal, by contributing patches you agree to do the same. +

+ If you've ever received information regarding the OLE 2 Compound Document + Format under any type of exclusionary agreement from Microsoft, or + (possibly illegally) received such information from a person bound by + such an agreement, you cannot participate in this project. (Sorry) +

+ Those submitting patches that show insight into the file format may be + asked to state explicitly that they have only ever read the publicly + available file format information, and not any received under an NDA + or similar. +

I just want to get involved but don't know where to start +

Read the rest of the website, understand what POI is and what it does, + the project vision, etc.
Use POI a bit, look for gaps in the documentation and examples.
Join the mail lists and share your knowledge with others.
Get Subversion and check out the POI source tree
Documentation is always the best place to start contributing, maybe you found that if the documentation just told you how to do X then it would make more sense, modify the documentation.
Get used to building POI, you'll be doing it a lot, be one with the build, know its targets, etc.
Write Unit Tests. Great way to understand POI. Look for classes that aren't tested, or aren't tested on a public/protected method level, start there.
Download the file format documentation from Microsoft - + OLE2 Binary File Formats or + OOXML XML File Formats
Submit patches (see below) of your contributions, modifications.
Fill out new features, see Bug database for suggestions.

Submitting Patches +

+ Create patches by getting the latest sources from Subversion. + Alter or add files as appropriate. Then, from the poi directiory, + type svn diff > mypatch.patch. This will capture all of your changes + in a patch file of the appropriate format. However, svn diff won't + capture any new files you may have added. So, if you've added any + files, create an archive (tar.bz2 preferred as its the smallest) in a + path-preserving archive format, relative to your poi directory. + You'll attach both files in the next step. +

+ Patches are submitted via the Bug Database. + Create a new bug, set the subject to [PATCH] followed by a brief description. Explain you patch and any special instructions and submit/save it. + Next, go back to the bug, and create attachements for the patch files you + created. Be sure to describe not only the files purpose, but its format. + (Is that ZIP or a tgz or a bz2 or what?). +

+ Make sure your patches include the @author tag on any files you've altered + or created. Make sure you've documented your changes and altered the + examples/etc to reflect them. Any new additions should have unit tests. + Lastly, ensure that you've provided approriate javadoc. (see + Coding + Standards). Patches that are of low quality may be rejected or + the contributer may be asked to bring them up to spec. +

If you use a unix shell, you may find the following following + sequence of commands useful for building the files to attach.

+ +# Run this in the root of the checkout, i.e. the directory holding +# build.xml and poi.pom + +# Build the directory to hold new files +mkdir /tmp/poi-patch/ +mkdir /tmp/poi-patch/new-files/ + +# Get changes to existing files +svn diff > /tmp/poi-patch/diff.txt + +# Capture any new files, as svn diff won't include them +# Preserve the path +svn status | grep "^\?" | \ + awk '{printf "cp --parents %s /tmp/poi-patch/new-files/\n", $2 }' | sh -s + +# tar up the new files +cd /tmp/poi-patch/new-files/ +tar jcvf ../new-files.tar.bz2 +cd .. + +# Upload these to bugzilla +echo "Please upload to bugzilla:" +echo " /tmp/poi-patch/diff.txt" +echo " /tmp/poi-patch/new-files.tar.bz2" + +

+ + + + diff --git a/src/documentation/content/xdocs/howtobuild.xml b/src/documentation/content/xdocs/howtobuild.xml index f6610703e1..27a5e9e21a 100644 --- a/src/documentation/content/xdocs/howtobuild.xml +++ b/src/documentation/content/xdocs/howtobuild.xml @@ -21,69 +21,72 @@

- How To Build POI + Apache POI - How To Build +

- JDK + JDK Version

POI 3.5 and later requires the JDK version 1.5 or later. Versions prior to 3.5 require JDK 1.4+

- Installing Ant + Install Apache Ant

- The POI build system requires two components to perform a - build. - Ant and - Forrest. + The POI build system requires Apache Ant

Specifically the build has been tested to work with Ant version - 1.7.1 and Forrest 0.5. To install these products download - the distributions and follow the instructions in their - documentation. Make sure you don't forget to set the - environment variables FORREST_HOME and ANT_HOME. The - ANT_HOME/bin directory should be in the path. + 1.7.1. To install the product download the distribution and follow the instructions. +

+ Remember to set the ANT_HOME environment variable and add ANT_HOME/bin + to your shell's PATH.

+ Install JUnit

- One these products are installed you will also need to - download some extra jar files required by the build. + Running unit tests and building a distribution requires JUnit.

- - - - - - - - - -

Library	Location
junit	http://www.junit.org

- Just pick the latest versions of these jars and place - them in ANT_HOME/lib and make sure that optional.jar is - in ANT_HOME/lib . + Just pick the latest versions of the jars from + SourceForge and place + them in ANT_HOME/lib. Make sure that optional.jar is in ANT_HOME/lib. +

+ Install Apache Forrest +

+ The POI build system requires Apache Forrest to build the documentation. +

+ Specifically the build has been tested to work with Forrest 0.5. This is an old release which is available + here. +

+ Remember to set the FORREST_HOME environment variable.

- Running the Build + Building Targets with Ant

The main targets of interest to our users are:

- + - @@ -92,23 +95,28 @@ - - - - - + + + + + - +

Target	Ant Target	Description
clean	Erase all build work products (ie, everything in the +	Erase all build work products (ie. everything in the build directory
test	Run all unit tests from main, contrib and scratchpad
docs	Generate all documentation for the system	Run all unit tests from main, contrib and scratchpad (Requires JUnit)
jar	Produce jar files
docs	Generate all documentation (Requires Apache Forrest)
dist	Create a distribution.	Create a distribution (Requires JUnit and Apache Forrest)

+ diff --git a/src/documentation/content/xdocs/index.xml b/src/documentation/content/xdocs/index.xml index 7532599e11..bca06da917 100644 --- a/src/documentation/content/xdocs/index.xml +++ b/src/documentation/content/xdocs/index.xml @@ -21,54 +21,70 @@

- Apache POI - Java API To Access Microsoft Format Files + Apache POI - the Java API for Microsoft Documents +

28 September 2009 - POI 3.5-FINAL available +

28 September 2009 - POI 3.5-FINAL is now available

A full list of changes is available in the change log. - People interested should also follow the dev list to track progress.

+ People interested should also follow the dev mailing list to track further progress.

See the downloads page for more details.

Purpose +

Mission Statement

- The POI project consists of APIs for manipulating various file formats - based upon Microsoft's OLE 2 Compound Document format, and Office OpenXML format, using - pure Java. In short, you can read and write MS Excel files using Java. In addition, - you can read and write MS Word and MS PowerPoint files using Java. POI is your Java Excel - solution (for Excel 97-2007). However, we have a complete API for porting other OLE 2 - Compound Document formats and welcome others to participate. + The Apache POI Project's mission is to create and maintain Java APIs for manipulating various file formats + based upon the Office Open XML standards (OOXML) and Microsoft's OLE 2 Compound Document format (OLE2). + In short, you can read and write MS Excel files using Java. + In addition, you can read and write MS Word and MS PowerPoint files using Java. Apache POI is your Java Excel + solution (for Excel 97-2008). We have a complete API for porting other OOXML and OLE2 formats and welcome others to participate.

- 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. + OLE2 files include most Microsoft Office files such as XLS, DOC, and PPT as well as MFC serialization API based file formats. + The project provides APIs for the OLE2 Filesystem (POIFS) and + OLE2 Document Properties (HPSF).

- Office OpenXML Format based files include the new (2007+) xml based file formats, - including Microsoft office files such as XLSX, DOCX and PPTX. + Office OpenXML Format is the new standards based XML file format found in Microsoft Office 2007 and 2008. + This includes XLSX, DOCX and PPTX. The project provides a low level API to support the Open Packaging Conventions + using openxml4j.

- As a general policy we try to collaborate as much as possible with other projects to + For each MS Office application there exists a component module that attempts to provide a common high level Java api to both OLE2 and OOXML + document formats. This is most developed for Excel workbooks (SS=HSSF+XSSF). + Work is progressing for Word documents (HWPF+XWPF) and + PowerPoint presentations (HSLF+XSLF). +

+ The project has recently added support for Outlook (HSMF). Microsoft opened the specifications + to this format in October 2007. We would welcome contributions. +

+ There are also projects for Visio (HDGF) and Publisher (HPBF). +

+ As a general policy we collaborate as much as possible with other projects to provide this functionality. Examples include: Cocoon for which there are serializers for HSSF; Open Office.org with whom we collaborate in documenting the XLS format; and Lucene for which we provide format interpretors. When practical, we donate - components directly to those projects for POI-enabling them. + components directly to those projects for POI-enabling them. +

Why should I use Apache POI? +

+ A major use of the Apache POI api is for Text Extraction applications + such as web spiders, index builders, and content management systems.

Why/when would I use POI? -

- We'll tackle this on a component level. POI refers to the whole project. -

So why should you use POIFS, HSSF or XSSF?

@@ -85,136 +101,26 @@ using Java.

Components +

+ The Apache POI Project provides several component modules some of which may not be of interest to you. + Use the information on our Components page to determine which + jar files to include in your classpath. +

- -

Components To Date -

Overview -

The following are components of the entire POI project and a brief - summary of their purpose.

POIFS for OLE 2 Documents -

POIFS is the oldest and most stable part of the project. It is our port of the OLE 2 Compound Document Format to - pure Java. It supports both read and write functionality. All of our components ultimately rely on it by - definition. Please see the POIFS project page for more information.

HSSF and XSSF for Excel Documents -

HSSF is our port of the Microsoft Excel 97(-2007) file format (BIFF8) to pure - 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 - the HSSF+XSSF project page for more - information.

HWPF for Word Documents -

HWPF is our port of the Microsoft Word 97 file format to pure - Java. It supports read, and limited write capabilities. Please see the HWPF project page for more - information. This component is in the early stages of - development. It can already read and write simple files.

Presently we are looking for a contributor to foster the HWPF - development. Jump in!

HSLF for PowerPoint Documents -

HSLF is our port of the Microsoft PowerPoint 97(-2003) file format to pure - Java. It supports read and write capabilities. Please see the HSLF project page for more - information.

HPSF for Document Properties -

HPSF is our port of the OLE 2 property set format to pure - Java. Property sets are mostly use to store a document's properties - (title, author, date of last modification etc.), but they can be used - for application-specific purposes as well.

- -

HPSF supports both reading and writing of properties.

Please see the HPSF project - page for more information.

HDGF for Visio Documents -

HDGF is our port of the Microsoft Viso 97(-2003) file format to pure - Java. It currently only supports reading at a very low level, and - simple text extraction. Please see the HDGF project page for more - information.

HPBF for Publisher Documents -

HPBF is our port of the Microsoft Publisher 98(-2007) file format to pure - Java. It currently only supports reading at a low level for around - half of the file parts, and simple text extraction. Please see the HPBF project page for more - information.

Component map - -

- The POI distribution consists of several JAR files. Not all of them are needed in every case. The following table - shows the relationships between POI components and the JAR files. -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Component	JAR	Maven artifactId
POIFS	poi-version-yyyymmdd.jar	poi
HPSF	poi-version-yyyymmdd.jar	poi
HSSF	poi-version-yyyymmdd.jar	poi
XSSF	poi-ooxml-version-yyyymmdd.jar	poi-ooxml
HLSF	poi-scratchpad-version-yyyymmdd.jar	poi-scratchpad
HWPF	poi-scratchpad-version-yyyymmdd.jar	poi-scratchpad
HDGF	poi-scratchpad-version-yyyymmdd.jar	poi-scratchpad
HPBF	poi-scratchpad-version-yyyymmdd.jar	poi-scratchpad
HSMF	poi-scratchpad-version-yyyymmdd.jar	poi-scratchpad

Contributing

So you'd like to contribute to the project? Great! We need enthusiastic, hard-working, talented folks to help - us on the project in several areas. The first is bug reports and feature requests! The second is documentation - - we'll be at your every beck and call if you've got a critique or you'd like to contribute or otherwise improve - the documentation. Last, but not least, we could use some binary crunching Java coders to chew through the - complexity that characterizes Microsoft's file formats and help us port new ones to a superior Java platform! -

So if you're motivated, ready, and have the time, join the mail lists and we'll be happy to help you get started on the - project! + us on the project. So if you're motivated, ready, and have the time time download the source from the + Subversion Repository, build the code, + join the mailing lists and we'll be happy to help you get started on the project!

+ Please read our Contribution Guidelines. When your contribution is ready + submit a patch to our Bug Database. +

diff --git a/src/documentation/content/xdocs/legal.xml b/src/documentation/content/xdocs/legal.xml index 4950187155..f96087c13d 100644 --- a/src/documentation/content/xdocs/legal.xml +++ b/src/documentation/content/xdocs/legal.xml @@ -24,28 +24,34 @@ Apache POI - Legal Stuff + -

Apache POI - Legal Stuff +

License and Notice +

+ Apache POI releases are available under the Apache License, Version 2.0. + See the NOTICE file contained in each release artifact for applicable copyright attribution notices. Release artifacts are available + from the Download page. +

Copyrights and Trademarks

Sun, Sun Microsystems, Solaris, Java, JavaServer Web Development Kit, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. UNIX is a registered trademark in the United States and other countries, exclusively licensed through 'The Open Group'. -Microsoft, Windows, WindowsNT, Excel, Word, PowerPoint and Win32 are -registered trademarks of -Microsoft Corporation. Linux is a registered trademark of Linus Torvalds. +Microsoft, Windows, WindowsNT, Excel, Word, PowerPoint, Viso, Publisher, Outlook, +and Win32 are registered trademarks of Microsoft Corporation. +Linux is a registered trademark of Linus Torvalds. All other product names mentioned herein and throughout the entire web site are trademarks of their respective owners.

Cryptography Notice

This distribution includes cryptographic software. The country in diff --git a/src/documentation/content/xdocs/mailinglists.xml b/src/documentation/content/xdocs/mailinglists.xml index b984399370..833bcb500f 100644 --- a/src/documentation/content/xdocs/mailinglists.xml +++ b/src/documentation/content/xdocs/mailinglists.xml @@ -90,8 +90,7 @@

diff --git a/src/documentation/content/xdocs/overview.xml b/src/documentation/content/xdocs/overview.xml index 19dd9f62eb..7e284f130c 100644 --- a/src/documentation/content/xdocs/overview.xml +++ b/src/documentation/content/xdocs/overview.xml @@ -21,104 +21,256 @@

- Overview + Apache POI - Component Overview +

- +

Apache POI Project Components +

POIFS for OLE 2 Documents +

+ POIFS is the oldest and most stable part of the project. It is our port of the OLE 2 Compound Document Format to + pure Java. It supports both read and write functionality. All of our components ultimately rely on it by + definition. Please see the POIFS project page for more information. +

HSSF and XSSF for Excel Documents +

+ HSSF is our port of the Microsoft Excel 97(-2007) file format (BIFF8) to pure + Java. XSSF is our port of the Microsoft Excel XML (2007+) file format (OOXML) to + pure Java. SS is a package that provides common support for both formats with a common API. + They both support read and write capability. Please see + the HSSF+XSSF project page for more + information. +

HWPF and XWPF for Word Documents +

+ HWPF is our port of the Microsoft Word 97 (-2003) file format to pure + Java. It supports read, and limited write capabilities. Please see the HWPF project page for more + information. This component remains in early stages of + development. It can already read and write simple files. +

+ We are also working on the XWPF for the WordprocessingML (2007+) format from the + OOXML specification. +

HSLF and XSLF for PowerPoint Documents +

+ HSLF is our port of the Microsoft PowerPoint 97(-2003) file format to pure + Java. It supports read and write capabilities. Please see the HSLF project page for more + information. +

+ We are also working on the XSLF for the PresentationML (2007+) format from the + OOXML specification. +

HPSF for OLE 2 Document Properties +

+ HPSF is our port of the OLE 2 property set format to pure + Java. Property sets are mostly use to store a document's properties + (title, author, date of last modification etc.), but they can be used + for application-specific purposes as well. +

+ HPSF supports both reading and writing of properties. +

+ Please see the HPSF project + page for more information. +

HDGF for Visio Documents +

+ HDGF is our port of the Microsoft Viso 97(-2003) file format to pure + Java. It currently only supports reading at a very low level, and + simple text extraction. Please see the HDGF project page for more + information. +

HPBF for Publisher Documents +

+ HPBF is our port of the Microsoft Publisher 98(-2007) file format to pure + Java. It currently only supports reading at a low level for around + half of the file parts, and simple text extraction. Please see the HPBF project page for more + information. +

HSMF for Outlook Messages +

+ HSMF is our port of the Microsoft Outlook message file format to pure + Java. It currently only some of the textual content of MSG files. + Further support and documentation is expected over the comming weeks and months. + For now, users are advised to consult the unit tests for example use. + Please see the HPBF project page for more + information. +

+ Microsoft has recently added the Outlook file format to its OSP. More information + is now available making implementation of this API an easier task. +

What is it? -

The POI project is the master project for developing pure +

The Apache POI project is the master project for developing pure Java ports of file formats based on Microsoft's OLE 2 Compound Document Format. OLE 2 Compound Document Format is used by Microsoft Office Documents, as well as by programs using MFC property sets to serialize their document objects.

Apache POI is also the master project for developing pure + Java ports of file formats based on Office Open XML (ooxml.) + OOXML is part of an ECMA / ISO standardisation effort. This + documentation is quite large, but you can normally find the bit you + need without too much effort! + ECMA-376 standard is here, + and is also under the Microsoft OSP. +

Sub-Projects +

Component Map

- There following are ports, packages or components contained in the POI project. + The Apache POI distribution consists of support for many document file formats. This support is provided + in several Jar files. Not all of the Jars are needed for every format. The following tables + show the relationships between POI components, Maven repository tags, and the project's Jar files. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Component	Application type	Maven artifactId
POIFS	OLE2 Filesystem	poi
HPSF	OLE2 Property Sets	poi
HSSF	Excel XLS	poi
HSLF	PowerPoint PPT	poi-scratchpad
HWPF	Word DOC	poi-scratchpad
HDGF	Visio VSD	poi-scratchpad
HPBF	Publisher PUB	poi-scratchpad
HSMF	Outlook MSG	poi-scratchpad
XSSF	Excel XLSX	poi-ooxml
XSLF	PowerPoint PPTX	poi-ooxml
XWPF	Word DOCX	poi-ooxml
OpenXML4J	OOXML	poi-ooxml, ooxml-schemas

+ This table maps artifacts into the jar file name. "version-yyyymmdd" is the POI version stamp. For the latest release it is + 3.5-FINAL-20090928. +

+ + + + + + + + + + + + + + + + + + + + + +

Maven artifactId	JAR
poi	poi-version-yyyymmdd.jar
poi-scratchpad	poi-scratchpad-version-yyyymmdd.jar
poi-ooxml	poi-ooxml-version-yyyymmdd.jar
ooxml-schemas	ooxml-schemas-1.0.jar

+ OOXML file formats (poi-ooxml) also require ooxml-schemas-1.0.jar. This jar is large and we are experimenting with smaller versions. + Details are available on the dev mailing list.

POIFS -

- POIFS is the set of APIs - for reading and writing OLE 2 Compound Document Formats using (only) Java. -

- -

HSSF and XSSF -

- HSSF and XSSF are - the set of APIs for reading and writing Microsoft Excel - 97-2007 and OOXML spreadsheets using (only) Java. -

- -

HWPF -

- HWPF is the set of APIs - for reading and writing Microsoft Word 97(-XP) documents using (only) Java. -

- -

HSLF -

- HSLF is the set of APIs - for reading and writing Microsoft PowerPoint 97(-XP) documents using (only) Java. -

- -

HPSF -

- HPSF is the set of APIs - for reading property sets using (only) Java. -

- -

POI-Utils -

- POI-Utils are general purpose artifacts - from POI development that have not yet been implemented elsewhere. We're - always looking to donate these and maintain them as part of a general library - used in another project. These are things we need to complete our mission but - are generally outside of it. -

- -

- Examples - -

Small sample programs using the POI API are available in the +

Examples +

+ Small sample programs using the POI API are available in the src/examples directory of the source distribution. Before studying the source code you might want to have a look at the - "Examples" section of the POI API - documentation.

+ "Examples" section of the POI API + documentation. +

Contributed Software -

Besides the "official" components outlined above there is some further - software distributed with POI. This is called "contributed" software. It +

+ Besides the "official" components outlined above there is some further + software distributed with POI. This is called "contributed" software. It is not explicitly recommended or even maintained by the POI team, but - it might still be useful to you.

- -

- POI Browser -

The POI Browser is a very simple Swing GUI tool that displays the + it might still be useful to you. +

POI Browser +

+ The POI Browser is a very simple Swing GUI tool that displays the internal structure of a Microsoft Office file and especially the property set streams. Further information and instructions how to execute it can be found in the POI - Browser package description.

+ href="apidocs/org/apache/poi/contrib/poibrowser/package-summary.html#package_description">POI + Browser package description. +

diff --git a/src/documentation/content/xdocs/subversion.xml b/src/documentation/content/xdocs/subversion.xml index 61c097622a..6e5d342eb6 100644 --- a/src/documentation/content/xdocs/subversion.xml +++ b/src/documentation/content/xdocs/subversion.xml @@ -21,7 +21,7 @@

- Source Code Repository + Apache POI - Source Code Repository @@ -42,9 +42,11 @@ see the version control page.

- -

Subversion is an open-source version control system. The root url - of the ASF Subversion repository is +

Subversion is an open-source version control system. It has been contributed to the Apache Software Foundation and is + now available here. +

+ The root url of the ASF Subversion repository is http://svn.apache.org/repos/asf/ for non-committers and https://svn.apache.org/repos/asf/ @@ -82,8 +84,7 @@

diff --git a/src/documentation/content/xdocs/text-extraction.xml b/src/documentation/content/xdocs/text-extraction.xml index fa7474bc0f..61bc5c4643 100644 --- a/src/documentation/content/xdocs/text-extraction.xml +++ b/src/documentation/content/xdocs/text-extraction.xml @@ -21,7 +21,7 @@

- POI Text Extraction + Apache POI - Text Extraction @@ -29,7 +29,7 @@

Overview -

POI provides text extraction for all the supported file +

Apache POI provides text extraction for all the supported file formats. In addition, it provides access to the metadata associated with a given file, such as title and author.

In addition to providing direct text extraction classes, @@ -108,50 +108,53 @@ if one of these objects is embedded into a worksheet, the ExtractorFactory class can be used to recover an extractor for it.

- FileInputStream fis = new FileInputStream(inputFile); - POIFSFileSystem fileSystem = new POIFSFileSystem(fis); - // Firstly, get an extractor for the Workbook - POIOLE2TextExtractor oleTextExtractor = ExtractorFactory.createExtractor(fileSystem); - // Then a List of extractors for any embedded Excel, Word, PowerPoint - // or Visio objects embedded into it. - POITextExtractor[] embeddedExtractors = ExtractorFactory.getEmbededDocsTextExtractors(oleTextExtractor); - for (POITextExtractor textExtractor : embeddedExtractors) { - // If the embedded object was an Excel spreadsheet. - if (textExtractor instanceof ExcelExtractor) { - ExcelExtractor excelExtractor = (ExcelExtractor) textExtractor; - System.out.println(excelExtractor.getText()); +FileInputStream fis = new FileInputStream(inputFile); +POIFSFileSystem fileSystem = new POIFSFileSystem(fis); +// Firstly, get an extractor for the Workbook +POIOLE2TextExtractor oleTextExtractor = + ExtractorFactory.createExtractor(fileSystem); +// Then a List of extractors for any embedded Excel, Word, PowerPoint +// or Visio objects embedded into it. +POITextExtractor[] embeddedExtractors = + ExtractorFactory.getEmbededDocsTextExtractors(oleTextExtractor); +for (POITextExtractor textExtractor : embeddedExtractors) { + // If the embedded object was an Excel spreadsheet. + if (textExtractor instanceof ExcelExtractor) { + ExcelExtractor excelExtractor = (ExcelExtractor) textExtractor; + System.out.println(excelExtractor.getText()); + } + // A Word Document + else if (textExtractor instanceof WordExtractor) { + WordExtractor wordExtractor = (WordExtractor) textExtractor; + String[] paragraphText = wordExtractor.getParagraphText(); + for (String paragraph : paragraphText) { + System.out.println(paragraph); } - // A Word Document - else if (textExtractor instanceof WordExtractor) { - WordExtractor wordExtractor = (WordExtractor) textExtractor; - String[] paragraphText = wordExtractor.getParagraphText(); - for (String paragraph : paragraphText) { - System.out.println(paragraph); - } - // Display the document's header and footer text - System.out.println("Footer text: " + wordExtractor.getFooterText()); - System.out.println("Header text: " + wordExtractor.getHeaderText()); - } - // PowerPoint Presentation. - else if (textExtractor instanceof PowerPointExtractor) { - PowerPointExtractor powerPointExtractor = (PowerPointExtractor) textExtractor; - System.out.println("Text: " + powerPointExtractor.getText()); - System.out.println("Notes: " + powerPointExtractor.getNotes()); - } - // Visio Drawing - else if (textExtractor instanceof VisioTextExtractor) { - VisioTextExtractor visioTextExtractor = (VisioTextExtractor) textExtractor; - System.out.println("Text: " + visioTextExtractor.getText()); - } - } + // Display the document's header and footer text + System.out.println("Footer text: " + wordExtractor.getFooterText()); + System.out.println("Header text: " + wordExtractor.getHeaderText()); + } + // PowerPoint Presentation. + else if (textExtractor instanceof PowerPointExtractor) { + PowerPointExtractor powerPointExtractor = + (PowerPointExtractor) textExtractor; + System.out.println("Text: " + powerPointExtractor.getText()); + System.out.println("Notes: " + powerPointExtractor.getNotes()); + } + // Visio Drawing + else if (textExtractor instanceof VisioTextExtractor) { + VisioTextExtractor visioTextExtractor = + (VisioTextExtractor) textExtractor; + System.out.println("Text: " + visioTextExtractor.getText()); + } +}

diff --git a/src/documentation/content/xdocs/who.xml b/src/documentation/content/xdocs/who.xml index 928fc4c499..37f354daba 100644 --- a/src/documentation/content/xdocs/who.xml +++ b/src/documentation/content/xdocs/who.xml @@ -21,9 +21,9 @@

- Apache POI - Who we are + Apache POI - Who We Are - +

@@ -31,7 +31,7 @@

Apache POI - Who we are

- The POI Project operates on a meritocracy: the more you do, the more + The Apache POI Project operates on a meritocracy: the more you do, the more responsibility you will obtain. This page lists all of the people who have gone the extra mile and are Committers. If you would like to get involved, the first step is to join the mailing lists. @@ -41,11 +41,14 @@ We ask that you please do not send us emails privately asking for support. We are non-paid volunteers who help out with the project and we do not necessarily have the time or energy to help people on an individual basis. - Instead, we have set up mailing lists which often contain hundreds of - individuals who will help answer detailed requests for help. The benefit of - using mailing lists over private communication is that it is a shared - resource where others can also learn from common mistakes and as a - community we all grow together. + The mailing lists have many individuals + who will help answer detailed requests for help. The benefit of + using mailing lists over private communication is that they are a shared + resource where others can also learn from common questions. +

+ POI Developers count on feedback from the mailing lists. Many developers do take + an active role on the lists.

@@ -60,25 +63,15 @@

Nick Burch (nick at apache dot org)

- -

Emeritus Committers -

Andrew C. Oliver (acoliver at apache dot org)
Nicola Ken Barozzi (barozzi at nicolaken dot com)
Ryan Ackley (sackley at apache dot org)

Committers

Marc Johnson (mjohnson at apache dot org)
Marc Johnson (mjohnson at apache dot org)
Glen Stampoultzis (glens at apache.org)
Rainer Klute (klute at apache dot org)
Avik Sengupta (avik at apache dot org)
Shawn Laubach (slaubach at apache dot org)
Danny Mui (dmui at apache dot org)
Jason Height (jheight at apache dot org)
Tetsuya Kitahata (tetsuya at apache dot org)
Yegor Kozlov (yegor at apache dot org)
Amol S Deshmukh (amol at apache dot org)
David Fisher (wave at apache dot org)
(Please add your name here!!)

Emeritus Committers +

Andrew C. Oliver (acoliver at gmail dot com)
Nicola Ken Barozzi (barozzi at nicolaken dot com)
Ryan Ackley (sackley at apache dot org)
Tetsuya Kitahata (ai at spa dot nifty dot com)

diff --git a/src/documentation/resources/images/built-with-forrest-button.png b/src/documentation/resources/images/built-with-forrest-button.png new file mode 100644 index 0000000000000000000000000000000000000000..4a787abe4dc7831124c5a3105d328309d671654e GIT binary patch literal 1936 zcmeAS@N?(olHy`uVBq!ia0vp^5kM@@!3-or#C}}@QVJ!m5hWp+B{``KPNkVSB?{%4 zB^e5i1&PTSsS0lSMMbH_C5p!XSU`qIg48;emSp4?F%*}imZj$9IV6Hr>g5-upPn-{ z7N|%Aq{unHpt2}4J)?vn1ZWJ@wBY=-lJdkNkg=tCDTyVS`FXqD1Vn&(#K3xrQo&*h zA(^?U42FjK2B!K3Mr$wBh5%Ktmw5WRvR~q672y_j(|Vu{6yhxKh%9Dc;Q9c)(aAfd*^e>N}8ml8GDLnbh$Vh8yg>#P$;PF zC>QelbcQQ9twO^-_C801qj=2GblKSS!fj&e!5;2=cvDr4f*v|q3raa`n#2k(0Hfotk0b1J=Zc zVix-wb&f*FNxFAB>YkC+NOHE=$eo>CQlF6FW+Y*C$UweP(%~&@q>7f$#X#{A z;Q~QbwWpj0XSnm#bgimu&2m(IKJ4T((08AzspZ9!kdUPob@ zhUPNf9CfQG1}XglS^Z_=`jsLf7uek{k1Lkt=SCSE_Dw?nen%L4B7i^>@v~C&d=nR^FdJVP^0Cp33}tc?Gq$O(FfPpv_~AIPICFic;5W(Z>PHY@&p}`TbikKkV444Jk93Se-mtf*V{`vIwng zXu9Mqxh&@_YxVKtE1Q|E&EFj=C=gTZUe?$exv?(b$cHuUKkhedO?dx=U+Qq@<*v^rKUcg+uGXdSD-c1$LjDs$D3&%&n#_h{2#BhC!i@(`b;D9TORRq zdb5xI_xrb_^#0kXwa*@ycsr?PYU?avxGJe9GyUl7*!OiS zyFPrgF>;P=eC379dw#zycy~ibF5adl<@V%<|Ac&Q-%p5$abw8I1(|q!`K$Bs-$Ufi zn-NYN)w4{zw?yhbQXIC#@eD+l6OwziP6C9qB=6m^)Bp&s4|Xb_eY#M_>}{ahob-+F#617?*~$q0=_@T*^V)U2LV1m;&(&(TU%TRD_D(n) zkt5*A;KlgCw)x%rA4f%Q=dtWM=lnF0i|2Y{YvH!Kii;L@-PURI*lQP0-t8T_&{^nm zamG&RnUcY0o~~6qWBy(4eNK5~Ox(I2w%NP3-Ifalse false - +

true

false - - true + + false poi.apache.org - poi + Apache POI @@ -129,8 +130,8 @@ be used to configure the chosen Forrest skin. Built with Apache Forrest - http://xml.apache.org/forrest/ - images/built-with-forrest-button.png + http://forrest.apache.org/ + skin/images/built-with-forrest-button.png 88 31 diff --git a/src/documentation/skins/poi-site/xslt/fo/document2fo.xsl b/src/documentation/skins/poi-site/xslt/fo/document2fo.xsl index 1295ab9949..54ce2a7ec2 100644 --- a/src/documentation/skins/poi-site/xslt/fo/document2fo.xsl +++ b/src/documentation/skins/poi-site/xslt/fo/document2fo.xsl @@ -24,6 +24,9 @@ + + + diff --git a/src/documentation/skins/poi-site/xslt/html/document2html.xsl b/src/documentation/skins/poi-site/xslt/html/document2html.xsl index 6e8a05d5e0..4c3dd1570b 100644 --- a/src/documentation/skins/poi-site/xslt/html/document2html.xsl +++ b/src/documentation/skins/poi-site/xslt/html/document2html.xsl @@ -97,7 +97,7 @@ and tabs (tab2menu.xsl) to generate the final HTML. - +

diff --git a/src/documentation/skins/poi-site/xslt/html/site2xhtml.xsl b/src/documentation/skins/poi-site/xslt/html/site2xhtml.xsl index 74c0661d17..0de266e269 100644 --- a/src/documentation/skins/poi-site/xslt/html/site2xhtml.xsl +++ b/src/documentation/skins/poi-site/xslt/html/site2xhtml.xsl @@ -63,7 +63,7 @@ footer, searchbar, css etc. As input, it takes XML of the form: ================= start Group Logo ================== - +

@@ -76,8 +76,8 @@ footer, searchbar, css etc. As input, it takes XML of the form: ================= end Group Logo ================== ================= start Project Logo ================== - -

+ +

@@ -140,12 +140,12 @@ footer, searchbar, css etc. As input, it takes XML of the form: + Search +

-
- Search