On 04/11/2017 16:47, Enrico Schürrer wrote:
Dear colleagues,
at the moment I'm working on the translation of the WSJT-X User Guide
into German language.
Please let me know what I will have to do to give this document to the
public.
73's
Enrico
OE1EQW
Hi Enrico and all who might consider contributing to the WSJT-X project
by translating the User Guide to other languages. WSJT-X implements the
User Guide using a simple mark up format called Asciidoctor (a minor
variant of Asciidoc format). This markup is done with ordinary text
files (using utf-8 character encoding to allow for all locales) and they
can be viewed here, in our source control repository:
https://sourceforge.net/p/wsjt/wsjt/HEAD/tree/branches/wsjtx/doc/user_guide/en/
Here is a basic AsciiDoc reference guide that shows how the markup in
these files works:
http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/
Not only is it much easier to translate these files since no final
formatting is required, but also the files are used to produce both HTML
and PDF renderings. By contributing, translated Asciidoctor markup
files, that we can add to the project they will automatically be carried
forward through version upgrades, upgrade edits can be done much more
easily, multiple contributors can be coordinated even for a single
language and the WSJT-X application will automatically select the best
available translation available, depending on your system locale
settings, when the User Guide is selected either in local form or on-line.
WSJT-X itself is also amenable to internationalization (aka i18n), that
is a little more complex but tools exist to build language specific
variants of the text strings shown in the application user interface.
These too will be automatically carried forward through version upgrades
and can be maintained by multiple contributors which avoids the common
issue of abandonment that is prevalent with i18n contributions to open
source projects.
73
Bill
G4WJS.
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
wsjt-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/wsjt-devel
