README.md

Scientific Python Lectures translations

scientific-python-lectures official documentation translations is a project to provide scientific-python-lectures official documentation, hosted on the Read The Docs platform, in multiple languages.

Note

This is following PEP 545 – Python Documentation Translations.

Note

The current procedure is bit tricky because Read The Docs doesn't have a way to specify options for sphinx-build command. conf.py files for each languages have language and locale_dirs values without having full copy of conf.py of scientific-python-lectures doc. If we want to specify conf.py file that is out of source directory, we will use -c option for the sphinx-build command. Unfortunately Read the Docs doesn't support that. If there is a better way, open an issue.

How the translated documentation projects are setup on RTD

Instructions: https://docs.readthedocs.org/en/latest/localization.html#project-with-multiple-translations

Key points:

• There is a RTD project for each language.
• Each project needs the correct Language setting on the Settings page.
• The parent project needs connections created to each translated project on the Translations Settings page.

Language	Build Status	RTD Project	Transifex
日本語

How to add a new language translation

1. Add new language to locale/update.sh:

-   rm -R es ja
-   tx pull -l es,ja
+   rm -R es ja pt_BR
+   tx pull -l es,ja,pt_BR

2. Update po files:

sh ./locale/update.sh

3. Commit them

4. Add new project on Read The Docs. For example, for pt_BR:

   https://readthedocs.org/projects/scientific-python-lectures-pt-br/

Note

If a RTD project name for a translation is already taken, create a unique project name instead. For example, when scientific-python-lectures-ru was taken, scientific-python-lectures-doc-ru was used instead.

5. Add new translation project to parent project:

   https://readthedocs.org/dashboard/scientific-python-lectures/translations/

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Tetsuo Koyama 📖 🚇 🌍 🤔

This project follows the all-contributors specification. Contributions of any kind welcome!