Difference between revisions of "How to create a language pack"
From Joomla! Documentation
m (Hutchy68 moved page How to create a language pack to J1.5:How to create a language pack: namespacing) |
m (removing review, this article is archived) |
||
Line 1: | Line 1: | ||
− | + | {{RightTOC}} | |
==CORE language packs== | ==CORE language packs== | ||
Joomla! uses three language packages, one for the front end, one for the administrator and one for installation. Ideally you will create all three. | Joomla! uses three language packages, one for the front end, one for the administrator and one for installation. Ideally you will create all three. |
Revision as of 20:35, 10 May 2013
The "J1.5" namespace is an archived namespace. This page contains information for a Joomla! version which is no longer supported. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.
CORE language packs[edit]
Joomla! uses three language packages, one for the front end, one for the administrator and one for installation. Ideally you will create all three.
For practical information on the way to make core translation files:
- For Joomla! 3.x, see Making a Language Pack for Joomla 3.x
- For Joomla! 1.6.x and 2.5.x, see Making a Language Pack for Joomla 1.6
- For Joomla! 1.5, see forum: How to create a new 1.5 language pack.
Files encoding[edit]
- ALL FILES MUST BE SAVED AS UTF8 NO BOM (for non-ascii glyphs as in accented letters, etc.)
Tools[edit]
Many people find it helpful to use the Translation manager extension. This helps by automating the creation of the files.
Translation pack[edit]
A translation pack consists of an xml file, a blank index file and a set of *.ini files containing the language strings for your language. The easiest way to understand this structure is to look at the files in the language/en-GB folder of your Joomla! installation.
This is an excerpt from en-GB.mod_login.ini
BUTTON_LOGIN=Login
BUTTON_LOGOUT=Logout
ENCRYPT LOGIN FORM=Encrypt Login Form
FORGOT_YOUR_PASSWORD=Forgot your password?
FORGOT_YOUR_USERNAME=Forgot your username?
GREETING=Greeting
To create a package for your language you change the strings to the right of the = signal.
Language naming convention[edit]
Language naming convention in Joomla are: language + ISO code.
- Use 2 letters when available. The list is available here.
- This reference concerns country codes
Name of package should start with your language's ISO code + description + version:
- fr-FR_joomla_lang_full_3.0.2v1.zip
Locale[edit]
The locale is used to sort translated lists when present on the server. Information on available locales may be found here.
Guidelines for developers[edit]
Guidelines for developers to facilitate translation: Language Guidelines for 3rd Party Extensions
- For Joomla 1.5 see the forum: Building Extension's Language Pack for J1.5