Diff for "Translations/Guide"

Not logged in - Log In / Register

Differences between revisions 6 and 7
Revision 6 as of 2009-01-18 04:45:14
Size: 5610
Editor: 78
Comment:
Revision 7 as of 2009-03-20 02:11:24
Size: 6577
Editor: h194-54-129-79
Comment:
Deletions are marked like this. Additions are marked like this.
Line 7: Line 7:
This guides contains specific information about translation into your language. For example what strings should be translated and what not, what are plurar forms and other general things about working with Launchapad Translations (Rosetta). This guides contains specific information about translating software into your language. It contains details about what strings should be translated and what not, what are plurar forms and other things you should be aware of while translating software using Launchpad Translations (Rosetta) or any other tool.
Line 9: Line 9:
You are free to translate this guide and include it into your language specific guide, otherwise please make sure your language guide contains a reference to the general guide. This guide does not include hint and tips about using Launchpad Translations (Rosetta) as a translation tool. For such information please read [[Translations/StartingToTranslate Starting to translate]] .
Line 11: Line 11:
This guide does not include hint and tips about working with Launchpad Translations (Rosetta). For such information please read [[Translations/StartingToTranslate Starting to translate]] . You are free to translate this guide and include it into your language specific guide. You can use this information as a starting point for developing the guidelines for you language.
Line 13: Line 13:
After reading this guide please find the guide specific to your language into the [[Translations/GuidesList | list of translation guides for all languages]]. To assure translations quality for your language, it is recommended to ask new translators to follow the information from the guidelines for your language, or in case it is not ready yet, to point them to this guide.

= Basic rules for checking translations quality =
 * After finishing a translation, read it again to check for errors and see if it makes sense
 * If the translation doesn't make sense for you / your mother, it is definetly wrong and should be fixed

= Suggestions for sections in your guidelines =



= Plural forms =

While English language has 2 plural forms, it might happens that your language has more than 2 plural forms.

It is recommended to include information and examples about the usage of plural forms into your language.

Example
{{{
Romanian language has 3 plural forms.

Original text:
msgstr[0] %d thing
msgstr[1] %d things
msgstr[2] %g things

Translation:
msgstr[0] %d lucru
msgstr[1] %d lucruri
msgstr[2] %d de lucruri

}}}


= Menu accelerators / shortcuts =

Different development languages and frameworks use different ways to signify which key within a string should be used as a keyboard shortcut. Very often, if you see an underscore (e.g. Save _As) or ampersand (e.g. Print previe&w) at the beginning or within a word, it may well be a keyboard shortcut.

Ensuring you have a unique shortcut for each function is important and you should, at the very least, view the software in action and draw up a list of the shortcuts you plan to use before you start translating. You should place the underscore, ampersand or whichever other control character directly in front of the letter you want to use as the shortcut.
If you have a program interface with the same fast access character in different options/tabs/checkboxes/etc., you will have to press the shortcut several times in the keyboard to walk through all of them.


Examples of menu accelerators:
{{{
_File
New &Tab
~Downloads
}}}
Line 16: Line 63:

This section contains general information about strings that should not be translated and how to identify them.

Also to help you with identifying string that should not be translated, software developers usualy add comments describing the intend of the text and tips about translating it. Always check the comments attached to each string.
Line 36: Line 88:
== Formatting tags ==
You may see HTML, such as <strong>, used to format text in a string. Copy these tags exactly as you find them and apply them to the relevant part of the text, remembering to close the tags as appropriate. You may also see other tags, such as XML, and should treat them the same way.
== Formatting/XML tags ==
You may see HTML/XML tags, such as <strong>, used to format text in a string. Copy these tags exactly as you find them and apply them to the relevant part of the text, remembering to close the tags as appropriate. You may also see other tags, such as XML, and should treat them the same way.
Line 67: Line 119:
In many cases the presense of such string in a translations files is a bug and the software developers should be informed about it and asked to remove those strings.
Line 93: Line 147:
= Menu accelerators / shortcuts =

Different development languages and frameworks use different ways to signify which key within a string should be used as a keyboard shortcut. Very often, if you see an underscore (e.g. Save _As) or ampersand (e.g. Print previe&w) at the beginning or within a word, it may well be a keyboard shortcut.

Ensuring you have a unique shortcut for each function is important and you should, at the very least, view the software in action and draw up a list of the shortcuts you plan to use before you start translating. You should place the underscore, ampersand or whichever other control character directly in front of the letter you want to use as the shortcut.
If you have a program interface with the same fast access character in different options/tabs/checkboxes/etc., you will have to press the shortcut several times in the keyboard to walk through all of them.


Examples of menu accelerators:
{{{
_File
New &Tab
~Downloads
}}}

= Plural forms =

While English language has 2 plural forms, it might happens that your language has more than 2 plural forms.

For more information about plural forms please check the [[Translations/GuidesList| translation guide dedicated for your language]].

Example
{{{
Romanian language has 3 plural forms.

Original text:
msgstr[0] %d thing
msgstr[1] %d things
msgstr[2] %g things

Translation:
msgstr[0] %d lucru
msgstr[1] %d lucruri
msgstr[2] %d de lucruri

}}}

