31ab82a2c7
git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@113002 13f79535-47bb-0310-9956-ffa450edef68
56 lines
2.0 KiB
XML
56 lines
2.0 KiB
XML
<?xml version="1.0"?>
|
|
<document>
|
|
|
|
<properties>
|
|
<title>Maven XDoc Plug-in</title>
|
|
<author email="jason@zenplex.com">Jason van Zyl</author>
|
|
</properties>
|
|
|
|
<body>
|
|
<section name="Maven XDoc Plug-in">
|
|
<p>
|
|
The Xdoc plugin is the primary mechanism used to produce the
|
|
Maven-generated documentation as well as any user supplied
|
|
"xdocs". An xdoc is an XML document conforming to a small and
|
|
simple set of tags. Maven uses this format extensively. All
|
|
Maven-generated reports are first generated as an xdoc, which
|
|
is then transformed to HTML via this plugin.
|
|
</p>
|
|
<p>
|
|
The documentation is mainly in <code>Anakia</code> format. More
|
|
information along with samples, can be found at:
|
|
<ul>
|
|
<li>
|
|
<a href="http://jakarta.apache.org/site/jakarta-site-tags.html">the tags defined</a>
|
|
</li>
|
|
<li>
|
|
<a href="http://jakarta.apache.org/site/jakarta-site-tags-example.html">examples of the tags</a>
|
|
</li>
|
|
</ul>
|
|
</p>
|
|
<p>
|
|
There are a few additions to the anakia format. You can use the
|
|
<code>footer</code> tag for including text or images just below
|
|
the navigation menu and above the copyright notice. This tag is
|
|
only usefull in the navigation.xml file and should be placed
|
|
within the body element. For example:
|
|
</p>
|
|
<source><![CDATA[
|
|
<!-- footer will be placed above the (c) -->
|
|
<footer>
|
|
<A href="http://sourceforge.net/projects/ctecl">
|
|
<IMG src="http://sourceforge.net/sflogo.php?group_id=72748" border="0" alt="sf logo"/>
|
|
</A>
|
|
</footer>
|
|
]]></source>
|
|
<p>
|
|
In addition to xdocs, users may wish to include other types of
|
|
files such as images, their own HTML files, PDFs, etc. By
|
|
default, this plugin will copy all files located in the
|
|
<code>maven.docs.src</code> directory (<code>xdocs</code> by
|
|
default) to the final generated site.
|
|
</p>
|
|
</section>
|
|
</body>
|
|
</document>
|