View source for Help:Translating

<languages />
<translate><!--T:1--> The Resonite wiki uses the [https://www.mediawiki.org/wiki/Extension:Translate Translate MediaWiki extension], for enabling translations and for content to be surfaced in different languages.</translate>

<translate><!--T:2--> The extension has [https://www.mediawiki.org/wiki/Help:Extension:Translate extensive documentation] and [https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_example video tutorials available].</translate>

<translate><!--T:3--> For brevity, we'll also present some information here.</translate>

== <translate><!--T:34--> Translating</translate> ==
=== <translate><!--T:31--> Before Translating</translate> ===
<translate><!--T:32--> Ensure, that you've been marked as an "automoderated user". This will prevent translations going to the moderation queue.</translate> 
<translate><!--T:35--> To do this:</translate>
* <translate><!--T:36--> Make a single non-translation related edit and the wiki moderation team will pick up that edit and mark you as auto moderated.</translate>
** <translate><!--T:37--> A good place to start is your personal user page. Tell us who you are!</translate>

<translate>== Preparing a page for translation == <!--T:4--></translate>
<translate><!--T:5--> This information is based on [https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_example mediawiki's tutorial].</translate>

# <translate><!--T:6--> Ensure the page is at a reasonable level of stability</translate>
#* <translate><!--T:7--> Pages that are under construction or change frequently should not be included until they are ready.</translate>
# <translate><!--T:8--> Add <nowiki><languages /></nowiki> to the top of the page in the ''source editing'' view.</translate>
# <translate><!--T:9--> Surround translatable elements in <nowiki><translate></translate></nowiki> tags.</translate>
#* <translate><!--T:10--> See further guidance on this below</translate>
# <translate><!--T:11--> Mark this page for translation</translate>

<translate>
<!--T:15-->
=== Best practices for translate tags ===
These are based on [https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_administration#Markup_examples Mediawiki's Examples].
</translate>

* <translate><!--T:16--> Do not wrap the whole page in <nowiki><translate></nowiki></translate>
** <translate><!--T:17--> This is a problem we had in he past which lead to confusion sometimes.</translate>
* <translate><!--T:18--> Instead wrap select parts with the tags.</translate>
* <translate><!--T:19--> A good example is actually the [https://www.mediawiki.org/w/index.php?title=Help:Extension:Translate/Page_translation_administration&action=edit source of previous linked mediawiki page].</translate>
* <translate><!--T:20--> Be careful around:</translate>
** <translate><!--T:21--> Tables</translate>
** <translate><!--T:22--> Images</translate>
** <translate><!--T:23--> Templates</translate>
** <translate><!--T:24--> Lists</translate>
<translate>
<!--T:25-->
==== Tables ====
'''Don't''':
<pre>
<nowiki>
<translate>
</nowiki>
{| class="wikitable"
|+ Food complements
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream
|}
<nowiki>
</translate>
</nowiki>
</pre>
</translate>
* <translate><!--T:26--> Wrapping a whole table in translate tags makes it hard to translate.</translate>
<translate>
<!--T:27-->
'''Do'''
<pre>
{| class="wikitable"
|+<nowiki><translate nowrap>Food complements</translate></nowiki>
|-
|<nowiki><translate nowrap>Orange</translate></nowiki>
|<nowiki><translate nowrap>Apple</translate></nowiki>
|-
|<nowiki><translate nowrap>Bread</translate></nowiki>
|<nowiki><translate nowrap>Pie</translate></nowiki>
|-
|<nowiki><translate nowrap>Butter</translate></nowiki>
|<nowiki><translate nowrap>Ice cream</translate></nowiki>
|}
</pre>
</translate>
* <translate><!--T:28--> Wrapping each individual item in translate tags makes it '''easier''' to translate.</translate>

<translate>
<!--T:29-->
==== Images ====
Wrap only, the description/alt-text in <nowiki><translate></nowiki> e.g.
</translate>

<pre>
<nowiki>
[[File:MediaWiki database schema latest.svg|thumb|link=https://www.mediawiki.org/w/index.php?title=Manual:Database_layout/diagram&action=render|<translate>Database schema of MediaWiki core</translate>]]</nowiki></pre>

<translate>
<!--T:30-->
=== Example Pages ===
The following pages have examples of '''good''' uses of the <nowiki><translate></nowiki> tags:
</translate>
* [[Resonite Team]]

<translate>
<!--T:12-->
== Tutorials ==
We have a number of tutorials available for translating pages:</translate>

* [https://www.youtube.com/watch?v=weR8pwJKejs <translate><!--T:13--> preparing a page for translations by ProbablePrime</translate>]
* [https://www.youtube.com/watch?v=ACuCSuklPRk <translate><!--T:14--> translating a page by ProbablePrime</translate>]