Help:Extension:Translate/Page translation administration/es

Que. 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 se opone, por ejemplo, a la diferente versión lingüística de los artículos en diferentes Wikipedias, que son totalmente independientes entre sí. Se supone que las páginas sólo se traducen de un idioma principal a otros idiomas, pero los traductores también pueden aprovechar las traducciones en otros idiomas si existen.

Porque. Sin ninguna ayuda, la traducción de más de unas pocas páginas en otros idiomas se convierte en un desperdiciador de tiempo en el mejor de los casos, un inmanejable lío en el peor. Con la función de traducción de páginas puede evitar el desastre y traer estructura al proceso de traducción. La idea central es que el texto fuente se divide en unidades más pequeñas, cada una de las cuales se traducirá individualmente. Cuando el texto fuente está segmentado en unidades, todos los cambios pueden ser aislados y los traductores sólo necesitan actualizar las traducciones de unidades que han tenido cambios en el texto fuente. 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, porque no es necesario hacerlo todo a la vez.

Quien. Esta página describe el tutorial de traducción de páginas al proporcionar una visión más profunda de cómo funciona el sistema y sugiere las mejores 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 todos los que editan el texto fuente de las páginas traducibles, aunque no tengan acceso a las funciones administrativas de la aprobación de cambios para la traducción.

Vida de una página traducible
Funciones. Múltiples personas están involucradas en el proceso de escribir y traducir una página wiki: el escritor inicial crea una página, alguien corrige los errores de ortografía, un administrador de traducción marca la página de traducción, traductores traducen, alguien hace cambios en la página, un administrador de traducción marca esos cambios para traducción. Esos roles pueden superponerse más o menos, pero la responsabilidad final de una traducción sin complicaciones queda para el administrador de la traducción de la página. El administrador decide cuándo la página está lista para ser traducida la primera vez, se asegura de que la segmentación cumple un propósito y aprueba (o corrige) los cambios.

Preparación. Para tener algo traducido tienes que escribirlo primero. Si ya ha realizado la traducción sin la extensión Traducir, consulte a continuación la sección sobre migración de traducciones. Si quieres muchas traducciones rápidamente, es crucial que el texto fuente esté en buena forma. Antes de marcar una página para su traducción, pídale a otra persona que la revise y, si es posible, pida a un especialista en idiomas que haga el texto más claro y conciso. El vocabulario difícil y las oraciones difíciles de entender son un tapón del espectáculo a muchas traducciones voluntarias. El marcado, también, puede causar problemas a los traductores, pero como administrador de traducción puede evitar esos problemas, vea abajo la sección sobre cómo manejar el marcado. Naturalmente, los cambios que realice en el texto fuente de las traducciones requieren actualizaciones 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 suceden, y el sistema los maneja bien, así que echa un vistazo a la sección sobre cómo manejar los cambios.

Etiquetando. Cuando el texto está de otra manera listo para la traducción, cualquiera puede marcar las partes traducibles encerrándolas en etiquetas y añadiendo la barra  a la página. Este último añade una lista de todas las traducciones de la página, con su finalización y porcentajes actualizados. No hay otra indicación de que existan traducciones. Vea abajo cómo hacer el etiquetado. El sistema detectará cuando las etiquetas se colocan en la página traducible y la página tendrá un enlace para marcarlo para su traducción. También se quejará y evitará el ahorro si usted por ejemplo se olvidó de agregar una etiqueta de cierre. La página traducible también se listará en Special:PageTranslation como lista para marcarse.

Marcando. 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 puede ser marcada de nuevo si ha cambiado mientras tanto. Vea abajo cómo hacer cambios que causen interrupciones mínimas. El marcado de la página inicia un proceso de fondo que utiliza la cola de trabajos de MediaWiki. Este proceso revisa cada página de traducción y lo regenera: los cambios en la plantilla de página de traducción se reflejarán y las traducciones obsoletas se reemplazarán temporalmente con el texto original. Por el contrario, la interfaz de traducción se actualiza inmediatamente.

