Multi-language support

TODO: this document(s) should serve as an overview of what's Daisy supports for multi-language content and translation management.

Quite some inspiration can already be found on the wiki.

This should not only explain the translation management features, but also best practices for working with language variants (e.g. set up one wiki site per language variant).

klad documentation outline

• intro:

• when to use variants versus just docs in different languages

• terminology: translation management, reference variant/language, translated variant

• pointer to cd-wiki page with design ideas

• possible translation workflows: in Daisy or not, continuously or not (as on cd-wiki)

• pointer to translation import/export

• touch topic of cross-language fields/parts (not supported yet)

• recommended setup

• explain one should have one site per language (and branch), that branch/language query parameters are only intended for exceptional use

• how-to of defining languages, and setting up sites (home page & navtree in multiple languages, use same collection, create siteconf.xml) + how to do this with updated daisy-wiki-add-site tool

• setting the reference language:

• for existing documents

• for newly created documents

• keeping track of translation status

• explain use of the special attributes (background + how-to use in wiki)

• explain how to search for not-in-sync translations