Sphinx official documentation translations

This is a project to provide Sphinx official documentation, hosted on the Read The Docs platform, in multiple languages.

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.

Build Status	sphinx-doc docs	RTD Project
	http://www.sphinx-doc.org/en	https://app.readthedocs.org/projects/sphinx/ (Parent project)
	http://www.sphinx-doc.org/ar	https://app.readthedocs.org/projects/sphinx-ar/
	http://www.sphinx-doc.org/ca	https://app.readthedocs.org/projects/sphinx-ca-es/
	http://www.sphinx-doc.org/de	https://app.readthedocs.org/projects/sphinx-de/
	http://www.sphinx-doc.org/es	https://app.readthedocs.org/projects/sphinx-es/
	http://www.sphinx-doc.org/fr	https://app.readthedocs.org/projects/sphinx-fr/
	http://www.sphinx-doc.org/it	https://app.readthedocs.org/projects/sphinx-it-it/
	http://www.sphinx-doc.org/ja	https://app.readthedocs.org/projects/sphinx-ja/
	http://www.sphinx-doc.org/ko	https://app.readthedocs.org/projects/sphinx-ko/
	http://www.sphinx-doc.org/pl	https://app.readthedocs.org/projects/sphinx-pl-pl/
	http://www.sphinx-doc.org/pt-br	https://app.readthedocs.org/projects/sphinx-pt-br/
	http://www.sphinx-doc.org/ru	https://app.readthedocs.org/projects/sphinx-doc-ru/
	http://www.sphinx-doc.org/sr	https://app.readthedocs.org/projects/sphinx-sr/
	http://www.sphinx-doc.org/zh-cn	https://app.readthedocs.org/projects/sphinx-zh-cn/

How to add a new language translation

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

   - LANGS='es ja'
   + LANGS='es ja pt_BR'

2. Update po files:

   sh ./locales/update.sh
   

4. Commit them

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

   https://app.readthedocs.org/projects/sphinx-pt-br/

   Note

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

7. Add new translation project to parent project:

   https://app.readthedocs.org/dashboard/sphinx/translations/