Help:Extension:Translate/ca



L'extensió Translate millora MediaWiki amb unes característiques essencials que es necessiten per fer el treball de traducció. Es pot utilitzar per traduir les pàgines de contingut, la interfície del wiki i fins i tot altres productes de programari, ja que s'utilitza en translatewiki.net. L'extensió Translate ve amb una interfície de traducció fàcil d'utilitzar i es pot separar l'estructura del contingut (des del contingut del text) que s'ha de traduir, mostrant només el text traduïble als traductors, en dividir el contingut en unitats manejables. De cada unitat se'n comprova automàticament els canvis, i els traductors veuen immediatament el que necessita modificar-se d'una pàgina específica o de tot el wiki.

L'extensió Translate s'utilitza per traduir la interfície d'usuari de MediaWiki i altres projectes de programari en translatewiki.net per centenars de traductors cada mes. En userbase.kde.org s'utilitza per traduir gairebé mil pàgines de contingut amb la documentació de l'usuari. És fàcil començar a utilitzar l'extensió Translate, però a la vegada també mostra informes avançats de les característiques de l'augment proporcional de les traduccions, de les revisions realitzades i del flux de treball.

Característiques


Interfície: La principal característica de l'extensió Translate és una interfície de traducció senzilla i alhora funcional. A més de la informació essencial com a definició de missatge i la documentació, també es poden veure traduccions en altres idiomes. Si una definició ha canviat, podreu veure els canvis. L'extensió ve amb algunes comprovacions predefinides, que poden ajudar amb errors comuns com parèntesis i claudàtors desequilibrats i variables no utilitzades. Depenent de la configuració, també hi ha suggeriments de l memòria de traducció i serveis de traducció automàtica com les de Google Translate, Bing Translator de Microsoft i Apertium.

La usabilitat de la interfície de traducció s'ha millorat amb JavaScript i AJAX. El backend ofereix WebAPIs que es poden utilitzar en interfícies mòbils o interfícies adaptades a un tipus específic de contingut. També és possible exportar els missatges per a la seva traducció en un altres eines fora-línia i en-línia que acceptin el format d'arxiu Gettext po.

Grups de missatges i tasques: Moltes de les característiques es construeixen al voltant de dos conceptes bàsics: grups de missatges i tasques.

Un grup de missatges representa una col·lecció de missatges. Una pàgina de contingut seria un grup de missatges, on, en la forma més simple, cada paràgraf seria un missatge en aquest grup. Els missatges utilitzats en cada extensió de MediaWiki formen un grup de missatges a translatewiki.net - algunes de les extensions més grans tenen diversos grups. Podeu també fer un grup de grups, com Tots els butlletins o Tots els missatges de l'extensió Translate. Moltes de les estadístiques i les tasques de treball són en base a grups de missatges.

Les tasques, o en altres paraules diferents llistes de missatges referents a un grup de missatges, facilitant diferents casos d'ús. Normalment un traductor obté una llista de tots els missatges sense traduir en un grup de missatges elegit, però hi ha tasques en que només us interessi revisar els missatges o simplement obtenir una llista de tots els missatges, traduïts o no.



Informes i estadístiques: L'extensió té una àmplia diversitat d'informes que van des veure els missatges no traduïts en tots els grups de missatges en un idioma determinat a llistes de traductors per idioma amb el seu nivell d'activitat.

Traducció de contingut: Si alguna vegada heu tractat de traduir el contingut en MediaWiki sense utilitzar eines, en sabeu els problemes. Les versions traduïdes resten desfasades i no hi ha manera de comprovar els canvis en la pàgina principal, així que hi ha moltes traduccions a mig fer o desfasades sense una visió clara de la situació general. Els traductors sovint se senten descoratjats quan no poden treballar amb petits trossos manejables de text. Els traductors no troben en que van treballar o el que necessita una actualització. Els usuaris també es confonen amb informació desfasada.

Tot això es soluciona amb l'extensió Translate i la seva funció de traducció de pàgines. S'afegeix una mica de sobrecàrrega de feina per preparar les pàgines que necessiten traducció, però els beneficis superen amb escreix aquesta feina. Essencialment, només heu de marcar les parts de la pàgina que necessiten ser traduïdes. L'extensió Translate s'encarrega de dividir aquestes parts en unitats de la mida d'un paràgraf i en crea un grup de missatges per a cada pàgina. Després els traductors poden utilitzar totes les característiques descrites anteriorment. A més podeu afegir fàcilment una barra d'idiomes amb l'etiqueta o tenir enllaços que automàticament vagin a la versió a l'idioma preferit de l'usuari (només) quan existeixi, mitjançant l'ús d'enllaços de la forma Special:MyLanguage/Pagename.

For more information see the tutorial Com configurar una pàgina de contingut per a la traducció i la documentació a fons de la funció de traducció de pàgines.

