Help:Extension:Translate/Unstructured element translation/ca

Aquesta pàgina explica com realitzar, amb raonable facilitat, la traducció dels missatges de les interfícies wiki personalitzades, amb l'extensió Translate. S'aplica a qualsevol part del wiki en la que vulgueu que automàticament es proporcioni en l'idioma de la interfície de l'usuari. L'exemple més típic és la barra lateral, perquè no pot haver-ne només una, però el mateix mètode es pot utilitzar per a la pàgina principal, si voleu tenir totes les traduccions sota el mateix títol o, fins i tot, per a les plantilles.

Aquest mètode és aplicable també als continguts del wiki on la traducció completa de la pàgina no s'ajusta, com les pàgines difícils en marcatge o en les plantilles, el marcatge del qual no vol exposar als traductors. Tot això gira entorn dels missatges de la interfície, o en la paraula màgica, que li permet incloure missatges de la interfície en qualsevol lloc on es pot escriure text wiki. Aquesta paraula màgica permet substituir automàticament el missatge de la interfície, ja sigui estàndard, personalitzat o nou, en l'idioma de la interfície de l'usuari.

El podeu utilitzar per portar el poder de la localització automàtica de la interfície del wiki al contingut del wiki, però no resol el problema per als usuaris anònims, que no poden canviar l'idioma de la interfície per defecte. Vegeu la nota sobre l'extensió Universal Language Selector més avall.

En comparació amb la traducció de pàgines, aquest mètode té alguns inconvenients:


 * 1) Els desenvolupadors de MediaWiki generalment desaconsellen la utilització de , ja que fragmenta la memòria cau. En lloc d'emmagatzemar una versió rendida en la memòria cau d'una pàgina, quan  s'utilitza s'ha d'emmagatzemar potencialment en memòria cau per centenars d'idiomes diferents.
 * 2) És més difícil de configurar, el que requereix l'accés a la configuració del wiki.
 * 3) No hi ha seguiment automàtic de les traduccions desfasades i les estadístiques de finalització podrien estar sense efecte quan s'agreguen o s'eliminen els missatges nous.
 * 4) Només els administradors del wiki poden afegir missatges als grups de missatges i traduir-los. Això vol dir que el sistema és adequat només per a les pàgines que no canvien amb freqüència, o els administradors tindran molta feina.

El millor és que funciona la majoria del temps i encara es pot seguir treballant. Hi ha dos tutorials que proporcionen exemples dels casos d'ús comú. Abans hi ha una secció on es detalla com configurar un grup de missatges, cosa que sempre és necessari quan s'utilitza aquest mètode.

Instal·lació
A server administrator must complete this step. The following snippet needs to be added to LocalSettings.php: The message group id,, must be unique, so don't reuse the same id for multiple groups. The second parameter to the, refers to the Mediawiki:Sidebar-messages page. The label is shown in dropdowns and other places where you can select a message group. The description is shown in Special:Translate. Those are the values you can and should change to what suits your wiki when adding a new custom message group.

Tutorial de la barra lateral localitzada
We assume that the setup step has already been done. Then you should follow the sidebar customization guide carefully. Let's assume the following simple sidebar was created: And MediaWiki:Sidebar-commonpages contains, while MediaWiki:Sidebar-faq contains.
 * sidebar-commonpages
 * FAQ|sidebar-faq

Then all we need to do is to go to MediaWiki:Sidebar-messages (or whatever was defined in the previous step) and write there: sidebar-commonpages sidebar-faq That is, the names of the system messages, without the "MediaWiki:" namespace prefix, separated by whitespace.

Then go to Special:Translate/wiki-sidebar (or whatever was defined in the previous step; see Special:Translate for the list of defined groups). Now it is possible to translate the messages into other languages. Since all the messages are in the MediaWiki namespace, only a wiki administrator can edit the list of messages and actually translate them.

Tutorial de la pàgina principal localitzada
Another use case is a page with lots of markup or templates. See the main page of translatewiki.net for example. The advantage of this method is that the language automatically appears in the user's interface language. The drawback is that to change the language in which the page is displayed, the interface language must be changed.

The implementation is the same as in the previous tutorial:


 * 1) Setup a new message group.
 * 2) Take a wiki page.
 * 3) Replace each translatable part with  and move the content to MediaWiki:Mainpage-messagename.
 * 4) Go to MediaWiki:Mainpage-messages (or what was defined in the setup) and add the message names there separated by whitespace.
 * 5) You are done. Go to Special:Translate to translate the main page.

Here is an example. Let's say Main Page contains:  is a community for chefs and bakers that love chocolate. We currently have full of chocolate. Then change it to: 

Create MediaWiki:Mainpage-slogan with the content: is a community for chefs and bakers that love chocolate. Create MediaWiki:Mainpage-pagecount with the content: We currently have full of chocolate. Create MediaWiki:Mainpage-messages with the content: mainpage-slogan mainpage-pagecount And you are done! You can add and remove new messages any time you want.

Selector d'idioma
Not only the user can't choose what localised version of the page to read unless changing their preferences, but anonymous users can't set their user interface language and always use the wiki's default language. A page translated with this system will be in the default content language, if you don't provide anonymous users a way to select their language.

Luckily, there is a solution. With the UniversalLanguageSelector extension it is possible to guess the user's preferred language and also to let the user manually select another language and store the choice in a cookie, with no need of tricks such as the  parameter, which is suitable mostly only for debugging.