Online Manual:Translation Portal: Difference between revisions From Online Manual

Jump to: navigation, search
(Undo revision 8111 by Darkness'black (talk))
(→‎How to translate a template: Step-by step instructions, because this can be confusing to new wiki users.)
Line 31: Line 31:
The translation of a template follows a different approach then the translation of a normal page.
The translation of a template follows a different approach then the translation of a normal page.


The first step is create a new sub-page of the template. The name of this sub-page must correspond to the code of the language you want to translate the template to (we will provide a list of codes as soon as possible, in the meantime you will find few links already created in each updated template). Once the sub-page is created the second step is copy the '''entire''' template to the sub-page. Then the last step is translate '''only''' the text that needs to be translated and keep everything else (markup, logical operators (e.g. #if, #ifeq, etc.) and so on) as it is.<br />Whenever possible the text in the templates will be marked with comments indicating the start (<nowiki><!-- start translate --></nowiki>) and the end (<nowiki><!-- stop translate --></nowiki>) points of each portion that can be translated.
* '''Create a new sub-page of the template'''. <!--
--><br />The first step is create a new sub-page of the template. The name of this sub-page must correspond to the code of the language you want to translate the template to (we will provide a list of codes as soon as possible, in the meantime you will find few links already created in each updated template).<!--
--><br />Example: For the template [[Template:Add_new_template_translation]] , you can see the existing subpages at [[Special:PrefixIndex/Template:Add_new_template_translation/]].  Here's how the '''/it''' sub-page was created
*# Go to the template. You'll find it at http://wiki.simplemachines.org/smf/Template:Add_new_template_translation
*# Edit the adress bar on your browser.  Add a slash, followed by the correct language code. For italian, this was done by adding '''/it''', so the address bar now said http://wiki.simplemachines.org/smf/Template:Add_new_template_translation
* '''Copy the entire template to the sub-page'''.
*#Now, at the template's base page (for example, http://wiki.simplemachines.org/smf/Template:Add_new_template_translation), use the "edit" or "view source" button to see the complete source of the base page.  Copy all of this
*#If the translated template sub-page already exists, you should see an "edit link" (for example, athttp://wiki.simplemachines.org/smf/Template:Add_new_template_translation/it). If it does not yet exist, you will see a message such as "There is currently no text in this page. .... '''edit this page'''". This is the English-language version of the message. The actual message content may depend on the localization settings you have chosen on the wiki. Follow the link to '''edit this page'''.
*# Paste the content you copied from the template's base page into the sub-page you are creating.
#Translate ONLY the text that needs to be translated, and keep everything else just as it was. When a template is ready for translation, it will be marked up with contents to tell where to begin and end translation (<nowiki><!-- start translate --></nowiki>) and the end (<nowiki><!-- stop translate --></nowiki>).


==Haven't these translations already been done for the old help tab==
==Haven't these translations already been done for the old help tab==

Revision as of 14:45, 1 August 2011

This is a project page for Translators. Translators can check in here to find out what they can do. If you have any questions about this information, or suggestions for improving this page, please discuss at Online Manual talk:Translation Portal

Pages Ready for Translation

These pages appear in the new help tab, and are ready for translation. As soon as you save a translation message (like a language string), it will immediately be available to all users of the wiki and the new help tab.

  • Registering - Many forums require users to register to gain full access.
  • Posting - The whole point of a forum, posting allows users to express themselves.
  • Search - Searching is an extremely helpful tool for finding information in posts and topics.
  • Logging In - After registering you need to login to really gain full access to the forum.
  • Bulletin Board Code - Posts can be spiced up with a little BBC.
  • Memberlist - The memberlist shows all the members of a forum.
  • Features- Here is a list of the most popular features in SMF.
  • Profile - Each member has their own personal profile.
  • Calendar - Users can keep track of events, holidays, and birthdays with the calendar.
  • Personal messages - Users can send personal messages to each other.

How to translate these pages

These translations will be done using a wiki extension called the Translate extension, provided by the translatewiki team. To begin, go to the base page to be translated. If you have permission to translate, you will see a link titled "Translate this page" before the content of the page. Follow the link to the Translate form. You'll see the page's name listed in "Group". Choose the language from the drop-down list, and hit the "Fetch" button.

You will see all the language strings which need to be translated. The translation tool calls them messages. The link for the language message is on the left, and the content is on the right. Click on the link to start an editing window for that message. Above the editing window, you will see the source text, labeled "Message definition". In the textarea below, you may begin typing in the translation. If you wish, enter a Summary to discribe the changes you have made. When you have completed translating the language message, you must use the "Save page" button to save the language message you are editing on this page.

For more information on translating, please see the Page translation feature documentation from the translatewiki team

Note about links translation - Unfortunately at the moment the only way to have translations not marked as outdated by the extension is to use the english form of the link (i.e. without any language code like en, it, fr, etc. at the end). A "special case" that should be handled by the extension, but apparently is not, are intra-page anchors (e.g. [[#Pages Ready for Translation]]) in that cases the anchor must be translated, but the extension will outline the sentence containing it as outdated (see this page to have an idea of the result). For the time being let's live with it, eventually we will find the cause and fix it.

How to translate a template

In wikimedia a template is a special page that can be used within other pages to repeat consistently informations and/or structures (e.g. boxes like Template:Version specific). Templates can contain HTML, formatting entities, logical constructs and of course text. HTML, formatting and logical operators must not be translated, while text should be.

The translation of a template follows a different approach then the translation of a normal page.

  • Create a new sub-page of the template.
    The first step is create a new sub-page of the template. The name of this sub-page must correspond to the code of the language you want to translate the template to (we will provide a list of codes as soon as possible, in the meantime you will find few links already created in each updated template).
    Example: For the template Template:Add_new_template_translation , you can see the existing subpages at Special:PrefixIndex/Template:Add_new_template_translation/. Here's how the /it sub-page was created
    1. Go to the template. You'll find it at http://wiki.simplemachines.org/smf/Template:Add_new_template_translation
    2. Edit the adress bar on your browser. Add a slash, followed by the correct language code. For italian, this was done by adding /it, so the address bar now said http://wiki.simplemachines.org/smf/Template:Add_new_template_translation
  • Copy the entire template to the sub-page.
    1. Now, at the template's base page (for example, http://wiki.simplemachines.org/smf/Template:Add_new_template_translation), use the "edit" or "view source" button to see the complete source of the base page. Copy all of this
    2. If the translated template sub-page already exists, you should see an "edit link" (for example, athttp://wiki.simplemachines.org/smf/Template:Add_new_template_translation/it). If it does not yet exist, you will see a message such as "There is currently no text in this page. .... edit this page". This is the English-language version of the message. The actual message content may depend on the localization settings you have chosen on the wiki. Follow the link to edit this page.
    3. Paste the content you copied from the template's base page into the sub-page you are creating.
  1. Translate ONLY the text that needs to be translated, and keep everything else just as it was. When a template is ready for translation, it will be marked up with contents to tell where to begin and end translation (<!-- start translate -->) and the end (<!-- stop translate -->).

Haven't these translations already been done for the old help tab

The old Help tab and the current text found here on the wiki came from the same source -- the old online documentation at http://docs.simplemachines.org/. So the new help files are very similar to the old help tab documentation. In some places, the information has been updated. This means you may be able to find translations in the old help tab or in the language files (or in the Language Editor, if you are an SMF LE translator). If the new wiki language message is still a good match to the old help tab string, you can copy and paste the the old translation into the wiki.

Hey! What happened to the wiki translation I did earlier

To those of you who tried out translation before we finished setting things up -- thank you. It helped us see how things were going to work. We apologize for all the confusing changes. Now that the wiki has moved out of beta, we will avoid making so many confusing changes in the future.

If you did some earlier translation on the wiki, and it no longer shows up, you can find it in the history. So if you worked on translating part of Registering/nl but don't see it now -- click the history button to find your older version of a page. If your earlier work in one browser window, and use the wiki translation tool in another browser window, you will be able to cut-and-paste your work into the appropriate language message. You can cut and paste your translations into the appropriate language http://wiki.simplemachines.org/smf/index.php?title=Registering/nl&action=history. As long as it is still a good match for the one of the current language "messages", you can just copy and paste it into the correct message. Thanks for your help and your patience.

Pages with older translations

Pages not yet ready for translation

These pages already appear in the help tab. Each one requires some work. As each file becomes "stable", it will be released for translation.

Some things site admins would like to do to make translation easier and better

We are in the early stages of translating pages on the wiki, so we are still learning about the best way to get everything set up, and about any problems that might arise. Please let us know if you run into difficulties, or need more information.

Here is our plan to get the wiki ready for translation:

  1. Make sure the translate extension is in place and working well. (good to go!)
  2. Make sure the pages are all in a final version and a "translator friendly" state (Some pages are ready now!)
  3. Add information the translators need
    • How to find pages that need translation (Special:PageTranslation)
    • Create our own local guide to translation, so we don't have to depend on the translatewiki.net teams documentation

Tips and trick about translations

Headlines, templates and line spacing

Just noticed:

{{Other languages}}
{{TOCright}}
<translate><!--T:1-->
===View All Members===

will result in the headline no being properly displayed in translated pages (i.e. the triple equals doesn't get translated to a heading and remains as it is). To solve the issue, please use an empty line between the last template and the translate tag:

{{Other languages}}
{{TOCright}}

<translate><!--T:1-->
===View All Members===


Advertisement: