Agregando un Idioma

Preparaciones

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 Instalando Dependencias y Construyendo el Manual.

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&ccedil;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:

    1language = 'fr'
    2locale_dirs = ['locale/']
    3gettext_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 su disco. Puede ir al directorio locale``para ver subdirectorio oculto ``.svn dentro del mismo, junto con los directorios del idioma. Necesitará agregar su propio conjunto de archivos para el idioma al que esté 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/gettext -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