Confirmedusers, editor
2,830
edits
Vintage Story Wiki:How to translate the wiki: Difference between revisions
From Vintage Story Wiki
Vintage Story Wiki:How to translate the wiki (view source)
Revision as of 21:14, 13 March 2024
, 2 months agoMarked this version for translation
(added reminder to check edit history before starting translation) |
(Marked this version for translation) |
||
| (8 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
<languages/> | <languages/> | ||
__TOC__ | |||
<translate> | <translate> | ||
<!--T:41--> | |||
Want to find something to work on? Check the [[:Category:Priority translation|Priority translations category]]. | |||
== Principles for translation == <!--T:15--> | == Principles for translation == <!--T:15--> | ||
| Line 13: | Line 18: | ||
*: {{ll|Template:Page language link|2=<translate><!--T:17--> Template:Page language link</translate>}} | *: {{ll|Template:Page language link|2=<translate><!--T:17--> Template:Page language link</translate>}} | ||
*: {{ll|Template:Localized link|2=<translate><!--T:18--> Template:Localized link</translate>}} | *: {{ll|Template:Localized link|2=<translate><!--T:18--> Template:Localized link</translate>}} | ||
* | * If you are marking a '''template''' for translation, make sure the "Enable translation-aware transclusion" checkbox is selected! | ||
<translate> | <translate> | ||
=== How to mark for translation === <!--T:1--> | === How to mark for translation === <!--T:1--> | ||
| Line 30: | Line 35: | ||
<!--T:20--> | <!--T:20--> | ||
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. | ||
<!--T:42--> | |||
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]]. | |||
=== How to update translations === <!--T:4--> | === How to update translations === <!--T:4--> | ||
| Line 35: | Line 43: | ||
<!--T:5--> | <!--T:5--> | ||
[[File:Update-translation.PNG|thumb|500px|right]] | [[File:Update-translation.PNG|thumb|500px|right]] | ||
[[File:Update-translation-version.PNG|thumb|500px|right]] | |||
<!--T:6--> | <!--T:6--> | ||
| Line 40: | Line 49: | ||
# If the page does not offer the option for that language yet, no translation has been started | # 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 | # 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 | ||
# Click on "translated version" to continue working on the translation. | # 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. | |||
==== How to mark new edits for translation ==== <!--T:43--> | |||
<!--T:44--> | |||
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. | |||
<!--T:45--> | |||
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. | |||
<!--T:46--> | |||
# 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. | |||
=== How to actually translate === <!--T:7--> | === How to actually translate === <!--T:7--> | ||
| Line 67: | Line 93: | ||
<!--T:13--> | <!--T:13--> | ||
[[File:Template-translate.PNG|thumb|500px|right|Veerserif's note: now outdated due to the new tnt template.]] | [[File:Template-translate.PNG|thumb|500px|right|Veerserif's note: now outdated due to the new {{tl|tnt}} template and software update.]] | ||
<!--T:14--> | <!--T:14--> | ||
| Line 73: | Line 99: | ||
<!--T:21--> | <!--T:21--> | ||
When you | 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. | ||
<!--T:22--> | <!--T:22--> | ||
| Line 130: | Line 156: | ||
Hello! This is a sentence which includes a translation variable: <tvar|tvar-example>🙂I'm a translation variable</>. Look at it in different languages! | Hello! This is a sentence which includes a translation variable: <tvar|tvar-example>🙂I'm a translation variable</>. Look at it in different languages! | ||
== Frequently Asked Questions == <!--T:47--> | |||
=== Why is there a /en subpage if the pages are already in English? === <!--T:48--> | |||
<!--T:49--> | |||
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. | |||
<!--T:50--> | |||
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. | |||
<!--T:51--> | |||
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. | |||
</translate> | </translate> | ||
[[Category:Wiki Editing]] | [[Category:Wiki Editing]] | ||
