Eclipse Community Forums: Platform - User Assistance (UA) » Eclipse Help index has mixed languages

Help

Home

Home » Eclipse Projects » Platform - User Assistance (UA) » Eclipse Help index has mixed languages

Show: Today's Messages :: Show Polls :: Message Navigator

Eclipse Help index has mixed languages [message #474790]

Fri, 14 November 2008 18:52

Eric Roberts

Messages: 24
Registered: July 2009

Junior Member

We are writing our own docs with the DITA OT and sticking them into an
Eclipse Infocenter. We package our doc plugins with multiple languages in
a single plugin using the 'nl' sub directory scheme described in the
Eclipse documentation (the English docs occupy the root of the plugin, all
other languages are under the nl/ directory).

The issue we are having is when a language other than English, for example
German, is displaying (by setting lang=de in the infocenter URL) and the
index tab is opened, any index term at the tertiary level is displayed in
English instead of German. If I use a plugin that has only German these
tertiary terms display correctly in German. I've determined that in the
case of a multilanguage doc plugin, Eclipse is falling back to the English
TOC entry title for those tertiary terms but I have no idea why it would
do that. Looking at the German index.xml file the <topic title="">
attributes are all in German.

Anfrage
Estrellen
Zusammenarbeit
Collaborating on Demand Request Items
Collaboration

If I add a fourth level in the index I notice that the Main parent titles
stay in German but the children are in English

Anfrage
Estrellen
Zusammenarbeit
Collaborating on Demand Request Items
Collaboration
Zusammenarbeit
Collaborating on Demand Request Items
Collaboration

If 'Zusammenarbeit' only has one child, that child displays properly in
German.

Anfrage
Estrellen
Zusammenarbeit
Zusammenarbeit

Here's a relevant piece of the German index.xml file. Is this valid?

<index>
...
<entry keyword="Anfrage">
<entry keyword="Erstellen">
<topic href="html/createdemands.htm" title="Übermitteln von
Erstanfrageeinträgen"/>
</entry>
<entry keyword="Zusammenarbeit">
<topic href="html/collaboration.htm" title="Zusammenarbeit"/>
<topic href="html/demandcollaboration.htm"
title="Zusammenarbeit bei Erstanfrageeinträgen"/>
</entry>
...
</index>

Additionally, there are two entries for Anfrage, Estrellen but each entry
points to a different topic. Why are they being grouped in two separate
Anfrage entries?

Anfrage
Estrellen --> points to topic1.htm
Zusammenarbeit
Collaborating on Demand Request Items
Collaboration
Anfrage
Arefaktaufschlusselung
Estrellen --> points to topic2.htm
Formularbeantwortung

Report message to a moderator

Re: Eclipse Help index has mixed languages [message #474791 is a reply to message #474790]

Fri, 14 November 2008 20:54

Chris Goldthorpe

Messages: 815
Registered: July 2009

Senior Member

Which version of Eclipse are you using? This sounds like something that
was fixed in Eclipse 3.4.1 in IndexAssembler.java.

Report message to a moderator

Re: Eclipse Help index has mixed languages [message #474792 is a reply to message #474791]

Fri, 14 November 2008 21:47

Eric Roberts

Messages: 24
Registered: July 2009

Junior Member

I'm using 3.4. Would I be able to drop the 3.4.1 org.eclipse.help jar
into 3.4 if that is the case?

Report message to a moderator

Re: Eclipse Help index has mixed languages [message #474793 is a reply to message #474792]

Fri, 14 November 2008 22:50

Chris Goldthorpe

Messages: 815
Registered: July 2009

Senior Member

Eric R wrote:
> I'm using 3.4. Would I be able to drop the 3.4.1 org.eclipse.help jar
> into 3.4 if that is the case?
>

That may work but because of the way P2 loads plugins it's possible that
the new version of the plugin will not get automatically loaded when you
restart Eclipse if you put the new org.eclipse.help jar in the plugins
directory. In any case I would recommend that you first test using
Eclipse 3.4.1 tlo see if it fixes the problem for you.

Report message to a moderator

Re: Eclipse Help index has mixed languages [message #474797 is a reply to message #474793]

Mon, 17 November 2008 16:21

Eric Roberts

Messages: 24
Registered: July 2009

Junior Member

Thank you very much, Chris. The org.eclipse.help jar from 3.4.1 does
indeed fix the problem. I removed the older org.eclipse.help jar and
dropped in the new one and it seems to work fine. Is there anything else
I should be cautious of?

Report message to a moderator

Re: Eclipse Help index has mixed languages [message #474827 is a reply to message #474797]

Wed, 19 November 2008 21:58

Chris Goldthorpe

Messages: 815
Registered: July 2009

Senior Member

If that plugin works for you then it should be safe to use it. There
were not many changes between 3.4 and 3.4.1 and none that would not be
backward compatible.

Eric R wrote:
> Thank you very much, Chris. The org.eclipse.help jar from 3.4.1 does
> indeed fix the problem. I removed the older org.eclipse.help jar and
> dropped in the new one and it seems to work fine. Is there anything
> else I should be cautious of?
>

Report message to a moderator