View source for Fortius linguarum/Preparing translations

<languages />
{{Fortius linguarum/TOC}}
<div style="margin:2px 0;">__TOC__</div>

{|id="mp-upper" style="clear:left;margin:2px 0;background:none;"
|-
|style="width:90%;border:1px solid #CEF2E0;{{border-radius|1em}}background:#F5FFFA;color:#000;vertical-align:top"|
{|id="mp-left" cellpadding="2" cellspacing="5" style="width:100%;{{border-radius|1em}}background:#f5fffa;vertical-align:top;"
|-
!id="Markup"|{{Fortius linguarum/Header|1=<translate><!--T:1--> Executive summary</translate>}}
|-
|style="color:#000" id="mp-tfa"|
<translate><!--T:2-->
# Import text into wiki page
# Add <tvar name="languages"><code>&lt;languages /&gt;</code></tvar> tag to top of page
# Markup with <tvar name="translate"><code>&lt;translate&gt;&lt;/translate&gt;</code></tvar> tags
# Use <tvar name="tvar"><code>&lt;tvar name="..."&gt;&lt;/tvar&gt;</code></tvar> tags for static variables that should not be changed from translation to translation
# Save the page
# Click mark for translation at top of wiki page
# Set any priority languages or limit languages and click the mark for translation</translate>
|}
|}

{{-}}
{{anchor|Simple}}{{Fortius linguarum/Header|1=<translate><!--T:3--> Chapter 1: The basics!</translate>}}

==== <translate><!--T:4--> Bringing text onto wiki</translate> ====

<translate><!--T:5--> Simple enough to do <tvar name="smiley"><code>:-)</code></tvar> Copy the source text you want translated into a wiki page.</translate>

<div style="clear:both;margin:0.5em 0;border-top:1px solid #AAA"></div>

=== <translate><!--T:6--> The box of languages and <tvar name="languages"><code>&lt;languages /&gt;</code></tvar> tag</translate> ===

<translate><!--T:7-->
You need to enable the language box that sits at the top of the page. This links to all in-progress and completed translations.

<!--T:8-->
To do this simply add:</translate>

 <span dir="ltr"> '''&lt;languages /&gt;'''</span>

<translate><!--T:56--> or</translate>

 <span dir="ltr"> '''&lt;languages/&gt;'''</span>

<translate><!--T:57-->
The space before the slash is optional and may be added or removed without changing how the page will be rendered (this can be useful for translation admins as a pseudo null edit if you want to mark again the same page to update translation statistics in all languages when they get out of sync).

<!--T:58-->
If the page to translate is a template, or if it's any page intended to be transcluded into another one, this tag should be placed in a noinclude section (avoid adding a linebreak after closing that section):</translate>

<div dir="ltr">
 '''&lt;noinclude&gt;&lt;languages /&gt;&lt;/noinclude&gt;'''
 ''<translate><!--T:59--> (the rest of the template code follows here)</translate>''
</div>

<div style="clear:both;margin:0.5em 0;border-top:1px solid #AAA"></div>

=== <translate><!--T:9--> Units and <tvar name="translate"><code>&lt;translate&gt;&lt;/translate&gt;</code></tvar> tags</translate> ===

<translate><!--T:10--> Translations are broken down into discrete units breaking up a much larger request into more manageable chunks. Lets take the following block of text:</translate>

<span dir="ltr">{{quotation|The 'Principia' deals primarily with massive bodies in motion, initially under a variety of conditions and hypothetical laws of force in both non-resisting and resisting media, thus offering criteria to decide, by observations, which laws of force are operating in phenomena that may be observed.}}</span>

<translate><!--T:12--> To make this a translation unit simply add</translate> <code>&lt;translate&gt;</code> [...] <code>&lt;/translate&gt;</code> <translate><!--T:13--> like so:</translate>
<span dir="ltr">{{quotation|'''<big><code>&lt;translate&gt;</code></big>'''The 'Principia' deals primarily with massive bodies in motion, initially under a variety of conditions and hypothetical laws of force in both non-resisting and resisting media, thus offering criteria to decide, by observations, which laws of force are operating in phenomena that may be observed.'''<big><code>&lt;/translate&gt;</code></big>'''}}</span>

<div style="clear:both;margin:0.5em 0;border-top:1px solid #AAA"></div>

=== <translate><!--T:15--> Numbers, Hyperlinks and Wikilinks</translate> ===

<translate><!--T:16-->
Fixed variables such as Numbers, Hyperlinks and Wikilinks should often be included through the use of ''translation variables'' or <tvar name="tvar"><code>&lt;tvar name="..."&gt;</code></tvar> tags. 

<!--T:17-->
These tags consist of three parts as you can see in the diagramme below. These are:
# the tags
# the name of the variable
# the variable itself

