Ayuda:Extensión:Translate/Administración de traducción de página

This page is a translated version of the page Help:Extension:Translate/Page translation administration and the translation is 96% complete.

Outdated translations are marked like this.

Nota: Cuando editas esta página, aceptas liberar tu contribución bajo la licencia CC0. Para más información mira las páginas de ayuda de dominio público.

Documentación de Extensión:Traducir

Traductores (Página principal de ayuda)

Administradores de traducción

Administradores de sistemas y desarrolladores

Traducir esta plantilla

Qué. La función de traducción de páginas permite la traducción controlada de páginas wiki a otros idiomas. Esto significa que el contenido de cada traducción será, por lo general, igual a la página de origen. Esto contrasta, por ejemplo, con las diferentes versiones lingüísticas de los artículos en las distintas Wikipedias, que son totalmente independientes entre sí. Se asume que las páginas solo se traducen de un idioma principal a otros idiomas, pero los traductores también pueden aprovechar las traducciones en otros idiomas si existen.

¿Por qué?. Sin ayuda, traducir más de unas pocas páginas a otros idiomas se convierte, en el mejor de los casos, en una pérdida de tiempo, y en el peor, en un desastre inmanejable. Con la función de traducción de páginas, puede evitar este desorden y proporcionar una estructura al proceso de traducción. La idea principal es que el texto original se segmente en unidades más pequeñas, cada una de las cuales se traducirá individualmente. Cuando el texto original se segmenta en unidades, se pueden aislar todos los cambios y los traductores solo necesitan actualizar las traducciones de las unidades que han experimentado cambios en el texto original. Esto también permite a los traductores trabajar en unidades de tamaño manejable y compartir el trabajo entre varios traductores o continuar la traducción en sesiones posteriores, ya que no necesitan hacerlo todo a la vez.

Quién. Esta página detalla el tutorial de traducción de páginas al proporcionar una visión más profunda de cómo funciona el sistema y sugiere buenas prácticas para una amplia variedad de casos. Esta página está destinada a administradores de traducción de páginas y, en general, a cualquier persona que edite el texto de origen de las páginas traducibles, aunque no tenga acceso a las funciones administrativas para aprobar los cambios de traducción.

Vida de una página traducible

Roles. El proceso de escribir y traducir una página wiki implica a varias personas: el escritor inicial crea una página, alguien corrige los errores de ortografía, un administrador de traducción marca la página para traducirse, los traductores traducen, alguien hace cambios en la página, un administrador de traducción marca esos cambios para traducirse y los traductores actualizan las traducciones. Es posible que esas funciones se solapen en mayor o menor medida, pero la responsabilidad final de una traducción sin problemas recae en el administrador de la traducción de la página. El administrador decide cuándo la página está lista para la traducción por primera vez, se asegura de que la segmentación tenga un propósito y aprueba (o corrige) los cambios.

Preparación. Para tener algo traducido, primero hay que escribirlo. Si ya ha realizado traducciones sin la extensión Translate, consulte la sección sobre la migración de traducciones que aparece a continuación. Si deseas muchas traducciones rápidamente, es fundamental que el texto original esté en buen estado. Antes de marcar una página para su traducción, solicite a otra persona que la revise y, si es posible, pídale a un especialista en idiomas que haga el texto más claro y conciso. Las palabras raras y las oraciones complejas son difíciles de traducir. El marcado también puede causar problemas a los traductores, pero como administrador de traducción puedes evitar esos problemas, consulta la sección sobre cómo manejar el marcado a continuación. Como es lógico, los cambios que realice en el texto original de las traducciones requieren la actualización de todas las traducciones existentes, por lo que es mejor esperar hasta que el contenido de la página se haya estabilizado. Por otro lado, los cambios ocurren, y el sistema los maneja bien, así que consulte la sección sobre cómo manejar los cambios a continuación.

Etiquetado. Cuando el texto esté listo para su traducción, cualquiera puede marcar las partes traducibles encerrándolas entre etiquetas ‎<translate> y agregando la barra ‎<languages /> a la página. Esta última opción añade una lista de todas las traducciones de la página, con su grado de finalización y porcentajes actualizados. No existe ningún otro indicio de que existan traducciones. A continuación, consulta cómo hacer el etiquetado. El sistema detectará cuándo se colocan las etiquetas en la página traducible, y la página tendrá un enlace para marcarla para su traducción. También mostrará un error e impedirá guardar los cambios si, por ejemplo, olvidó agregar una etiqueta de cierre. La página traducible también aparecerá en la lista de Special:PageTranslation como "lista para corregir".

Marcado. Después del etiquetado, un administrador de traducción marca la página para su traducción. La interfaz se explica en Ejemplo de traducción de página. La responsabilidad del administrador de traducción es asegurarse de que la segmentación tiene sentido y que el etiquetado ha sido adecuado. La página se puede marcar de nuevo si ha tenido cambios. Consulte más adelante cómo hacer cambios que causen mínimas interrupciones. La selección de la página inicia un proceso en segundo plano que utiliza la cola de trabajos de MediaWiki. Este proceso recorre cada página de traducción y la regenera: los cambios en la plantilla de la página de traducción se reflejarán y las traducciones obsoletas se resaltarán con un fondo rosa. Por el contrario, la interfaz de traducción se actualiza inmediatamente.

Cambios. Los usuarios pueden seguir realizando cambios en el código fuente de la página traducible. Los cambios serán visibles para los usuarios que vean la página en el idioma original, pero las traducciones se realizan a partir de las unidades de traducción extraídas de la última versión de la página traducible que se ha marcado para su traducción. Además, se informa que las páginas traducidas están actualizadas al 100 % si se han traducido todas las unidades de traducción, incluso si la página original tiene cambios nuevos. Puede comprobar fácilmente si hay cambios sin marcar al ver la página traducible en el idioma de origen. En la parte superior aparece un aviso que indica que puede traducir esta página y también enlaces a los cambios, si los hay.

