Description

This is a little maven plugin that allows you to document your maven site using OpenOffice (and I would guess any other software supporting ODF text documents (odt). Only OpenOffice have been tested though) and produce APT documents from that. You must use a special template (APT.ott) that comes along with this plugin. It contains all the formats supported by APT. The plugin will read the .odt document and produce a corresponding .apt document. Any image found in the document will be copied to the image directory specified in the plugin configuration.

See the user guide for more specific information.

Maven usage

Here is an example:

    <plugin>

        <groupId>se.biltmore.tools.odt2apt</groupId>
        <artifactId>maven-odt2apt-plugin</artifactId>
        <version>1.0.1</version>

        <configuration>
            <source>${basedir}/src/site/odt/**/.*\.odt</source>
            <destination>${basedir}/src/site/apt</destination>
            <imageDestination>${basedir}/src/site/resources/images</imageDestination>
            <imageAPTLinkPath>images</imageAPTLinkPath>
        </configuration>

        <executions>
            <execution>
                <id>convert-odt-to-apt</id>
                <goals>
                    <goal>odt-to-apt</goal>
                </goals>
            </execution>
        </executions>

    </plugin>

Now when you do "mvn site " it will execute this plugin in the "pre-site" phase before it start generating the site.

See the UserGuide for how to setup the repository this plugin is available in for automatic download.

Here is a picture of the OpenOffice document that is the source of the odt->apt->html result you are reading right now: