= docx4j component =

/[/projects.html projects]/docx4j

== News ==

docx4j v2.5.0 is out. Includes pptx4j.

xlsx4j is in svn.

== Purpose ==

docx4j is our Java library for manipulating Microsoft Open XML(Word docx, Powerpoint pptx, and Excel xlsx) files.  It uses JAXB to create the in-memory representation.  

It is available under the Apache License (v2).

== Getting started ==

We have a Getting Started guide, in [http://dev.plutext.org/svn/docx4j/trunk/docx4j/docs/Docx4j_GettingStarted.html HTML] and [http://dev.plutext.org/svn/docx4j/trunk/docx4j/docs/Docx4j_GettingStarted.pdf PDF].

The HTML version is also available in the following languages:

- [http://dev.plutext.org/svn/docx4j/trunk/docx4j/docs/Docx4j_GettingStarted_Chinese_simplified.html Chinese simplified]
- [http://dev.plutext.org/svn/docx4j/trunk/docx4j/docs/Docx4j_GettingStarted_Chinese_traditional.html Chinese traditional]
- [http://dev.plutext.org/svn/docx4j/trunk/docx4j/docs/Docx4j_GettingStarted_Francais.html French]
- [http://dev.plutext.org/svn/docx4j/trunk/docx4j/docs/Docx4j_GettingStarted_German.html German]
- [http://dev.plutext.org/svn/docx4j/trunk/docx4j/docs/Docx4j_GettingStarted_Hindi.html Hindi]
- [http://dev.plutext.org/svn/docx4j/trunk/docx4j/docs/Docx4j_GettingStarted_Japanese.html Japanese]
- [http://dev.plutext.org/svn/docx4j/trunk/docx4j/docs/Docx4j_GettingStarted_Russian.html Russian]
- [http://dev.plutext.org/svn/docx4j/trunk/docx4j/docs/Docx4j_GettingStarted_Espagnol.html Spanish]

== Download ==

A nightly build can be found [http://dev.plutext.org/docx4j/ here] (built for Java 1.5+).

Otherwise, you can set up your own [wiki:DevEnv development environment from scratch].

== Requirements and Dependencies ==

You currently need to be using Java 1.5+.  See [http://forums.java.net/jive/thread.jspa?threadID=411 here] regarding issues with 1.4, which retrotranslator can [http://forums.java.net/jive/message.jspa?messageID=212494 reportedly solve].  

docx4j relies on quite a few third party jar files.  We are grateful these are available. Please see [wiki:Docx4jDependencies here] or [http://dev.plutext.org/forums/viewtopic.php?p=425&sid=aaa0e77f5d1191bee7c85f1ecc9a2191#p425 better here] for details.

== Heritage ==

This library is based originally on [http://www.openxml4j.org OpenXML4J], and a number of its source files retain that project's copyright notice. We gratefully acknowledge OpenXML4J's work, and encourage you to use it directly or via Apache POI, especially if you are only working with spreadsheets.  Here is a stab at some of the [wiki:CompareOpenXML4J differences].

== Keywords ==

docx java, Office Open XML, OpenXML, ooxml, WordML, WordprocessingML