WikiIslam:Instructions for Translators
This page aims to provide step-by-step instructions for new translators at WikiIslam; from creating an account to adding a finished translation to the main page.
Translations should always remain faithful to the original English work, retaining their scholarly tone and information. If for localization purposes an editor thinks there should be some slight alterations made, they must first be discussed with others on the talk page.
- First Step
- Create account: The first step for you would be to create an account which only takes a minute and does not require email confirmation. If you already have an account, you can login. When you are logged in, you will see your username at the top left of every page with various user specific links like My talk, Preferences and so on.
- Which language? Let us know on your talk page or our forum page which language you're wanting to translate into.
- Islamic sources in your language: Are there any Quran, Hadith and Tafsir websites in your language? Let us know (through your talk page or the forum page) so we can make templates for Quran and hadith in your language. These will be used in the translations for quoting Quran and hadith. Quran and hadith translations should ideally:
- Should be from translations which are accepted well and regularly referred to by Muslims who know that language. This is the most important to consider.
- Have URL's that change according to the verse or hadith displayed. URL's can be changed later site-wide at any time to point to a different site as long as the text in the quote is the same.
- if possible:
- load relatively fast in the browser
- have no or little ads
- also display Arabic
Sometimes there aren't too many sources for a certain language and we have to use what we have available.
Let us know about the sources you know of and we can check to see if they can be used in the templates.
Steps for a Translation
- Go to Help:Contents. Translate the title of your chosen article and type that into the "Create Page" box. If any of these characters exist in the title, avoid using them: brackets, commas, colons, semi-colons etc. These can be added into the title later by using {{page_title|Desired page title}}.
- After clicking "Create page" you will see a blank page.
- Open another window. Then go to your chosen article and click the 'Edit' button. You will now see the text and all the wiki-formatting of the target article.
- Copy and paste the entire thing into the new page you created. In Windows, Select all text and then CTRL-C; CTRL-V to paste.
- You can now start your translation. Delete the English text as you go. You can also keep another window open which has the original article in a regular view (non-editable).
- After you are done, you can preview or save the page. To make sure you don't lose your work, please see the "Saving your Work" section on the Help page. You can also simply 'copy' all the text. You can also do intermediate saves if you have to interrupt your work, or if it's a long page.
- To find what you have been working on, click the 'My contributions' link at the top right.
(old)
Steps
After you choose what article to translate:
- Login or create account: Unless you are okay with having your IP address recorded in page histories, the first step for you would be to create an account . If you already have an account, you can login. When you are logged in, you will see your username at the top left of every page with various user specific links like My talk, Preferences and so on.
- Go to Help:Contents. Translate the title of your chosen article and type that into the "Create Page" box. If any of these characters exist in the title, avoid using them: brackets, commas, colons, semi-colons etc. These can be added into the title later by using {{page_title|Desired page title}}.
- After clicking "Create page" you will see a blank page.
- Open another window. Then go to your chosen article and click the 'Edit' button. You will now see the text and all the wiki-formatting of the target article.
- Copy and paste the entire thing into the new page you created. In Windows, Select all text and then CTRL-C; CTRL-V to paste.
- You can now start your translation. Delete the English text as you go. You can also keep another window open which has the original article in a regular view (non-editable).
- After you are done, you can preview or save the page. To make sure you don't lose your work, please see the "Saving your Work" section on the Help page. You can also simply 'copy' all the text. You can also do intermediate saves if you have to interrupt your work, or if it's a long page.
- To find what you have been working on, click the 'My contributions' link at the top right.
If these steps are difficult to follow, you can leave a message on the forum page with the name of the article you'd like to translate and the new title of your translated version. We will make a page for you with that new title with the existing English text that you can translate. Remember to save your work as you go (see the tips for saving your work).
We are also looking for feedback on these steps. Please let us know on the forum page if these directions can be improved or if you face any difficulties.
- End of old stuff
Examples
Source text | Translated text | Notes |
---|---|---|
Women | X | Suppose X is the translation of Women. For plain text, write the output in plain text (as expected). |
[[Women]] | X (or) [[Women|X]] | This is a link to an English article (or redirect). Suppose X is the translation of Women. You can remove the brackets and just write X, or write [[Women|X]] |
<ref> This is a plain text reference</ref> | <ref> (translate into your language)</ref> | This is a plain text reference. Leave the ref tags intact and translate the rest. |
<ref> This is a reference with a link</ref> | <ref> (leave code format intact; translate the rest)</ref> | This is a reference with a link. Maintain the code formatting for the reference and link and translate the rest |
[[Category:Women]] | This is a category. | |
{{Template:Muslim Statistics}} or {{Template:Muslim Statistics}} | This is a template. | |
Quote | ||
Quote with reference | ||
Quote with linked reference | ||
Section Heading | ||
Images | ||
Bold and Italics text | ||
Quran and hadith templates | ||
{{main|Allah}} | (remove this text) | This is a link in a sub-section. Unless that link exists in your language, you can remove this text. |
Anything like <code> should be left unchanged, for example <ref>, <br> (or <BR>).