Creating a language definition file - Revision history

Wilsonge at 11:20, 29 April 2013

2013-04-29T11:20:05Z

Mvangeest: Adjusted category

2011-01-16T15:13:54Z

Adjusted category

Batch1211 at 12:51, 20 September 2010

2010-09-20T12:51:09Z

Akede at 19:27, 22 November 2009

2009-11-22T19:27:00Z

Akede at 09:58, 19 November 2009

2009-11-19T09:58:40Z

Chris Davenport: Added note about including double-quote characters in language strings.

2009-09-09T23:02:01Z

Added note about including double-quote characters in language strings.

Chris Davenport: Added to some relevant categories.

2009-01-10T17:07:36Z

Added to some relevant categories.

Chris Davenport: Minor amendment to wording.

2008-08-26T21:06:34Z

Minor amendment to wording.

Chris Davenport: Omit references when transcluded.

2008-08-17T11:28:39Z

Omit references when transcluded.

Chris Davenport: New page: Important note: Joomla language INI files must be saved as UTF-8 without the Byte Order Mark (BOM)For more information on Byte Order Mark see [http://unicode.org/faq/utf_b...

2008-08-17T10:34:39Z

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...

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_bom.html#BOM http://unicode.org/faq/utf_bom.html#BOM]</ref>.

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.

----
<references/>

@@ Line 1: / Line 1: @@
 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_bom.html#BOM http://unicode.org/faq/utf_bom.html#BOM]</ref>.
@@ Line 15: / Line 16: @@
 The "''VALUE''" cannot include double-quote characters (").  To get a double-quote character you must use the HTML special character sequence "&amp;quot;" instead.  Single-quote characters (') are valid.
-More information about the discussed changed for Joomla 1.6 can be found on the page [[Specification of language files]] {{JVer|1.6}}
+More information about the discussed changed for the Joomla 2.5 and 3.x series can be found on the page [[Specification of language files]] {{JVer|2.5}} {{JVer|3.x}}
 <noinclude>
 ----
 <references/>[[Category:Tutorials]][[Category:Language Development]]</noinclude>

@@ Line 14: / Line 14: @@
 The "''VALUE''" cannot include double-quote characters (").  To get a double-quote character you must use the HTML special character sequence "&amp;quot;" instead.  Single-quote characters (') are valid.
 <noinclude>
 ----
-<references/>[[Category:Languages]]</noinclude>
+<references/>[[Category:Tutorials]][[Category:Language Development]]</noinclude>
-More information about the discussed changed for Joomla 1.6 can be found on the page [[Specification of language files]] {{JVer|1.6}}
-−
 [[Category:Tutorials]][[Category:Language Development]]

← Older revision		Revision as of 12:51, 20 September 2010
Line 18:		Line 18:
	<references/>[[Category:Languages]]</noinclude>		<references/>[[Category:Languages]]</noinclude>
	More information about the discussed changed for Joomla 1.6 can be found on the page [[Specification of language files]] {{JVer\|1.6}}		More information about the discussed changed for Joomla 1.6 can be found on the page [[Specification of language files]] {{JVer\|1.6}}
		+
		+	[[Category:Tutorials]][[Category:Language Development]]

@@ Line 17: / Line 17: @@
 ----
 <references/>[[Category:Languages]]</noinclude>
-More information about the discussed changed for Joomla 1.6 can be found on the page [[1.6: Specification of language files]]
+More information about the discussed changed for Joomla 1.6 can be found on the page [[Specification of language files]] {{JVer|1.6}}

← Older revision		Revision as of 09:58, 19 November 2009
Line 17:		Line 17:
	----		----
	<references/>[[Category:Languages]]</noinclude>		<references/>[[Category:Languages]]</noinclude>
		+	More information about the discussed changed for Joomla 1.6 can be found on the page [[1.6: Specification of language files]]

@@ Line 11: / Line 11: @@
 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.
+The “''KEY''” can 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 one to be encountered is the one that will be used.
 <noinclude>
 ----
 <references/></noinclude>