Help:Extension:Translate/Translation example/sw

<translate> Documentation for <tvar|ext>Extension:Translate</></translate>

<translate> Translators</translate> (<translate> main help page</translate> )

<translate> Translation administrators</translate>

<translate> Sysadmins and developers</translate>

<translate> Translate this template</translate>

Karibu, mfasiri mtukufu. Tuna kazi nyingi ya kufanya, hivyo hebu tupitie mambo ya msingi kwa haraka sana ili uweze kuanza mapema iwezekanavyo. Baada ya mafunzo haya wewe utakuwa umejua jinsi ya kutumia chombo chako binafsi cha tafsiri. Madhara yake ni ya kudumu, hivyo kama hutaki kujifunza jinsi ya kutumia hiyo, tafadhali kuacha kusoma sasa.

Ni matumaini yetu kwamba popote umetoka, watawala wa tafsiri tayari wameanzisha kitu kutafsiri. Mafunzo haya yanatumia ukurasa wa Fréttinga _ ambao hujionyesha katika mafunzo kwa watawala wa tafsiri. Mambo yaliyojadiliwa hapa hayategemei ukurasa huo, na kuomba kwa kila kitu unaweza kutafsiri kwa chombo hiki.

Labda una kiungo kutoka kwa mtu akikuuliza utafsiri kitu. Kama lala, unaweza tazama Special:LanguageStats, dashibodi ya mfasiri, katika wiki yako kwa kitu cha kutafsiri. Kama unataka tu kuona jinsi inavyofanya kazi kwa ujumla, bado unaweza kusoma pamoja na kuangalia viwambo ili kupata hisia yake.

Kwa kawaida huwezi kufanya tafsiri bila ya kuomba ruhusa. Hata hivyo baadhi ya wiki zimewezesha tafsiri kwa watumiaji wote. Wewe kwa haraka utatambua haraka ikiwa unakosa haki za kutafsiri. Kama hivi ndivyo, wasiliana na msimamizi wa tafsiri ya wiki yako. Hebu tuanze kwa kupata mtazamo wa tafsiri.

1a. Enda kwa ukurasa wa réttinga.
2a. Bofya kiungo cha "Translate this page" (kama hakitaonyeshwa basi huna ruhusa ya kutafsiri).

Ama unaweza jaribu:

1b. Enda kwa translator dashibodi.
2b. Bonyeza jina la kundi lolote la ujumbe ambalo lina jumbe ambazo hazijatafsriwa.

Jumbe za kutafsiri zimegawanywa kwa "kundi ujumbe": Kila ukurasa ambao unaweza tafsriwa ni kikundi ujumbe, lakini kuna aina nyingine ya makundi ya ujumbe pia.

3. Chagua lugha nyingine isipokuwa lugha ya asilia ya chanzo (ambayo kwa kawaida ni Kiingereza au en).

Translate manual - Translate example - 03. LanguageStats short.png

Dashibodi ya mfasiri inaonyesha Fréttinga yahitaji kutafsriwa. Bofya katika kichwa chake ili ufasiri.
Translate manual - Translate example - 04. Untranslated.png

Tazama jumbe zote ambazi hazijafasiriwa

Mhariri wa tafsiri

This view and variations of it are the basic interface you will be working in. The long list of messages still to be translated 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 make your first translation. Click a row to open the translation editor. You will see the source text you need to translate and a text area where you can write your translation. If you clicked the first message listed for the page Fréttinga, it should say "Fréttinga" as the content. Since it is a name, you don't usually need to change it, so you can copy it as-is to the text area. If your language uses a different writing system, you can choose to transliterate it. Then just click save and you are done!

4. Bofya kwenye ujumbe ulioko kwenye nguzi ya kushoto.
5. Katika mawasiliano kwenye kidukizo, andika tafsiri ya cjanzo cha hati katika nafasi iliyohifadhiwa kwa ajili yake.
6. Bofya "Hifadhi".

5. In the editor dialog, write the translation of the source text in the place reserved for it.

6. Click or tap "Save translation".

File:Translate manual - Translate example - 07. Editor assistant.png

A message with a tip and a suggestion from two assistant languages (scroll till the end to see them)

