How to translate a page

This page explains how to translate a wiki page into your own language.

Summary

This Wiki was originally written in English. But to make it more accessible to more people, the community is working to translate each page into different languages. If you speak a language that's not English, you can help too! Simply follow the instructions below or email community@therestartproject.org for more information. If you have native or professional level of competence in a non-English language you can also be signed up to approve translations by those with maybe a greater technical competence but lesser linguistic accomplishment.

Warning

If a page has already been entered into the translation system you must not modify the source language version without understanding how to do so safely. This is not hard but does need to be understood.

Overview

There are three steps to translate a page to another language:

1. The page must first be prepared for translation by a 'Translation Administrator'
2. Anyone can then submit translations for the page
3. Finally, the submitted translations must be approved by an official 'Translator'

Who can translate pages?

In theory, anyone who has an account on Restarters.net can translate any page on the Wiki. But to make sure that translations are accurate and that safety information is communicated correctly, some actions (such as approving new translations) require additional permissions. Your permissions are set by your 'role', which will be one of these three:

Normal user

Most people are normal users. So if you're not sure which role you have, this is probably you. Normal users can translate any page that has been prepared for translation (see below for instructions). But normal users can't prepare new pages for translation themselves and any translations they provide must be approved before being published.

Translator

Translators can do everything normal users can do. They can also review and approve translations submitted by normal users. Translators tend to be people who are native speakers of the language they are translating into and who also have some technical repair knowledge. Their task is to make sure translations are accurate and that any safety information is correct. If you're interested in becoming a Translator, please get in touch at: community@therestartproject.org

Translation Administrator

Translation Administrators can do everything normal users and translators can do. In addition, they decide which pages to prepare for translation. In general, pages that are well-established and don't change frequently are good candidates for translation. This is because it's harder to keep translations of pages that change often up to date. If you're interested in becoming a Translation Administrator, please get in touch at: community@therestartproject.org

How to prepare a page for translation (Translation Administrators only)

1. Navigate to the 'Prepare page for translation' page in the list of Special Pages (this only works for Translation Administrators).
2. Search for the page you want to prepare for translation using the search bar. As you start typing, a list of matching pages will appear. Select the page you want and click 'Prepare'. Note: if the page you're looking for doesn't appear, it may not have been prepared for translation yet. You will need to ask a Translation Administrator to do this for you.
   

   The system will automatically add <'translate'> tags to the page as well as other special translation formatting. Any text that is between a <'translate'> tag and a <'/translate'> tag will be made translatable.

3. Check the page to make sure no text is missing from the translatable sections.
4. Click 'Publish' at the top.
5. Next, go to the list of pages proposed for translation, find the page you want to translate and click 'mark for translation'. This will give you a preview of how the page will be divided into different translation sections. If everything looks ok, click 'Mark this version for translation' at the bottom of the page. Once you've done this, the page will be ready to translate.

How anyone can translate a prepared page

1. First, make sure your language setting in the Wiki is the language you wish to translate into. (You can change your preferrred language under Special Pages - Users and Rights - Preferences.)
2. Go to the Translate page
3. Choose the language you want to translate into (note: there is currently a bug that hides the search text you type) :
   
4. By default, you will see a list of everything that needs translating into your chosen language. You can either work through the list or select which page you want to translate by clicking on the 'All' button near the top (note: there is currently a bug that makes this list messy). If you can't see the page you want to translate, you will need to ask a Translation Administrator to prepare it for you. Please message James or email community@therestartproject.org
   
5. Add your translated text to each section of the page. Click 'Publish' when you're happy with a section or 'Skip to next' if you're not sure. If you prefer a more visual interface, click the 'Page' button at the bottom to change your view. Once you have translated every section, the page is ready to be reviewed by a translator. Your translated page will be published when a translator has checked that everything is ok.

How to publish translated pages (Translators and Translation Administrators only)

1. Go to the Translate page
2. Choose the language you want to translate into (note: there is currently a bug that hides the search text you type) :
   
3. By default, you will see a list of everything that needs translating into your chosen language. You can either work through the list or select which page you want to translate by clicking on the 'All' button near the top (note: there is currently a bug that makes this list messy). If you can't see the page you want to translate, you will need to ask a Translation Administrator to prepare it for you. Please message James or email community@therestartproject.org
   
4. Click on 'Review' at the bottom of the page. This will show you translations waiting for approval. For each section, check whether the submitted translation is accurate and includes any necessary safety information. You can edit translations by clicking the pencil icon that appears on the left when you hover over each translation.
5. Approve translations by clicking on the tick/check button on the left of each section. Sections that you approve will be published on the Wiki.
   

That's it, the page has been translated!