Skip to content
Java ODF toolkit project
Branch: master
Clone or download
Latest commit 510eecc Jun 4, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Updating the website Jun 3, 2019
generator Minor version updates Jun 3, 2019
legal Configuration changes caused by switching from 'Apache Foundation' to… Dec 20, 2018
odfdom Update JavaDoc API update Jun 3, 2019
simple Update JavaDoc API update Jun 3, 2019
src/site Update website Jun 4, 2019
taglets JavaDoc fix for older/Linux Maven - adding AdditionalOption within Ad… Jun 3, 2019
validator Minor version updates Jun 3, 2019
xslt-runner-task Enable 'mvn site' and fixing JavaDoc title & bottom lines Jun 3, 2019
xslt-runner Enable 'mvn site' and fixing JavaDoc title & bottom lines Jun 3, 2019
.gitignore Update JavaDoc API update Jun 3, 2019
.travis.yml Removing OracleJDK8 due to required from 16.04 since license change Apr 24, 2019
CHANGES.txt Cleanup and update of pom.xml files May 15, 2019
HEADER.txt fix the broken line endings issue in LICENSE.txt, HEADER.txt, and pom… Dec 14, 2011
KEYS Configuration changes caused by switching from 'Apache Foundation' to… Dec 20, 2018
LICENSE Some tweaks to licenses & notices by Michael Stahl Jan 8, 2019
NOTICE
README.md Update mailinglists Jun 3, 2019
pom.xml Update JavaDoc API update Jun 3, 2019

README.md

Working on your first Pull Request? You can learn how from this free series How to Contribute to an Open Source Project on GitHub

The ODF Toolkit

http://odftoolkit.org

The ODF Toolkit is a set of Java modules that allow programmatic creation, scanning and manipulation of Open Document Format (ISO/IEC 26300 == ODF) documents. Unlike other approaches which rely on runtime manipulation of heavy-weight editors via an automation interface, the ODF Toolkit is lightweight and ideal for server use.

The ODF Toolkit consists of four subcomponents:

  1. ODFDOM (odfdom-java-*.jar) This is an Open Document Format (ODF) framework. Its purpose is to provide an easy, common way to create, access and manipulate ODF files, without requiring detailed knowledge of the ODF specification. It is designed to provide the ODF developer community with an easy, lightweight programming API portable to any object-oriented language.

  2. Simple API (simple-odf-*.jar) 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 ODFDOM API

  3. ODF Validator (odfvalidator-*.war) This is a tool that validates Open Document Format (ODF) files and checks them for conformance according to the ODF Standard. ODF Validator is available as an online service and as a command line tool. This page primarily describes the command line tool. Please visit http://odftoolkit.org/conformance/ODFValidator.html for details regarding the online tool.

  4. ODF XSLT Runner(xslt-runner-.jar, xslt-runner-task-.jar) ODF XSLT Runner is a small Java application that allows you to apply XSLT stylesheets to XML streams included in ODF packages without extracting them from the package. It can be used from the command line. A driver to use it within an Ant build file, ODF XSLT Runner Task, is also available.

Getting Started

The ODF Toolkit is based on Java 8 and uses the Maven 3 http://maven.apache.org/ build system. To build ODF Toolkit, use the following command in this directory:

mvn clean install

The simplest way to use these modules are just put the jars files in your classpath directly. If you are not using maven you can see the versions of the major components for your release in CHANGES.txt.

Documentation

License

See also LICENSE.

Collective work:

  • Copyright 2011-2018 The Apache Software Foundation.
  • Copyright 2018-2019 The Document Foundation.

This product has been created by The Document Foundation, incorporating many modifications from different contributors.

See the NOTICE file distributed with this work for additional information regarding copyright ownership.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

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.

The ODF Toolkit includes a number of subcomponents with separate copyright notices and license terms. Your use of these subcomponents is subject to the terms and conditions of the licenses listed in the LICENSE.txt file.

Mailing Lists

Discussion about ODF Toolkit takes place on the following mailing lists:

The mailing lists are open to anyone and publicly archived.

Issue Tracker

If you encounter errors in ODF Toolkit or want to suggest an improvement or a new feature, please visit the ODF Toolkit issue tracker at https://github.com/tdf/odftoolkit/issues. There you can also find the latest information on known issues and recent bug fixes and enhancements.

You can’t perform that action at this time.