Agregando un Idioma

Preparaciones

Si el idioma al que quieres traducir no ha sido ya iniciado por alguien más y deseas crear un conjunto de nuevos archivos para el idioma deseado, digamos “fr” (Francés), entonces primero debes utilizar el entorno que has creado, como es descrito en :ref: Empezando <about-getting-started>, en particular las secciones Instalar y Construcción.

Esto te dará 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 de los 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.

1. Ve a https://developer.blender.org para crear tu cuenta propia y volverte un desarrollador/traductor para la organización Blender.

2. Inicia sesión de la cuenta y crea una tarea con el tipo todo, dirigiéndote a un administrador en el campo Subscriptores, solicitando a un miembro con los privilegios necesarios para transferir los cambios al repositorio central del equipo de traducción.

3. Abre una instancia de la aplicación de consola, tal como el emulador de terminal de Gnome.

4. Cambia el directorio de trabajo actual al directorio de blender_docs, donde está la instancia de Makefile .

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

1. Asegúrate de que la instancia del directorio build sea removida, si existe alguna:

   make clean
   

2. Convierte todos los archivos rst en archivos de trducción po:

   make gettext
   

3. Crea archivos html:

   make html
   

4. Después de esto, efectivamente puedes ver los archivos html creados localmente al seguir la instrucción generada, tal como:

   xdg-open <path to your English manual>/blender_docs/build/html/index.html
   

Crear la Entrada del Idioma en el Menú HTML

1. Crea una entrada para el idioma en el menú html al abrir el archivo ./resources/theme/js/version_switch.js (asumiendo que estás en el subdirectorio blender_docs).

2. Encuentra la tabla para los idiomas en var all_langs = {..};.

3. Ingresa la entrada: "fr": "Français",, ("fr": "Français"). (Notar los caracteres Unicode.)

4. Descubre los cambios en el repositorio local:

   svn status
   

5. Ingresa tu contraseña:

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

6. Actualiza tu repositorio local a la versión de los cambios más recientes, incluyendo la que recién has hecho:

   svn update .
   

Establecer el Archivo de Configuración Local

1. Abre un editor de texto para ingresar los siguientes textos y cambiar el código del idioma a cualquiera sea el que vayas a traducir:

   language = 'fr'
   locale_dirs = ['locale/']
   gettext_compact = True
   

2. Guarda este archivo como conf.py en el directorio blender_docs, donde está el Makefile.

3. Dile a svn que ignore este archivo cuando realice operaciones al ejecutar este comando shell:

   svn propset svn:ignore conf.py .
   

Generar el Conjunto de Archivos para el Idioma Objetivo

1. Verifica el repositorio de traducción actual utilizando el comando:

   svn checkout https://svn.blender.org/svnroot/bf-manual-translations/trunk/blender_docs/locale
   

   Esto descargará todos los conjuntos de idiomas disponibles en el repositorio en el directorio locale de tu disco. Puedes ir al directorio locale``para ver subdirectorio oculto ``.svn dentro del mismo, conjuntamente con los directorios del idioma. Necesitarás agregar tu propio conjunto de archivos para el idioma al que estés intentando traducir.

2. Desde el directorio blender_docs para generar un conjunto de archivos para el idioma fr:

   make gettext
   sphinx-intl update -p build/locale -l fr
   

   Estos archivos aún están en inglés solamente, con todas las entradas msgstr en blanco.

3. Envía 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"
   

4. No necesitas a todos los otros idiomas que hay ahí, así que de momento remueve el directorio locale:

   rm -fr locale
   

   Descargaremos este nuevo conjunto de idiomas como es explicado en la próxima sección.

Nota

• Es recomendado que crees dos variables de entorno para estos directorios en el .bashrc , para que sea más conveniente cambiar o escribir comandos shell / scripting batch para el proceso de resultados de traducción y revisión:

  export BLENDER_MAN_EN=$HOME/<directory to make file directory above>/blender_docs
  export BLENDER_MAN_FR=$BLENDER_MAN_EN/locale
  

• Los archivos recientemente generados contendrán algunos placeholders para los autores, las fechas de revisión, etc. Si te parece que el trabajo de reemplazarlos es repetitivo, haz uso del script change_placeholders.sh en el subdirectorio ~/blender_docs/toos_maintenance, haz una copia de esto a tu directorio local bin y reemplaza todos los valores que fueron mencionados en el archivo con tus detalles específicos, entonces luego de cada cambio en un archivo, ejecutarías los siguientes comandos para actualizar el archivo con tus datos personales, fecha y hora de revisión, además de generar los archivos html para tu idioma, que puedes ver utilizando tu navegador de Internet:

  $HOME/bin/change_placeholders.sh $BLENDER_MAN_FR
  make -d --trace -w -B -e SPHINXOPTS="-D language='fr'" 2>&1