Adición de un nuevo idioma

Preparación

Si el idioma que desea traducir no lo ha iniciado otra persona y desea crear un conjunto de archivos nuevos para el idioma deseado, digamos “fr” (Francés), primero debe usar el entorno que ha creado, como se indica en Primeros pasos, en particular las secciones Instalación de dependencias y Construyendo el Manual.

Esto proporcionará un entorno básico para:

Crear un nuevo conjunto de idioma de traducción a partir de la fuente en inglés.
Ejecutar el comando make para convertir los textos traducidos en archivos po a archivos html para testearlos localmente.
Actualizar los cambios en textos en inglés que hayan sido agregados por otros contribuidores.

Los ejemplos de abajo muestran el proceso de crear un nuevo conjunto de archivos para el idioma francés (código fr) en la plataforma Linux. Otras plataformas podrían variar ligeramente pero en principio debería ser lo mismo.

Goto https://developer.blender.org to create an account for yourself and become a developer/translator for the Blender organization.
Login the account and create a task with todo type, addressing an administrator in the Subscribers field, requesting for a committer right in order to transfer changes to the central repository of the translation team.
Open an instance of the console application, such as Gnome-Terminal emulator.
Change the current working directory to the directory of blender_docs, where the instance of Makefile resides.

Probar el Proceso Make para Crear Archivos HTML en Inglés

Asegúrese de eliminar la instancia anterior del directorio build, si existe alguno:
```
make clean
```
Convierta todos los archivos rst en archivos de traducción pot:
```
make gettext
```
Cree archivos html:
```
make html
```
After this, you can actually view the created html files locally following the prompted instruction, such as:
```
xdg-open <path to your English manual>/blender_docs/build/html/index.html
```

Crear la Entrada del Idioma en el Menú HTML

Create an entry for the language in the html menu by opening file ./resources/theme/js/version_switch.js (assuming you are at the blender_docs subdirectory).
Buscar la tabla para los idiomas en var all_langs = {..};.
Introducir la entrada: "fr": "Français",, ("fr": "Français"). (Nótense los caracteres Unicode).
To find out about changes in the local repository:
```
svn status
```

Enter your password:

svn commit --username <your username> -m "your comment"

Bring your local repository up to the most recent version of changes, including the one you have just done:
```
svn update .
```

Setting the Local Configuration File

Open a text editor to enter the following texts, change the language code to whatever the language you will be translating:
```
1language = 'fr'
2locale_dirs = ['locale/']
3gettext_compact = True
```
Save this file as conf.py in the blender_docs directory, where Makefile resides.
Tells svn to ignore this file when performing operations by executing this shell command:
```
svn propset svn:ignore conf.py .
```

Generar el Conjunto de Archivos para el Idioma Objetivo

Consulte el repositorio de traducción actual con el comando:
```
svn checkout https://svn.blender.org/svnroot/bf-manual-translations/trunk/blender_docs/locale
```
This will download all language sets available in the repository into the locale directory of your drive. You can go to the locale directory to see the hidden subdirectory .svn within it, together with directories of languages. You’ll need to add your own set of files for the language you are trying to translating to.
From the blender_docs directory to generate a set of files for fr language:
```
make gettext
sphinx-intl update -p build/gettext -l fr
```
Estos archivos aún están sólo en inglés, con todas las entradas msgstr en blanco.

Envíe el nuevo conjunto de archivos al repositorio central:

cd locale
svn add fr
svn commit --username <your username> -m "Initial commit language set of files for French"

You don’t need all other languages being there, so remove the locale directory for the time being:
```
rm -fr locale
```
We will download this new set of language as guided in the next section.

Nota

Se recomienda crear dos variables de entorno para estos directorios, en .bashrc para que sea más conveniente cambiar o generar scripts de comandos por lotes/shell para el proceso de traducción y revisión de resultados:
```
export BLENDER_MAN_EN=$HOME/<directory to make file directory above>/blender_docs
export BLENDER_MAN_FR=$BLENDER_MAN_EN/locale
```
Newly generated files will contain some placeholders for authors and revision dates etc. If you find the job of replacing them repetitive, make use of the script change_placeholders.sh in the subdirectory ~/blender_docs/toos_maintenance, make a copy of that to your local bin directory and replace all values that were mentioned in the file with your specific details, then after each change to a file, you would do following commands to update the file with your personal details, revision date and time, plus generating the html files for your language, which you can view using your Internet browser:
```
$HOME/bin/change_placeholders.sh $BLENDER_MAN_FR
make -d --trace -w -B -e SPHINXOPTS="-D language='fr'" 2>&1
```