MozillaWiki

Nepal/Localization/Localization Style Guide: Difference between revisions

Page Discussion

Nepal/Localization/Localization Style Guide (view source)

Revision as of 09:28, 27 August 2023

7,056 bytes added ,  27 August 2023
→‎Formality, Tone and Natural Expression: replaced 'आ' character
(Created page with "==Mozilla L10n Style Guide for ne_np== <big>'''Intro'''</big> Style guides define the standard against which we determine a translation's quality. They contain rules that a...")
 
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Mozilla L10n Style Guide for ne_np==
<big>'''Mozilla L10n Style Guide for ne_np'''</big>


 
<big>Intro</big>
<big>'''Intro'''</big>


Style guides define the standard against which we determine a translation's quality. They contain rules that are both defined by Mozilla and by Mozilla Nepal on how to best translate text in Mozilla products, websites, and other projects. Style guides are used to both translate and evaluate a translation's quality. By following these rules, a translator has a better chance of producing a high quality translation that represents Mozilla values and culture.
Style guides define the standard against which we determine a translation's quality. They contain rules that are both defined by Mozilla and by Mozilla Nepal on how to best translate text in Mozilla products, websites, and other projects. Style guides are used to both translate and evaluate a translation's quality. By following these rules, a translator has a better chance of producing a high quality translation that represents Mozilla values and culture.
Line 16: Line 15:
"Wow. Such Nice Pair of Shoes!"
"Wow. Such Nice Pair of Shoes!"


Do not translate it as "वाह। यस्ता राम्रा जुत्ताका जोडा।"
[x] Do not translate it as ''"वाह! कस्ता राम्रा जुत्ताका जोडा।"''
 
[✔] But Translate it as ''"आहा, कती राम्रो जुत्ता।"''
 
Also, complete sentences are preferred over incomplete english counterparts whenever space is not strictly constrained. For example, when translating About &brandShortName; preference is given to &brandShortName; को बारेमा जान्नुहोस् over &brandShortName;  बारे . When space is a problem, (maybe in mobile?), find closest-to-complete phrase which is shorter in length. For the above example, it could be &brandShortName; को बारेमा . Always keep in mind that “easy-for-users-to-understand” is given preference over “because-there-was-no-space” translations.
 
== Cultural References ==
 
If the source language has a cultural reference that has no equivalent and widely accepted Nepali phrase, remove the cultural reference and translate the core meaning.
 
== Brand Names ==
 
All Brand Names are kept in it’s original language and never translated. For example do not translate "Firefox", "Mozilla", "Facebook", "Twitter", "Skype", anything that is a name of a brand.
 
== Technical Strings ==
 
Strings which are part of a library specification, some complex words and phrases which gives meaning only on the context of the specific library or language should not be translated. This will be changed slowly when local developer start shifting their programming paradigm to the local language, in which case, we will slowly translate those english strings to nepali. But for this, a detailed meeting with list of words to translate to nepali will be published.
 
== Short Forms ==
 
This is different from abbreviations, which are generally not translated but again depends on context. Short Forms such as prefs: for preferences will be elongated while translating to Nepali. This means that prefs: will be translated to प्राथमिकता  and not प्रेफ्स:
 
== MDN Links ==
 
When you are introduced with MDN Links, remove the `en-US/` part of the URL so that the URL redirects to the proper locale. Example. https://developer.mozilla.org/en-US/docs/Web/API/Push_API/Using_the_Push_API#Encryption becomes  https://developer.mozilla.org/docs/Web/API/Push_API/Using_the_Push_API#Encryption
 
== Translating Legal Strings ==
 
When translating somewhat legal strings(about:rights, licenses), pay special care to translate to corresponding legal Nepali tone.
 
== Terminology ==
 
Here are a few existing term bases we approve of for software/internet terminology and definitions (though not limited to):
 
* Microsoft key terms and target languages  https://www.microsoft.com/Language/en-US/Default.aspx
* Pootle's own term list: https://mozilla.locamotion.org/ne/terminology/
* List of Nepali Words/Phrases and Explanation: https://docs.google.com/spreadsheets/d/1_2JeUCi3Bh-rgwc-426sXL0UvuNZ--diJuXQJcX-DHM/edit?usp=sharing
 
 
You should be consistent in the use of existing reliable appropriate term bases in Nepali language. These term bases could be developed and approved by the Mozilla Nepal community, or leveraged from another party that adhere to national, international or local standards for software and Internet terminology.  Avoid the following:
 
