[jira] Commented: (MPXDOC-128) Internationalized Websites

2005-05-21 Thread Brett Porter (JIRA)
 [ http://jira.codehaus.org/browse/MPXDOC-128?page=comments#action_39477 ]
 
Brett Porter commented on MPXDOC-128:
-

committed. I need to review a couple of things:
- try moving the tags out of jelly tags, get it working with m1
- getting an NPE in 1.1 running plugin tests (probably unrelated bug in 1.1)

I made some changes to i18n.xml (removed the large images, adjusted final 
section text)

> Internationalized Websites
> --
>
>  Key: MPXDOC-128
>  URL: http://jira.codehaus.org/browse/MPXDOC-128
>  Project: maven-xdoc-plugin
> Type: Improvement
> Versions: 1.9
>  Environment: All
> Reporter: Daniel Frey
> Assignee: Brett Porter
>  Attachments: Default language.jpg, French site.jpg, GrabClassLoaderTag.java, 
> UnGrabClassLoaderTag.java, dummy.zip, jelly-tagsdiff.txt, 
> maven-xdoc-plugin-1.9-SNAPSHOT.zip, svndiff.txt, templates_de.properties, 
> xdoc.zip, xdoc_20_05_2005.diff
>
> Original Estimate: 16 hours
> Remaining: 16 hours
>
> Documentation generated by maven xdocs plugin does not support 
> internationalization. The main scope therefore is restricted to developers. 
> However, end user documentation is as well a very suitable scope for mavens 
> web site. I therefore would appreciate an internationalizable xdocs plugin. I 
> consider this an important feature, as it opens maven to new people.

-- 
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


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: [jira] Commented: (MPXDOC-128) Internationalized Websites

2005-04-29 Thread Valerie Nyre
Hello again.


Sorry about my last complaint - 
your quick replies are revitalizing


I don't wnat to make too much noise, but there is one uncertainty... 



Maven 2 and I18N :

Will Maven2 follow the same approach as suggested in MPXDOC-128 (using
the FMT-Taglibrary...)? 

This implies changes in jelly script of all xdocs-dependent plugins...
Is this planned or even in the works ? 




Thanks again

Valerie Nyre






Arnaud HERITIER wrote:
> 
> I'll try to publish a SNAPSHOT with the multi-locales xdoc plugin this WE.
> 
> Arnaud
> 
> On 4/28/05, Vincent Siveton <[EMAIL PROTECTED]> wrote:
> > Hi again,
> >
> > > 1.
> > > Will Maven 2 follow an approach to I18N - will MPXDOC-128 be the solution 
> > > ?


> >
> > AFAIK M2 will provide i18n directly in the POM.
> > The site plugin will generate the website and the reports in different
> > languages.
> >

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: [jira] Commented: (MPXDOC-128) Internationalized Websites

2005-04-28 Thread Arnaud HERITIER
I'll try to publish a SNAPSHOT with the multi-locales xdoc plugin this WE.

Arnaud

On 4/28/05, Vincent Siveton <[EMAIL PROTECTED]> wrote:
> Hi again,
> 
> > 1.
> > Will Maven 2 follow an approach to I18N - will MPXDOC-128 be the solution ?
> 
> AFAIK M2 will provide i18n directly in the POM.
> The site plugin will generate the website and the reports in different
> languages.
> 
> >
> > 2.
> > Can you provide a clean snapshot hat can be used as Jump-Start into using 
> > it ?  With an example that works on Linux  - one which we can just INSTALL 
> > and  RUN THE XDOCS-GENERATE-SITE ?
> 
> I am not a member of the xdoc team so I cant
> 
> > Thanks for you suggestions above - However...My SysAdmin also changed with 
> > the project.xml to point to the correct model. He downloaded the Model, but 
> > this is not the problem we are having.
> >
> > It might be of interest to you to know that we still cannot get the 
> > solution to work on Linux:
> >
> > Maven can BUILD the project, but it seems that the text variables (property 
> > files) cannot be found. Unresolved variables are displayed as "??variable 
> > name??" -
> 
> Its a known limitation for multiproject goal (classloader prob for the 
> reactor)
> Actually, I have no clue about it. Let's see my post:
> http://www.mail-archive.com/dev@maven.apache.org/msg21646.html
> 
> > We followed the user instructions, we named the property files correctly, 
> > we have them both in the /temp/ of xdocs and in the root of our /docs/ 
> > directory. We could not even get your sample to work.
> 
> Well... lets try to update the \maven-xdoc-plugin-1.9-SNAPSHOT\plugin.jelly:
> Comment the deleted task around the line 748 (from the patch in the
> MPXDOC-128 web page)
> 
> > Well, I am a bit ashamed to admit: I made a quick-and-dirty installation of 
> > the snapshot in my Windows system (without the project.xml, 
> > build.properties and the like... which I assumed only important to build 
> > the snapshot... )  and it works.
> >
> > I tried to convince my Sysadmin to do the same, but  I am also having 
> > communication problem now - My sysadmin wants to follow a clean official 
> > procedure and wants to install the complete snapshot.
> 
> Sorry, I can't help with corporate policies!
> 
> > (See above: Question 2)
> >
> > My respect and thanks
> >
> 
> Regards,
> 
> Vincent
> 
> > Valerie
> 
> -
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
> 
>

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: [jira] Commented: (MPXDOC-128) Internationalized Websites

2005-04-28 Thread Vincent Siveton
Hi again,

> 1.
> Will Maven 2 follow an approach to I18N - will MPXDOC-128 be the solution ?

AFAIK M2 will provide i18n directly in the POM.
The site plugin will generate the website and the reports in different
languages.

> 
> 2.
> Can you provide a clean snapshot hat can be used as Jump-Start into using it 
> ?  With an example that works on Linux  - one which we can just INSTALL and  
> RUN THE XDOCS-GENERATE-SITE ?

I am not a member of the xdoc team so I cant

> Thanks for you suggestions above - However...My SysAdmin also changed with 
> the project.xml to point to the correct model. He downloaded the Model, but 
> this is not the problem we are having.
> 
> It might be of interest to you to know that we still cannot get the solution 
> to work on Linux:
> 
> Maven can BUILD the project, but it seems that the text variables (property 
> files) cannot be found. Unresolved variables are displayed as "??variable 
> name??" -

Its a known limitation for multiproject goal (classloader prob for the reactor)
Actually, I have no clue about it. Let's see my post:
http://www.mail-archive.com/dev@maven.apache.org/msg21646.html

> We followed the user instructions, we named the property files correctly, we 
> have them both in the /temp/ of xdocs and in the root of our /docs/ 
> directory. We could not even get your sample to work.

Well... lets try to update the \maven-xdoc-plugin-1.9-SNAPSHOT\plugin.jelly:
Comment the deleted task around the line 748 (from the patch in the
MPXDOC-128 web page)

> Well, I am a bit ashamed to admit: I made a quick-and-dirty installation of 
> the snapshot in my Windows system (without the project.xml, build.properties 
> and the like... which I assumed only important to build the snapshot... )  
> and it works.
> 
> I tried to convince my Sysadmin to do the same, but  I am also having 
> communication problem now - My sysadmin wants to follow a clean official 
> procedure and wants to install the complete snapshot.

Sorry, I can't help with corporate policies!

> (See above: Question 2)
> 
> My respect and thanks
> 

Regards,

Vincent


> Valerie

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



[jira] Commented: (MPXDOC-128) Internationalized Websites

2005-04-28 Thread Valerie Nyre (JIRA)
 [ http://jira.codehaus.org/browse/MPXDOC-128?page=comments#action_38284 ]
 
Valerie Nyre commented on MPXDOC-128:
-

Hello Folks


I am back here again - a simple Maven User - 


Two questions:

1. 
Will Maven 2 follow an approach to I18N - will MPXDOC-128 be the solution ? 


2.
Can you provide a clean snapshot hat can be used as Jump-Start into using it ?  
With an example that works on Linux  - one which we can just INSTALL and  RUN 
THE XDOCS-GENERATE-SITE ? 




Thanks for you suggestions above - However...My SysAdmin also changed with the 
project.xml to point to the correct model. He downloaded the Model, but this is 
not the problem we are having.




It might be of interest to you to know that we still cannot get the solution to 
work on Linux: 


Maven can BUILD the project, but it seems that the text variables (property 
files) cannot be found. Unresolved variables are displayed as "??variable 
name??" - 


We followed the user instructions, we named the property files correctly, we 
have them both in the /temp/ of xdocs and in the root of our /docs/ directory. 
We could not even get your sample to work.


Well, I am a bit ashamed to admit: I made a quick-and-dirty installation of the 
snapshot in my Windows system (without the project.xml, build.properties and 
the like... which I assumed only important to build the snapshot... )  and it 
works. 


I tried to convince my Sysadmin to do the same, but  I am also having 
communication problem now - My sysadmin wants to follow a clean official 
procedure and wants to install the complete snapshot. 


(See above: Question 2)



My respect and thanks 



Valerie 






> Internationalized Websites
> --
>
>  Key: MPXDOC-128
>  URL: http://jira.codehaus.org/browse/MPXDOC-128
>  Project: maven-xdoc-plugin
> Type: Improvement
> Versions: 1.9
>  Environment: All
> Reporter: Daniel Frey
> Assignee: Arnaud HERITIER
>  Attachments: Default language.jpg, French site.jpg, dummy.zip, 
> maven-xdoc-plugin-1.9-SNAPSHOT.zip
>
> Original Estimate: 16 hours
> Remaining: 16 hours
>
> Documentation generated by maven xdocs plugin does not support 
> internationalization. The main scope therefore is restricted to developers. 
> However, end user documentation is as well a very suitable scope for mavens 
> web site. I therefore would appreciate an internationalizable xdocs plugin. I 
> consider this an important feature, as it opens maven to new people.

-- 
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


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



[jira] Commented: (MPXDOC-128) Internationalized Websites

2005-04-27 Thread Daniel Frey (JIRA)
 [ http://jira.codehaus.org/browse/MPXDOC-128?page=comments#action_38206 ]
 
Daniel Frey commented on MPXDOC-128:


Ok, a simple adaptation resolved the issue with the model. Adapting project.xml 
of the plugin and replace 


  maven
  maven-model
  1.1
  jar


with 


  maven
  maven-model
  1.1-SNAPSHOT
  jar


works fine.

Daniel Frey

> Internationalized Websites
> --
>
>  Key: MPXDOC-128
>  URL: http://jira.codehaus.org/browse/MPXDOC-128
>  Project: maven-xdoc-plugin
> Type: Improvement
> Versions: 1.9
>  Environment: All
> Reporter: Daniel Frey
> Assignee: Arnaud HERITIER
>  Attachments: Default language.jpg, French site.jpg, dummy.zip, 
> maven-xdoc-plugin-1.9-SNAPSHOT.zip
>
> Original Estimate: 16 hours
> Remaining: 16 hours
>
> Documentation generated by maven xdocs plugin does not support 
> internationalization. The main scope therefore is restricted to developers. 
> However, end user documentation is as well a very suitable scope for mavens 
> web site. I therefore would appreciate an internationalizable xdocs plugin. I 
> consider this an important feature, as it opens maven to new people.

-- 
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


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



[jira] Commented: (MPXDOC-128) Internationalized Websites

2005-04-27 Thread Daniel Frey (JIRA)
 [ http://jira.codehaus.org/browse/MPXDOC-128?page=comments#action_38205 ]
 
Daniel Frey commented on MPXDOC-128:


Hello Vincent,

When installing the plugin I have come across a small problem I just want to 
feedback here. The snapshot zip contains a directory with the plugin, which in 
turn has to be jared to be deployed correctly. It would be perfect to have a 
jar/zip with the plugin structure inside (no folder).

Thanks,
Daniel Frey

> Internationalized Websites
> --
>
>  Key: MPXDOC-128
>  URL: http://jira.codehaus.org/browse/MPXDOC-128
>  Project: maven-xdoc-plugin
> Type: Improvement
> Versions: 1.9
>  Environment: All
> Reporter: Daniel Frey
> Assignee: Arnaud HERITIER
>  Attachments: Default language.jpg, French site.jpg, dummy.zip, 
> maven-xdoc-plugin-1.9-SNAPSHOT.zip
>
> Original Estimate: 16 hours
> Remaining: 16 hours
>
> Documentation generated by maven xdocs plugin does not support 
> internationalization. The main scope therefore is restricted to developers. 
> However, end user documentation is as well a very suitable scope for mavens 
> web site. I therefore would appreciate an internationalizable xdocs plugin. I 
> consider this an important feature, as it opens maven to new people.

-- 
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


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



[jira] Commented: (MPXDOC-128) Internationalized Websites

2005-04-27 Thread Daniel Frey (JIRA)
 [ http://jira.codehaus.org/browse/MPXDOC-128?page=comments#action_38204 ]
 
Daniel Frey commented on MPXDOC-128:


Hello Vincent,

Thank for your great work! Good job! Now I would like to test it.

I have tried to install the maven-xdoc-plugin-1.9 snapshot using maven 1.0.2. I 
deleted the old plugin in the plugins directory within maven installation 
directory. Running maven site, everything works fine so far:

plugin maven-xdoc-plugin-1.8 is cached (dynatag dep) but no longer present
Cache invalidated due to out of date plugins

But then I get the following error:

Attempting to download commons-jelly-1.0-beta-4.jar.
159K downloaded
Attempting to download maven-model-1.1.jar.
WARNING: Failed to download maven-model-1.1.jar.
Attempting to download commons-jelly-tags-fmt-1.0.jar.
21K downloaded

BUILD FAILED
File.. C:\Dokumente und Einstellungen\Daniel 
Frey\.maven\cache\maven-site-plugin-1.5.2\plugin.jelly
Element... attainGoal
Line.. 40
Column 42
The build cannot continue because of the following unsatisfied dependency:

maven-model-1.1.jar

It seems that this 1.9-SNAPSHOT is relying on a maven-model release not 
available. How can I resolve this issue?

Thanks,
Daniel Frey

> Internationalized Websites
> --
>
>  Key: MPXDOC-128
>  URL: http://jira.codehaus.org/browse/MPXDOC-128
>  Project: maven-xdoc-plugin
> Type: Improvement
> Versions: 1.9
>  Environment: All
> Reporter: Daniel Frey
> Assignee: Arnaud HERITIER
>  Attachments: Default language.jpg, French site.jpg, dummy.zip, 
> maven-xdoc-plugin-1.9-SNAPSHOT.zip
>
> Original Estimate: 16 hours
> Remaining: 16 hours
>
> Documentation generated by maven xdocs plugin does not support 
> internationalization. The main scope therefore is restricted to developers. 
> However, end user documentation is as well a very suitable scope for mavens 
> web site. I therefore would appreciate an internationalizable xdocs plugin. I 
> consider this an important feature, as it opens maven to new people.

-- 
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


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: [jira] Commented: (MPXDOC-128) Internationalized Websites

2005-04-22 Thread Valerie Nyre

Hello Vincent


It would be a pity if this fine solution would remain unnoticed. 

I trust, you tested the fmt taglib for jelly on Linux as well.

In our case, i cannot employ Java-programmers to investigate the
problem, and if we cannot get the solution running we might have to
stall our attempt. 

The only thing we "simple users" can do is try to install a "basic"
maven with minimal functionality to try to avoid any side effects. Of
course, we'll report if we notice anything relevant.




Thanks for your quick response !



Valerie 











Vincent Siveton wrote:
> 
> Hi Valerie,
> 
> This patch works fine for a single project but according my
> experience, we have a classpath problem for bundles in multiproject
> case. Actually, I have no clue about it. Lets see my post:
> http://www.mail-archive.com/dev@maven.apache.org/msg21646.html
> 
> M2 support:
> What does the m2 team think about this issue?
> 
> Vincent
> 
> 2005/4/20, Valerie Nyre (JIRA) <[EMAIL PROTECTED]>:
> > [ http://jira.codehaus.org/browse/MPXDOC-128?page=comments#action_37818 
> > ]
> >
> > Valerie Nyre commented on MPXDOC-128:
> > -
> >
> > Hello
> >
> > Your xdocs suggestion described in
> >
> >http://jira.codehaus.org/browse/MPXDOC-128
> >
> > with the new taglib: fmt works fine for me on Windows 2000.
> >
> > Thank you very much ! ! !
> >
> > For what reason ever, my remote sysadmin working on Linux complains that
> > xdocs cannot resolve the keys  I will travel tomorrow
> > 5 hours to my sysadmin and then "eyeball" his installation - but at the
> > moment I cannot imagine what the problem could be 
> >
> > Perhaps you might have an idea...
> >
> > Thanks if you pay attention to this comment
> >
> > Valerie Nyre
> >
> > > Internationalized Websites
> > > --
> > >
> > >  Key: MPXDOC-128
> > >  URL: http://jira.codehaus.org/browse/MPXDOC-128
> > >  Project: maven-xdoc-plugin
> > > Type: Improvement
> > > Versions: 1.9
> > >  Environment: All
> > > Reporter: Daniel Frey
> > > Assignee: Arnaud HERITIER
> > >  Attachments: Default language.jpg, French site.jpg, dummy.zip, 
> > > maven-xdoc-plugin-1.9-SNAPSHOT.zip
> > >
> > > Original Estimate: 16 hours
> > > Remaining: 16 hours
> > >
> > > Documentation generated by maven xdocs plugin does not support 
> > > internationalization. The main scope therefore is restricted to 
> > > developers. However, end user documentation is as well a very suitable 
> > > scope for mavens web site. I therefore would appreciate an 
> > > internationalizable xdocs plugin. I consider this an important feature, 
> > > as it opens maven to new people.
> >
> > --
> > 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
> >
> > -
> > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > For additional commands, e-mail: [EMAIL PROTECTED]
> >
> >
> 
> -
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: [jira] Commented: (MPXDOC-128) Internationalized Websites

2005-04-20 Thread Vincent Siveton
Hi Valerie,

This patch works fine for a single project but according my
experience, we have a classpath problem for bundles in multiproject
case. Actually, I have no clue about it. Lets see my post:
http://www.mail-archive.com/dev@maven.apache.org/msg21646.html

M2 support: 
What does the m2 team think about this issue?

Vincent


2005/4/20, Valerie Nyre (JIRA) <[EMAIL PROTECTED]>:
> [ http://jira.codehaus.org/browse/MPXDOC-128?page=comments#action_37818 ]
> 
> Valerie Nyre commented on MPXDOC-128:
> -
> 
> Hello
> 
> Your xdocs suggestion described in
> 
>http://jira.codehaus.org/browse/MPXDOC-128
> 
> with the new taglib: fmt works fine for me on Windows 2000.
> 
> Thank you very much ! ! !
> 
> For what reason ever, my remote sysadmin working on Linux complains that
> xdocs cannot resolve the keys  I will travel tomorrow
> 5 hours to my sysadmin and then "eyeball" his installation - but at the
> moment I cannot imagine what the problem could be 
> 
> Perhaps you might have an idea...
> 
> Thanks if you pay attention to this comment
> 
> Valerie Nyre
> 
> > Internationalized Websites
> > --
> >
> >  Key: MPXDOC-128
> >  URL: http://jira.codehaus.org/browse/MPXDOC-128
> >  Project: maven-xdoc-plugin
> > Type: Improvement
> > Versions: 1.9
> >  Environment: All
> > Reporter: Daniel Frey
> > Assignee: Arnaud HERITIER
> >  Attachments: Default language.jpg, French site.jpg, dummy.zip, 
> > maven-xdoc-plugin-1.9-SNAPSHOT.zip
> >
> > Original Estimate: 16 hours
> > Remaining: 16 hours
> >
> > Documentation generated by maven xdocs plugin does not support 
> > internationalization. The main scope therefore is restricted to developers. 
> > However, end user documentation is as well a very suitable scope for mavens 
> > web site. I therefore would appreciate an internationalizable xdocs plugin. 
> > I consider this an important feature, as it opens maven to new people.
> 
> --
> 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
> 
> -
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
> 
>

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



[jira] Commented: (MPXDOC-128) Internationalized Websites

2005-04-20 Thread Valerie Nyre (JIRA)
 [ http://jira.codehaus.org/browse/MPXDOC-128?page=comments#action_37818 ]
 
Valerie Nyre commented on MPXDOC-128:
-

Hello 


Your xdocs suggestion described in 

http://jira.codehaus.org/browse/MPXDOC-128


with the new taglib: fmt works fine for me on Windows 2000. 


Thank you very much ! ! !  



For what reason ever, my remote sysadmin working on Linux complains that
xdocs cannot resolve the keys  I will travel tomorrow
5 hours to my sysadmin and then "eyeball" his installation - but at the
moment I cannot imagine what the problem could be 


Perhaps you might have an idea... 



Thanks if you pay attention to this comment



Valerie Nyre




> Internationalized Websites
> --
>
>  Key: MPXDOC-128
>  URL: http://jira.codehaus.org/browse/MPXDOC-128
>  Project: maven-xdoc-plugin
> Type: Improvement
> Versions: 1.9
>  Environment: All
> Reporter: Daniel Frey
> Assignee: Arnaud HERITIER
>  Attachments: Default language.jpg, French site.jpg, dummy.zip, 
> maven-xdoc-plugin-1.9-SNAPSHOT.zip
>
> Original Estimate: 16 hours
> Remaining: 16 hours
>
> Documentation generated by maven xdocs plugin does not support 
> internationalization. The main scope therefore is restricted to developers. 
> However, end user documentation is as well a very suitable scope for mavens 
> web site. I therefore would appreciate an internationalizable xdocs plugin. I 
> consider this an important feature, as it opens maven to new people.

-- 
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


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



[jira] Commented: (MPXDOC-128) Internationalized Websites

2004-11-13 Thread jira
The following comment has been added to this issue:

 Author: Siveton Vincent
Created: Sat, 13 Nov 2004 9:46 AM
   Body:
I am totally agree with you. The internationalization support is an highly 
issue for some reasons like law constraint (Canada has two official languages - 
English and French)

This issue was already discussed in the past with the release manager of XDOC 
plugin. He suggested me to share here my proposal (as an alpha version) and to 
explain quickly my implementation. 

Here is a generated structure (in totally agreement with the release manager) 
for an english/french web site:
|-- en\
|-- user_dir\
|-- index.html
|-- ... (mail-lists.html, maven-reports.html...)
|-- fr\
|-- user_dir\
|-- index.html
|-- ... (mail-lists.html, maven-reports.html...)
|-- images\
|-- style\
|-- user_dir\
|-- index.html
|-- ... (mail-lists.html, maven-reports.html...)

Thus, we have a default version, an english version and a french one. You can 
easily switch language from the left navigation bar (see screenshot)

My implementation choice is:
* Bundle properties to generate documents from Xdoc templates (allow 
translation for the actual XDOC plugin):
maven-xdoc-plugin-1.9-SNAPSHOT\plugin-resources\templates\templates.properties
* User can define his own bundle. By default, the bundle is in the 
${maven.docs.src} xdoc folder and its name is ${maven.xdoc.bundle}:
${maven.docs.src}\${maven.xdoc.bundle}.properties
LIMITATION: actually, the plugin should copy this bundle to 
maven-xdoc-plugin-1.9-SNAPSHOT\plugin-resources\temp\ directory to provide keys 
access.
* Added message tag to translate easily message. Example:
 ==> it s a shortcut to the user bundle (more quickly to 
write!)
 ==> Key in the defined bundle from the 
XDOC path ie bundle="plugin-resources\temp\myBundle")
About key and text, I choose this rule: define a key is more important that the 
text message itself. 
For instance, blabla will become the myKey value and 
NOT blabla text.
* Update some already defined tags to allow key and bundle management

To try my proposal, unzip attachments:
* maven-xdoc-plugin-1_9-SNAPSHOT.zip to unzip into ${user.home}\.maven\cache\
* a dummy example based on genapp plugin. Just call in a command line "maven 
site" or "maven app:default"

To create your own internationalize web site, just add this keys in your 
project.properties:
maven.xdoc.locale.list=en, fr
maven.xdoc.bundle=xdocs
and add xdocs.properties and xdocs_(fr | en).properties files in your xdocs 
folder
And, write or update your Xdocs to allow keys and bundle;o)

Known problem:
If you are using a big site or a multiproject site, its highly recommanded to 
increase the memory to prevent outofmemory failure
MAVEN_OPTS=-Xms512m -Xmx1024m

Future direction:
I think that every project should have a default language and available 
languages. The language should become a part of the POM definition. Thus, all 
plugins should provide internationalization ways.

Feel free to contact me to other questions or if you have some problems with 
this updated plugin.

Best regards,

Vincent

-
View this comment:
  http://jira.codehaus.org/browse/MPXDOC-128?page=comments#action_26378

-
View the issue:
  http://jira.codehaus.org/browse/MPXDOC-128

Here is an overview of the issue:
-
Key: MPXDOC-128
Summary: Internationalized Websites
   Type: Improvement

 Status: Open
   Priority: Major

 Original Estimate: 16 hours
 Time Spent: Unknown
  Remaining: 16 hours

Project: maven-xdoc-plugin
   Versions:
 1.9

   Assignee: Arnaud HERITIER
   Reporter: Daniel Frey

Created: Fri, 12 Nov 2004 5:26 AM
Updated: Sat, 13 Nov 2004 9:46 AM
Environment: All

Description:
Documentation generated by maven xdocs plugin does not support 
internationalization. The main scope therefore is restricted to developers. 
However, end user documentation is as well a very suitable scope for mavens web 
site. I therefore would appreciate an internationalizable xdocs plugin. I 
consider this an important feature, as it opens maven to new people.


-
JIRA INFORMATION:
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

If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]