Changing glossary to ???

[Ruediger Landmann]

On 06/20/2010 01:58 AM, Eric "Sparks" Christensen wrote:
> I'm working on the Jargon Buster.  The old XML contains tags that are no
> longer used.  It appears to create a glossary.  So what replaces the
> tags that are there?
>    
The validity problem was that the <section> that contained the 
<glossary> lacked a <title>. I've fixed the validity problem (and 
cleaned up the rest of the XML a little) and it builds fine.

However, glossaries cannot be translated properly in a number of 
languages -- notably Chinese and Japanese -- because we cannot yet sort 
entries in those languages. The output from Publican ends up with 
entries in a completely jumbled order. (In fact, the characters are 
being sorted according to their unicode codepoints, but this appears  
completely random to a human reader.)

We have a long-standing bug against Publican to find a solution [0], and 
we're slowly chipping away at it as time allows, but it's non-trivial. 
Note also its appearance on the Publican wishlist, that links to some 
newly-found work that might help [1].

In the meantime, the only safe solution is not to use DocBook for any 
such content, where information is simply sorted according to 
alphabetical order. Until the translation issues can be solved, the Wiki 
is a much better place for this type of material.

Cheers
Rudi


[0] https://bugzilla.redhat.com/show_bug.cgi?id=475684
[1] https://fedorahosted.org/publican/wiki/WishList