Help:Extension:Translate/Translation example





Welcome, glorious translator. We a have lot of work to do, so let's get over the basics very quickly so that you can start as soon as possible. After this tutorial you'll know how to use your personal TranslateTech language translation toolset. The effect will be permanent, so if you don't want to learn how to use it, please stop reading now.

We hope that wherever you come from, the translation administrators have already setup something to translate. This tutorial uses the Fréttinga page that is created in the tutorial for translation administrator. The things we cover here do not depend on that particular page, and the topics we cover apply to everything you can translate with this tool.

Maybe you already got a link from someone asking you to translate something. If not, you can check Special:LanguageStats in your wiki for something to translate. If you just want to see how it works in general, you can still read along and watch the screenshots to get some impression of it.

Usually you cannot make translations without asking for permissions. Some wikis however have enabled translation to all users. You will quickly notice if you lack the rights to translate. If this is the case, contact the translation administrator of your wiki. Let's start with getting to the translation view.


 * 1a. Go to the Fréttinga page
 * 2a. Click the "Translate this page" link (if it does not show up you don't have permission to translate)

Or you can try:


 * 1b. Go to Special:LanguageStats
 * 2b. Click the name of any message group that has untranslated messages

Messages to translate are grouped by "message group": each translatable page is a message group, but there can be other kinds of message groups too.


 * 3. Choose a language other than the language of the source text (which usually is English)

Translation editor
This view and variations of it are the basic things you will be looking at. The long list of messages still to translate may occasionally depress you, but fortunately we don't actually need to watch that list so often. You should see at least some untranslated messages here. Let's do our first translation. Click the link of the left column to get a popup. You will see the source text you need to translate and a textarea where you can write your translation. If you clicked the first message listed for page Fréttinga, it should say "Fréttinga" as the content. Since it is a name you don't usually need to change it, except if your language uses different writing system, in which case you might need to transliterate it. Then just click save and you are done!


 * 4. Click the message name on the left column.
 * 5. In the popup dialog, write the translation of the source text in the place reserved for it.
 * 6. Click "Save".



Depending on the configuration of the wiki, you also see other things in the popup besides the source text. There might be suggestions from translation memories or machine translation systems. There can be section for tips that provide crucial information that you need to use to make a correct translation. So if there are tips, read them carefully. If there aren't tips and you feel like you need them, ask someone in the wiki to add them, or add them yourself if you can. These tips help you to translate better and faster. Don't feel ashamed to ask for clarifications – it's highly likely that the other tens or hundreds translators are wasting their time thinking of the same issues. Enough of that, I'll let you make your own mind on that.

One more thing about the aids: if you benefit from seeing the message translated into other languages as additional tip, please go to Special:Preferences -> Editing -> Translation options and add them to assistant languages for yourself.

Usually there is no need to add a summary if you are making a new translation, unless you want to clarify some decisions you made in terminology or formatting. When changing existing translations it's polite to mention Fixed a spelling error or Use term X consistently and so on, to help other translators understand and improve cooperation. Feel free to make a few more translations and try out the other buttons. The small downwards-pointing arrows next to suggestions and source text immediately paste the text in the text area.

Translation view
Here we are again, watching the depressing list. If you refresh the page, the list should now be shorter, or even empty. The view has the usual paging controls and description of the group, but more interesting at the top there are some selector for choosing language and message group and the task.

All message groups function the same, and you don't need to worry about them. The important thing is that you always need to choose some message group to work on, and things like statistics and completion percentages are calculated on message group level. From the task selector you can switch the view suitable for doing other tasks, like review. Depending on the configuration, you should see at least "Review all translations" and possibly "Accept translations". Choose "Review all" and you should see the translations you made together with the source texts. Again, depending on the configuration, you might also see buttons that say "Accept", but grayed out because you cannot accept your own translations. Read more about reviewing and other quality control methods in the quality control page.

You might also see the message group status in the top right corner of the message group description, which can be set for each language of the group; if you see a dropdown selector of the possible states, it means that you can change it, and you should update it when you work on the translation. See more about workflow states in the message group states page.

Important concepts


You already know what is a message group or a task and have seen the translation editor popup and assistant languages. The translation administrator might now have continued his page translation tutorial and changed the contents of the page Fréttinga. When messages change, they will show up again in the list of untranslated messages, prefixed with a string " ". This is just a marker to make it obvious that translation needs updating. When updating translations, be sure to remove the " " string if the translation is okay, otherwise it isn't considered translated. In some cases you might even add the " " string itself to a translation that you know is wrong, but don't know how to fix it. Be careful about the syntax, it must be exactly right. " " may also be added automatically when new translation is saved, if the automatic checks find likely issues in the translation, like for example unbalanced link syntax missing the other ] symbol. You should also get a warning about these when translating.

On translatable pages, the outdated translations are marked with a reddish color, shown on the screenshot. If you now return to the page by clicking the link on the message group description, you should see that your translations are already there. Most of the translation you will make are applied immediately, with exception about fuzzy messages and some message groups, like many of those in translatewiki.net, where the translation are regularly and manually exported by translation administrator to the software they are used in.

And one more useful tip when translating translatable pages, magic words like 0 will format the output in the translation language, not in the language of the source text. You can read more on how magic words work and should be used in translations here: Help:Magic words.