Mambo Translator v1.0beta (01.05.2005)
======================================
Introduction
============
Mambo Translator supports you in translating files in the Mambo CMS that are not enabled for multi-lingual use.
For example the PHP files used for the Administration interface contain hardcoded messages in English.
To translate the Admin interface you usually just edit the corresponding PHP files directly.
The problem is that you will have to retranslate all files on every update of Mambo.
Here comes the Mambo Translator into play.
Instead of directly editing the PHP files in Mambo you create translation files specifying the original text and the translated text.
Mambo Translator will then search your Mambo installation and search/replaces all found matches.
After a Mambo update you simply rerun Mambo Translator to have your new version translated again.
Installation
============
Simply extract the zip file to your hard disk.
Translation Files
=================
I created some few example translations for the German.
The mambo translator directory contains a sub folder "german" containing all german translation related files.
The file global.txt contains global translations that will be applied on all .php,.htm,.html and .xml files found in your mambo installation.
The specific folder contains translations that will only applied to a certain file in your mambo installation.
For example the translations in the file
german/specific/administrator/modules/mod_fullmenu.php.txt
will be applied to the file
<mambo_install_directory>/administrator/modules/mod_fullmenu.php
You can simply add your on translations by creating similar files (path_in_mambo/filename.txt), there is no additional configuration required.
It is important that your translation file consists of the fullname of the original file plus the ending .txt otherwise mambo translator will ignore it.
Translation File Format
=======================
The lines in the translation files have the following format:
<original string>=<translated string>
Note: Have the equals sign (=) in the string to translate or in the translated string is NOT supported.
When there is a line like
'User Manager'='Benutzerverwaltung'
Mambo Translator will search for the string 'User Manager' including the quote signs.
Lines starting with # are treated as comments and will be ignored.
Running the translator
======================
To apply the german translations to your Mambo installation simply invoke the mambo_translator.cmd as follows:
mambo_translator.cmd <path_to_translation_files> <path_to_mambo>
For example:
mambo_translator.cmd "german" "D:\apps\apache\htdocs\mambocms"
File Listing
============
+ german -> folder containing example german translation files
- mambo_translator.cmd -> the "main" program. don't call it directly
- mambo_translator.sed -> used by ssed to convert the translation files to search and replace commands that ssed understands
- readme.txt -> this file
- ssed.exe -> the program that performs search and replaces in a single file
- translate2german.cmd -> call this to use the german translation files
Technology
==========
Mambo Translator requires Windows 2000 or later.
It utilizes ssed 3.62 (
http://sed.sourceforge.net/grabbag/ssed/) for search and replace.
Cheers,
sebthom
Mambo Translator 1.0 beta 
Linear Mode
