TDF Wiki/Multilingual/eo

From The Document Foundation Wiki
Jump to: navigation, search
This page is a translated version of the page TDF Wiki/Multilingual and the translation is 0% complete.

Other languages:
العربية • ‎dansk • ‎Deutsch • ‎Ελληνικά • ‎English • ‎Esperanto • ‎español • ‎فارسی • ‎français • ‎galego • ‎Bahasa Indonesia • ‎italiano • ‎日本語 • ‎Basa Jawa • ‎lietuvių • ‎Nederlands • ‎português • ‎português do Brasil • ‎română • ‎русский • ‎slovenčina • ‎українська • ‎中文(简体)‎ • ‎中文(台灣)‎

This page concerns the Multilingual Wiki content present on the TDF Wiki.

Gnome-dialog-warning.svg

Information
Do not use the OrigLang type of translation for newly created pages. We are currently transitioning to the MediaWiki Translate extension.


Background

This page contains some important hints for wiki editors. Please read this page before adding translated or localized content to the wiki.

Content with local focus

Pages are written in their local language only and won't be translated. They are subpages of a page named by the language code in upper case.

Examples:

 https://wiki.documentfoundation.org/DE
 https://wiki.documentfoundation.org/DE/Team
 https://wiki.documentfoundation.org/DE/Veranstaltungen
 ...
 https://wiki.documentfoundation.org/FR
 https://wiki.documentfoundation.org/FR/Blabla
 

Content with global focus

Pages are set up in English and are translated to different languages. The translated pages are subpages named by their language code. The translation process is handled by the Translate extension.

Follow these steps to make a page translatable:

  1. Put content that needs to be translated inside <translate></translate> blocks
  2. Use the {{#translation:}} template to add language suffixes to elements such as menus, categories or even links to local pages
  3. Add the language menu block <languages/>
  4. After saving the page, click the link at the top that says Mark this page for translation
  5. Check that everything is fine and click the button at the bottom that says Mark this version for translation

After the page is marked for translation, the Translate extension will automatically add markers in the form of <!--T:1--> to denote translatable strings. To become automatically separated into a string, a block of text has to be surrounded by blank lines. To force the separation of strings, you can add more <translate></translate> blocks. Pay attention to bulleted or numbered lists especially.

When you add or change content in the source page, this will appear at the top of the page: This page has changes since it was last marked for translation. Click the link "marked for translation" to bring the translation system up to date following the same process as in the initial marking for translation.

In an ideal situation, translators should see a minimal amount of wiki markup. Having markup for a table or a template in the translatable string is frustrating and confusing for the translator. Try to leave such markup outside the <translate></translate> blocks.

Sometimes there is a need to give a page a display title that is different from the name in the page path. Note that this is not recommended and should be avoided. In these cases, use the Rename template like so: {{Rename|My new name}}. The template will make sure there are no errors in the translated pages regarding the title.

Sometimes you need to access the English wiki source without the <!--T:1--> markers. This can be done by adding /en at the end of the page path and then editing the source. This will allow you to copy a page structure into a new page (such as Release notes).

Below is an example of a page prepared for translation. Notice the separation of the bulleted list and contents in a table.

 {{TopMenu{{#translation:}}}}
 {{Menu{{#translation:}}}}
 {{Menu.Documentation{{#translation:}}}}
 <languages/>

 <translate>
 == Hello World ==

 * We must take the world as we find it
 * When we are gone, let the world be flooded
 * The world is as fools wish it to be
 * It's a small world!
 </translate>
 <translate>
 * Crows are black the world over
 * He slipped once and all the world knew about it
 * The world is like a market, the one does business and the other does none
 * Huge though the world is, I always miss when I hit at it
 </translate>


 {| class="wikitable"
 |-
 | <translate>Cell content</translate>
 |-
 | {{sometemplate|<translate>Text content for a template</translate>}}
 |}

 [[Development/Create_a_Hello_World_LibreOffice_extension{{#translation:}}|<translate>Tutorial on creating a Hello World extension</translate>]]

 [[Category:Documentation{{#translation:}}]]
 

Migrating old translated content to the current system

In the past, TDF wiki employed a translation process that used templates called OrigLang and Lang. The templates displayed a menu that linked the source page with the translated ones. You can find all the translated content that use the Lang template in this list: Special:WhatLinksHere/Template:Lang

Translate extension has a migration tool, which helps in moving already translated content to the new system. If the source and translation blocks match exactly, the migration will be very easy. Otherwise you have to cut and paste strings between the input boxes.

The migration goes as follows:

  1. After marking a page for translation, wait for some minutes, so the server will have processed the page
  2. Navigate to Special:PageMigration
  3. In the input box, input the language path of the page you want to migrate, like: Mypath/Mypage/de for some imaginary German translation
  4. Click the Import button
  5. Clean up the contents in the input boxes containing the old translations (for example, remove any useless menu templates)
  6. In the column with the translations, you can't leave empty or extra input boxes at the end, so delete them by clicking the trashcan icon next to them
  7. After you cleaned up and put everything in order, click the Save button

Remember that you can always view the old version of a translated page using its View history link and clicking on an old revision.