Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Set-up a translation infrastructure #75

Open
ruphy opened this issue Dec 9, 2019 · 2 comments · May be fixed by #77
Open

Set-up a translation infrastructure #75

ruphy opened this issue Dec 9, 2019 · 2 comments · May be fixed by #77
Labels
meta Meta changes not related to the standard itself

Comments

@ruphy
Copy link
Member

ruphy commented Dec 9, 2019

We need a simple way to manage translations and evolve the standard with automated consistency checks.

The master copy needs to be developed in English, translations are handled with a separate workflow and can be done separately. With a build-like process translated versions are created and uploaded, without the need for manual merges.

@ruphy
Copy link
Member Author

ruphy commented Dec 9, 2019

@bfabio and I decided to try out the following approach:

  • use Gettext as underlying backend for translators
  • implement a custom .pot/.po utility for parsing our dialect of rst correctly (e.g. understanding the "Key: key" syntax)
  • implement two scripts to: generate_pot_merge_po (to create pot files and merge them into existing po files); generate_doc (to generate doc from the master english copy and the translated po files)
  • (later) integrate this system with a CI toolchain

@bfabio
Copy link
Contributor

bfabio commented Dec 12, 2019

Update: after further discussion, we agreed that a solution based on the built-in i18n mechanism in Sphinx would be more beneficial, resulting in a simplification and a better alignment with upstream practices.

@bfabio bfabio linked a pull request Dec 12, 2019 that will close this issue
6 tasks
@libremente libremente added the meta Meta changes not related to the standard itself label Jan 30, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
meta Meta changes not related to the standard itself
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants