Esta página describe el proceso de traducción de NVDA y los ficheros relacionados usando el proceso de flujo de trabajo automático. Para obtener más información sobre el proceso de traducción en general, lee la página de introducción a la traducción.

El proceso de flujo de trabajo automático consiste en recibir archivos de traducción, trabajar en tus traducciones y luego enviarlas al servidor de traducciones. Esto se hace a través de un sistema de control de versiones llamado Subversion (SVN). De vez en cuando, recibirás nuevas traducciones (junto con nuevos avisos de traducción por correo electrónico o por Twitter (opcional, sigue a “@SRT_” para recibir tuits), y tus traducciones se incluirán en NVDA periódicamente para que puedas probarlas.

Ten en cuenta que necesitas mantener las traducciones actualizadas y probar tu trabajo de traducción para asegurarte de que funciona de la manera prevista. Además, lee el documento del proceso de publicación para recordar las fechas de publicación.

Los detalles del flujo de trabajo se describen a continuación.

Creando una cuenta

Para comenzar el proceso de flujo automático subscríbete a la lista de correos de traducciones de NVDA y solicita una invitación para unirte al flujo de trabajo. Una vez recibas tu invitación en assembla, puedes proceder creando un nombre de usuario/clave de acceso tal que puedas utilizar el servidor svn. Una vez te hayas autentificado, necesitas aceptar la invitación al equipo screenReaderTranslations. Después de eso, no necesitaremos regresar al sitio web.

Descargar e instalar subversion

Actualmente recomendamos Tortoise svn. Descárgalo de http://tortoisesvn.net e instálalo.

La configuración y propiedades predeterminadas de TortoiseSVN están bien, así que no necesitas cambiar nada.

La primera vez que se hace checkout (para descargar el repositorio)

Para descargar el repositorio de screenreader translations crea un directorio, por ejemplo llamado Traducciones, haz clic derecho o pulsa Aplicaciones y desde el menú de Contexto selecciona SVN chekout… Copia y pega la siguiente dirección web en el cuadro de edición de dirección de repositorio:
http://subversion.assembla.com/svn/screenReaderTranslations

Puedes mirar si ha sido correcto cuando la última línea que se imprima diga algo como Completed; Path: At revision: 1234

Estructura del Repositorio

El diseño del repositorio es como sigue:

  • Carpetas de dos caracteres de códigos del idioma (como es para español o fr para francés), según se utilizan por nvda, conteniendo todos los documentos de traducción para este idioma.
  • scripts: los scripts que se ejecutan en el servidor, generalmente no deberían cambiarse.
  • Algunos ficheros t2tconf, ficheros de configuración estándar que no deberían cambiarse.

Cada directorio de idioma contiene:

  • add-ons, los mensajes traducibles para varios complementos (si están habilitados para tu idioma).
  • changes-newRevisions, directorio que contiene las actualizaciones que deben traducirse para el fichero changes.t2t (solo lectura).
  • userGuide-newRevisions, directorio que contiene las actualizaciones que deben traducirse para el fichero userGuide.t2t (solo lectura).
  • symbols-newRevisions, directorio que contiene actualizaciones que deben traducirse para el fichero symbols.dic (solo lectura).
  • changes.t2t, lista localizada de cambios (debes editarlo).
  • changes.html, html generado automáticamente desde t2t, para que puedas verificar la sintaxis.
  • userGuide.t2t, manual localizado (debe editarse).
  • userGuide.html, html generado automáticamente desde tu t2t, para que puedas verificar la sintaxis.
  • userGuide-structureDifferences.txt, genera automáticamente la diferencia entre las estadísticas de la guía de usuario en inglés y las estadísticas de la guía de usuario traducida (muy útil).
  • nvda.po, el archivo de interfaz de NVDA, los nuevos mensajes del pot se fusionan automáticamente, y se te enviará un correo electrónico (o un tuit) cuando haya nuevos mensajes para traducir.
  • characterDescriptions.dic, tu archivo de descripciones de caracteres traducido (debe editarse).
  • symbols.dic, tu archivo de símbolos traducido (debe editarse).
  • Settings, metainformación variada para ayudar al sistema de traducción automática, también se utiliza para indicar cuándo se desea traducir un complemento específico.

Flujo de trabajo

Para minimizar los problemas de combinación, y permitir que el sistema funcione automáticamente con
efectividad se recomienda encarecidamente que se haga:

  • svn update antes de comenzar el trabajo.
  • svn commit cuando finalices el trabajo con una sección.

El flujo de trabajo es algo como esto:

  1. Recibes un correo electrónico diciéndote que nvda.po ha sido actualizado, y te dirá cuántos mensajes están sin traducir, y cuántos están provisionales.
    1. svn update para recibir las modificaciones
    2. Traducir los mensajes nuevos/mensajes provisionales.
    3. Commit, en el mensaje del commit dí si el trabajo se finalizó o no.
  2. Recibes un correo electrónico (o un tuit) que te informa que hay nuevas revisiones para los cambios o que se deben traducir los documentos de la Guía del usuario
    1. svn update, ves un directorio nuevo en changes-newRevisions, por ejemplo 10289.
    2. Dentro de 10289 puedes ver el changes.t2t, el differences.txt, el wordDifferences.txt y el log.txt
    3. En differences.txt deberían estar exactamente las líneas que debes añadir/cambiar/eliminar.
    4. Si tu traducción está completa, los números de línea de cada bloque differences deberían estar cerca de donde necesites realizar tus cambios.
    5. Si differences.txt te mostró una línea que se modificó, y no te resulta sencillo ver qué cambió, (por ejemplo, un signo de puntuación insertado o una ortografía corregida), entonces encuentra la misma línea en wordDifferences.txt , y te mostrará palabra por palabra el cambio.
    6. log.txt, útil en ocasiones para ver el mensaje de commit de los autores de NVDA, por lo que se proporciona en caso de que sea útil.
    7. Cuando finalicemos con todos los bloques de differences para 10289, verificamos para asegurarnos de que nada se haya perdido (consulta svn diff, svn status)
    8. hacemos un svn commit, y en el mensaje decimos que completamos la traducción de 10289.

Órdenes útiles de svn

Descargar nuevos cambios desde el servidor

Para actualizar el repositorio simplemente selecciona la carpeta Traducciones en tu explorador haciendo clic derecho sobre ella y activa SVN update.
La última línea de la ventana de salida debería ser algo como updated to revision 1234.

Las otras líneas mostrarán una lista de ficheros que hayan sido afectados.

    added file1.txt # significa que file.txt ha sido añadido a svn, y estás opteniendo tu copia.
    updated file2.txt # significa que file2.txt ha sido actualizado
    deleted file3.txt # significa que alguien eliminó el fichero y svn también está eliminando tu copia del fichero.
    g file4.txt # significa que se ha cambiado el fichero, y también se cambió por alguien más, pero svn combinó los cambios correctamente.
    c file5.txt # significa que se ha modificado el fichero y ha sido modificado por alguien más, pero svn no pudo combinar automáticamente, esto causa un problema, así que pide ayuda si te ocurre esto.

Haciendo commit (enviando las modificaciones al servidor)

Si tradujiste nuevas revisiones, cambiaste la guía de usuario, etc, puedes enviar los cambios
haciendo clic derecho sobre tu código de idioma dentro de la carpeta Traducciones y seleccionando SVN commit desde el menú.

En el diálogo deberías escribir un mensaje de Commit con tu código de idioma y una descripción del trabajo que has hecho.
Puedes marcar/desmarcar los ficheros a ser enviados.
Los ficheros con cambios están marcados automáticamente.
Si eliminaste un fichero o carpeta en windows,
por omisión está desmarcado en este diálogo, así que tienes que marcarlo para que sea eliminado del repositorio en el servidor.

Modificación involuntaria de un fichero

Si eliminaste un fichero por error o algo como eso puedes revertir los cambios haciendo click derecho sobre la carpeta Traducciones, y seleccionando TortoiseSVN -> revert del menú.

Información que falta

Si tienes cualquier consejo o información adicional porfavor actualiza este archivo.