Depending on the configuration of the wiki, you may also see other things in the editor besides the source text. There may be suggestions from translation memories or machine translation systems. There can be a 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 are no tips and you feel like you need them, ask someone in the wiki to add them; if you are knowledgeable enough about the text that needs translation, add them yourself. 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.

File:Translate extension tvars - translation variables.png

Two screenshots, showing the wikitext and the translation tool, and how a translation variable works

At the bottom of the box for translated text, you might see buttons with a label that starts with a $ (dollar sign). E.g. $1, or $name. These are "translation variables" (tvars). They are most often used for either links, or other types of text that should not be translated. You should insert these tvars into your translation in the matching location, either by clicking the button or by copying/typing it manually. These tvars must not be translated into your language.

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

Feel free to make a few more translations and try out the other buttons. Clicking the suggestions or the "Paste source" button will immediately paste that text in the text area, overwriting anything already in that text area.

Translation view

Here we are again, watching the list with untranslated messages. If you refresh the page, the list should now be shorter, or even empty. The view has information like description of the group, but more interesting at the top you can choose language, message group and different message filters.

All message groups function the same way, and you don't need to worry about them too much. The important thing is that you always need to choose a message group to work on, and things like statistics and completion percentages are calculated on message group level.

File:Translate manual - Translate example - 08. Review all.png

Review all messages view

From the different views at the bar at the bottom, you can switch to the view suitable for doing other tasks, like review or translating whole pages. Depending the configuration, you should see all or some of the following views: "List", "Page" and "Proofreading". Read more about reviewing translations and other quality assurance methods in the quality assurance page.

The page can also contain the message group status near 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 are working on the translation or if you are reviewing it. See more about workflow states in the message group states page.

Important concepts

File:Translate manual - Translate example - 10. Outdated clicking.png

The translation is incomplete, and as usual the top of the page gives us the link to translate: Click the link "translated version". In this case we'll discover that some English strings already have translations, which need updating.

You already know what a message group is, and have seen the translation editor and assistant languages. Now the translation administrator may have continued their page translation tutorial and changed the contents of the page Fréttinga. When the text that must be translated changes, it will show up again in the list of untranslated messages and also in the list of outdated messages.

When facing outdated messages, you have two options. You can confirm that the translation does not need any changes after all, or you can make the necessary changes to it. Messages may appear to be outdated automatically when a new translation is saved, if the automatic checks find issues in the translation, like for example unbalanced link syntax missing the other "]" character. You will also get a warning about these when editing the translation.

The outdated translations are marked with red. If you now return to the translated page by clicking the link on the message group description, you should see that your translations are already there. Most of the translations you will make are applied immediately with exception about some message groups, like many of those in translatewiki.net, where the translation are regularly and manually exported by translation administrators to the software they are used in.

One more useful tip when translating translatable pages: magic words like {{FORMATNUM}} will format the output in the translation language, not in the language of the source text. If you like, you can read more on how magic words work and should be used in translations. This is not required reading, though.

Translate manual - Translate example - 12. Editor fuzzy.png

Updating a fuzzied or outdated message: here we have clicked to see the differences
Translate manual - Translate example - 15. Translation memory.png

An example with suggestions from the translation memory. The percentage indicates the quality of the suggestion and there's a count for the occurrences of each suggestion. In the example, we're choosing to use the most used one.

Getting your translation to another wiki

If you're working with software documentation, you are probably translating this material because you want to use it somewhere else. To export your translation, go to the main translation page, and click the "Export" tab. Choose the language you want, and copy the wikitext from the box. You can then paste that text on to any wiki. This fast, simple process only works for translations, not for the original source language.

Exporting the original language (usually English on MediaWiki) for use on another wiki, without all of the translation markup, is more complicated.

First, open the page in the wikitext editor. This will produce a URL similar to www.mediawiki.org/w/index.php?title=YOUR-PAGE-NAME-HERE&action=edit.
Second, manually change this URL to insert a subpage for the language you want. If the original is written in English, then you add /en after your page name, so that the URL says www.mediawiki.org/w/index.php?title=YOUR-PAGE-NAME-HERE/en&action=edit Press return so that it will open the modified URL you just created.
Then you can copy the wikitext out of the new wikitext editing window, without the translation markup. This can be pasted onto another wiki.

Anyone can export text. You do not need to be a translator or translator admin to get a copy of the translation.