Cambios. Los usuarios pueden seguir realizando cambios en el origen de la página traducible. Los cambios serán visibles para los usuarios que vean la página en el idioma de origen, pero las traducciones se hacen con las unidades de traducción extraídas de la última versión de la página traducible que se ha marcado para traducción: las páginas de traducción son 100% actualizadas si todas las unidades de traducción han sido traducidas, incluso si la página de origen tiene nuevos cambios. Puede ver fácilmente si hay cambios no marcados al ver la página traducible en el idioma de origen: hay un aviso en la parte superior 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 origen de la página traducible, al administrador de traducción se le dará la opción de "No invalidar traducciones" para cada sección. Si una sección se invalida, los idiomas traducidos obtendrán un color de fondo rosa para esas secciones, y un icono de reloj se mostrará a los traductores en la interfaz de traducción. Si una sección no está invalidada, los lectores de las páginas traducidas no podrán ver cambios, y los traductores tendrán que examinar la sección dentro de la interfaz de traducción para ver los cambios.

Idioma fuente. También hay una página de traducción con el código de idioma del idioma de origen: no contiene las etiquetas adicionales y otros marcados relacionados con la traducción de páginas que se utilizan en el origen de página traducible. Esta página no está vinculada desde la interfaz, pero es útil, por ejemplo, cuando se desea transcluir la página (normalmente para las plantillas traducibles) o exportarla. Por ejemplo, esta página esta disponible en Help:Extension:Translate/Page translation administration/en.

Peticiones de traducción cerradas. Algunas páginas traducibles tienen un contenido que solo es interesante durante un cierto período de tiempo. Por ejemplo, anuncios y actualizaciones regulares de estado, como los resúmenes mensuales de Wikimedia. Puede mantener esas páginas con traducciones, pero ocultarlas en la interfaz de traducción. Esto no impide más traducciones a las páginas, pero reduce enormemente la posibilidad de que un usuario empiece accidentalmente a traducir la página. La desalentación y su reversión se hacen desde Special:PageTranslation.

Priorizando idiomas. También puede definir una lista de idiomas en los que específicamente desea traducir; dejar la lista de idiomas vacía se interpreta como todos los idiomas permitidos. La página se comportará como una página desalentada (ver párrafo anterior) para los idiomas que no están en la lista de prioridades y, al traducirlos, los traductores recibirán un aviso. También puede evitar la traducción en otros idiomas, por ejemplo si las traducciones se utilizan realmente en otro lugar y no podrá utilizarlas, pero en algunos idiomas.

Agrupando. 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 contraen de forma predeterminada en Special:LanguageStats en el grupo selector en Special:Translate.

Trasladando. Puede trasladar las páginas traducibles como trasladaría cualquier otra página. Cuando se traslada, puede elegir si desea mover también cualquier subpágina que no sea de traducción. El movimiento utiliza un trabajo de fondo para mover las muchas páginas relacionadas. Mientras el movimiento está en progreso, no es posible traducir la página. La finalización se anota en el registro de traducción de páginas.

Borrando. Al igual que el traslado, el borrado se accede desde el lugar normal. Usted puede borrar la página traducible entera, o apenas una página de la traducción, desde el botón de cancelación en ella. La eliminación borrará también todas las páginas de la unidad de traducción relacionadas. Al igual que en el traslado, un proceso de fondo eliminará las páginas en el tiempo y se anota la terminació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 método estándar "delete".

Revirtiendo. Del mismo modo, revertir ediciones incorrectas funciona como de costumbre (incluyendo el botón de revertir): 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 en la unidad de traducción de la página de edición a la traducción, haga clic en el enlace "" para el editor y busca una edición en un momento similar.

Protegiendo. Es posible proteger la página traducible. Las páginas de traducción no se pueden proteger, ni tampoco la protección de la página traducible. 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 "priorizar idiomas" anterior. Juntas estas dos acciones evitan efectivamente 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.

Remover de la traducción. También es posible desmarcar una página para su traducción. Primero debes eliminar todas las etiquetas de la página. Entonces puedes usar Special:PageTranslation o siga el enlace en la parte superior de la página traducible para eliminarlo 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, editables libremente. No se recomienda esta acción.

Anatomía de una página traducible
The translation of a translatable page will produce many pages, which all together compose the translatable page in the broadest sense: their title is determined by the title of the translatable :


 * (the source page)
 * (the translation pages, plus a copy of the source page without markup)
 * (all the translation unit pages)

In addition to this, there are the translation page template and the sources of translation units, extracted from the source page and stored in the database. The system keeps track of which versions of the source page contain translation tags and which version of them have been marked for translation.

Every time a translation unit page is updated, the system will also regenerate the corresponding translation page. This will result in two edits. The translation unit page edit is hidden by default in recent changes and can be shown by choosing show translations from the translation filter. Any action other than editing (like deleting and moving) the translation unit pages will not trigger the regeneration of the corresponding translation page.