*Inconsistent use of terminology within the project
*Inconsistent use of terminology with term base
*Inconsistent use of terminology across all of your projects
*Using terminology from another subject matter (e.g., don't use medical terminology in Firefox).
 
== Units and Grammar ==
 
The translation should strive to achieve proper unit conversions for currency, measurements, etc. for the target audience.
=== Units and Unit Conversion ===
 
<big> Date Format </big>
 
The date formats for weeks and months can be expressed in the following forms:
 
* Fully spelled out
* Two or Three letters
* Single letter
 
While localizing Dates, use the format by taking into consideration about the target space available.
 
Reference material can be found here: https://en.wikipedia.org/wiki/Date_format_by_country
<big> Calendar view: </big>
 
* Sunday should be the first day of the week. 
* Even though lunar calendar is used in our daily life, we should follow Gregorian calendar for localization.
 
Regional Calendar is Observed. The calendar in use is “Bikram Sambat”, about 47 years ahead of A.D. (See: http://nepalipatro.com.np )
 
<big> Time Format </big>
 
HH:MM <time of day> (12 hour clock) is the preferred Time format.
 
<big> Numerals </big>
 
Use comma as a separator. Use Nepali system. eg Rs 1,000 & 1,00,00,000
   
<big> Currency </big>
 
Google App Store currently shows “NPR” as the currency to buy its apps. It is the standard currency code, we do not have any notations. 
<big> Units </big>
If Source strings will use the imperial system (e.g., miles, pounds, feet, gallons, etc.). Target translations should convert imperial metrics to metric measurement system.
<big> Names </big> 
 
The order of name is: Prefix FirstName MiddleName LastName
 
<big> Address and Postal Code Format </big>
 
Zip code/Postal code is not widely used. Exact addressing is limited to certain places only. There is no any defined format as of now.
 
=== Word Forms ===
 
<big> Pluralization </big>
 
Please refer to the standard Unicode Plural specification for Nepali language (http://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html#ne).
 
When using plural verbs, use आ sound, instead अ sound which is used for singular verbs. Same rule applies for adjectives too.
 
Nepali language uses plural form #2 as specified in the following link: https://developer.mozilla.org/en-US/docs/Mozilla/Localization/Localization_and_Plurals
 
Singular: 1
Plural: 0, 0.0 - 0.9, 1.1 - ... , 2,3,4,5,...
 
<big> User Interface Elements </big>
 
* Titles :  Should be brief and precise. Localizers can assume that source content reaches 2/3 of the total available line space. This allows localization text to expand and not be truncated or resolved through ellipsis. Title on the final page (meaning no more click through) should allow enough room to display full text.
       
* Buttons: Capitalize the first letter of each word. Limit to one or two words. Use verbs that precisely describe the button's action. For example, "Cancel", "Clear History", "Add Email", "Select All", etc.         
Value Selector Lists: Capitalize the first letter of the first word and the first letter of any proper nouns. Limit to one or two words.
* Articles:  Avoid them where possible. Articles (such as the word "the" in English) should be avoided wherever possible. User interface elements have limited space available for text. Avoiding articles will help ensure that your translations will be accommodated within the user interface.             
 
*Ellipsis: Ellipsis are often inserted automatically in the UI where strings are truncated. Ellipsis should only be used at high level of UI pages, but not be on the final page (after a series of click-through) where detailed instruction is given. Ellipsis should not be used as a way to solve truncation issue.  Focus on making the UI short and precise.  The sequence of the sentence structure in another language may not translate well, when a sentence is half finished as such.
 
== Translation Consistency ==
Consistent Localization means that same source should have same translation whenever possible. 


But Translate it as "अाहा, कती राम्रो जुत्ता।"
We advise you to use Transvision (https://transvision.mozfr.org/consistency) to check for translation consistency and submit the translation.


Also, complete sentences are preferred over incomplete english counterparts whenever space is not strictly constrained. For example, when translating About &brandShortName; preference is given to &brandShortName; को बारेमा जान्नुहोस्  over &brandShortName;  बारे . When space is a problem, (maybe in mobile?), find closest-to-complete phrase which is shorter in length. For the above example, it could be &brandShortName; को बारेमा  . Always keep in mind that “easy-for-users-to-understand” is given preference over “because-there-was-no-space” translations.
== General Mozilla L10n Style Guide ==
You should also follow the guidelines in the following link while localizing Firefox.  
https://developer.mozilla.org/en-US/docs/L10n_Style_Guide#General_Mozilla_l10n_style
Retrieved from "https://wiki.mozilla.org/Special:MobileDiff/1149036...1247731"