=======================================================

Internationalization Guide For 1-2-All
 
=======================================================


1) Introduction

	1-2-All 4.50 introduces a new internationalization/translation scheme
	that should make it easier for you to translate your 1-2-All
	installation into a different language.
	
	Language files are now stored in the "/lang" directory with the naming
	convention "lang.language.txt".  These files are plain text files with one
	string definition per line with the format: 
	
	"Original string" = "Translated String"
	
	The supplied lang.english.txt is a complete listing of all of the strings used
	throughout 1-2-All with empty translated strings.
	
	1-2-All's translation functions will ignore empty and missing
	translations.  For example, if a template uses the string "Hello World", and 
	in your language file you have:
	
	"Hello World" = ""
	
	1-2-All will display "Hello World" (and not an empty string).  Likewise,
	if your language file has no entry for the string "Hello World", 1-2-All
	will still display "Hello World".

2) Creating New Translations

	Creating a new translation is as simple as copying the default 
	lang.english.txt to a new file named, for example, lang.mylang.txt.
	After you have copied the file, open lang.mylang.txt in your favorite
	plain text editor and simply supply the translations on the right hand
	side for every string.
	
	Remember, you aren't required to provide translations for every string; 
	1-2-All will still display the original English for strings that you
	don't translate.
	
	
3) Modifying Existing (English) Translations

	To modify a translation, you simply have to put your strings on the right
	side of a equal sign (=). Original strings (on the left) have to match strings
	found in templates. So, for example, if you wish to call a Department "Category",
	locate that word in language file and trnaslate it with a different word.
	
	Change:
	"Department" = ""
	
	To:
	"Department" = "Category"
	
4) A Note About Language Files and Templates

	1-2-All 4.50 introduces completely customizeable templates for the 
	public and admin sections of your site. If you create new templates, keep in mind
	that you don't have to use the translation capabilities of 1-2-All, 
	you can create your templates in any language you would like.  However, if you
	are only modifying the existing templates or creating a new template based off
	existing ones, using the translation files is the quickest way to translate the
	existing strings used throughout the site.