Invalidación. Si se realizan cambios en el código fuente de la página traducible, el administrador de la traducción se le dará la opción de Require updates to the translation a cada sección. Si una sección queda invalidada, las secciones traducidas tendrán un fondo de color rosa y se mostrará un icono de reloj a los traductores en la interfaz de traducción. Si una sección no se invalida, los lectores de las páginas traducidas no verán ningún cambio, y los traductores tendrán que examinar la sección dentro de la interfaz de traducción para poder ver las modificaciones.

Idioma de origen. También hay una página de traducción con el código de idioma del idioma de origen. No contiene las etiquetas adicionales ni otro marcado relacionado con la traducción de páginas que se utiliza en el código fuente de la página traducible. Esta página no está enlazada desde la interfaz, pero resulta útil, por ejemplo, cuando se desea transcluir la página (normalmente para plantillas traducibles) o exportarla. Por ejemplo, la página en la que se encuentra está disponible sin marcas en Help:Extension:Translate/Page translation administration/en.

Cambiar el idioma de origen. La extensión normalmente asumirá que la página traducible de origen está en el idioma predeterminado de la wiki. Los administradores pueden cambiar la configuración de idioma de una página específica mediante la página Special:PageLanguage para que se pueda utilizar como página de origen para la traducción. Consulte Idioma del contenido de la página para obtener más información.

Idioma de traducción. Si no están completamente traducidas, las páginas pueden contener texto en diferentes idiomas. En las páginas de traducción, las unidades que no se hayan traducido tendrán las marcas correspondientes de idioma y la dirección del texto adecuados para que las reglas CSS se apliquen correctamente. Sin embargo, MediaWiki no permite por el momento definir el idioma para el análisis sintáctico más que a nivel de página. Todas las palabras clave y las funciones del analizador sintáctico (parser) utilizan el idioma de destino de la traducción, incluso si el texto circundante no está traducido. Esto puede crear una incompatibilidad no deseada, por ejemplo, al darle formato a números o fechas. Algunas funciones mágicas y etiquetas de analizador permiten configurar el idioma de salida, en cuyo caso puede usar el término mágico {{TRANSLATIONLANGUAGE}} que devuelve el idioma de origen para las unidades no traducidas o el idioma de destino para las unidades traducidas.

Peticiones de traducción cerradas. Algunas páginas traducibles tienen un contenido que solo es interesante durante un determinado período de tiempo. Por ejemplo, los anuncios y las actualizaciones regulares de estado, como los resúmenes mensuales de Wikimedia. Puedes mantener esas páginas con sus traducciones, pero ocultarlas en la interfaz de traducción. Esto no impide que se hagan nuevas traducciones en las páginas, pero reduce drásticamente la posibilidad de que un usuario empiece a traducir accidentalmente la página. La acción de desalentar una traducción y la reversión de dicha acción se llevan a cabo desde Special:PageTranslation.

Priorización de idiomas. También puede definir una lista de idiomas en los que específicamente desea traducir una página; una lista de idiomas vacía se interpretará como que todos los idiomas están permitidos. La página se comportará como una página disuasoria (véase el párrafo anterior) para los idiomas que no estén en la lista de prioridades y, al traducirlos a esos idiomas, los traductores recibirán un aviso. También puede impedir la traducción a otros idiomas, por ejemplo, si las traducciones se utilizan en otro lugar y no podrá utilizarlas salvo en algunos idiomas.

Agrupación. Es posible agrupar las páginas relacionadas. Estos grupos funcionan como todos los demás grupos de mensajes. Tienen sus propias estadísticas y contienen todos los mensajes de los subgrupos: en este caso, las páginas traducibles. Esta funcionalidad se encuentra actualmente en Special:AggregateGroups. Los grupos de mensajes agregados se encuentran colapsados de forma predeterminada en Special:LanguageStats en el selector de grupos en Special:Translate.

Movimiento. Puede mover las páginas traducibles como cualquier otra página. Al moverlas, puede elegir si desea mover también las subpáginas que no se traducen. El movimiento utiliza un proceso en segundo plano para mover las numerosas páginas relacionadas. Mientras se realiza el movimiento, no es posible traducir la página. La finalización se registra en el registro de traducción de la página. Para obtener más información, consulte la guía para trasladar una página traducida .

Borrado. Al igual que el traslado, se accede al borrado desde el lugar habitual. Puede borrar la página traducible por completo, o solo una página de la traducción, mediante el botón de borrar. El borrado también eliminará todas las páginas relacionadas de la unidad de traducción. Al igual que ocurre en el traslado, un proceso en segundo plano eliminará las páginas a lo largo del tiempo y se anotará la finalización en el registro de traducción de páginas. La eliminación requiere los permisos «delete» y «pagetranslation», pero las páginas individuales de las unidades de traducción siempre se pueden borrar con el permiso estándar «delete».

Reversión. Del mismo modo, la reversión de ediciones incorrectas funciona como siempre (incluido el botón de reversión): solo tiene que editar la unidad de traducción afectada y la página de traducción también se actualizará. Para encontrar la edición de la unidad de traducción desde la página de edición de la traducción, simplemente haga clic en el enlace de contribs. del editor y busque una edición en un momento similar. Dentro del sistema de traducción, puedes marcar una traducción existente como obsoleta añadiendo !!FUZZY!! al principio del cuadro de mensaje traducido de la unidad de traducción.

Protección. Es posible proteger la página traducible. Las páginas de traducción no se pueden proteger y, asimismo, la protección de la página traducible tampoco se extiende a ellas. Para evitar más ediciones de traducciones, debe agregar el idioma de origen como único idioma de prioridad y deshabilitar las traducciones a otros idiomas. Consulte Priorización de idiomas más atrás. Juntas, estas dos acciones evitan los cambios tanto en la página de origen como en las páginas de traducción con sus páginas de unidad de traducción. Es posible proteger páginas de unidades de traducción individuales, aunque no es recomendable.

