Changing glossary to ???
Eric Christensen
eric at christensenplace.us
Mon Jun 21 16:34:51 UTC 2010
On Mon, 21 Jun 2010, Ruediger Landmann wrote:
> 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
So how do you propose we put together the Jargon Buster? I understand the
problem but I don't really know what to do with it.
--Eric
More information about the docs
mailing list