View source for Fortius linguarum/Preparing translations/eo

<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=<span lang="en" dir="ltr" class="mw-content-ltr">Executive summary</span>}}
|-
|style="color:#000" id="mp-tfa"|
<div lang="en" dir="ltr" class="mw-content-ltr">
# Import text into wiki page
# Add <code>&lt;languages /&gt;</code> tag to top of page
# Markup with <code>&lt;translate&gt;&lt;/translate&gt;</code> tags
# Use <code>&lt;tvar name="..."&gt;&lt;/tvar&gt;</code> 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
</div>
|}
|}

{{-}}
{{anchor|Simple}}{{Fortius linguarum/Header|1=<span lang="en" dir="ltr" class="mw-content-ltr">Chapter 1: The basics!</span>}}

==== <span lang="en" dir="ltr" class="mw-content-ltr">Bringing text onto wiki</span> ====

<span lang="en" dir="ltr" class="mw-content-ltr">Simple enough to do <code>:-)</code> Copy the source text you want translated into a wiki page.</span>

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

=== <span lang="en" dir="ltr" class="mw-content-ltr">The box of languages and <code>&lt;languages /&gt;</code> tag</span> ===

<div lang="en" dir="ltr" class="mw-content-ltr">
You need to enable the language box that sits at the top of the page. This links to all in-progress and completed translations.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
To do this simply add:
</div>

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

<span lang="en" dir="ltr" class="mw-content-ltr">or</span>

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

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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):
</div>

<div dir="ltr">
 '''&lt;noinclude&gt;&lt;languages /&gt;&lt;/noinclude&gt;'''
 ''<span lang="en" dir="ltr" class="mw-content-ltr">(the rest of the template code follows here)</span>''
</div>

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

=== <span lang="en" dir="ltr" class="mw-content-ltr">Units and <code>&lt;translate&gt;&lt;/translate&gt;</code> tags</span> ===

<span lang="en" dir="ltr" class="mw-content-ltr">Translations are broken down into discrete units breaking up a much larger request into more manageable chunks. Lets take the following block of text:</span>

<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>

<span lang="en" dir="ltr" class="mw-content-ltr">To make this a translation unit simply add</span> <code>&lt;translate&gt;</code> [...] <code>&lt;/translate&gt;</code> <span lang="en" dir="ltr" class="mw-content-ltr">like so:</span>
<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>

=== <span lang="en" dir="ltr" class="mw-content-ltr">Numbers, Hyperlinks and Wikilinks</span> ===

<div lang="en" dir="ltr" class="mw-content-ltr">
Fixed variables such as Numbers, Hyperlinks and Wikilinks should often be included through the use of ''translation variables'' or <code>&lt;tvar name="..."&gt;</code> tags.
</div> 

<div lang="en" dir="ltr" class="mw-content-ltr">
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
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Here is an example:
</div>

<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>

<span lang="en" dir="ltr" class="mw-content-ltr">This is how you would handle the four of them:</span>
<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>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''Caution:''' although most translators do this correctly, errors can be made.
</div>

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

=== <span lang="en" dir="ltr" class="mw-content-ltr">Mark for translation</span> ===

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

<span lang="en" dir="ltr" class="mw-content-ltr">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.</span>

# <span lang="en" dir="ltr" class="mw-content-ltr">Click the "Mark this page for translation" link.</span><br /><span lang="en" dir="ltr" class="mw-content-ltr">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.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Ensure that your text has been split up appropriately. That there aren't any unnecessarily long units.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Click the "Mark this version for translation" button.</span>

{{Fortius linguarum/Header|1=<span lang="en" dir="ltr" class="mw-content-ltr">Chapter 2. What to do next – Notify your volunteers!</span>}}

==== <span lang="en" dir="ltr" class="mw-content-ltr">Getting people to translate</span> ====

<span lang="en" dir="ltr" class="mw-content-ltr">You've set up your request and marked and ready for translation, but now we need to get people translating. <code>:)</code> At this point you need to move on the chapter 3 where the various forms of seeking translations are discussed in depth. <code>:)</code></span>

'''<div class="center"><big>[[Fortius linguarum/Communications|→ <span lang="en" dir="ltr" class="mw-content-ltr">Chapter 3. Communications</span>]]</big></div>'''

{{anchor|Complex}}
{{Fortius linguarum/Header|1=<span lang="en" dir="ltr" class="mw-content-ltr">Appendix 1 – Complex requests</span>}}

=== <span lang="en" dir="ltr" class="mw-content-ltr">Tables and images</span> ===

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div> 

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<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>

<span lang="en" dir="ltr" class="mw-content-ltr">We can break this down into its various components.</span>

==== Tabeloj ====

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

<span lang="en" dir="ltr" class="mw-content-ltr">In this instance you place the translate tags within the cell so that it appears thusly:</span>

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

==== Bildoj kaj dosieroj ====

<span lang="en" dir="ltr" class="mw-content-ltr">Here is some markup for a file:</span>

<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>

<span lang="en" dir="ltr" class="mw-content-ltr">Unlike in a wikilink where we used a <code>&lt;tvar name="..."&gt;...&lt;/tvar&gt;</code> 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:</span>

<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=<span lang="en" dir="ltr" class="mw-content-ltr">Appendix 2 – Some cautionary words</span>}}

=== Komplikaj tradukoj ===

<span lang="en" dir="ltr" class="mw-content-ltr">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. <code>:)</code></span>

=== <span lang="en" dir="ltr" class="mw-content-ltr">Long translations – Translator time</span> ===

<span lang="en" dir="ltr" class="mw-content-ltr">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.</span>

=== <span lang="en" dir="ltr" class="mw-content-ltr">Long translations – Admin time</span> ===

<span lang="en" dir="ltr" class="mw-content-ltr">Be aware that pages like [[Special:MyLanguage/Fundraising 2012/Translation/FAQ|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.</span>

{{Fortius linguarum/Header|1=<span lang="en" dir="ltr" class="mw-content-ltr">Appendix 3 – Making changes to a request page</span>}}

==== <span lang="en" dir="ltr" class="mw-content-ltr">Marking a new version for translation</span> ====

<div lang="en" dir="ltr" class="mw-content-ltr">
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. <code>:)</code>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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. <code>:)</code>
</div>

==== <span lang="en" dir="ltr" class="mw-content-ltr">Does your new text really need retranslating?</span> ====

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

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