Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

<languages/>
__TOC__

<div lang="en" dir="ltr" class="mw-content-ltr">
Want to find something to work on? Check the [[:Category:Priority translation|Priority translations category]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Principles for translation ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Is the page going to get major changes in the future? If so, maybe finish writing it before you tag it for translation.
* Has the page not been updated for over a month? Check by clicking on "View History" and ask about it in the discord channel before starting translation!
* If the content inside the <code><nowiki><translate></nowiki></code><code><nowiki></translate></nowiki></code> doesn't need to be translated, ''don't put it inside the tags''. Better to have multiple sets of translation tags than one massive one that creates future problems.
* "Maintenance" tags (categories, navboxes) should not be inside the translate tags.
* Make use of our templates for translatable content:
</div>
*: {{ll|Template:Page language link|2=<span lang="en" dir="ltr" class="mw-content-ltr">Template:Page language link</span>}}
*: {{ll|Template:Localized link|2=<span lang="en" dir="ltr" class="mw-content-ltr">Template:Localized link</span>}}
* If you are marking a '''template''' for translation, make sure the "Enable translation-aware transclusion" checkbox is selected!
<div lang="en" dir="ltr" class="mw-content-ltr">
=== How to mark for translation ===
''PLEASE read the [https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_example official MediaWiki documentation] for this feature!''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:Translate.PNG|thumb|500px|right|This is how it should look after translation & language tags were added]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# Go to the page you want to translate and click edit. Make sure the page is complete, or close to being complete!
# Add the language selector bar by typing in <code><nowiki><languages /></nowiki></code>.
# Enclose the text you want to translate using <code><nowiki><translate></nowiki></code><code><nowiki></translate></nowiki></code> tags. You can add as many sets of these tags as you want. Make sure navboxes and category tags are ''excluded''.
# Click save, then at the top of the page a small link will appear, titled "Mark this page for translation". Click on it, scroll to the bottom and hit the button "Mark this version for translation".
# Go to the [[Special:Translate|translation center]] and start thunder typing ;-)
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
For tackling specific formatting issues in wikitext and how they interact with the translate tags, see [https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_administration#Markup_examples this guide on MediaWiki]. When translating a page that uses translatable templates, do not include them within the <code><nowiki><translate></nowiki></code> tags.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Want other editors to know this page is not only ready for translation, but of the absolute ''highest'' translatability? Use the [[Template:Priority translation|priority translation template]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== How to update translations ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# Go to the page you want to translate and switch to the language you want to translate to
# If the page does not offer the option for that language yet, no translation has been started
# If there was a translation attempt previously, the page will show the current progress of translation at the top, adding information if the translation is up to date or not
# Instead you might also find "This page contains changes which are not marked for translation." - in which case the original version of the page was updated since it's last translation. Click on "marked for translation" and check the changes between last (translated) version and the current one. Take care to not invalidate previous translations unless they now include misleading or wrong translations - keep in mind that you would not just invalidate your own translation language, but all others as well!
# Once done checking, scroll to the bottom and hit "mark this version for translation".
# Back on the content page, click on "translated version" to continue working on the translation.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== How to mark new edits for translation ====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
This applies when you have made ''new edits to a page'', and want those changes to be reflected for translation. Note that translators cannot translate what hasn't been written in the original page - translators ''cannot'' add new text in the Translate software.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If you are making major edits, be careful with the translation tags. Additions usually don't need to edit or change any translation tags. If you need to reorder or move paragraphs, move the associated translation tags with them - it doesn't matter if the translation tags are out of order. If you are removing old text, you may need to delete translation tags. Whenever possible, avoid doing so since this removes already-finished translations. However in some cases, this is unavoidable.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# Make your changes to the base version of the article.
# Double check that your additions and the article generally are properly marked for translation.
# Save your edit.
# At the top of the article, find and click "mark this version for translation"
# Your new edits should now be translatable.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== How to actually translate ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# Click on the "translate" or "translated version" page after the page was marked for translation
# This will open up the translation page, with the original English text showing up on the left side of the screen
# If necessary, you can choose into which language you wish to translate in the upper right corner of the screen using the "Translate to ..." drop down menu
# After being marked for translation, every page is automatically segmented into sections for translation. These can be translated and saved individually, meaning there is no need to do a whole page at a time.
# Clicking on a section to the left will open a text box below, in which the translation can be typed.
# Clicking on "Save Translation" will save the text, and it will then show up to the right as the current translated version
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== Important notes on what to translate and what not ====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Everything that looks like "code" probably doesn't need translation. This includes:
* <code><nowiki>__TOC__</nowiki></code> - To create a Table Of Contents at the beginning of a page.
* <code><nowiki>{| class="wikitable sortable"</nowiki></code> - Or any other "wikitable" lines, used together with plenty of <code>|-</code> and other such symbols to build a nice looking table. Only the actual content text within the table needs translation - if in doubt, open the original page on the side to check the content of the table.
*<code><nowiki>[[File:MeatInFirepit.png|200px|thumb|right|text]]</nowiki></code> - To include a picture into the page. Only the "text" part here needs translating, as it is the description that shows up under the picture - the rest should not be translated!
* <code><nowiki>[[quern|text]]</nowiki></code> - To link to a different page in the wiki, while not directly using the linked-to page name. Only translate the "text" part, this will change the word in which the link is embedded, without changing the link destination itself.<br><br>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If in doubt, don't hesitate to ask in the discords wiki-and-translation channel for help!
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== How to translate templates ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:Template-translate.PNG|thumb|500px|right|Veerserif's note: now outdated due to the new {{tl|tnt}} template and software update.]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Templates should only be tagged and mark for translation when they are ''complete''. Make sure the <code><nowiki><languages /></nowiki></code> tag is '''outside''' of the part of the template marked for transclusion, i.e. the <code><nowiki><onlyinclude> ... </onlyinclude></nowiki></code> or <code><nowiki><includeonly> ... </includeonly></nowiki></code> part.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
When you mark a template for translation, '''make sure''' that the "Enable translation-aware transclusion" checkbox is enabled. On older templates, you must make a content change that would prompt you to re-mark it for translation in order to update its translations to be transclusion aware. Once you have done so, MediaWiki will automatically fetch the correctly translated version of the template for use on a translated page - there's no longer a need to use {{tl|tnt}} to call them.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
When translating a page that uses translatable templates, do not include them within the <code><nowiki><translate></nowiki></code> tags. (I'm repeating this because it's important.)
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Translating categories ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Categories can also be translated, and if done correctly will automatically put translated pages in their relevant language code subpage.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Translating a Category page ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can tag a Category page for translation in the same way as any other page, by adding <code><nowiki><languages/></nowiki></code> for the language selector bar then adding a set of <code><nowiki><translate></nowiki></code><code><nowiki></translate></nowiki></code> tags. The translate tags must be present even if there is no content in the Category page. [https://wiki.vintagestory.at/index.php?title=Category%3AItems&type=revision&diff=43848&oldid=28218 See this diff] as an example of what to add to an empty Category page.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Translation-aware category tags ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
On the article that should be included in the translatable category, '''make sure the Category tags are not included in the <code><nowiki><translate></nowiki></code> tags''', then change the Category tags so that they read:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
<code><nowiki>[[Category:CategoryName{{#translation:}}]]</nowiki></code>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
For example, <code><nowiki>[[Category:Metals]]</nowiki></code> should become <code><nowiki>[[Category:Metals{{#translation:}}]]</nowiki></code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Then save and re-mark the page for translation to update the page across all languages.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Using translation variables ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''Note: our version of the Translate extension is outdated, so current MediaWiki documentation does not apply for this feature.''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Sometimes, you ''don't'' want to translate something in a page - maybe it is something like a number, a special link name, or some piece of code that should not be translated. In this case, you can use a translation variable in order to make sure translation of the page does not change it.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Translation variables are written like this: <code><nowiki>&lt;tvar&#124;name&gt;variable&lt;/&gt;</nowiki></code>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
To translators, it will look like this:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
: some text that isn't the variable ''$name'' some more text
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
When translating, simply paste in the ''$name'' part and it will appear in your translation exactly as it is in the original page.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Example ===
</div>
<code><nowiki>Hello! This is a sentence which includes a translation variable: &lt;tvar&#124;tvar-example&gt;&#128578;I'm a translation variable&lt;/&gt;. Look at it in different languages!</nowiki></code>

<div lang="en" dir="ltr" class="mw-content-ltr">
Hello! This is a sentence which includes a translation variable: &#128578;I'm a translation variable. Look at it in different languages!
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Frequently Asked Questions ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Why is there a /en subpage if the pages are already in English? ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, the translation extension will create a subpage for ''every'' language version of a page, and English is not an exception. This is because the Translate extension doesn't really care which language the "base" version of the article was written with. Hypothetically, every single page could be written in German and translated to everything else, and the Translation extension would still create a <code>/de</code> subpage and more importantly, continue to work in exactly the same way.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You usually won't see the <code>/en</code> subpage when browsing the wiki. However, due to the way that some templates are localized, you may navigate to them through certain navbox links. In those cases, you'll be directed to the <code>Article/en</code> subpage if your account language is set to English.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Much like every other language subpage, it is only updated when someone remembers to "mark this version for translation". So if you see an out-of-date <code>/en</code> page, go to the main page and update the whole thing for translation. You'll be helping everyone that way.
</div>

[[Category:Wiki Editing]]

Anonymous

Search

Export translations

Namespaces

More

Page actions

Navigation

Navigation

VS related links

Community portal

Wiki tools

Wiki tools

Anonymous

Search

Export translations

Navigation

Wiki tools

Page tools