If you need the copy of the source page without markup, e.g. to be pasted in another wiki without Translate, the text will be displayed or saved.
 * identify the source language code (for English, en ) and visit ;
 * click the "" button to reach an address like this and replace  with   in the address bar, press enter:

Segmentación
Principios generales:


 * 1) Todo el texto destinado a la traducción debe ser envuelto con etiquetas . Puede haber varios pares de etiquetas en una sola página.
 * 2) Everything outside those tags will not change in any translation page. This static text, together with the placeholders which mark the place where the translation of each translation unit will be substituted, is called the translation page template.
 * 3) Too much markup in the text makes it difficult for translators to translate. Use more fine grained placing of  tags when there are lots of markup.
 * 4) The text inside  tags is split into translation units where there is one or more empty lines between them (two or more newlines).

Restrictions. The page translation feature places some restrictions on the text. There should not be any markup that spans over two or more translation units. In other words, each paragraph should be self-contained. This is currently not enforced in the software, but violating it will cause invalid rendering of the page, the severity depending on whether MediaWiki itself is able to fix the resulting html output or not.

Parsing order. Beware, the tags work differently from other tags, because they do not go through the parser. This should not cause problems usually, but may if you are trying something fancy. In more detail, they are parsed before any other tags like or, with the exception of  which is recognized by the Translate extension in some circumstances (such as rendering a page) but not in others (such as generating the list on Special:PageTranslation of pages containing ). If you want to have the literal expression "" in the source text, you should escape it like " ".

Tag placing. If possible, try to put the tags on their own lines, with no empty lines between the content and the tags. Sometimes this is not possible, for example if you want to translate some content surrounded by the markup, but not the markup itself. This is fine too, for example:

To make this work, the extension has a simple whitespace handling: whitespace is preserved, except if an opening or closing  tag is the only thing on a line. In that case the newline after the opening tag or before the closing tag is eaten. This means that they don't cause extra space in the rendered version of the page.

Variables. It is possible to use variables similar to template variables. The syntax for this is. For translators these will show up only as, and in translation pages will automatically be replaced by the value defined in the translatable page (so they are global "constants" across all its translation pages). Variables can be used to hide untranslatable content in the middle of a translation unit. It also works for things like numbers that need to be updated often. You can update the number in all translations by changing the number in the translatable page source and re-marking the page. You do not need to invalidate translations, because the number is not part of the translation unit pages.

Markup examples
Below are listed some alternatives and suggested ways to handle different kinds of wiki markup.

