From 1ba327098287475fab1487d4670c02dc0e40945e Mon Sep 17 00:00:00 2001 From: Luciano Baraglia Date: Tue, 7 Oct 2014 14:11:44 -0300 Subject: [PATCH] Spanish translation workflow updates [skip ci] --- docs/internals-es/translation-workflow.md | 56 +++++++++++-------------------- 1 file changed, 20 insertions(+), 36 deletions(-) diff --git a/docs/internals-es/translation-workflow.md b/docs/internals-es/translation-workflow.md index 80e0759..3492ae4 100644 --- a/docs/internals-es/translation-workflow.md +++ b/docs/internals-es/translation-workflow.md @@ -1,62 +1,46 @@ Flujo de Trabajo de Traducción ============================== -Yii se traduce en muchos idiomas con el fin de ser útil para desarrolladores de aplicaciones e internacionales. Dos áreas principales donde la contribución es muy bienvenida son la documentación y los mensajes del framework. +Yii se traduce en muchos idiomas con el fin de ser útil para desarrolladores de aplicaciones e internacionales. +Dos áreas principales donde la contribución es muy bienvenida son la documentación y los mensajes del framework. -Framework Mensajes ------------------- +Mensajes del Framework +---------------------- -Framework tiene dos tipos de mensajes: excepciones que están destinados al desarrollador y nunca se traducen y mensajes +El framework tiene dos tipos de mensajes: excepciones que están destinadas al desarrollador y nunca se traducen, y mensajes que en realidad son visibles para el usuario final, tales como errores de validación. El orden para comenzar con la traducción de mensajes: -1. Comprobar `framework/messages/config.php` y asegúrese de que su lenguaje aparece en `lenguajes`. Si no, añadir su lenguaje allí (recuerde que debe mantener la lista en orden alfabético). El formato de código de idioma debe seguir [Código de Idiomas IETF](http://es.wikipedia.org/wiki/C%C3%B3digo_de_idioma_IETF), por ejemplo, `es`. -2. Ir al `framework` y ejecutar `yii message/extract messages/config.php`. -3. Traducir los mensajes en `framework/messages/your_lenguaje/yii.php`. Asegúrese de guardar el archivo con codificación UTF-8. +1. Comprobar que en `framework/messages/config.php` su idioma aparece en `languages`. Si no, añade tu idioma allí (recuerda que debes mantener la lista en orden alfabético). +El formato de código de idioma debe seguir el [Código de Idiomas IETF](http://es.wikipedia.org/wiki/C%C3%B3digo_de_idioma_IETF), por ejemplo, `es`. +2. Ir al directorio `framework` y ejecutar el comando `yii message/extract messages/config.php`. +3. Traducir los mensajes en `framework/messages/tu-idioma/yii.php`. Asegúrate de guardar el archivo con codificación UTF-8. 4. [Crear un pull request](https://github.com/yiisoft/yii2/blob/master/docs/internals-es/git-workflow.md). -Con el fin de mantener la traducción al día puede ejecutar `yii message/extract messages/config.php` nuevamente. Se volverán a extraer automáticamente los mensajes de mantenimiento intactos sin los cambios. +Con el fin de mantener la traducción al día puedes ejecutar `yii message/extract messages/config.php` nuevamente. +Se volverán a extraer automáticamente los mensajes de mantenimiento intactos sin los cambios. -En el archivo de traducción de cada elemento de la matriz representa la traducción (valor) de un mensaje (clave). Si el valor está vacío, el mensaje se considera como no traducida. Los mensajes que ya no necesiten traducción tendrán sus traducciones encerrado entre un par de marcas »@@. Cadena de mensaje se puede utilizar con el formato de formas plurales. Compruebe [sección i18n de la guía](../guide-es/tutorial-i18n.md) para más detalles. +En el archivo de traducción de cada elemento del `array` representa un mensaje (clave) y su la traducción (valor). Si el valor está vacío, el mensaje se considera como no traducido. +Los mensajes que ya no necesiten traducción tendrán sus traducciones encerrado entre un par de marcas '@@'. El texto de los mensajes se puede utilizar con el formato de formas plurales. +Chequea la [sección i18n de la guía](../guide-es/tutorial-i18n.md) para más detalles. Documentación ------------- -Coloque traducciones de documentación bajo `docs/-` donde `` es el nombre de la documentación original como `guide` o `internals` y `` es el código de Lenguaje de los docs Lenguaje se convierten a. Para la traducción de guias es `docs/guide-es`. +Coloca las traducciones de la documentación bajo `docs/-` donde `` es el nombre de la documentación original como `guide` o `internals` +y `` es el código del idioma al que se está traduciendo. Para la traducción al español de la guía, es `docs/guide-es`. -Después del trabajo inicial se lleva a cabo usted puede conseguir lo que ha cambiado desde la última traducción del fichero usando un comando especial del directorio `build`: +Después de que el trabajo inicial está hecho, puedes obtener los cambios desde la última traducción del archivo usando un comando especial del directorio `build`: ``` php build translation "../docs/guide" "../docs/guide-es" "Reporte de traducción guia en Español" > report_guide_es.html ``` -Si se quejan de composer, ejecutar `composer install` en el directorio raíz. +Si recibes un error de composer, ejecuta `composer install` en el directorio raíz. Convenios para la traducción ---------------------------- -- active record — sin traducción -- cache — sin traducción -- framework — sin traducción -- helper — sin traducción -- hash — sin traducción -- id — sin traducción -- widget — sin traducción -- script — sin traducción -- assets — sin traducción -- bootstrapping | bootstrap — sin traducción -- routing — sin traducción -- logging — sin traducción -- cookies — sin traducción -- controller — controlador -- model — modelo -- view — vista -- themes — temas o plantillas -- behaviors — comportamientos -- handlers — manipuladores -- instantiating — instanciando -- link — enlace -- render — sin traducción -- DatePicker — sin traducción -- rendering — renderizando +Las palabras en inglés que son propias del framework o de PHP, o traducibles pero que están muy ligadas a conceptos extendidos o nombres de clases, se pueden dejar en idioma original. +Ejemplos: `namespace`, `assets`, `helper`, `widget`, etc.