WikiIslam:Instructions for Translators: Difference between revisions

From WikiIslam, the online resource on Islam
Jump to navigation Jump to search
m (will continue this)
mNo edit summary
Line 4: Line 4:
This page aims to provide step-by-step instructions for new [[WikiIslam:Translations|translators]] at [[WikiIslam]]; from creating an account to announcing a completed translation on the main page.  
This page aims to provide step-by-step instructions for new [[WikiIslam:Translations|translators]] at [[WikiIslam]]; from creating an account to announcing a completed translation on the main page.  


==Early Steps==
==Stages==
===Initial Steps===


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.
This section covers everything needed prior to beginning a translation.
 
====Creating an Account====


==Translating Content==
Because most translations are initially hosted on the English language version of WikiIslam, it is essential that prospective translators [[Help:Logging in|create an account]] prior to starting any work. IP edits to translations will usually be reverted on the English language version of WikiIslam in order to minimize [[WikiIslam:Vandalism|vandalism]]. This will obviously not be the case if and when a [[WikiIslam:Translations#Sub-Domains|dedicated sub-domain]] is opened in any particular language.


==Post-Translation==
To create an account, new users should click on the ''<span class="plainlinks">[{{fullurl:Special:Userlogin||qs=type=signup}} Create account] </span>'' link at the top right of the page. They will need to provide a username and password, as well as answer a visual "[[Special:Captcha|anti-spam]]" test. Those who already have an account, should <span class="plainlinks">[{{fullurl:Special:Userlogin|type=login}} login]</span> using their details.


====Contacting an Administrator====


====Choosing Islamic sources====


===Translating Content===


This section covers everything needed for the actual translation process.


===Post-Translation===


This section covers everything needed once the translation process itself is complete.




==Additional Notes==


;First Step
===Alterations in Translations===
# '''Create account''': The first step for you would be to <span class="plainlinks">[{{fullurl:Special:Userlogin|type=login}} create an account] </span> which only takes a minute and does not require email confirmation. If you already have an account, you can <span class="plainlinks">[{{fullurl:Special:Userlogin|type=login}} login]</span>.  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 [[Special:Mytalk|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.


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.


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 <nowiki>{{</nowiki>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:Contents#Saving your Work|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 for a Translation===
===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 <span class="plainlinks">[{{fullurl:Special:Userlogin|type=login}} create an account] </span>. If you already have an account, you can <span class="plainlinks">[{{fullurl:Special:Userlogin|type=login}} login]</span>.  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 <nowiki>{{</nowiki>page_title|Desired page title}}.
# 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 <nowiki>{{</nowiki>page_title|Desired page title}}.
#After clicking "Create page" you will see a blank page.
#After clicking "Create page" you will see a blank page.
Line 60: Line 49:
# To find what you have been working on, click the 'My contributions' link at the top right.
# 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 [[Help:Contents#Saving_your_Work|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''





Revision as of 10:23, 21 October 2014

Under-construction.jpg
This page is under construction, in the middle of an expansion or major revamping
In its present state, the views expressed here may not reflect the views of WikiIslam. Please help us in completing this article.
      
Page History - Article's Talk page
Last edit was made on 10/21/2014
Login / Create Account
Shortcut:
WIIT

This page aims to provide step-by-step instructions for new translators at WikiIslam; from creating an account to announcing a completed translation on the main page.

Stages

Initial Steps

This section covers everything needed prior to beginning a translation.

Creating an Account

Because most translations are initially hosted on the English language version of WikiIslam, it is essential that prospective translators create an account prior to starting any work. IP edits to translations will usually be reverted on the English language version of WikiIslam in order to minimize vandalism. This will obviously not be the case if and when a dedicated sub-domain is opened in any particular language.

To create an account, new users should click on the Create account link at the top right of the page. They will need to provide a username and password, as well as answer a visual "anti-spam" test. Those who already have an account, should login using their details.

Contacting an Administrator

Choosing Islamic sources

Translating Content

This section covers everything needed for the actual translation process.

Post-Translation

This section covers everything needed once the translation process itself is complete.


Additional Notes

Alterations in Translations

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.




Steps for a Translation

  1. 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}}.
  2. After clicking "Create page" you will see a blank page.
  3. 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.
  4. 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.
  5. 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).
  6. 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.
  7. To find what you have been working on, click the 'My contributions' link at the top right.


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>).

See Also