Internationalising JBoss Tools
by Sean Flanigan
Hi all,
I've been working on a solution that would make it easy for the Red Hat
L10n team to translate JBoss Tools and then include the translations in
JBoss Tools.
I now think that we do need file conversion as part of the build. To
avoid the problem of conflicting translations, I would recommend that
all translations apart from English live as PO files in the source tree,
and their .properties will only be generated as build/runtime artifacts.
The generated .properties files /could/ be stored in the source tree
for convenience if preferred, but in any case I think it's best that all
edits happen in the PO files.
I did consider converting from properties to PO, so that we could have
only properties files in the source tree, not POT/PO, but properties
files don't contain important metadata which is available in PO files
and used by translators to manage workflow, re-use translations, verify
that MessageFormat strings haven't been broken, etc.
And remember, you can't even put Unicode characters in a .properties
file without using native2ascii or a special editor. With PO, you can
use a special Gettext editor if you like, but PO is perfectly happy to
be UTF-8, and editable with any text editor.
I have created a pure Java Ant task (prop2pot) which can generate (from
the English .properties files in the source tree) the translation
templates (POT) to give to Red Hat's L10n team.
The L10n team would then translate the POT files into PO files which
contain the translations.
I have another task po2prop which can generate .properties files from PO
files, but I'm still working on po2frag, which will package .properties
files as plugin fragments, to use as language packs. I have a kludgy
shell script which seems to work, but it really needs to be pure Java if
it's going to be part of the build. I would appreciate some help with
making the Java version less kludgy, since I'm quite new to OSGi bundles.
Regards
Sean.
--
Sean Flanigan
Senior Software Engineer
Engineering - Internationalisation
Red Hat
15 years, 6 months
Re: [jbosstools-dev] need help on generating doc
by Max Rydahl Andersen
> As far as I know you don't need to adjust anything in /.m2/settings.xml.
> All plugins are downloaded to .m2 automatically if they are required.
Okey - I just thought the stylesheets were only available from jboss maven
repository and not
the main maven repository.
> Do you think, it will be a solution to send Anthony ready-built cods
> (html
> and pdf)? The file with the cods is attached.
Well, he needs to add things to the docs so he need to be able to build it.
/max
>
> Best regards, Michael
>
>
>> I remember there beeing a need to adjust something in ~/.m2/settings.xml
>> or something ?
>>
>> /max
>>
>>
>>> Hello Max,
>>>
>>> It's pretty basic:
>>>
>>> 1. You need to have maven installed.
>>> 2. You need to run "mvn clean install" command in the doc(or in the
>>> folder
>>> with pom.xml) folder of your trunk.
>>>
>>> I have just check, the hibernate docs are built successfully.
>>> Hence, Anthony has to make sure that he ran the "mvn clean install"
>>> from
>>>
>>> "trunk\hibernatetools\docs\reference\" folder, since main pom.xml file
>>> is in
>>> that folder.
>>>
>>> The error message he sent is not really informative, though it's clear
>>> that
>>> Maven misses some plugin.
>>> Please ask him to send more info.
>>>
>>> Best regards, Michael
>>>
>>> -----Original Message-----
>>> From: Max Rydahl Andersen [mailto:max.andersen@redhat.com]
>>> Sent: Wednesday, October 22, 2008 3:34 PM
>>> To: Anthony Patricio; jbosstools-dev(a)lists.jboss.org
>>> Cc: Svetlana Mukhina; 'michael sorokin'
>>> Subject: Re: [jbosstools-dev] need help on generating doc
>>>
>>> Svetlana/Michael,
>>>
>>> Do you have the instructions for doing the docbook builds around ?
>>>
>>> /max
>>>
>>>> Hi,
>>>> I'm trying to generate the hbtools doc but I have following error:
>>>> org.jboss.maven.shared.resource.ResourceException: could not locate
>>>> specified re
>>>> source directory
>>>> at
>>>> org.jboss.maven.shared.resource.ResourceDelegate.collectFileNames(Res
>>>> ourceDelegate.java:156)
>>>> at
>>>> org.jboss.maven.shared.resource.ResourceDelegate.process(ResourceDele
>>>> gate.java:108)
>>>> at
>>>> org.jboss.maven.plugins.jdocbook.ResourceMojo.processProjectResources
>>>> (ResourceMojo.java:69)
>>>> at
>>>> org.jboss.maven.plugins.jdocbook.ResourceMojo.process(ResourceMojo.ja
>>>>
>>>> Can someone help me?
>>>>
>>>> thanks,
>>>> Anthony
>>>> _______________________________________________
>>>> jbosstools-dev mailing list
>>>> jbosstools-dev(a)lists.jboss.org
>>>> https://lists.jboss.org/mailman/listinfo/jbosstools-dev
>>>
>>>
>>>
>>
>>
>>
>> --
>> /max
>>
--
/max
15 years, 6 months
Re: [jbosstools-dev] need help on generating doc
by Max Rydahl Andersen
I remember there beeing a need to adjust something in ~/.m2/settings.xml
or something ?
/max
> Hello Max,
>
> It's pretty basic:
>
> 1. You need to have maven installed.
> 2. You need to run "mvn clean install" command in the doc(or in the
> folder
> with pom.xml) folder of your trunk.
>
> I have just check, the hibernate docs are built successfully.
> Hence, Anthony has to make sure that he ran the "mvn clean install" from
>
> "trunk\hibernatetools\docs\reference\" folder, since main pom.xml file
> is in
> that folder.
>
> The error message he sent is not really informative, though it's clear
> that
> Maven misses some plugin.
> Please ask him to send more info.
>
> Best regards, Michael
>
> -----Original Message-----
> From: Max Rydahl Andersen [mailto:max.andersen@redhat.com]
> Sent: Wednesday, October 22, 2008 3:34 PM
> To: Anthony Patricio; jbosstools-dev(a)lists.jboss.org
> Cc: Svetlana Mukhina; 'michael sorokin'
> Subject: Re: [jbosstools-dev] need help on generating doc
>
> Svetlana/Michael,
>
> Do you have the instructions for doing the docbook builds around ?
>
> /max
>
>> Hi,
>> I'm trying to generate the hbtools doc but I have following error:
>> org.jboss.maven.shared.resource.ResourceException: could not locate
>> specified re
>> source directory
>> at
>> org.jboss.maven.shared.resource.ResourceDelegate.collectFileNames(Res
>> ourceDelegate.java:156)
>> at
>> org.jboss.maven.shared.resource.ResourceDelegate.process(ResourceDele
>> gate.java:108)
>> at
>> org.jboss.maven.plugins.jdocbook.ResourceMojo.processProjectResources
>> (ResourceMojo.java:69)
>> at
>> org.jboss.maven.plugins.jdocbook.ResourceMojo.process(ResourceMojo.ja
>>
>> Can someone help me?
>>
>> thanks,
>> Anthony
>> _______________________________________________
>> jbosstools-dev mailing list
>> jbosstools-dev(a)lists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/jbosstools-dev
>
>
>
--
/max
15 years, 6 months