This repository gathers all files involved in translation of shell scripts and
documents provided in the Slint distribution and its website https://slint.fr

Redaers not accustomed with internationalization and localization can read:
https://slint.fr/doc/internationalization_and_localization_of_shell_scripts.html 

Content of the main folders:
* `configuration`: configuration files for `po4a` and the `crowdin` client
  application.
* `po`: POT and PO files
* `localization_toolbox`: helpers for translation of shell scripts. 
* `sources`: internationalized shell scripts, and documents in asciidoc format,
   to be translated.
* `translations`: translations of documents in `sources`,in the same formats. 

Translation processes, applied upon creation of a new source file.
1. If the source file is a shell script it is internationalized by the writer.
2. The translation manager stores the source file in the relevant subdirectory
   of the `sources` directory.
3. The translation manager converts the source file to a POT file and stores
   it in the relevant subdirectory of the `po` directory. The conversion is
   done, depending on the format of the source file:
   . In case of a shell script running `xgettext`, directly or through the 
     script `toolbox.sh` provided in the `localisation_toolbox` directory.
   . In case of an document in asciidoc format, running `po4a` xith as argument
     the relevant configuration file in the `configuration` directory.
4. The translation manager up upload the POT file to Crowdin using the
   `crowdin` client application.
5. Crowdin automatically creates the PO files.
6. The translator either translate directly in Crowdin, or download the PO
   file, translate it using a PO editor then upload the edited PO file to
   Crowdin.
7. The translation manager downloads the translations in PO format using
   `crowdin` to the relevant subdirectory of the `po` directory.
8. The translation manager converts the PO file to a translated file that will
   be stored in the relevant subdircetory of the `translations` directory. 
   The conversion is done, depending on the format of the source file:
   . In case of a shell script running `msgfmt` , directly or through the
     script `toolbox.sh` provided in the `localisation_toolbox` directory.
     In this case the translation in the MO format.
   . In case of an document in asciidoc format, running `po4a` with as argument
     the relevant configuration file in the `configuration` folder.
     In this case the translation is in the asciidoc format, that will be
     converted to html/
9. The translations in are used these ways, depending on the translation unit:
   . The translatons of `slint-scripts` are included in a Slint package also
     named slint-scripts.
   . The translations of `auto`, `rc.S` and `SeTkeymap` are included in the
     Slint installer.
   . The translations of `HandBook`, `homepage` `news` and of the articles
     included in `wiki` are converted to html by the script build_website.sh
     available in https://github.com/DidierSpaier/slint-website that then
     uploads them to the https://slint.fr web site
   . The translations of `HandBook` are alo converted to html by the script
     slint-docs.SlackBuild that builds the slint-doc package to install in
     the system the translated HandBook that allow reading it iff line.


In case of an update of an already translated source file, the
updated POT file is uploaded at step 4, then at stem 5 Crowdin automatically
updates the existing PO files accordingly, then at step 6 the translators edit
them as need be, adding or editing translated text strings.

.
├── CONTENT.md
├── LICENSE
├── README.md
├── configuration
│   ├── HandBook.cfg
│   ├── README.md
│   ├── crowdin.yml
│   ├── homepage.cfg
│   ├── news.cfg
│   ├── slint-scripts.cfg
│   ├── wiki.a001.cfg
│   └── wiki.a002.cfg
├── localization_toolbox
│   ├── README.md
│   ├── docs
│   ├── name
│   ├── po
│   ├── scripts
│   ├── tmp
│   └── toolbox.sh
├── po
│   ├── HandBook
│   ├── SeTkeymap
│   ├── auto
│   ├── homepage
│   ├── news
│   ├── rc.S
│   ├── slint-scripts
│   └── wiki
├── sources
│   ├── HandBook
│   ├── HandBook14.2.1
│   ├── SeTkeymap
│   ├── auto
│   ├── headers
│   ├── homepage
│   ├── news
│   ├── rc.S
│   ├── slint-scripts
│   └── wiki
├── translations
│   └── HandBook
└── wip
    └── note

29 directories, 15 files