Size: 5610
Comment:
|
Size: 12951
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). 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 working with Launchpad Translations (Rosetta). For such information please read [[Translations/StartingToTranslate Starting to translate]] . After reading this guide please find the guide specific to your language into the [[Translations/GuidesList | list of translation guides for all languages]]. |
This guide contains specific information about translating software into your language. It contains details about what strings should be translated and what not, what are plural forms and other things you should be aware 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]]. 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 the 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 = Below are listed some common sense rules to follow during the translation work in order to improve the translation quality: * Pay attention to all section from the guildelines and always keep in touch with other translators * When you have translated a string, read it again and see if there are any error or the translations sound right in your language. * If the translated string does not make sense for you (or your mother/father), definelty it is wrong and you should redo/rephrase it. * If it feasible, always ask another team member to review your translations. * Translations consistency is an important aspect of translation quality. You can check the translation of a word / phrase in multiple free software project using the [[http://open-tran.eu| Open Tran]] website * Terminology dictionary * Before allowing new members in your team make sure they have previously done good translations and are aware of the team translation guide = Plural forms = While English language has 2 plural forms, it might happens that your language has more than 2 plural forms. Dealing with plural forms is one of the first question/problems for new translators. It is recommended that your guidelines 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 }}} = Translating DocBook (XML) files = You can translate XML files using Launchpad Translations, by converting the xml to a pot file, using xml2po, and then importing it in Rosetta. When translating XML files please mare sure you are aware of the following things: == XML tags are case sensitive == When using xml2po and then po2xml, xml tags and attributes are case sensitive: Example: {{{ Original: See the <ulink url="http://ubuntustudio.org/"> Correct: Vea el <ulink url="http://ubuntustudio.org/"> Wrong: Vea el <UlinK Url="http://ubuntustudio.org/"> }}} == menuchoice tag == "menuchoise" tag should inlude only "guibutton | guiicon | guilabel | guimenu | guimenuitem | guisubmenu | interface" tags. Don't include other tags or text outside of these tags. Example: {{{ Original: <menuchoice><guimenu>Applications</guimenu><guisubmenu>Multimedia</guisubmenu><guimenuitem>Movie Player</guimenuitem></menuchoice> Correct: <menuchoice><guimenu>Apliaciones</guimenu><guisubmenu>Multimedia</guisubmenu><guimenuitem>Reproductor de películas</guimenuitem> Wrong: <menuchoice><guimenu>Apliaciones</guimenu><guisubmenu>Multimedia</guisubmenu>Reproductor de <guimenuitem>películas</guimenuitem> }}} |
Line 16: | Line 93: |
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 usually add comments describing the intend of the text and tips about translating it. Always check the comments attached to each string. |
|
Line 36: | Line 118: |
== 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 44: | Line 126: |
}}} Also you should not translate the xml tags attibutes and their values (if you tranlate their values, make sure you know what you are doing and check the developers comments). Examples: {{{ Original: <link linkend="desktop-themes"> Right: <link linkend="desktop-themes"> Wrong: <link linkend="temi del desktop"> |
|
Line 67: | Line 157: |
In many cases the presence 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 71: | Line 163: |
Orignal: The port which the server will listen to if the 'use_alternative_port' key is set to true. | Original: The port which the server will listen to if the 'use_alternative_port' key is set to true. |
Line 92: | Line 184: |
= 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 }}} |
If you see such text please fill a bug and inform the software developers about the existence of context. = Suggestions for sections included in your guidelines = Below are some ideas, hints, for some information that could be included into the guildelines for your language: * A section describing the current focus for translations. What packages should be translated, their priority, due date... etc * Create or provide a communication channel for all translators. It can be a forum, mailing list, IRC channel. The main usage of this channel is to support team work, ask for help or suggestions. * Provide information about other team working on translations, links to other upstream projects. Try to keep in touch/sync with their work. * Decide what grammatical mode or tense is used when translating into your language. * Decide grammatical person and if you are going to use a formal or informal approach when translating software. T-V distinction. * Decide a common set of terminology or dictionary to be used by all translators. This will help creating uniform translations. * A section, or a dedicated page, containing examples of common errors, together with an explanation of the error and the suggested solution * A section, or a dedicated page, containing examples of strings that should not be translated. = Common/Best practice = Below you will find a set of common practices for running a team * Don't forget about other translators or translations groups. In many cases you or your are not the only one doing translation in the free software ecosystem. Always keep in touch with that other teams are doing and make sure the translation teams for your language are translating free software using the same "language". Try to create or join a communication channel channel common to all translation teams for your language and use it for talking about important aspect that affect all translations. * Define a procedure for accepting new team members. * The acceptance level may vary according to the percentage of already finished translations. For languages with few translators and translations already done team acceptance could be lower than in the case of a language with many translators, translations made and the presence of GTP, OpenOffice , etc upstream translation projects. * Before accepting a member you may ask him/her to provide some translation. If the translations are great you may accept the new member. Otherwise giving feedback about why the translation are not good is a great help. Try to use a forum, mailinglist or IRC channel for giving feedback to potential new members. * Create a webpage/wikipage for the translations guide. This guide should contain: * First rule: "If a translation does not make sense for you / your grandmother, definitely it is wrong!". * Second rule: "Make your translation useful and adapt to the context. Don't follow always the original text". Like for example "Tile children" may sound funny in many languages so try "Arrange windows as tile". The original text is not always the correct one. * a common terminology or a link to a common terminology dictionary or glossary. Don't forget about [[http://open-tran.eu | open-tran.eu ]] . You can also install [[http://www.i18n.ro/glosar | the glossary used by Romanian teams]] ([[ http://diacritice.svn.sourceforge.net/viewvc/diacritice/trunk/ | here is the code]]) * information about what should be translated and what not * specific rules for translating into your language * a list of frequent errors. * explaining the plurar form for your language and how to use them * how you should translate menu accelerators / shortcuts * inform the translators about other translation project and how we should cooperate and work together * Make sure you have a good communication channel for all members of the team or subteam. Try to reach all communication types: mailinglist, forum, IRC channel. |
Launchpad Help > Translations > General Translation Guide
Overview
This guide contains specific information about translating software into your language. It contains details about what strings should be translated and what not, what are plural forms and other things you should be aware 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.
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 the 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
Below are listed some common sense rules to follow during the translation work in order to improve the translation quality:
- Pay attention to all section from the guildelines and always keep in touch with other translators
- When you have translated a string, read it again and see if there are any error or the translations sound right in your language.
- If the translated string does not make sense for you (or your mother/father), definelty it is wrong and you should redo/rephrase it.
- If it feasible, always ask another team member to review your translations.
Translations consistency is an important aspect of translation quality. You can check the translation of a word / phrase in multiple free software project using the Open Tran website
- Terminology dictionary
- Before allowing new members in your team make sure they have previously done good translations and are aware of the team translation guide
Plural forms
While English language has 2 plural forms, it might happens that your language has more than 2 plural forms.
Dealing with plural forms is one of the first question/problems for new translators. It is recommended that your guidelines 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
Translating DocBook (XML) files
You can translate XML files using Launchpad Translations, by converting the xml to a pot file, using xml2po, and then importing it in Rosetta.
When translating XML files please mare sure you are aware of the following things:
XML tags are case sensitive
When using xml2po and then po2xml, xml tags and attributes are case sensitive: Example:
Original: See the <ulink url="http://ubuntustudio.org/"> Correct: Vea el <ulink url="http://ubuntustudio.org/"> Wrong: Vea el <UlinK Url="http://ubuntustudio.org/">
menuchoice tag
"menuchoise" tag should inlude only "guibutton | guiicon | guilabel | guimenu | guimenuitem | guisubmenu | interface" tags. Don't include other tags or text outside of these tags.
Example:
Original: <menuchoice><guimenu>Applications</guimenu><guisubmenu>Multimedia</guisubmenu><guimenuitem>Movie Player</guimenuitem></menuchoice> Correct: <menuchoice><guimenu>Apliaciones</guimenu><guisubmenu>Multimedia</guisubmenu><guimenuitem>Reproductor de películas</guimenuitem> Wrong: <menuchoice><guimenu>Apliaciones</guimenu><guisubmenu>Multimedia</guisubmenu>Reproductor de <guimenuitem>películas</guimenuitem>
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 usually 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>
Also you should not translate the xml tags attibutes and their values (if you tranlate their values, make sure you know what you are doing and check the developers comments). Examples:
Original: <link linkend="desktop-themes"> Right: <link linkend="desktop-themes"> Wrong: <link linkend="temi del desktop">
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 presence 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:
Original: 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"
If you see such text please fill a bug and inform the software developers about the existence of context.
Suggestions for sections included in your guidelines
Below are some ideas, hints, for some information that could be included into the guildelines for your language:
- A section describing the current focus for translations. What packages should be translated, their priority, due date... etc
- Create or provide a communication channel for all translators. It can be a forum, mailing list, IRC channel. The main usage of this channel is to support team work, ask for help or suggestions.
- Provide information about other team working on translations, links to other upstream projects. Try to keep in touch/sync with their work.
- Decide what grammatical mode or tense is used when translating into your language.
- Decide grammatical person and if you are going to use a formal or informal approach when translating software. T-V distinction.
- Decide a common set of terminology or dictionary to be used by all translators. This will help creating uniform translations.
- A section, or a dedicated page, containing examples of common errors, together with an explanation of the error and the suggested solution
- A section, or a dedicated page, containing examples of strings that should not be translated.
Common/Best practice
Below you will find a set of common practices for running a team
- Don't forget about other translators or translations groups. In many cases you or your are not the only one doing translation in the free software ecosystem. Always keep in touch with that other teams are doing and make sure the translation teams for your language are translating free software using the same "language". Try to create or join a communication channel channel common to all translation teams for your language and use it for talking about important aspect that affect all translations.
- Define a procedure for accepting new team members.
The acceptance level may vary according to the percentage of already finished translations. For languages with few translators and translations already done team acceptance could be lower than in the case of a language with many translators, translations made and the presence of GTP, OpenOffice , etc upstream translation projects.
- Before accepting a member you may ask him/her to provide some translation. If the translations are great you may accept the new member. Otherwise giving feedback about why the translation are not good is a great help. Try to use a forum, mailinglist or IRC channel for giving feedback to potential new members.
- Create a webpage/wikipage for the translations guide. This guide should contain:
- First rule: "If a translation does not make sense for you / your grandmother, definitely it is wrong!".
- Second rule: "Make your translation useful and adapt to the context. Don't follow always the original text". Like for example "Tile children" may sound funny in many languages so try "Arrange windows as tile". The original text is not always the correct one.
a common terminology or a link to a common terminology dictionary or glossary. Don't forget about open-tran.eu . You can also install the glossary used by Romanian teams (here is the code)
- information about what should be translated and what not
- specific rules for translating into your language
- a list of frequent errors.
- explaining the plurar form for your language and how to use them
- how you should translate menu accelerators / shortcuts
- inform the translators about other translation project and how we should cooperate and work together
- Make sure you have a good communication channel for all members of the team or subteam. Try to reach all communication types: mailinglist, forum, IRC channel.