<!--T:18-->
Here is an example:</translate>

<span dir="ltr">{{quotation|text=To contact us, either see our [[Main page|contacts page]], [www.twitter.com tweet us], phone us on 555-1212 or email us at info{{@}}wikimedia.org}}</span>

<translate><!--T:19--> This is how you would handle the four of them:</translate>
<span dir="ltr">{{quotation|text=To contact us, either see our [['''&lt;tvar name="mainpage"&gt;'''Main page'''&lt;/tvar&gt;'''{{!}}contacts page]], ['''&lt;tvar name="tweeturl"&gt;'''www.twitter.com'''&lt;/tvar&gt;''' tweet us], phone us on '''&lt;tvar name="phonenumber"&gt;'''555-1212'''&lt;/tvar&gt;''' or email us at '''&lt;tvar name="infoemail"&gt;'''info{{@}}wikimedia.org'''&lt;/tvar&gt;'''}}</span>

<translate><!--T:20-->
Wikilinks and URLs are very similar in that the target page is contained within variable and will remain fixed whereas the text can be localised. The phone number and the email however are entirely static and should not be change in anyway by translators.

<!--T:21-->
'''Caution:''' although most translators do this correctly, errors can be made.</translate>

<div style="clear:both;margin:0.5em 0;border-top:1px solid #AAA"></div>

=== <translate><!--T:22--> Mark for translation</translate> ===

[[{{Localized media|Translate manual - Page example - 2. Preparations|png}}|link=:mw:Special:MyLanguage/Help:Extension:Translate/Translation example|thumb|300px]]

<translate><!--T:23--> After saving the page, you will see a link at the top of the page saying "Mark this page for translation" (or "This page contains changes which are not marked for translation." if you are not a translation administrator). Click on that link.</translate>

# <translate><!--T:24--> Click the "Mark this page for translation" link.</translate><br /><translate><!--T:25--> You will see that your text has been split  into translation units. The first unit is the title of the page, the second is the first paragraph or line, the third is the header of the second paragraph and so on. You can give names to the translation units but it is often best to simply stick to the default numbering.</translate>
# <translate><!--T:26--> Ensure that your text has been split up appropriately. That there aren't any unnecessarily long units.</translate>
# <translate><!--T:55--> Click the "Mark this version for translation" button.</translate>

{{Fortius linguarum/Header|1=<translate><!--T:27--> Chapter 2. What to do next – Notify your volunteers!</translate>}}

==== <translate><!--T:28--> Getting people to translate</translate> ====

<translate><!--T:29--> You've set up your request and marked and ready for translation, but now we need to get people translating. <tvar name="smiley1"><code>:)</code></tvar> At this point you need to move on the chapter 3 where the various forms of seeking translations are discussed in depth. <tvar name="smiley2"><code>:)</code></tvar></translate>

'''<div class="center"><big>[[Fortius linguarum/Communications|→ <translate><!--T:30--> Chapter 3. Communications</translate>]]</big></div>'''

{{anchor|Complex}}
{{Fortius linguarum/Header|1=<translate><!--T:31--> Appendix 1 – Complex requests</translate>}}

=== <translate><!--T:32--> Tables and images</translate> ===

<translate><!--T:33-->
When dealing with images and tables, you want to handle them in a similar fashion. Tables can often contain complex markup which should at all cost be excluded from translation units. They key is to have the contents of the table as units and not the table itself. 

<!--T:34-->
So here is about as complicated an example as you could really expect to have to translate. I am sure it could be more complicated but the theme effectively remains the same.
</translate>