Desenvolupadors: L'extensió ve amb una funció de suport per a molts formats de fitxers de traducció comunes, com els fitxers de les propietats de Java i els po de Gettext. Compta amb un ampli conjunt d'eines, tant en wiki com en la línia d'ordres, per importar i exportar traduccions de manera eficient.

Use cases
You can translate almost anything with the Translate extension. Naturally there are specialized tools for translation of certain kind of content like video subtitles, that are better done with those tools, but in general Translate performs very well with any kind of text that can be split into messages with length ranging from one word up to one large paragraph. Longer messages become unwieldy to translate and are just harder to work with.

The three primary use cases that the Translate extension supports are content translation, local interface translation and software translation. All of them are covered in the following sections, with links to tutorials and to reference documentation or in-depth topical help where available. Of the three use cases the interface translation has been utilized the least.

Content translation


Most wikis have content they would like to be available in multiple languages. Whether just a few or hundreds of pages, it doesn't matter. In order to prevent wasting translator's time, pages should be marked for translation only when they are reasonably stable. Each change that is made afterwards can affect tens or hundreds of old translations, and the time needed to update them adds up. Especially with volunteer translators, you should be aware of this aspect, and respect the time they spend making translations and updates, avoiding unnecessary work. If you use the Translate extension to translate pages, you are already well on your way to using the translator time available in the most effective and efficient way.

The way the Translate extension splits up a page into paragraph sized units does not leave too much freedom for translators to change the content. This is usually a good thing and is ideal where continuity and consistency of content across languages is desired. It can be worked around, but in principle this way of doing translations is not generally suitable, for example, for Wikipedia articles, which usually are totally independent of each other. Even if they originally start as a translation from a different language, they usually begin living their own independent life from the original version. With Translate, the original page is always the main version, and new content cannot be developed in translated versions.

With these limitations in mind there are still plenty of cases where this feature is a perfect match. Most, if not all, user documentation falls into this category as well as news-like content that does not change once written. If you have the Translate extension already installed and access rights configured, try creating a page and wrapping the whole text inside  and follow the links, or follow the tutorial How to prepare a page for translation.

Local interface translation in multilingual wikis
One thing almost every wiki has customized is the sidebar. It is possible to create a message group for the custom sidebar messages and also for other local interface customisations.

One interesting expansion is the multilingual pages or templates built with the magic word. The translatewiki.net main page and some Wikimedia Commons templates are good examples of this. The magic word is an alternative to the content translation feature and it is more suitable to mark-up heavy pages just like the translatewiki.net main page. Another nice feature is that the language of the page automatically follows the user interface language, so there is no need for a language bar, although you might want to have an interface language selector instead.

Setting this up is currently a bit more complicated than content translation and needs software configuration, but it is all covered in the tutorial How to make an interface message group.

Software translation
The Translate extension is a good fit for translating software interface messages. At translatewiki.net, it is used to translate tens of software products from games to web applications. The Translate extension supports reading and updating translations from and to common formats used in web development including Java properties, Gettext and Yaml files.

Change tracking is also available for externally tracked files, because internally the extension uses a cached derivative version of the localisation files where the source text and its translations are stored, instead of using them directly in their original format. Translation administrators can either use the web interface or a command line interface to check new message definitions and "fuzzy" (request update of) translations when they need updating. This works regardless of the underlying file format or version control system (if any).

With simple command line tools, translation administrators can easily import even a large set of existing translations and with just one command they can export all translations in the correct format and in the correct directory structure. You can export directly to your VCS repository checkout, where you can easily commit changes and new files.

For translators and translation administrators

 * How to translate [Tutorial]
 * Translation best practices
 * Statistics and reporting
 * Quality assurance
 * Message group states
 * Off-line translation
 * [In progress] Glossari

For translation administrators

 * How to prepare a page for translation [Tutorial]
 * Page translation administration
 * Interface message groups (localised sidebar, main page and templates) [Tutorial]
 * [In progress] Message group management
 * YAML configuration format
 * How to write YAML configuration for file based message groups [Tutorial]

Reference documents for developers

 * Instal·lació i Configuració; MediaWiki Language Extension Bundle should be enough in most cases.
 * [In progress] Translate explained for developers
 * Hooks
 * [In progress] Message groups
 * [In progress] File format support
 * Translation aids
 * [Unwritten] Web API
 * Insertables
 * Translation memories

Related

 * Translation notifications
 * Localisation/Tutorial: General localisation tutorial for developers, for use at hackathons & trainings
 * Extension:TranslateSvg: Adds support for translating SVG files
 * Universal Language Selector: Provides webfonts and input methods

Todo

 * Implementation on Meta: m:Meta:Translate extension.
 * See translate-doc for specific tasks.