Confirmedusers, editor
2,831
edits
(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! | ||
# | # 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 ;-) | ||
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--> | |||
<!--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]] |