Eliminar de la traducción. También es posible desmarcar una página para su traducción. Puede utilizar Special:PageTranslation o seguir el enlace en la parte superior de la página traducible para eliminarla de la traducción. Esto eliminará cualquier estructura relacionada con la traducción de páginas, pero dejará todas las páginas existentes en su lugar, que podrán editarse libremente. No se recomienda realizar esta acción.

Transclusión sensible al idioma. Es posible transcluir una página traducible en otra página como plantilla.. En tal caso, la página traducible se cargará en el idioma de la página de destino si ha sido traducida a ese idioma. Si dicha traducción no existe, la página traducible se cargará en el idioma de origen. Este comportamiento de una página traducible se controla mediante la opción Habilitar la transclusión con reconocimiento de traducción para esta página al marcar la página para traducir. Las nuevas páginas traducibles tendrán este comportamiento habilitado por defecto.

Anatomía de una página traducible

La traducción de una página traducible producirá muchas páginas que en conjunto componen la página traducible en el sentido más amplio. Su título está determinado por el título de la traducible Page:

Página – la página de origen
Página/<código de idioma> – las páginas de traducción, más una copia de la página de origen sin marcado
Translations:Página/<identificador de unidad de traducción>/<código de idioma> – todas las unidades de traducción de la página

Además, se encuentran la plantilla de la página de traducción y las fuentes de las unidades de traducción, extraídas de la página original y almacenadas en la base de datos. El sistema registra qué versiones de la página original contienen etiquetas de traducción y cuáles de ellas se han marcado para su traducción.

Cada vez que se actualiza la página de una unidad de traducción, el sistema regenera la página de traducción correspondiente. Esto genera dos ediciones. La edición de la página de la unidad de traducción está oculta por defecto en los cambios recientes y se puede mostrar seleccionando «Mostrar traducciones» en el filtro de traducción. Cualquier acción que no sea editar (como eliminar o mover) las páginas de las unidades de traducción no activará la regeneración de la página de traducción correspondiente.

Si necesita una copia de la página de origen sin marcado, por ejemplo, para pegarla en otra wiki sin la extensión Translate,

identifica el idioma de origen de la página (si es el inglés, en) y visita Page/<código de idioma>;
haga clic en el botón «Ver historial» para llegar a una dirección como esta y reemplaza action=history con action=raw en la barra de direcciones, pulse Entrar:
se mostrará y guardará el texto.

Segmentación

Principios generales:

Todo el texto destinado a la traducción debe estar encerrado entre etiquetas ‎<translate>. Puede haber varios pares de etiquetas en una sola página.
Todo lo que se encuentre fuera de esas etiquetas no cambiará en ninguna página de traducción. Este texto estático, junto con los marcadores de posición que marcan el lugar donde se sustituirá la traducción de cada unidad de traducción, se denomina plantilla de la página de traducción.
Si hay demasiado marcado en el texto, los traductores lo tendrán más difícil para traducir. Cuando haya mucho marcado, junte más las etiquetas ‎<translate>, de forma que contengan menos wikitexto.
El texto dentro de las etiquetas ‎<translate> se divide en unidades de traducción donde hay una o más líneas vacías entre ellas (dos o más líneas nuevas).

Restricciones. La función de traducción de páginas impone algunas restricciones al texto. No debe haber ningún marcado que se extienda entre dos o más unidades de traducción. En otras palabras, cada párrafo debe ser autónomo. Por ahora, esta restricción no está implementada en el software, pero su incumplimiento provocará una representación incorrecta de la página, cuya gravedad dependerá de si MediaWiki es capaz de corregir o no el código HTML resultante.

Orden del análisis sintáctico. Tenga cuidado, las etiquetas ‎<translate> funcionan de manera diferente a las demás etiquetas, ya que no pasan por el analizador. Normalmente, esto no debería causar problemas, pero podría causarlos si está tratando de hacer algo creativo. Más concretamente, se analizan antes que las demás etiquetas como ‎<pre> o ‎<source>, exceptuando ‎<nowiki>, que está reconocida por la extensión Translate.

Colocación de las etiquetas

La etiqueta ‎<translate> impone una serie de requisitos concretos para funcionar correctamente, particularmente relacionados con el manejo de espacios en blanco, su uso en parámetros no nombrados y tablas y el espaciado entre el marcador de unidad y el texto, que se detallan a continuación.

Colocación de las etiquetas. Si es posible, trate de poner las etiquetas en sus propias líneas, sin líneas vacías entre el contenido y las etiquetas. A veces, esto no es posible, por ejemplo, si desea traducir un contenido delimitado por el marcado, pero no el propio marcado. Esto también es correcto, por ejemplo:

{{Template|1=<translate>Algún parámetro localizado</translate>}}

Para que esto funcione, la extensión tiene un manejo simple de espacios en blanco: los espacios en blanco se conservan, excepto si una etiqueta de apertura o cierre ‎<translate>‎</translate> es lo único que hay en una línea. En este caso, se ignora el salto de línea que va después de la etiqueta de apertura o antes de la etiqueta de cierre. Esto significa que no generan espacio adicional en la versión renderizada de la página

Las unidades de traducción más pequeñas son más fáciles de traducir y mantener. Considera dividir párrafos largos en varias unidades de traducción, utilizando varios conjuntos de etiquetas ‎<translate>.

Si insertas una etiqueta dentro del valor de un parámetro en la llamada a una plantilla, asegúrate de que el parámetro está nombrado (si no, añade un nombre numérico, como 1=).

Si insertas una etiqueta dentro de una celda de tabla, asegúrate de que no haya espacio en blanco de más entre las etiquetas y el marcado de la tabla , ya que esto perturbará la salida HTML.

Nota: Debes dejar el espacio entre el contenido y el marcador de unidad (el software añade automáticamente dicho espacio). De lo contrario, el editor mostrará un mensaje de error: «Marcadores de unidad de traducción en posición inesperada», y no podrás publicar los cambios. Por ejemplo:

Correcto: <translate> Hello, world.</translate>
Incorrecto: <translate>Hello, world.</translate>

Variables

Véase también Meta:Guía de internacionalización#Variables de traducción.

Para ocultar a los traductores los elementos no traducibles, o asegurarse de que ciertos contenidos que están dentro de una unidad de traducción, así como los destinos de los enlaces y los nombres de archivos, no sean sometidos al proceso de traducción, utilice como solución el marcado de variables que se describe a continuación.

Se pueden utilizar variables similares a las variables de las plantillas. La sintaxis para esto es ‎<tvar name="nombre">contenido‎</tvar> (las comillas son opcionales si el valor no contiene espacios ni ninguno de los caracteres " ' ` = < >). Nota: las variables deben estar nombradas, de lo contrario, se podría producir una representación no válida de la página. A los traductores se les mostrarán las variables simplemente como $nombre, y en las páginas de traducción estas serán sustituidas por el contenido del tvar nombrado nombre. Por lo tanto, son "constantes" globales en todas sus páginas de traducción. Esto también funciona para elementos tales como números que tienen que actualizarse a menudo. Puede actualizar el número en todas las traducciones cambiando el valor de la variable en la página traducible de origen y volviendo a marcar la página para que el cambio se refleje de forma universal en todas las versiones idiomáticas. No es necesario invalidar las traducciones, ya que el número no forma parte de las páginas de la unidad de traducción.

Tenga en cuenta que las variables no se comparten entre diferentes unidades de traducción. Si desea utilizar la misma variable en más de una unidad, debe repetir el código en cada unidad. Puede usar el mismo nombre. Se pueden utilizar variables de traducción para separar y ocultar los elementos y contenidos no traducibles, como los destinos de los enlaces y los nombres de archivos, del proceso de traducción o del interior de la unidad de traducción. Por ejemplo, esto se puede usar para mostrar un enlace cuya etiqueta debe traducirse, pero no la URL real:

[[<tvar name="example">Special:MyLanguage/Help:Extension:Translate</tvar>|Translation extension]]

Valores separados por comas. Para ciertos contenidos como los datos de gráficos (extensión Graph) que deben ser analizados por el software en forma de valores separados por comas, es recomendable que las unidades de traducción estén separadas entre ellas por las comas para evitar que los traductores utilicen caracteres de coma localizados (adaptados a su configuración regional y de idioma), lo cual confundirá al software.

Valores en texto plano. Para impedir cualquier modificación del valor de la traducción, utilice el atributo nowrap así: <translate nowrap>...</translate>. Por defecto, se modifican los valores obsoletos y no traducidos para permitir la compatibilidad con el resaltado y el etiquetado de idioma.

Tratamiento de ‎<nowiki>: Antes de la versión 2020.10 de Translate, ‎<nowiki> no recibía un tratamiento consistente y las páginas seguían apareciendo en Special:PageTranslation. Para solucionarlo de forma provisional, se recurría a técnicas de escapado de código como «<translate>...</translate>».

Sintaxis anterior: Antes de la versión 2021.04 de Translate, la sintaxis era <tvar|nombre>contenido</> (T274881). Esta sintaxis aún cuenta con soporte, pero se considera obsoleta.

Ejemplos de marcado

A continuación se muestran algunas alternativas y sugerencias para utilizar distintos tipos de marcado wiki.

Atributos

Por defecto, la extensión Translate puede envolver unidades de traducción obsoletas para resaltarlas, y envolver unidades no traducidas para definir los metadatos de idioma adecuados. En algunas circunstancias, el marcado adicional añadido por este envoltorio no es adecuado.

<abbr title="<translate nowrap>Frequently asked questions</translate>"><translate>FAQ</translate></abbr>

Categorías

Las categorías se pueden añadir de dos maneras: en la plantilla de la página de traducción o en una de las unidades de traducción.

Si tiene las categorías en la plantilla de la página de traducción, todas las traducciones acabarán en la misma categoría.

Si tiene categorías dentro de unidades de traducción, deberá enseñar a los usuarios un esquema de nomenclatura.

A continuación, mostramos dos posibles esquemas que son independientes de los medios técnicos para adoptarlos.

Traducción añadiendo el sufijo de idioma: Category:Coches/fi (recomendado)

[...]
</translate>

[[Category:Cars{{#translation:}}]]

El nombre de la página de categoría no se traduce (al igual que los nombres de otras páginas).
Una categoría por idioma.
La traducción de páginas se podría aplicar a la categoría misma: las categorías estarían enlazadas entre sí y los encabezados estarían traducidos (pero no el nombre de la categoría en los enlaces o equivalentes).

Sin traducción: Category:Coches

Todas las traducciones en la misma categoría (buena solución si hay pocos idiomas, mala si hay muchos).
El nombre de categoría quedaría sin traducir (puede ponerse tal cual en la plantilla de traducción).

Comentarios del código

Aunque los ejemplos de código no deben ser traducidos, puedes traducir los comentarios de los ejemplos del código utilizando etiquetas ‎‎<translate> y el atributo nowrap.

<syntaxhighlight lang="php">
public static function registrationCallback() {
   // <translate nowrap>Debe coincidir con el nombre utilizado en la configuración de la extensión</translate>
   define( 'CONTENT_MODEL_EXAMPLE', 'example' );
}
</syntaxhighlight>

Tenga cuidado con el código parcialmente traducido. Consideremos el siguiente caso:

<syntaxhighlight lang="bash">
$ php /path/to/w/maintenance/run.php myScript.php
</syntaxhighlight>

Puede que tenga la tentación de envolver la parte de /path/to en etiquetas de ‎<translate>, sin embargo, debe evitar esto a toda costa. A menos que el texto se haga traducible en su totalidad, habrá problemas con la direccionalidad y otros factores que entran en juego con esos mensajes de retazos . Lamentablemente, en este momento no existe un marcado adecuado para implementar esto.

Encabezados

Marcado recomendado para etiquetar encabezados de sección para su traducción:

Incluye el marcado de las cabeceras dentro de las etiquetas de traducción para que el traductor tenga el contexto adecuado.
Inserte un newline entre la etiqueta de traducción de apertura y el encabezado, o MediaWiki no lo identificará correctamente como un encabezado. Por ejemplo, edición de secciones no funciona si no se utiliza el marcado recomendado.

Los encabezados deben estar separados por una línea vacía. De esta manera, alguien puede traducir rápidamente la tabla de contenidos antes de pasar al contenido. Además, garantiza que se generen anclas enlazables para el encabezado.

Correcto:

<translate>
== Cultura == 

Lorem ipsum dolor.
</translate>

Incorrecto: (sin línea nueva después de la etiqueta ‎<translate>, encabezado fuera de las etiquetas de traducción)

== <translate>Cultura</translate> ==

Incorrecto: (sin línea nueva)

<translate>== Cultura ==</translate>

Enlaces

Si la página de destino es o debería ser traducible, entonces el wikienlace debe contener el prefijo de Special:MyLanguage/.

Cualquier página que pudiera traducirse debería enlazarse con Special:MyLanguage/, aunque no esté actualmente internacionalizada. Así, solo habrá que traducir la etiqueta del enlace, ya que el wikienlace redirigirá automáticamente a los usuarios a la página de traducción en su propio idioma de interfaz, tal como se ha seleccionado, por ejemplo, a través del Selector Universal de Idioma. Sin embargo, para lograr un comportamiento consistente, se debe utilizar esta sintaxis en todos los enlaces.

Se recomienda incluir los enlaces dentro de las etiquetas del párrafo, ya que así el traductor puede cambiar la etiqueta del enlace, y también puede cambiar el destino del enlace a una versión localizada si existe.

Los elementos no traducibles de los wikienlaces se pueden ocultar al traductor mediante la sintaxis de variables.

En mediawiki.org, puedes utilizar Template:Localized link para enlazar a páginas de la misma wiki como una alternativa más sencilla a Special:MyLanguage/. Esto también funciona en Meta-Wiki y otras wikis multilingües de Wikimedia con una plantilla similar.

Enlaces a páginas traducibles:

<translate>
Los desarrolladores pueden [[<tvar name=1>Special:MyLanguage/Manual:Extensions</tvar>|escribir nuevas extensiones]].
</translate>

Enlaces a páginas con una versión localizada independiente:

<translate>
Helsinki es la capital de [[w:Finland|Finlandia]].
</translate>

Enlaces a páginas no traducibles:

<translate>
La barra lateral está definida en <tvar name=1>[[MediaWiki:Sidebar]]</tvar>.
</translate>

Enlaces externos:

<translate>
PHP ([<tvar name=url>http://php.net</tvar> sitio web]) es un lenguaje de programación.
</translate>

Listas

Plantéate dividir las listas largas en varias partes con un elemento de lista por unidad. Pero hazlo solo si los elementos son lo suficientemente independientes como para traducirse de forma separada a todos los idiomas. Evita crear «mensajes de Lego» partiendo una sola frase en varias unidades o separando partes lógicamente conectadas, ya que esto puede afectar a la puntuación o al estilo de la lista.

No insertes líneas vacías entre los elementos de la lista, ya que al hacerlo se dividirá la lista, provocando una apariencia incorrecta y problemas de accesibilidad ("Hueco en la lista").

Nota: Para dividir una lista, utiliza las etiquetas ‎<translate> para cada uno de los elementos de la lista, excluyendo los asteriscos, almohadillas y puntos y comas iniciales en el texto que se utilizan para el marcado de la lista. De lo contrario, la lista se dividirá en varias listas cuando cualquiera de las unidades de traducción esté desactualizada, y las etiquetas ‎<translate>...‎</translate> y el contenido entre ellas se marcarán como no editables en el editor visual.

Correcto:

<translate>
Visita:
* nuestra página principal
* luego la página de preguntas frecuentes,
</translate>

o

* <translate>Principios generales</translate>
* <translate>Encabezados</translate>
* <translate>Imágenes</translate>
* <translate>Tablas</translate>

Incorrecto:

<translate>* Principios generales</translate>
<translate>* Encabezados</translate>
<translate>* Imágenes</translate>
<translate>* Tablas</translate>

Archivos multimedia

Si se necesita una versión diferente de un archivo multimedia para diferentes idiomas, incluye la sintaxis completa del archivo dentro de las etiquetas de traducción. Por ejemplo, un diagrama que incluye texto debe reemplazarse por una nueva imagen en cada idioma.

Si un archivo multimedia debe mantenerse igual en diferentes idiomas, traduce únicamente el pie de imagen u otros parámetros de texto.

Un archivo diferente para cada idioma:

<translate>
[[File:Europe countries map en.png|thumb|Mapa de Europa con los nombres de los países]]
</translate>

El mismo archivo para cada idioma:

[[File:Ball.png|50px|<translate>Icono de pelota</translate>]]

Números

Con los números y otros elementos no lingüísticos, es posible que desees extraer el número mismo de la traducción y convertirlo en una variable. Esto presenta varias ventajas:

Puede actualizar el número sin invalidar las traducciones.
La memoria de traducción puede funcionar mejor cuando se ignora el número que cambia.

<translate>
Ingresos este mes <tvar name=income>{{FORMATNUM:3567800}}</tvar> EUR
</translate>

Ten en cuenta que esto impide que los traductores localicen el número haciendo conversión de moneda. La llamada FORMATNUM garantiza que el número esté correctamente formateado en el idioma de destino.

Tablas

Para traducir tablas, añade etiquetas ‎<translate> solo alrededor del texto traducible.

{| class="wikitable"
! <translate>Versión<translate>
! <translate>Estado<translate>
|-
| 1.0.0
| <translate>Estable</translate>
|}

Plantillas

Las plantillas tienen distintas funciones y propósitos, por lo que la mejor solución depende de para qué sirve la plantilla. Si la plantilla no forma parte de un párrafo más largo, no debe incluirse en las etiquetas de traducción, a menos que tenga parámetros que deban ser traducidos. If the template is not a part of longer paragraph, it should be left out of translation tags, unless it has parameters that need to be translated.

Para un ejemplo de plantilla traducida con la traducción de página, consulta Plantilla:Extensión-Traducir .

Otra forma de traducir una plantilla es utilizar la traducción de elementos no estructurados, pero entonces el idioma de la plantilla deducirá el idioma de la interfaz del usuario, no el idioma de la página que está viendo.

Plantillas sin parámetros:

{{Subpáginas}}

Plantillas con parámetros traducibles:

{{MiPlantilla|1=<translate>¡Hola!</translate>}}

Cuando traduzcas un parámetro de plantilla, asegúrate de que el parámetro tenga un nombre o utiliza un nombre numérico, como 1=.

Transclusión

Puedes transcluir una página traducida en otra página traducida utilizando la sintaxis estándar Transclusión . Si no hay ninguna traducción disponible para el idioma de destino, el contenido transcluido se muestra en el idioma de origen.

<translate>
== Consejos de comunicación ==
</translate>

{{:Consejos de comunicación}}

Página traducible

(introducido en a582f3ad21bd) Se puede utilizar en plantillas que se transcluyen tanto en páginas traducibles como en páginas no traducibles, y su comportamiento debe diferir en función de si la página es traducible o no (por ejemplo, utilizar el idioma del usuario en páginas no traducibles). Devuelve el título de la página de traducción (la página original que se traduce a los demás idiomas) si la página es traducible (esto incluye las páginas traducidas), y nada si la página no es traducible. De la misma manera que la etiqueta del analizador ‎<languages>, no devuelve nada si la página contiene marcado (en el sentido de lenguaje de marcas) de traducción pero aún no se ha marcado (señalado) para traducir.

{{#if:{{TRANSLATABLEPAGE}}|{{Una plantilla}}|{{Una plantilla/{{int:lang}}}}}}

Asumiendo que Template:Una plantilla es una plantilla traducible donde esté habilitada la transclusión sensible al idioma (véase más arriba) y MediaWiki:lang y sus traducciones están definidas en el wiki dado de forma análoga a mediawiki.org, el código anterior lo transcluye en el idioma de la página en las páginas traducibles y en el idioma de la interfaz de usuario en las demás páginas.

Idioma de la página traducida

(introducido en 98b6958a2471) Puede que las plantillas traducidas deseen definir el idioma en el que están (por ejemplo, en un elemento contenedor de HTML). Si la plantilla está fuera de las etiquetas $1, $2 devuelve el idioma de la página en la que se encuentra directamente (en oposición al idioma de la página en que el lector la está viendo). When used outside of ‎<translate> tags, {{TRANSLATIONLANGUAGE}} returns the language of the page it’s directly in (as opposed to the language of the page on which the reader sees it).

Supón que {{1/en}} está transcluida en la página titulada 2/de.

Si se utiliza {{PAGELANGUAGE}} en el texto de {{1/en}}, devolverá de.
Si se utiliza {{TRANSLATIONLANGUAGE}} en el texto de {{1/en}} (fuera de las etiquetas ‎<translate>), devolverá en.

Idioma de traducción

(introducido en 5e8106cdc353) Cuando el texto utilice métodos de formato dependientes del idioma, pueden presentarse desajustes en las secciones no traducidas. Se puede utilizar {{TRANSLATIONLANGUAGE}} para evitarlo.

2020-09-15 is {{#time:l|2020-09-15|es}}

La entrada anterior se puede mostrar así:

inglés: 2020-09-15 is Tuesday.
finés: 2020-09-15 on tiistai.

Sin la palabra mágica, el texto no traducido en una página de traducción al finés se podría mostrar así:

2020-09-15 is tiistai

Variables de traducción

Utiliza etiquetas ‎<tvar> para ocultar los elementos no traducibles a los traductores. Cada variable de traducción debe tener un name: ya sea una palabra corta o, si los traductores no necesitan conocer el contenido de la variable, un número. Cada variable dentro de un conjunto de etiquetas ‎<translate> debe tener un name diferente.

Correcto:

<translate>
Si se establece la variable en <tvar name=1>LocalSettings.php</tvar>, el valor predefinido en <tvar name=2>extension.json</tvar> no se utiliza.
</translate>

Incorrecto: (sin name)

<translate>
El nombre del archivo debe ser <tvar>extension.json</tvar>.
</translate>

Incorrecto: (el mismo name para múltiples variables dentro de un conjunto de etiquetas ‎<translate>)

<translate>
Para utilizar Markdown, añade la extensión de archivo <tvar name=1>.md</tvar>, como <tvar name=1>README.md</tvar>.
</translate>

Cambiar el texto de origen

No añadas por tu cuenta los marcadores de unidad (), el sistema lo hará automáticamente.

Principios generales:

Evita cambios innecesarios que invaliden las unidades de traducción
Haz los cambios tan aislados como puedas
Si haces cambios menores en una unidad de traducción existente, mantén el marcador. Si haces grandes cambios en un párrafo entero, elimina el marcador
No agregues por tu cuenta los marcadores de unidad de traducción
Cuando edites, los marcadores de unidad deben dejarse en paz y su posición respecto de la unidad a la que pertenecen no debe cambiar.
Cuando traslades una unidad, traslada también el marcador de unidad.
Cuando borres una unidad, borra también el marcador.

Aunque puedes editar el contenido traducido utilizando el editor visual (VisualEditor), debes utilizar el editor de código fuente para añadir o cambiar el marcado de traducción. Para facilitar la adición del marcado de traducción, utiliza los botones del recuadro situado debajo de la interfaz de edición.

No utilices la edición por secciones al editar páginas traducidas, ya que esto añade espacios en blanco adicionales a la página.^[1] Selecciona siempre la opción de editar toda la página.

Marcadores de unidad

Tras haber marcado una página para traducir, el sistema actualizará la página traducible de origen y añadirá identificadores únicos, denominados «marcadores de unidad», a cada unidad de traducción. Véase el ejemplo a continuación. Un ejemplo de marcador de unidad es . Estos marcadores de unidad son cruciales para el sistema, que los utiliza para rastrear los cambios en cada unidad de traducción. No deberías añadir nunca marcadores de unidad por tu cuenta. Los marcadores de unidad se encuentran siempre en la línea anterior a unidad, o, si empieza por un encabezado, después del primer encabezado en la misma línea. La diferencia en la colocación en el caso de los encabezados es necesaria para que la edición de secciones siga funcionando de la manera esperada.

<translate>
== Birds == <!--T:1-->
Birds are animals which....

<!--T:2-->
Birds can fly and...
</translate>

Modificar la unidad de texto

La operación más habitual en las unidades de traducción es la modificación de su contenido. Puedes corregir errores ortográficos y gramaticales o hacer otros cambios en la unidad. Al modificar el texto de una unidad, no se debe eliminar el marcador correspondiente, y tampoco se debe cambiar su posición en relación con la unidad a la que pertenece. Esto se debe a que la mayoría de las ediciones mantienen la estructura original de la unidad de traducción, por lo que existe la posibilidad de reutilizar traducciones existentes. Al volver a marcar la página para traducir, verás la diferencia en el texto de la unidad. También se mostrará esta misma diferencia a los traductores cuando actualicen sus traducciones. En correcciones ortográficas y otros casos en los que no desees que las traducciones existentes queden resaltadas en las páginas traducidas, puedes evitar invalidarlas: los traductores seguirán viendo la diferencia si por cualquier razón acaban actualizando la traducción. Si dejas los marcadores, los cambios que se hayan hecho se resaltarán en la interfaz de administrador de traducción, incluso los cambios menores, y los administradores de traducción podrán comparar los cambios y decidir si desean invalidar las traducciones existentes. Si eliminas los marcadores, las unidades modificadas serán tratadas como unidades completamente nuevas, lo que hará más difícil comparar los cambios en la interfaz de administrador de traducción.

Añadir texto nuevo

Puedes añadir texto nuevo libremente entre las etiquetas ‎<translate>. Asegúrate de que haya una línea en blanco entre unidades adyacentes para que el sistema lo pueda reconocer como una unidad nueva. También puedes deliminar el nuevo texto entre etiquetas ‎<translate> si no lo está ya. De nuevo, no añadas los marcadores de unidad por tu cuenta, el sistema lo hará. You can also add ‎<translate> tags around the new text, if it is not inside existing ‎<translate> tags. Again, do not add unit markers yourself, the system will do it.

Al añadir texto, tu objetivo es cambiar el menor número posible de unidades de traducción existentes. Por ejemplo, aquí hay dos párrafos de una página traducida:

<translate>
<!--T:1-->
El uso de resúmenes de edición ayuda a otros usuarios a comprender tus ediciones sin tener que profundizar en los detalles.

<!--T:2-->
Si se detecta una violación de derechos de autor, también mantiene información de autoría después de un borrado significativo de revisiones.
</translate>

Para añadir un nuevo párrafo, agrega el texto separado por nuevas líneas:

<translate>
<!--T:1-->
El uso de resúmenes de edición ayuda a otros usuarios a comprender tus ediciones sin tener que profundizar en los detalles.

Los resúmenes de edición son opcionales, pero se recomiendan.

<!--T:2-->
Si se detecta una violación de derechos de autor, también mantiene información de autoría después de un borrado significativo de revisiones.
</translate>

Para añadir una frase a un párrafo existente, crea una nueva unidad de traducción. En este ejemplo, el texto ahora se divide en tres conjuntos de etiquetas ‎<translate>. Esto te permite añadir una frase al primer párrafo sin invalidar la unidad T:1.

<translate>
<!--T:1-->
El uso de resúmenes de edición ayuda a otros usuarios a comprender tus ediciones sin tener que profundizar en los detalles.
</translate>
<translate>Los resúmenes de edición son opcionales, pero se recomiendan.</translate>

<translate>
<!--T:2-->
Si se detecta una violación de derechos de autor, también mantiene información de autoría después de un borrado significativo de revisiones.
</translate>

Eliminar texto

Puedes borrar unidades enteras. Si lo haces, borra también el marcador de unidad.

Por ejemplo, aquí hay un extracto de una página traducida:

* <translate><!--T:1--> No añadas marcadores de unidad de traducción por tu cuenta.</translate>
* <translate><!--T:2--> Cuando traslades una unidad, traslada también el marcador de unidad.</translate>
* <translate><!--T:3--> Cuando borres una unidad, borra también el marcador.</translate>

Para quitar la segunda viñeta, elimina toda la línea, incluyendo el marcador de unidad y las etiquetas ‎<translate>:

* <translate><!--T:1--> No añadas marcadores de unidad de traducción por tu cuenta.</translate>
* <translate><!--T:3--> Cuando borres una unidad, borra también el marcador.</translate>

Fraccionar unidades

Puedes fraccionar unidades existentes, ya sea añadiendo una línea en blanco en medio de una unidad o añadiendo etiquetas ‎<translate>. Asimismo, puedes mantener el marcador de unidad con la primera unidad o eliminarlo por completo. En el primer caso, los traductores verán el texto anterior al actualizar la traducción. Si eliminaste el marcador, ambas unidades se comportarán como si nunca hubiera existido traducción alguna una vez se haya vuelto a marcar la página para traducir. You can either keep the unit marker with the first unit or remove it altogether. In the first case, translators see the old text when updating the old translation. If you removed the unit marker, both units will behave as if no translation ever existed, after the page is re-marked for translation.

Estado original

Mantener el marcador

Eliminar el marcador

<!--T:1-->
Cat purrs. Dog barks.

<!--T:1-->
Cat purrs.

<!--T:2--> (Agregado tras volver a marcar)
Dog barks.

<!--T:2--> (Agregado tras volver a marcar)
Cat purrs.

<!--T:3--> (Agregado tras volver a marcar)
Dog barks.

Kissa kehrää. Koira haukkuu.

Dog barks.

Cat purrs.

Dog barks.

Fusionar unidades

En caso de fusionar unidades, debes eliminar todos los marcadores de unidad salvo a lo sumo uno.

Trasladar unidades

Puedes trasladar unidades sin invalidar las traducciones: basta con trasladar el marcador de unidad junto con el resto de la unidad.

Antes de marcar la nueva versión de la página para traducir, asegúrate de que se sigan las mejores prácticas, especialmente que los traductores obtengan una unidad de traducción nueva si el contenido ha cambiado. Asegúrate también de que no haya cambios innecesarios para evitar perder el tiempo de los traductores. Si la página de origen va a cambiar muchas veces, puede que merezca la pena esperar a que se estabilice antes de asignar el trabajo a los traductores.

Las traducciones de unidades no utilizadas no se eliminan automáticamente, pero eso no debería causar problemas.

Trasladar páginas traducidas

Los administradores de traducción pueden trasladar las páginas traducidas como lo harían con cualquier otra página. También es posible trasladar páginas traducidas entre wikis multilingües utilizando un script. Para obtener más información, consulta la guía para trasladar una página traducida .

Migrar a traducción de página

Esta sección aborda funciones del sistema de traducción de páginas que están disponibles únicamente para los administradores de traducción de páginas y no son relevantes para otros usuarios.

Si has estado traduciendo páginas antes de usar el sistema de traducción de páginas, es posible que desees migrar las páginas al nuevo sistema, al menos aquellas para las que esperas tener nuevas traducciones y para las que deseas tener estadísticas. Probablemente tengas plantillas existentes para cambiar de idioma y tal vez diferentes convenciones de nomenclatura de páginas.

Puedes iniciar la migración limpiando, etiquetando y marcando la página de origen. Puedes conservar las plantillas de cambio de idioma existentes mientras migra las traducciones antiguas. Si tus páginas siguen la convención de nomenclatura de las subpáginas del código de idioma, se reemplazarán con el texto de origen después de marcar la página de origen para su traducción, pero aún podrás acceder a las traducciones del historial. You can keep the existing language-switching templates while you migrate the old translations. If your pages follow the language code subpages naming convention, they will be replaced with the source text after marking the source page for translation, but you'll still be able to access translations from history.

Esta tarea manual ha sido parcialmente automatizada por Special:PageMigration (disponible solo para administradores de traducción), que muestra las unidades de origen y de destino una al lado de la otra y permite al usuario ajustar las unidades proporcionando una serie de funcionalidades mencionadas en esta página a continuación.

¿Cómo usarlo?

Ve a Special:PageMigration
Introduce el título de la página y el código de idioma. Por ejemplo, «Help:Special pages» y «fr».
El texto de origen, que ya fue dividido en unidades por Translate, y el de las traducciones importadas se mostrarán uno junto al otro con cierta correspondencia inicial.
Utiliza las acciones disponibles de cada unidad para completar a mano las correspondencias.
Dado que las unidades de traducción son editables, haz las mejoras manuales necesarias (para añadir variables de traducción, arreglar enlaces y el marcado, etc.).
Haz clic en el botón «Guardar». Esto creará páginas bajo el espacio de nombres Translations de la forma Translations:Página/<unidad de traducción>/<código de idioma>. Las traducciones antiguas se han importado en Translate.
En caso contrario, si deseas cancelar la importación, haz clic en el botón Cancelar.

Acciones disponibles

Cada fila compuesta de la unidad de origen y la de destino cuenta con un conjunto de iconos de acción. Se utilizan de la siguiente manera:

Añadir: Al hacer clic en este ícono de acción, se añadirá una nueva unidad vacía debajo de la actual. Utiliza esta función si deseas dividir la unidad actual y necesitas una unidad a continuación.
Permutar: Al hacer clic en este ícono de acción, se permutará el contenido de la unidad actual con la unidad siguiente. Puedes utilizar esta función cuando las unidades se alineen incorrectamente debido a la distinta ordenación de secciones o cuando tengas que arrastrar una unidad hacia abajo o hacia arriba. En cualquier caso, recuerda que permuta la unidad actual con la siguiente (situada inmediatamente debajo) y no crea unidades adicionales.
Eliminar: Al hacer clic en este ícono de acción, se eliminará completamente la unidad de destino correspondiente de la página y de desplazarán todas las unidades restantes de destino una posición hacia arriba. Utiliza esto para eliminar contenido no deseado como código o traducciones importadas que están completamente presentes en el idioma de origen. Nota: esta acción es irrevocable (en la sesión actual).

Solución de problemas

Si marcas una página para traducir e inmediatamente accedes a la página especial y tratas de importar traducciones, puede que recibas un mensaje de error como «La página <título-de-página>/<idioma> no contiene traducciones obsoletas.». Esto se debe a que FuzzyBot aún no ha marcado los mensajes de la página antigua: la herramienta no encontrará una edición de FuzzyBot en la página de traducción. En este caso, basta con esperar a que FuzzyBot haga su trabajo. Una vez se haya visto una edición, puedes proceder con las importaciones.
Espera un rato después de pulsar el botón «Guardar». Mientras el color de fondo del botón permanezca gris, hay un proceso en curso de importar unidades no vacías. En cuanto se vuelva a colorear, la importación estará completa.
Dentro del sistema de traducción, puedes marcar una traducción existente como obsoleta añadiendo !!FUZZY!! al principio del cuadro de mensaje traducido de la unidad de traducción.

Consejos

La migración será más sencilla si en primer lugar (antes de marcar para traducir) compruebas si las traducciones existentes son similares al texto original en inglés y editas a mano la estructura de las páginas: rompe párrafos y listas, añade los encabezados que falten (aunque estén vacíos).
Será útil comprobar el resultado en la interfaz de traducción principal: puede que algunas de las unidades se marquen inmediatamente como obsoletas debido a errores de marcado o si no se han añadido todas las variables de traducción.
La traducción del título de la página deberá hacerse a mano. Si no conoces muy bien el idioma de la página importada, puedes tratar de encontrar la traducción del título de la página entre las páginas de «lo que enlaza aquí» o a veces en las redirecciones.

Referencias

↑ phab:T292352

[1] :T292352

[1]