Location of site.xml

[Graham Leggett <mi...@sharp.fm>]

Hi all,

The docs for the site plugin mention the site.xml file, but don't indicate
where you are supposed to put this file in your project, or how to
override the location of the file should your project use a non standard
structure.

Anyone know so I can update MSITE-192?

Regards,
Graham
--



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org

Re: Location of site.xml

[Graham Leggett <mi...@sharp.fm>]

On Mon, November 13, 2006 3:13 pm, Franz Allan Valencia See wrote:

> I do not think there is a documentation for the contents of site.xml,
> that is published, but you may want to review [1] since it is the
> structure of site.xml.

The contents of site.xml are reasonably easy to find, however where the
site.xml file is supposed to go, as well as how to override it are not
easy to find.

The only specific mention is in "getting started", a document not likely
to be read by somebody who is already a long time user of maven, but not a
long time user of the site plugin, or in the docs for site:site, where the
siteDirectory configuration directive is mentioned, but not documented.

I started my docs search here:
http://maven.apache.org/plugins/maven-site-plugin/examples/sitedescriptor.html

This page mentions that a "Site Descriptor" exists, but doesn't explicitly
state the Site Descriptor is called site.xml, or where in your project you
should expect to find it (src/site/site.xml), or what configuration
directive you need to specify to change this (siteDirectory).

Regards,
Graham
--




---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org

Re: Location of site.xml

[Franz Allan Valencia See <fr...@gmail.com>]

Good day to you, Graham,

I do not think there is a documentation for the contents of site.xml,
that is published, but you may want to review [1] since it is the
structure of site.xml.

Cheers,
Franz

[1] http://svn.apache.org/repos/asf/maven/doxia/trunk/doxia-decoration-model/src/main/mdo/decoration.mdo

On 11/13/06, Wendy Smoak <ws...@gmail.com> wrote:
> On 11/13/06, Graham Leggett <mi...@sharp.fm> wrote:
>
> > The docs for the site plugin mention the site.xml file, but don't indicate
> > where you are supposed to put this file in your project, or how to
> > override the location of the file should your project use a non standard
> > structure.
> >
> > Anyone know so I can update MSITE-192?
>
> It goes directly in src/site/.  To override it, configure the <siteDirectory>.
>
> http://maven.apache.org/guides/getting-started/index.html#How%20do%20I%20create%20documentation?
>
> http://maven.apache.org/plugins/maven-site-plugin/site-mojo.html
>
> --
> Wendy
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org

Re: Location of site.xml

[Wendy Smoak <ws...@gmail.com>]

On 11/13/06, Graham Leggett <mi...@sharp.fm> wrote:

> The docs for the site plugin mention the site.xml file, but don't indicate
> where you are supposed to put this file in your project, or how to
> override the location of the file should your project use a non standard
> structure.
>
> Anyone know so I can update MSITE-192?

It goes directly in src/site/.  To override it, configure the <siteDirectory>.

http://maven.apache.org/guides/getting-started/index.html#How%20do%20I%20create%20documentation?

http://maven.apache.org/plugins/maven-site-plugin/site-mojo.html

-- 
Wendy

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org