How to create a language pack

From Joomla! Documentation

Revision as of 10:01, 3 September 2008 by Chris Davenport (Talk | contribs)

Replacement filing cabinet.png
This Namespace has been archived - Please Do Not Edit or Create Pages in this namespace. Pages contain information for a Joomla! version which is no longer supported. It exists only as a historical reference, will not be improved and its content may be incomplete.
This Page Needs Your Help

This page is tagged because it NEEDS REVIEW. You can help the Joomla! Documentation Wiki by contributing to it.
More pages that need help similar to this one are here. NOTE-If you feel the need is satistified, please remove this notice.

Joomla! uses three language packages, one for the front end, one for the administrator and one for installation. Ideally you will create all three.

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

DESCLOGINFORM=This Module displays a username and password Login form. It also displays a link to retrieve a forgotten password.  If User registration is enabled, (refer to the Global Configuration settings), then another link will be shown to invite Users to   self-register.
FORGOT_YOUR_PASSWORD=Forgot your password?
FORGOT_YOUR_USERNAME=Forgot your username?

To create a package for your language you change the strings to the right of the =.

Many people find it helpful to use the translation manager extension. This helps by automating the creation of the files.

Language naming convention in Joomla are language and ISO code. Use 2 letters when available. The list is available here.

This reference concerns country codes

Because language strings may change it is best to create your packages using either the nightly build or subversion.

Name of package should be: xx-XX //using your language's ISO code.

Locale: Information on available locales may be found here.

If, for any reason, ini or xml language files are edited manually with a text editor, they have to be saved with the encoding UTF8 NO BOM.

For practical information on the way to make core Translation files, please see forum: