maven-plugins/xdoc/xdocs/properties.xml
ltheussl 947857a170 PR: MPXDOC-191
Include dependencies' scope in dependencies page.


git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@377551 13f79535-47bb-0310-9956-ffa450edef68
2006-02-14 00:37:37 +00:00

782 lines
28 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
/*
* Copyright 2001-2004 The Apache Software Foundation.
*
* 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.
*/
-->
<document>
<properties>
<title>XDoc plugin properties</title>
<author email="smor@apache.org">Stéphane MOR</author>
<author email="vmassol@apache.org">Vincent Massol</author>
<author email="vincent.siveton@gmail.com">Vincent Siveton</author>
</properties>
<body>
<section name="Directory Layout Properties">
<table>
<tr>
<th>Property name</th>
<th>Optional?</th>
<th>Description</th>
</tr>
<tr>
<td>maven.docs.dest</td>
<td>Yes</td>
<td>
Specifies the location of the transformed xdocs. This is
used by the "xdoc" goal.
The default value is <code>${maven.build.dir}/docs</code>.
</td>
</tr>
<tr>
<td>maven.docs.src</td>
<td>Yes</td>
<td>
Specifies the location of the project's xdoc
documentation. This is used by the "xdoc" goal.
The default value is <code>${basedir}/xdocs</code>.
</td>
</tr>
<tr>
<td>maven.gen.docs</td>
<td>Yes</td>
<td>
Specifies the location where Maven-generated xdocs are
stored. The generated xdocs are then later transformed to
HTML. The default value is
<code>${maven.build.dir}/generated-xdocs</code>.
</td>
</tr>
</table>
</section>
<section name="Performance Properties">
<table>
<tr>
<th>Property name</th>
<th>Optional?</th>
<th>Description</th>
</tr>
<tr>
<td>maven.xdoc.xml.copy</td>
<td>Yes</td>
<td>
A comma separated list of patterns to specify xml files to copy
from ${maven.docs.src} to ${maven.docs.dest} without
to perform a transformation to HTML.
The default value is empty (no xml files are copied).
</td>
</tr>
<tr>
<td>maven.xdoc.copy.excludes</td>
<td>Yes</td>
<td>
A comma separated list of patterns to specify resources not to copy
in xdoc:copy-resources. By default it is all the images not used by
Maven.
Override this to get back some images you need in your site.
</td>
</tr>
<tr>
<td>maven.xdoc.copy.excludes.classic</td>
<td>Yes</td>
<td>
A comma separated list of patterns to specify resources not to copy
in xdoc:copy-resources when using a theme other than classic.
Override this to get back some images you need in your site when
using a non-classic theme.
</td>
</tr>
<tr>
<td>maven.xdoc.validate.exclude</td>
<td>Yes</td>
<td>
A comma separated list of patterns to specify xml documents that
are to be excluded in <code>xdoc:validate</code>. This defaults to
<code>${maven.xdoc.navigation.file}</code>,
<code>${maven.xdoc.xml.copy}</code>,
<code>changes.xml</code>.
</td>
</tr>
<tr>
<td>maven.xdoc.skip.uptodate</td>
<td>Yes</td>
<td>
If set to <code>true</code>, Maven compares the timestamps
of corresponding source- and generated files and only
performs a transformation if they are different.
This leads to a speedup of the site generation by eliminating
tranforms of unchanged documents. <strong>Note</strong>:
this only applies to user-supplied source documents, if you
change settings in <code>project.xml</code>, <code>navigation.xml</code>
or any other properties- or configuration file, you should
generate the site from scratch to make sure all cross-links
are correct. Defaults to <code>false</code>.
</td>
</tr>
</table>
</section>
<section name="Localization Properties">
<table>
<tr>
<th>Property name</th>
<th>Optional?</th>
<th>Description</th>
</tr>
<tr>
<td>maven.docs.outputencoding</td>
<td>Yes</td>
<td>
Specifies the output encoding of the DVSL generated docs.
The default value is <code>ISO-8859-1</code>, an encoding supporting
english characters as well as most
<a href="http://www.w3.org/International/O-charset-lang.html">
european languages.</a>
</td>
</tr>
</table>
</section>
<section name="I18n Properties">
<table>
<tr>
<th>Property name</th>
<th>Optional?</th>
<th>Description</th>
</tr>
<tr>
<td>maven.xdoc.date.format</td>
<td>Yes</td>
<td>
Sets the format of the date to display. Defaults to "dd MMMM
yyyy" (eg: "14 August 2002"). For details on the format, see
SimpleDateFormat in the jdk documentation.
</td>
</tr>
<tr>
<td>maven.xdoc.date.locale</td>
<td>Yes</td>
<td>DEPRECATED. Use the property maven.xdoc.locale.default instead.<br/>
Sets the locale used for the date. Defaults to ${maven.xdoc.locale.default}.
</td>
</tr>
<tr>
<td>maven.xdoc.locale.default</td>
<td>Yes</td>
<td>
Sets the default locale used for the translation. If null, it is
the default locale for this instance of the Java Virtual Machine
Defaults to "en", ie english, to ensure backwards compatibility.
Be careful, following the standard, this value is case sensitive.
</td>
</tr>
<tr>
<td>maven.xdoc.locale.supported</td>
<td>Yes</td>
<td>
A comma separated list of locales supported by the project,
ie "fr, en_CA".
</td>
</tr>
<tr>
<td>maven.xdoc.bundle.src</td>
<td>Yes</td>
<td>
Specifies the location where user bundles are stored. The
default value is ${maven.docs.src}.
</td>
</tr>
<tr>
<td>maven.xdoc.bundle</td>
<td>Yes</td>
<td>
Specifies the name of the user bundles. The default value is
xdocs.
</td>
</tr>
<tr>
<td>maven.xdoc.ui.displayByDefault</td>
<td>Yes</td>
<td>
Boolean value to specify the display of the default language, ie
"English [By default]". The default value is false.
</td>
</tr>
<tr>
<td>maven.xdoc.ui.localeList.asSelect</td>
<td>Yes</td>
<td>
Boolean value to display the language list as an HTML
&lt;select/&gt; tag. The default value is false.
</td>
</tr>
<tr>
<td>maven.xdoc.ui.localeList.max</td>
<td>Yes</td>
<td>
An integer value to specify the maximum number of locales
displayes without an HTML &lt;select/&gt; tag. The default value is 5.
</td>
</tr>
</table>
</section>
<section name="Presentation Properties">
<table>
<tr>
<th>Property name</th>
<th>Optional?</th>
<th>Description</th>
</tr>
<tr>
<td>maven.xdoc.navigation.file</td>
<td>Yes</td>
<td>
The name of the navigation file to use.
The default is <code>navigation.xml</code>.
</td>
</tr>
<tr>
<td>maven.xdoc.theme</td>
<td>Yes</td>
<td>
The documentation theme to use. The default is <code>theme</code>,
and valid values are <code>theme</code> (Maven 1.0RC2+),
<code>classic</code> (used in Maven 1.0RC1 and below) or
<code>stylus</code> (Maven 1.1-beta-3+).
You can override this property
if you provide a file <code>maven-&lt;theme_name&gt;.css</code>
in the <code>${maven.docs.src}/stylesheets</code> directory.
</td>
</tr>
<tr>
<td>maven.xdoc.theme.file</td>
<td>Yes</td>
<td>
Define the location of a local theme file.
This should be relative to the current <code>${basedir}</code>.
The file will be copied into the
<code>${maven.docs.dest}/style</code> directory.
This is useful for providing a global theme in a multiproject setup.
</td>
</tr>
<tr>
<td>maven.xdoc.theme.url</td>
<td>Yes</td>
<td>
An absolute URL that should point to a CSS file
that can be used in addition to maven-base.css.
</td>
</tr>
<tr>
<td>maven.xdoc.custom.templateDir</td>
<td>Yes</td>
<td>
A directory where custom templates for Maven generated sites may
be defined. The template files should have the same names as
the ones used by the xdoc plugin (<code>mail-lists.xml</code>,
<code>issue-tracking.xml</code>, etc.). By default, the templates
in the <code>${plugin.resources}/templates</code> directory
of the xdoc plugin are used.
</td>
</tr>
<tr>
<td>maven.xdoc.crumb.separator</td>
<td>Yes</td>
<td>The separator between links. Defaults to <code>|</code></td>
</tr>
<tr>
<td>maven.xdoc.date</td>
<td>Yes</td>
<td>
Allows the user to show the site generation date on the generated
website. One can place the date in 5 locations with "maven.xdoc.date":
<ul>
<li>left : at the place of the breadcrumbs (only if there are no breadcrumbs)</li>
<li>right : at the place of the links (only if there are no links)</li>
<li>navigation-top : above the user links, in the navigation menu</li>
<li>navigation-bottom : below Maven's links, in the navigation menu</li>
<li>bottom : on the left side in the footer</li>
</ul>
If "maven.xdoc.date" is left empty, no date is shown on the site (default).
</td>
</tr>
<tr>
<td>maven.xdoc.version</td>
<td>Yes</td>
<td>
The version number to show next to the date.
By default, <code>maven.xdoc.version</code> is not set and the value of
<code>pom.currentVersion</code> is displayed.
If <code>maven.xdoc.version</code> is set to empty, no version is shown on the site.
</td>
</tr>
<tr>
<td>maven.xdoc.includeProjectDocumentation</td>
<td>Yes</td>
<td>
Specifies if Maven should display the maven generated
project documentation on the site's navigation bar. By
default, Maven includes numerous reports and information
regarding a project. Set this value to 'no' to prevent the
inclusion on the navigation bar. Users building a
documentation site only (non-project related) will find this
value useful.
</td>
</tr>
<tr>
<td>maven.xdoc.developmentProcessUrl</td>
<td>Yes</td>
<td>
Sets the url of development process page.
Defaults to <a href="http://maven.apache.org/development-process.html">
http://maven.apache.org/development-process.html</a>.
</td>
</tr>
<tr>
<td>maven.xdoc.legend</td>
<td>Yes</td>
<td>
Whether to display the legend in the left navigation. Default is <code>true</code>.
</td>
</tr>
<tr>
<td>maven.xdoc.poweredby.image</td>
<td>Yes</td>
<td>
Sets the name of the image to use (see images/logos).
</td>
</tr>
<tr>
<td>maven.xdoc.poweredby.title</td>
<td>Yes</td>
<td>
Sets the title of the link for the powered
by logo. Defaults to "Powered by Maven"
</td>
</tr>
<tr>
<td>maven.xdoc.poweredby.url</td>
<td>Yes</td>
<td>
Sets the target of the link for the powered
by logo. Defaults to "http://maven.apache.org/"
</td>
</tr>
<tr>
<td>maven.xdoc.jsl</td>
<td>Yes</td>
<td>
The JSL stylesheet used to convert xdocs to HTML. To override, specify as a
<code>file:</code> URL.
</td>
</tr>
<tr>
<td>maven.xdoc.distributionUrl</td>
<td>Yes</td>
<td>
Location where the artifacts are distributed. This property is
optional. If it is not defined, then the Download report will
not be added to the navigation menu. NOTE: In the future this
information will be described in the POM. Usage example:
<code>maven.xdoc.distributionUrl=http://www.ibiblio.org/maven/maven/plugins</code>.
</td>
</tr>
<tr>
<td>maven.xdoc.distributionType</td>
<td>Yes</td>
<td>
Type of the distributed artifact. Override this property if
your project is distributing artifacts of a type different
that the default. NOTE: In the future
this information will be described in the POM.
Default value: <code>maven.xdoc.distributionType=jar</code>
</td>
</tr>
</table>
</section>
<section name="UI Color Settings (Classic theme only)">
<table>
<tr><th>Property</th><th>Optional?</th><th>Description</th></tr>
<tr>
<td>maven.ui.body.background</td>
<td>Yes</td>
<td>
Specifies the background color used for the body of each
page. The default value is <code>#fff</code> (white).
</td>
</tr>
<tr>
<td>maven.ui.body.foreground</td>
<td>Yes</td>
<td>
Specifies the foreground color used in the body of each
page. The default value is <code>#000</code> (black).
</td>
</tr>
<tr>
<td>maven.ui.section.background</td>
<td>Yes</td>
<td>
Specifies the background color used in the primary (1st
level) section headers. The default value is
<code>#036</code> (dark blue).
</td>
</tr>
<tr>
<td>maven.ui.section.foreground</td>
<td>Yes</td>
<td>
Specifies the foreground color used in the primary (1st
level) section headers. The default value is
<code>#fff</code> (white).
</td>
</tr>
<tr>
<td>maven.ui.subsection.background</td>
<td>Yes</td>
<td>
Specifies the background color used in the secondary (2nd
level) subsection headers. The default value is
<code>#888</code> (gray).
</td>
</tr>
<tr>
<td>maven.ui.subsection.foreground</td>
<td>Yes</td>
<td>
Specifies the foreground color used in the secondary (2nd
level) subsection headers. The default value is
<code>#fff</code> (white).
</td>
</tr>
<tr>
<td>maven.ui.table.header.background</td>
<td>Yes</td>
<td>
Specifies the background color used in the table header row.
The default value is <code>#bbb</code> (gray).
</td>
</tr>
<tr>
<td>maven.ui.table.header.foreground</td>
<td>Yes</td>
<td>
Specifies the foreground color used in the table header row.
The default value is <code>#fff</code> (white).
</td>
</tr>
<tr>
<td>maven.ui.table.row.odd.background</td>
<td>Yes</td>
<td>
Specifies the background color used in the odd numbered
table rows. The default value is <code>#ddd</code> (gray).
</td>
</tr>
<tr>
<td>maven.ui.table.row.odd.foreground</td>
<td>Yes</td>
<td>
Specifies the foreground color used in the odd numbered
table rows. The default value is <code>#000</code> (black).
</td>
</tr>
<tr>
<td>maven.ui.table.row.even.background</td>
<td>Yes</td>
<td>
Specifies the background color used in the even numbered
table rows. The default value is <code>#ddd</code> (gray).
</td>
</tr>
<tr>
<td>maven.ui.table.row.even.foreground</td>
<td>Yes</td>
<td>
Specifies the foreground color used in the even numbered
table rows. The default value is <code>#000</code> (black).
</td>
</tr>
<tr>
<td>maven.ui.banner.background</td>
<td>Yes</td>
<td>
Specifies the background color used in the banner. The
default value is <code>#036</code> (dark blue).
</td>
</tr>
<tr>
<td>maven.ui.banner.foreground</td>
<td>Yes</td>
<td>
Specifies the foreground color used in the banner. The
default value is <code>#fff</code> (white).
</td>
</tr>
<tr>
<td>maven.ui.banner.border.top</td>
<td>Yes</td>
<td>
Specifies the color used for the top-edge border of the
banner. The default value is <code>#369</code> (blue).
</td>
</tr>
<tr>
<td>maven.ui.banner.border.bottom</td>
<td>Yes</td>
<td>
Specifies the color used for the bottom-edge border of the
banner. The default value is <code>#003</code> (black).
</td>
</tr>
<tr>
<td>maven.ui.source.background</td>
<td>Yes</td>
<td>
Specifies the background color used in the source regions.
The default value is <code>#036</code> (dark blue).
</td>
</tr>
<tr>
<td>maven.ui.source.foreground</td>
<td>Yes</td>
<td>
Specifies the foreground color used in the source regions.
The default value is <code>#fff</code> (white).
</td>
</tr>
<tr>
<td>maven.ui.source.border.top</td>
<td>Yes</td>
<td>
Specifies the color used for the top-edge border of source
regions. The default value is <code>#888</code> (gray).
</td>
</tr>
<tr>
<td>maven.ui.source.border.bottom</td>
<td>Yes</td>
<td>
Specifies the color used for the bottom-edge border of
source regions. The default value is <code>#888</code>
(gray).
</td>
</tr>
<tr>
<td>maven.ui.source.border.right</td>
<td>Yes</td>
<td>
Specifies the color used for the right-edge border of
source regions. The default value is <code>#888</code>
(gray).
</td>
</tr>
<tr>
<td>maven.ui.source.border.left</td>
<td>Yes</td>
<td>
Specifies the color used for the left-edge border of
source regions. The default value is <code>#888</code>
(gray).
</td>
</tr>
<tr>
<td>maven.ui.navcol.background</td>
<td>Yes</td>
<td>
Specifies the background color used for the navigation
column on the left-hand side of the page. The default value
is <code>#eee</code> (gray).
</td>
</tr>
<tr>
<td>maven.ui.navcol.background.ns4</td>
<td>Yes</td>
<td>
Specifies the background color used for the navigation
column on the left-hand side of the page for Netscape 4.x.
The default value is <code>#fff</code>. Netscape 4.x does
not properly display the entire background using this color,
only the background of the text utilizes this color.
Therefore, it is recommended that this value is set to
white.
</td>
</tr>
<tr>
<td>maven.ui.navcol.foreground</td>
<td>Yes</td>
<td>
Specifies the foreground color used for the navigation
column on the left-hand side of the page. The default value
is <code>#000</code> (black).
</td>
</tr>
<tr>
<td>maven.ui.navcol.foreground.ns4</td>
<td>Yes</td>
<td>
Specifies the foreground color used for the navigation
column on the left-hand side of the page for Netscape 4.x.
The default value is <code>#555</code> (gray).
</td>
</tr>
<tr>
<td>maven.ui.navcol.border.top</td>
<td>Yes</td>
<td>
Specifies the color used for the top-edge border of the
navigation column. The default value is <code>#fff</code>
(white).
</td>
</tr>
<tr>
<td>maven.ui.navcol.border.right</td>
<td>Yes</td>
<td>
Specifies the color used for the right-edge border of the
navigation column. The default value is <code>#aaa</code>
(gray).
</td>
</tr>
<tr>
<td>maven.ui.navcol.border.bottom</td>
<td>Yes</td>
<td>
Specifies the color used for the bottom-edge border of the
navigation column. The default value is <code>#aaa</code>
(gray).
</td>
</tr>
<tr>
<td>maven.ui.navcol.width</td>
<td>Yes</td>
<td>
Specifies the width for the navigation column. The
default value is <code>20%</code>
(gray).
</td>
</tr>
<tr>
<td>maven.ui.breadcrumbs.background</td>
<td>Yes</td>
<td>
Specifies the background color used for the horizontal
navigation bar located immediately under the banner (note:
this element is not displayed on the page if no links have
been specified). The default value is <code>#ddd</code>
(gray).
</td>
</tr>
<tr>
<td>maven.ui.breadcrumbs.foreground</td>
<td>Yes</td>
<td>
Specifies the foreground color used for the horizontal
navigation bar located immediately under the banner (note:
this element is not displayed on the page if no links have
been specified). The default value is <code>#000</code>
(black).
</td>
</tr>
<tr>
<td>maven.ui.breadcrumbs.border.top</td>
<td>Yes</td>
<td>
Specifies the color used for the top-edge border of the
horizontal navigation section. The default value is
<code>#fff</code> (white).
</td>
</tr>
<tr>
<td>maven.ui.breadcrumbs.border.bottom</td>
<td>Yes</td>
<td>
Specifies the color used for the bottom-edge border of the
horizontal navigation section. The default value is
<code>#aaa</code> (gray).
</td>
</tr>
<tr>
<td>maven.ui.href.link</td>
<td>Yes</td>
<td>
Specifies the color used for all links. The default value is
<code>blue</code>.
</td>
</tr>
<tr>
<td>maven.ui.href.link.active</td>
<td>Yes</td>
<td>
Specifies the color used for all links that are active (i.e.
the color used when the mouse is currently over the link).
The default value is <code>#f30</code> (red).
</td>
</tr>
<!--
<tr>
<td>maven.ui.href.link.selfref</td>
<td>Yes</td>
<td>
Specifies the color used for all links that refer to
themselves. The default value is <code>#555</code> (gray).
</td>
</tr>
-->
</table>
</section>
<section name="Pom Settings">
<p>
The <code>Project Info</code> pull-down menu uses several settings
of your <code>project.xml</code> file for generating the pages:
</p>
<p>
The contents of the
<a href="http://maven.apache.org/maven-1.x/reference/project-descriptor.html#class_MailingList"><code>&lt;mailingList&gt;</code></a>
elements are used in the <code>Mailing Lists</code> page.
</p>
<p>
The contents of the
<a href="http://maven.apache.org/maven-1.x/reference/project-descriptor.html#class_Developer"><code>&lt;developer&gt;</code></a>
and
<a href="http://maven.apache.org/maven-1.x/reference/project-descriptor.html#class_Contributor"><code>&lt;contributor&gt;</code></a>
elements are used in the <code>Project Team</code> page.
</p>
<p>
The contents of the
<a href="http://maven.apache.org/maven-1.x/reference/project-descriptor.html#class_Dependency"><code>&lt;dependency&gt;</code></a>
element are used in the <code>Dependencies</code> page.
Note in particular that the optional <code>comment</code> and <code>scope</code> entries are generated by
<code>&lt;comment&gt;</code> and <code>&lt;scope&gt;</code> elements in the <code>&lt;properties&gt;</code> section of each dependency.
The <code>scope</code> parameter is not used in Maven 1 but it is
<a href="http://mavenbook.xwiki.com/xwiki/bin/view/Main/BeMaven2Friendly">recommended</a>
to specify it in order to make the transition to Maven 2 easier.
</p>
<p>
The contents of the
<a href="http://maven.apache.org/maven-1.x/reference/project-descriptor.html#class_Repository"><code>&lt;repository&gt;</code></a>
elements are used in the <code>Source Repository</code> page.
</p>
<p>
The &lt;issueTrackingUrl/&gt; element is used in the <code>Issue Tracking</code> page.
</p>
</section>
</body>
</document>