Launchpad Help > Translations > General Translation Guide

Overview

This guides contains specific information about translating software into your language. It contains details about what strings should be translated and what not, what are plurar forms and other things you should be aware of while translating software using Launchpad Translations (Rosetta) or any other tool.

This guide does not include hint and tips about using Launchpad Translations (Rosetta) as a translation tool. For such information please read Translations/StartingToTranslate Starting to translate .

You are free to translate this guide and include it into your language specific guide. You can use this information as a starting point for developing the guidelines for you language.

To assure translations quality for your language, it is recommended to ask new translators to follow the information from the guidelines for your language, or in case it is not ready yet, to point them to this guide.

Basic rules for checking translations quality

  • After finishing a translation, read it again to check for errors and see if it makes sense
  • If the translation doesn't make sense for you / your mother, it is definetly wrong and should be fixed

Suggestions for sections in your guidelines

Plural forms

While English language has 2 plural forms, it might happens that your language has more than 2 plural forms.

It is recommended to include information and examples about the usage of plural forms into your language.

Example

Romanian language has 3 plural forms. 

Original text:
msgstr[0] %d thing
msgstr[1] %d things
msgstr[2] %g things

Translation:
msgstr[0] %d lucru
msgstr[1] %d lucruri
msgstr[2] %d de lucruri

Menu accelerators / shortcuts

Different development languages and frameworks use different ways to signify which key within a string should be used as a keyboard shortcut. Very often, if you see an underscore (e.g. Save _As) or ampersand (e.g. Print previe&w) at the beginning or within a word, it may well be a keyboard shortcut.

Ensuring you have a unique shortcut for each function is important and you should, at the very least, view the software in action and draw up a list of the shortcuts you plan to use before you start translating. You should place the underscore, ampersand or whichever other control character directly in front of the letter you want to use as the shortcut. If you have a program interface with the same fast access character in different options/tabs/checkboxes/etc., you will have to press the shortcut several times in the keyboard to walk through all of them.

Examples of menu accelerators:

_File
New &Tab
~Downloads

What should not be translated

This section contains general information about strings that should not be translated and how to identify them.

Also to help you with identifying string that should not be translated, software developers usualy add comments describing the intend of the text and tips about translating it. Always check the comments attached to each string.

Data placeholders and variable names

In many development languages, a developer can insert data into a string by using a placeholder such as %s or %d. You may also see more complex variations, such as %(variablename)s, $name or ${name}. Copy these variables and placeholders exactly as you see, placing them in the exact order in whichever part of the string makes most sense in the target language.

If you're in doubt, ask another translator for advice.

Examples:

Original: I found $name ethernet device.
Wrong: S-a găsit $nume dispozitiv ethernet
Right: S-a găsit $name dispozitiv ethernet

Original: Delete %(name)s ?
Wrong: Ștergeți %(nume)le?
Wrong: Ștergeți %(nume)s?
Right: Ștergeți %(name)s?

Formatting/XML tags

You may see HTML/XML tags, such as <strong>, used to format text in a string. Copy these tags exactly as you find them and apply them to the relevant part of the text, remembering to close the tags as appropriate. You may also see other tags, such as XML, and should treat them the same way.

Examples:

Original: <strong>File name</strong>
Wrong: <puternic>Nume fișier</puternic>
Right: <strong>Nume fișier</strong>

Program parameters

Command line parameters should not be translated.

Example

Original: "The command line options are:\n"
          "       --quick         speeds up the processing\n"
          "       --slow          slows everything down."
Wrong:    "Opțiunile comenzii sunt:\n"
          "       --repede         grăbește procesarea\n"
          "       --încet          încetinește totul."
Right:    "Opțiunile comenzii sunt:\n"
          "       --quick         grăbește procesarea\n"
          "       --slow          încetinește totul."

TRUE/FALSE, GTK constants

Strings like "TRUE" , "FALSE" or gtk constants like "gtk-ok", "gtk-cancel" or "toolbar-icon" should not be translated.

In many cases the presense of such string in a translations files is a bug and the software developers should be informed about it and asked to remove those strings.

GCONF configuration keys

Examples:

Orignal: The port which the server will listen to if the 'use_alternative_port' key is set to true.
         Valid values are in the range from 5000 to 50000.
Wrong:   Portul pe care să asculte serverul în cazul în care cheia „folosește_port_alternativ” este activată.
         Valorile valide sunt între 5000 și 50000.
Right:   Portul pe care să asculte serverul în cazul în care cheia „use_alternative_port” este activată.
         Valorile valide sunt între 5000 și 50000.

Context text

In some old GNOME translations you might encounter translations context encoded into the original string. For for information please see: http://leonardof.org/2007/12/01/context-in-gnome-translations/en/

Examples:

Original: "Orientation|Top"
Wrong: "Orientare|Sus"
Wrong: "Orientation|Sus"
Right: "Sus"

< Launchpad Translators group

All language translations Guides list >

Translations/Guide (last edited 2018-10-26 11:00:37 by cjwatson)