Use a symetric directory layout (default locale is not on root directory)
-------------------------------------------------------------------------

                 Key: MSITE-434
                 URL: http://jira.codehaus.org/browse/MSITE-434
             Project: Maven 2.x Site Plugin
          Issue Type: New Feature
    Affects Versions: 2.0.1
         Environment: any ?
            Reporter: Tony Chemit


Abstract
--------

Make possible to break to default locale directory layout (adding a parameter 
symetricLayout)

Actually, when using two locales (en,fr) to generate site, the source directory 
layout is like this (symetricLayout=false) : 

src/site/
|-- apt
|   `-- index.apt
|-- fr
|   `-- apt
|       `-- index.apt
|-- site_en.xml
`-- site_fr.xml

And it generates like this :

target/site/
|-- index.html
`-- fr
    `-- index.html

With the parameter symetricLayout=true, the source directory layout is like 
this :

src/site/
|-- en
|   `-- apt
|       `-- index.apt
|-- fr
|   `-- rst
|       `-- index.apt
|-- site_en.xml
`-- site_fr.xml

And it generates this : 

target/site/
|-- en
|   `-- index.html
`-- fr
    `-- index.html

By default the parameter symetricLayout is to false (so nothing is changing :)).

Note
----

when using a single locale, the symetricLayout should always be to false.

Why doing this ?
----------------

We are developping a tool to edit (as a wiki) the generated site and store the 
changed directly in the svn of the project (Each night the site should be 
regenerated).

The purpose of this tools is to make possible external users (mainly our 
clients with credential on svn of course) to improve the documentation of their 
application without our help.

Using a symetric layout without distinguish a default locale is a lot easier 
for us.

Hope the patch will be accepted :)

Tony.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: 
http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Reply via email to