English: 日本語: 简体(中文):

This is a project to provide mayavi official documentation with multiple versions and multiple languages on Read The Docs site.

Current procedure is tricky because Read The Docs needs 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 sphinx doc. If we want to specify conf.py file that is out of source directory, we will use '-c' option for sphinx-build command. Unfortunately, Read the Docs can't. If there are any better ways, please let me know.

• RTD project pages for Sphinx:

  • https://readthedocs.org/projects/mayavi/ (Master)
  • https://readthedocs.org/projects/mayavi-ja/
  • https://readthedocs.org/projects/mayavi-zh-cn

• Documentation pages for each language:

  • https://mayavi.readthedocs.io/en/latest/
  • https://mayavi.readthedocs.io/ja/latest/
  • https://mayavi.readthedocs.io/zh_CN/latest/

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

Points are:

• We must have RTD projects for each language.
• Each projects must have correct Language setting on "Settings" page.
• Master project has connections to each translated projects on "translations settings" page.

sh ./locale/update.sh

After that, you should commit to updating the PO files.

1. add language to locale/update.sh:

   - rm -R ja
   - tx pull -l ja
   + rm -R ja de
   + tx pull -l ja,de
   

2. Update PO files

3. commit them

4. add a new project on Read The Docs like:

   https://readthedocs.org/projects/mayavi-ja/

5. add translation project to parent project like:

   https://readthedocs.org/dashboard/mayavi/translations/