Open Stack

Hi, Andreas

Thank you for asking.
My question is:
I see glossary is a part of documents, not a single document.
If we translate glossary, could it be published alone? How could
translators see their results of work?

I had a talk with Tom Fifiled.
He helped to address these questions:

There is one XML file that includes all glossary terms.
When a book uses a glossary term inside, doc authors mark it with some
special syntax, eg. <glossterm>account</glossterm>,
This generates a custom glossary for each book.
This is why I see a different glossary for each book.
That entire file is actually published to
http://docs.openstack.org/glossary/.
If glossary-terms.xml is translated
(https://github.com/openstack/openstack-manuals/tree/master/doc/glossary),
then all books will have a translated glossary and that particular special
page will also be translated.
Note also: the operations guide has a copy of the glossary. This is
automatically copied. It is an identical file.
(https://github.com/openstack/operations-guide/tree/master/doc/glossary)
So only glossary-terms.xml in the openstack-manuals/doc/glossary folder
needs translation.
Translations will also be automatically copied to operations-guide
repository.

I also talked with Tom about how to display the localized glossary.
If the localized glossary could be displayed with both English terms and
localized terms, it will be wonderful.
i.e. English term is ahead, localized term is followed in a same line,
Below is the explanation, completed localized.

The localized glossary page will include the mapping information between
English term to localized term.
And the terms could be sorted in English alphabetical order.
That will be display a great localized glossary.
But we need write some scripts to implement such function.

Any thoughts or comments?

Best regards
Ying Chun Guo (Daisy)


Andreas Jaeger <aj at suse.com> wrote on 2014/08/22 00:59:58:

> Andreas Jaeger <aj at suse.com>
> 2014/08/22 00:59
>
> To
>
> "openstack-i18n at lists.openstack.org"
<openstack-i18n at lists.openstack.org>,
>
> cc
>
> Subject
>
> [Openstack-i18n] Glossary clarification?
>
> I see on:
> https://wiki.openstack.org/wiki/I18nTeam/docs-translation
> "08/21/2014 - Waiting for a feedback from the doc team about the content
> of the Glossary "
>
> What exactly is your question? could you give some background, please?
>
> Andreas
> --
>  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
>   SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>    GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
>     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126
>
> _______________________________________________
> Openstack-i18n mailing list
> Openstack-i18n at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-i18n/attachments/20140822/9ff1c663/attachment.html>