View source for Help:Prepare a page for translation

{{Expert manual TOC}}

A page needs some preparation before it is released for translation. Generally it is a good idea to only release pages that do not experience too many changes. 

Only [[Special:ListGroupRights|administrators]] can prepare a page for translation, as it is a very sensitive process.

{{Note-nutshell|
*Add translate tags <code><nowiki><translate>…</translate></nowiki></code> around the text to be translated.
*Add the language bar with <code><nowiki><languages /></nowiki></code> at the beginning of the page.
*Mark the page for translation. Mark it again, every time significant changes have been made to the source code.
}}

==Preparing a page for translation==
===Translate tags and translation units===
Generally, translate tags are wrapped around the content to be translated:

<code><nowiki>
<translate></nowiki></code>
…''content''...
<code><nowiki></translate>
</nowiki></code>

View the page in edit mode and wrap translate tags around the content, i.e. add the beginning tag at the very front and the end tag at the very end. The wiki will split the text into small units that are easier to translate at once than the entire page. However, the text might not be split into units the most convenient way, so it's best to split the text oneself. 

Manual setting of translate tags:
*Wrap translate tags around all text that needs translation. 
*Choose small units (paragraphs, headers, lists), that belong together in content.
*Leave out untranslatable content like styling code in tables, code tags (except heading code), template parameters etc.
*Translate tags cannot be nested into each other.
*Take great care in setting the translate tags right. The wiki will warn you if there are any missing tags and the page cannot be saved.

To see how text can be split into units, view this page in edit mode and watch out for the translate tags.

===Marking the page for translation===
Once the translate tags are set and the page is saved, a link appears at the top: <code>"Mark this page for translation"</code>. When clicked, one is presented with an overview page ("PageTranslation") with the units of the text. Save the page at the bottom with <code>"Mark this version for translation"</code>. Now the page is ready for translation and will show up in the [[Special:Translate|translation interface]].

===Translation markers===
Back in the code (edit mode) on the page one can see that the wiki added certain translation markers for the translation units:
<code><nowiki><!--T:1--></nowiki></code>

These translation markers should '''never''' be touched manually (deleted, moved around etc.), as this will irritate the system.

If you need to rearrange sections of the text, do so from translate tag to translate tag and move the markers with them.

===Adding the language bar===
To have the languages bar show up on the page, the tag <code><nowiki><languages /></nowiki></code> must be added at the beginning (or the bottom) of the page. Once the text (or parts of it) is translated into at least one other language, the bar will show up where it was included. 

You do not need to add this on lyrics pages, as this is catered for with the [[Template:Infobox Lyrics|Infobox Lyrics template]] (it is included there and will show up automatically.)

===Changes to a page after translation===
If the text on a page is edited, the translation markers should always stay intact. If a paragraph is moved or deleted, the translate tags and translation markers should be moved or deleted with it. Do not move translation markers alone, this way the wiki won't recognize the right units anymore. Changes to the text within the translation tags (units) can be easily done. Newly added text needs new translation tags (but no translation markers!), to be included into translation.

Once changes to a page are made, the text <code>"Translate this page"</code> on the original (English) version will expand to <code>"Translate this page; This page has changes since it was last marked for translation."</code>. This page needs then new marking for translation like in the step above: Follow the link and mark the page anew. Now affected translation units will show up as "Outdated" and translators will have a chance to update the translation.

''Example'': A sentence is added to a paragraph. Once the page is marked again for translation, the paragraph will show up as "Outdated" in the translation interface. Translators can then check the paragraph and add the missing sentence to the paragraph in the translation. 

==Special case: Preparing a lyrics page for translation==
All [[:Category:Lyrics|lyrics pages]] should have the Spanish and English lyrics text on the original page. Only release pages that have the English translation included already. The translation is done as usual from the English text, but the Spanish text shall be included into the documentation, so translators always have the original text at hand. This way, a two-way translation Spanish &rarr; English &rarr; 3rd language shall be minimized. (Of course, in this case a translator would have to have knowledge in both languages to make use of this help feature).

For this example we use the page [[Lyrics:Charlemos|Charlemos]].

===Tag the page===
#Edit the lyrics page.
#Add translate tags around the following text: (Do not wrap around the template parameters, instead around the values AFTER the equal sign "=".)
##the English title (i.e. "Let's talk" – and '''not''' "English title")
##the summary (if there is one)
##the source translation value (<code><nowiki>|Source translation = <translate>….</translate></nowiki></code>)
##the English lyrics text. Add the tags in the English lyrics text not in the whole, instead in portions, so it will be easier to translate.
##around the whole Weblinks part, if there are any weblinks.
##around anything in the free text, if it needs translation.
#You do '''not''' need to add the <code><nowiki><languages /></nowiki></code> bar in the page, as this is catered for via the included [[Template:Infobox Lyrics|Infobox Lyrics template]].
#Save the page.

===Mark the page===
If everything worked well, you should see a link at the top of the page saying "Mark this page for translation". Click the link. You will be directed to "PageTranslation".

Control the translate packages. Save the page at the bottom with "Mark this version for translation". 

Now you can translate the page.

===Add documentation===
It is a good idea to add documentation to the translation units for some extra information for translators. In this case, we want to include the Spanish lyrics text in the documentation, so translators have the English and Spanish version as parallel sources.

Documentation is always shown, independently from the target language (you will see it, whether you translate into German or Chinese).

#Move over to the [[Special:Translate|translation page]].
#Add the original Spanish text in the correct portions to the documentation of the translation units: Click on "Add documentation" and copy the corresponding Spanish text (to the English parts) into the documentation field. Add line breaks (hit enter) between lines for better reading. Save documentation with "Save documentation".
Do NOT save the translation (without adding content it should not be possible). Only move to next, with a mouse click or "Skip to next".

==See also==
*[https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_example "How to prepare a page for translation" on mediawiki.org]