<div dir="ltr">
 <nowiki> {| style="border:2px solid #eeeeee; background:white; margin:auto;"
 |-
 | [[File:WMF Annual Report 2011–12 EN cover rgb 300ppi.png|250px|border|2011–2012 Annual Report|link=//upload.wikimedia.org/wikipedia/commons/4/48/WMF-AR_2011%E2%80%9312_EN_SHIP2_17dec12_300dpi_hi-res.pdf|center]]
 | [[File:2012-13 Wikimedia Foundation Plan FINAL FOR WEBSITE.pdf|435px|link=//upload.wikimedia.org/wikipedia/foundation/4/4f/2012-13_Wikimedia_Foundation_Plan_FINAL_FOR_WEBSITE.pdf]]
 |- style="vertical-align:top;"
 |
 Download the 2011–12 Annual Report:
 * '''[[Media:WMF-AR 2011–12 EN SHIP2 17dec12 300dpi hi-res.pdf|
 PDF version (3.9 MB)]]'''
 ||
 '''&lt;translate&gt;Download the 2012-13 Annual Plan:&lt;/translate&gt;'''
 * '''[[Media:2012-13 Wikimedia Foundation Plan FINAL FOR WEBSITE.pdf|
 PDF version (400 KB)]]'''
 * '''[[2012-2013 Annual Plan Questions and Answers|
 Annual Plan questions and answers]]'''
 |}</nowiki>
</div>

<translate><!--T:35--> We can break this down into its various components.</translate>

==== <translate><!--T:36--> Tables</translate> ====

<div dir="ltr">
 <nowiki> {| style="border:2px solid #eeeeee; background:white; margin:auto;"
 |-
 | Some text
 |}</nowiki>
</div>

<translate><!--T:37--> In this instance you place the translate tags within the cell so that it appears thusly:</translate>

<div dir="ltr">
 <nowiki>{| style="border:2px solid #eeeeee; background:white; margin:auto;"
 |-
 |'''&lt;translate&gt;'''Some text'''&lt;/translate&gt;'''
 |}</nowiki>
</div>

==== <translate><!--T:38--> Images and files</translate> ====

<translate><!--T:39--> Here is some markup for a file:</translate>

<div dir="ltr">
<nowiki>[[File:2012-13 Wikimedia Foundation Plan FINAL FOR WEBSITE.pdf|435px|The Wikimedia Foundation annual plan|link=//upload.wikimedia.org/wikipedia/foundation/4/4f/2012-13_Wikimedia_Foundation_Plan_FINAL_FOR_WEBSITE.pdf]]</nowiki>
</div>

<translate><!--T:40--> Unlike in a wikilink where we used a <tvar name="tvar"><code>&lt;tvar name="..."&gt;...&lt;/tvar&gt;</code></tvar> variable for the page, image markup is slightly more complicated. Since normally all we need to translate is the caption rather than including the entirety of the image. the translate tags should be used inside the image markup like so:</translate>

<div dir="ltr">
<nowiki>[[File:2012-13 Wikimedia Foundation Plan FINAL FOR WEBSITE.pdf|435px|</nowiki>&lt;translate&gt;The Wikimedia Foundation annual plan&lt;/translate&gt;|link=//upload.wikimedia.org/wikipedia/foundation/4/4f/2012-13_Wikimedia_Foundation_Plan_FINAL_FOR_WEBSITE.pdf]]</nowiki>
</div>

{{Fortius linguarum/Header|1=<translate><!--T:41--> Appendix 2 – Some cautionary words</translate>}}

=== <translate><!--T:42--> Complex translations</translate> ===

<translate><!--T:43--> Keep translation units as simple as possible. Complexity means the increased likelihood for errors, it raises the bar to translator participation reducing the amount of complete translations you will get. It may mean that links get broken which means time and effort fixing links. Simple = efficient. <tvar name="smiley"><code>:)</code></tvar></translate>

=== <translate><!--T:44--> Long translations – Translator time</translate> ===

<translate><!--T:45--> It takes time for volunteers to translate, time that could be spent taking photo's, writing articles or news stories. The longer the translation, the more effort and resources it will use up. Ask yourself, does this page need to be translated into every single language. Are there more important priorities? More of this will be touched on in the communications chapter.</translate>

=== <translate><!--T:46--> Long translations – Admin time</translate> ===

<translate><!--T:47--> Be aware that pages like [[<tvar name="fundraising-2012-FAQ">Special:MyLanguage/Fundraising 2012/Translation/FAQ</tvar>|Fundraising 2012/Translation/FAQ]] take a long time to set up and this particular request isn't even the best set up. Keep it as simple as you can get away with when dealing with such cases.</translate>

{{Fortius linguarum/Header|1=<translate><!--T:48--> Appendix 3 – Making changes to a request page</translate>}}

==== <translate><!--T:49--> Marking a new version for translation</translate> ====

<translate><!--T:50-->
You might find that you may need to make some changes to a translation. This may be slightly altering text or adding new swathes of paragraphs. Either way you need to know how to update your translation request. <tvar name="smiley"><code>:)</code></tvar>

<!--T:51-->
It's fairly simple actually when you make a change, you will see that at the top of the page it will now say '''"This page has changes since it was last marked for translation."'''. Click on ''last marked for translation'' and simply follow the steps above for marking for translation. <tvar name="smiley"><code>:)</code></tvar>
</translate>

==== <translate><!--T:52--> Does your new text really need retranslating?</translate> ====

<translate><!--T:53-->
As will be constantly reiterated throughout, we want to keep unnecessary work down to a minimum. If the change you made is merely a stylistic one, or spelling or grammar correction its important you mark "Do not invalidate translations". If you don't it will say that the unit needs translation.

<!--T:54-->
If however the changes you make are extensive and important then of course it may make sense to invalidate the old translation and request a new one.
</translate>

[[Category:Fortius linguarum{{#translation:}}|Preparing translations]]
[[Category:Translate extension{{#translation:}}]]