Soll eine neue Sprache einer ASP-Anwendundung hinzugefügt werden, muss als Erstes eine neue Sprach-Datei für diese Sprache erstellt werden:
Jetzt werden alle Sourcefiles ihrer ASP-Anwendung im aktuellen und in den Unter-Verzeichnissen eingelesen und alle Funktionsaufrufe von xMsg herausgesucht. Die Strings dieser Aufrufe werden in die Vorlagen-Datei lang/xlang.txt geschrieben.
Danach wird für die neue Sprache unter dem Verzeichnis lang ein neues Verzeichnis mit dem angegebenen Namen (z.B. lang/de/) angelegt. In dieses Verzeichnis wird eine Kopie der Vorlage abgelegt:
lang/de/xlang.txt
In dieser Kopie müssen nun die Texte mit einem beliebigen Editor übersetzt werden, indem diese in die Zeilen mit Txt = ? eingegeben werden.
Nachdem Änderungen an ihrer ASP-Anwendung vorgenommen wurden, müssen die Sprach-Dateien entsprechend nachgeführt werden. Dies wird wiederum vom Tool xlang.asp unterstützt. Klicken sie im Tool unter Update Message Files auf die gleichnamige Schaltfläche.
Jetzt werden erneut sämtliche Sourcefiles nach xMsg-Aufrufen gescannt, die Vorlagen-Datei daraus neu erstellt und die Änderungen werden in sämtliche bestehenden Sprach-Dateien eingefügt. Neu gefundene Texte sind durch Txt = ? gekennzeichnet. Texte, die nicht mehr in den Sourcen vorkommen, sind mit Src = ? gekennzeichnet und können gelöscht werden.
Danach müssen die Sprachdateien noch wie nachfolgend beschrieben ins binäre Format konvertiert werden.
Zur ASP-Anwendung wird eine Sprach-Datei mit der Funktion Lang.SetLanguage im Binärformat geladen. Die Sprach-Dateien mit den Übersetzungen im Text-Format müssen also noch entsprechend kompiliert werden:
Starten sie dazu das Tool xlang.asp und klicken sie unter Compile Message Files auf die gleichnamige Schaltfläche.