Vintage Story Wiki:How to translate the wiki: Difference between revisions

From Vintage Story Wiki
(Updated info on how to translate templates.)
(added instructions for category translation, added principles for translation)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
== Principles for translation ==
* Is the page going to get major changes in the future? If so, maybe finish writing it before you tag it for 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:
</translate>
*: {{ll|Template:Page language link|2=<translate>Template:Page language link</translate>}}
*: {{ll|Template:Localized link|2=<translate>Template:Localized link</translate>}}
*: {{ll|Template:Translatable template|2=<translate>Template:Translatable template</translate>}}
<translate>
<translate>
=== How to mark for translation === <!--T:1-->
=== How to mark for translation === <!--T:1-->
''PLEASE read the [https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_example official MediaWiki documentation] for this feature!''


<!--T:2-->
<!--T:2-->
Line 7: Line 20:


<!--T:3-->
<!--T:3-->
# Go to the page you want to translate and click edit
# Go to the page you want to translate and click edit. Make sure the page is complete, or close to being complete!
# To the very top add <code><translate<nowiki/>></code>, to the very bottom add <code></translate<nowiki/>></code>
# Add the language selector bar by typing in <code><nowiki><languages /></nowiki></code>.
# 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"
# 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 ;-)
# Go to the [[Special:Translate|translation center]] and start thunder typing ;-)
# Once translated, edit the page again, and to the very top, add <code><languages<nowiki/>/></code> - this will make the language bar appear


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.
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.
Line 49: Line 62:




=== How to translate templates === <!--T:12-->
== How to translate templates == <!--T:12-->


<!--T:13-->
<!--T:13-->
Line 60: Line 73:


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.)
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.)
== Translating categories ==
Categories can also be translated, and if done correctly will automatically put translated pages in their relevant language code subpage.
=== Translating a Category page ===
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.
=== Translation-aware category tags ===
On the article that should be included in the translatable category, change the Category tags so that they read:
<code><nowiki>[[Category:CategoryName{{#translation:}}]]</nowiki></code>
For example, <code><nowiki>[[Category:Metals]]</nowiki></code> should become <code><nowiki>[[Category:Metals{{#translation:}}]]</nowiki></code>.
Then save and re-mark the page for translation to update the page across all languages.


</translate>
</translate>


[[Category:Wiki Editing]]
[[Category:Wiki Editing]]
Retrieved from "https://wiki.vintagestory.at/index.php/Vintage_Story_Wiki:How_to_translate_the_wiki"