Actions

Difference between revisions of "Creating a language definition file"

From Joomla! Documentation

(New page: Important note: Joomla language INI files must be saved as UTF-8 without the Byte Order Mark (BOM)<ref name="ftn2">For more information on Byte Order Mark see [http://unicode.org/faq/utf_b...)
 
m (Omit references when transcluded.)
Line 12: Line 12:
  
 
The “''KEY''” may include spaces and other punctuation characters but there should not be any spaces either side of the equals sign as spaces are significant. If more than one entry has the same left-hand side, the last entry in the file is the one to perform the translation.
 
The “''KEY''” may include spaces and other punctuation characters but there should not be any spaces either side of the equals sign as spaces are significant. If more than one entry has the same left-hand side, the last entry in the file is the one to perform the translation.
 
+
<noinclude>
 
----
 
----
<references/>
+
<references/></noinclude>

Revision as of 06:28, 17 August 2008

Important note: Joomla language INI files must be saved as UTF-8 without the Byte Order Mark (BOM)[1].

The format of language definition files is very basic. Blanks lines and lines beginning with “#” are ignored and the latter may be used to add comments to the file. Each line consists of a pair of strings separated by an equals sign like this

KEY=Value

where “KEY” is a string to be translated and “Value” is the translated string. For example

ADDITIONAL INFORMATION=Additional Information

The “KEY” must be in all capitals or the string will not be found. The case of the source string does not matter as strings are folded to upper case before searching takes place. So “additional information”, “Additional Information” or even “AdDiTiOnAl InFoRmAtIoN” will be matched.

The “KEY” may include spaces and other punctuation characters but there should not be any spaces either side of the equals sign as spaces are significant. If more than one entry has the same left-hand side, the last entry in the file is the one to perform the translation.


  1. For more information on Byte Order Mark see http://unicode.org/faq/utf_bom.html#BOM