{| class=wikitable Translation by adding language suffix: Category:Cars/fi (recommended)
 * Categorías
 * width=40% | Categories can be added in two ways: in the translation page template or in one of the translation units. If you have the categories in the translation page template, all translations will end up in the same category. If you have categories inside translation units, you should teach the users a naming scheme. On the right we show two possible schemes which are independent of the technical means to adopt them.

[...] &lt;/translate>


 * Nombre de página de categoría no traducido (tal como los nombres de páginas).
 * Una categoría para cada idioma.
 * Page translation could be used for the category itself: the categories would be linked together and the headers would be translated (but not the name of the category in links and such).

No translation: Category:Cars

Incorrecto: == Culture ==
 * Todas las traducciones en la misma categoría (bueno solo si hay pocos idiomas, malo si hay muchos).
 * Nombre de categoría no traducido (puede ponerse como en la plantilla de traducción).
 * Headers
 * Headers can in principle be tied to the following paragraph, but it is better to have them separated with an empty line. This way someone can quickly translate the table of contents before going into the contents. When tagging headers, it is important to include the header markup inside the tags, or MediaWiki will no longer identify them properly. For example, section editing only works with the recommended mark-up given in the example. The markup also immediately gives translators a context: they are translating a header.
 * Headers can in principle be tied to the following paragraph, but it is better to have them separated with an empty line. This way someone can quickly translate the table of contents before going into the contents. When tagging headers, it is important to include the header markup inside the tags, or MediaWiki will no longer identify them properly. For example, section editing only works with the recommended mark-up given in the example. The markup also immediately gives translators a context: they are translating a header.

Wrong: == Culture ==

 Segmentación sugerida:  &lt;translate>

Culture
Lorem ipsum dolor. &lt;/translate>

&lt;translate> &lt;/translate>
 * Imágenes
 * Images that do contain language specific content like text should include the full image syntax in an unit. Other images can only tag the description with optional hint in message documentation of the page after it has been marked.
 * Images that do contain language specific content like text should include the full image syntax in an unit. Other images can only tag the description with optional hint in message documentation of the page after it has been marked.


 * Enlaces
 * Links can be included in the paragraph they are inside. This allows changing the link label, but also changing the link target to a localized version if one exists.
 * Links can be included in the paragraph they are inside. This allows changing the link label, but also changing the link target to a localized version if one exists.

If the target page is (or should be) also translatable, you should link to it by prepending  to its title. Only the link label will need to be translated, because this automatically redirects users to the translation page in their own interface language, as selected for instance via the UniversalLanguageSelector. However, to achieve a constant behavior the syntax must be used for all links.

Because headers are translated, you cannot rely on the automatically generated id's for headers. You can add your own anchors. To have them outside of the translation template you need to break up the page into multiple tag pairs around each header you want to have an anchor to. Enlaces internos: &lt;translate> Helsinki is capital of Finland. &lt;/translate>

Enlaces a páginas traducibles: &lt;translate> It has marvelous beaches with a lot of seagulls. &lt;/translate> Enlaces externos: &lt;translate> PHP (website) is a programming language. &lt;/translate> Enlaces dentro de una página: &lt;translate>

Culture
Lorem ipsum dolor.

...

For more about food, see section about culture. &lt;/translate>

&lt;translate> &lt;/translate> &lt;translate> &lt;/translate>
 * Listas
 * Lists can get long, so might want to split them into multiple parts with for example five items or less in each as follows. Do so only if the items are sufficiently independent to be translate separately in all languages, don't create "lego messages": for instance, you must avoid to split a single sentence in multiple units, or to separate logically dependent parts which may affect each other (with regard to punctuation or style of the list, for instance). To split a list, use -tags. Do not insert new lines as this will break the HTML output.
 * Lists can get long, so might want to split them into multiple parts with for example five items or less in each as follows. Do so only if the items are sufficiently independent to be translate separately in all languages, don't create "lego messages": for instance, you must avoid to split a single sentence in multiple units, or to separate logically dependent parts which may affect each other (with regard to punctuation or style of the list, for instance). To split a list, use -tags. Do not insert new lines as this will break the HTML output.
 * General principles
 * Headings
 * Images
 * Tables
 * Categories
 * Links
 * Templates


 * Números
 * With numbers and other non-linguistic elements you may want to pull the actual number out of translation and make it a variable. This has multiple benefits:
 * With numbers and other non-linguistic elements you may want to pull the actual number out of translation and make it a variable. This has multiple benefits:

&lt;translate> Income this month  EUR &lt;/translate> Note that this prevents the translators from localising the number by doing currency conversion. The  call makes sure the number is formatted correctly in the target language.
 * You can update the number without invalidating translations.
 * Translation memory can work better when the changing number is ignored.


 * Plantillas
 * Templates have varying functions and purposes, so the best solution depends on what the template is for. If the template is not a part of longer paragraph, it should be left out, unless it has parameters that need to be translated. If the template has no linguistic content itself, you don't need to do anything for the template itself.
 * For an example of templates translated with page translation, see Template:Extension-Translate. To use this template, you need to have another template similar to Translatable navigation template, because you cannot include the template by  anymore. This is not yet provided by the Translate extension itself, but that is in the plans.
 * For an example of templates translated with page translation, see Template:Extension-Translate. To use this template, you need to have another template similar to Translatable navigation template, because you cannot include the template by  anymore. This is not yet provided by the Translate extension itself, but that is in the plans.

Another way is to use the unstructured element translation to translate the template, but then the language of the template will follow the user's interface language, not the language of the page he is viewing.
 * }

Cambiar el texto de orígen
Principios generales:


 * Evita cambios
 * Haz los cambios tan aislados como puedas
 * No agregues por ti mismo marcadores de unidades de traducción

Unit markers. When page is marked for translation, the system will update the translatable page source and add unique identifiers for each translation unit. See example below. These markers are crucial for the system, which uses them to track changes to each translation unit. You should never add unit markers yourself. The markers are always on the line before the unit; or, if it starts with a header, after the first header on the same line. The different placement for headers is needed to keep section editing working as expected.

&lt;translate>

Birds
&lt;!--T:1--> Birds are animals which....

