<?xml version="1.0" encoding="UTF-8"?>
<!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You 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.
-->
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
<document>
  <header>
    <title>Welcome to the org.apache.forrest.plugin.input.odt Plugin</title>
  </header>
  <body>
    <section id="overview">
      <title>Apache Forrest - org.apache.forrest.plugin.input.odt Plugin</title>
      <p>
        Reads opendocuments and transforms them to xhtml/xdocs
      </p>
    </section>
    <section id="samples">
      <title>Samples</title>
      <p>
        This section includes links to a number of samples using this plugin.
        The plugin is intended to be self documenting through these samples. If
        you require further help please ask on the user mailing list.
      </p>
      <ul>
        <li><fixme author="rdg">
            Add a link to a sample here...
          </fixme></li>
        <li><fixme author="rdg">
            Add another sample link here...
          </fixme></li>
      </ul>
      <note>
        The more samples included here the easier it is for users to understand
        this plugin. If you can provide additional samples please do so.
      </note>
    </section>
    <section>
      <title>Document Title</title>
      <p>
        The displayed title is taken from the meta-data of the opendocument.
      </p>
      <ul>
        <li>If you set the Title field in the document <code>File -> Properties (General Tab)</code> Then this will be used</li>
        <li>Otherwise the first header - that is the title of the first section - will be used</li>
        <li>Otherwise - at last - the document filename will be used.</li>
      </ul>
    </section>
  </body>
</document>