&lt;!--T:2--> Birds can fly and... &lt;/translate> Changing unit text. Changing is the most common operation for translation units. You can fix spelling mistakes, correct grammar or do other changes to the unit. When re-marking the page for translation, you will see the difference in the unit text. The same difference is also shown to translators when they update their translations. For simple spelling fixes and other cases where you don't want the existing translations to be highlighted on the translated pages, you can avoid invalidating them: translators will still see the difference if they ever update the translation for any reason.

Adding new text. You can freely add new text inside tags. Make sure that there is one empty line between adjacent units, so that the system will see it as a new unit. You can also add tags around the new text, if it is not inside existing  tags. Again, do not add unit markers yourself, the system will do it.

Deleting text. You can delete whole units. If you do so, also remove the unit marker.

Splitting units. You can split existing units by adding an empty line in the middle of a unit, or by placing tags so that they split the unit. 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.

Merging units. If you merge units, you have to remove at least all but one unit marker.

Moving units. You can move units around without invalidating translations: just move the unit marker together with the rest of the unit.

Before marking the new version of the page for translation, ensure that the best practices are followed, especially that translators get a new translation unit if the content has changed. Also make sure that there are no unnecessary changes to prevent wasting translators time. If the source page is getting many changes, it may be worthwhile to wait for it to stabilize, and push the work for translators only after that.

Unused unit translations are not deleted automatically, but that should not cause trouble.

Migrar a traducción de página
If you have been translating pages before using the page translation system, you might want to migrate the pages to the new system, at least the ones you expect to have new translations and want statistics for. You will probably have existing templates for language switching and maybe different page naming conventions.

You can start migration by cleaning up, tagging and marking the source page. 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.

This manual task has been partly automated by Special:PageMigration, which shows the source and target units besides each other and allows the user to adjust the units by providing a set of features mentioned later in this page.

¿Cómo usarlo?
500px|Screenshot showing an example use of Special:PageMigration for "Help:Special pages" as page name and "fr" as language code.
 * 1) Ve a Special:PageMigration
 * 2) Enter the title of the page and the language code. For example, "Help:Special pages" & "fr"
 * 3) The source text which was divided into units by Translate and the imported translations will be shown besides each other with some initial alignment.
 * 4) Use the actions available for each unit to manually do the remaining alignment
 * 5) As translated units are editable, do required manual improvements (for add translation variables, fix links and markup, etc.)
 * 6) Click on the "" button. This will create pages under the Translations namespace of the form  . The old translations have been imported into Translate.
 * 7) Else, if you wish to abort the importing, click on the 'Cancel' button.

Acciones disponibles
Each row consisting of source and target unit has a set of action icons. They are used as follows:
 * 1) Add: Clicking on this action icon adds a new empty unit below the current one. Use this feature if you want to split the current unit and need a unit below.
 * 2) Swap: Clicking on this action icon swaps the content of the current unit with the unit below it. You can use this feature when the units get aligned improperly due to different ordering of sections. Or when you need to drag a unit below or above. In either case, remember it swaps with the unit below and does not create any additional units.
 * 3) Delete: Clicking on this action icon completely removes the corresponding target unit from the page and shifts the remaining target units up by one unit. Use this to remove unwanted content like code or imported translations which are present completely in the source language. Note: this irrevocable action (in the current session).

Solución de problemas

 * 1) If you mark a page for translation and immediately go to the special page and try to import translations, you may get an error message like "". This is because FuzzyBot didn't fuzzy the messages on the old page yet: the tool won't find an edit by FuzzyBot on the translation page. In this case, simply wait for FuzzyBot to do its job. Once an edit is seen, you can proceed with the imports.
 * 2) Please wait for some time after pressing the "" button. While the button background remains gray, there is an ongoing process of importing non-empty units. Once the button becomes colored again, the import is completed.

Tips

 * 1) Migration will be easier if you first (before the mark to translation) check whether existing translations are similar to the original English text, and manually edit the structure of pages: break paragraphs and lists, add the missing headers (even if empty).
 * 2) Will be useful to check the result in the core translation interface - some of the units may be immediately marked as obsolete because of errors markup or if not all of the translation variables was added.
 * 3) Translation of the page title will have to be added manually. If you do not know very well the language of the imported page, you can try to find the translation of the page title among the "links here" or sometimes in redirects. Note: Please don't translate the namespace, keep it untranslated.