aus dem DMXControl-Wiki

DMXControl 2.9 Sprachfile-Generierung Erstellung von Sprachfiles für DMXControl

www.dmxcontrol.de

Dieses Handbuch entspricht dem Wiki-Stand vom Mai 2012. Anregungen und Ergänzungen bitte direkt über das DMXControl-Wiki (http://www.dmxcontrol.de/wiki/) oder an info@dmxcontrol.de.

Copyright 2012 DMXControl

Voraussetzungen

DMXControl verwendet 2 Arten von Input-Sprachfiles:

• <Sprache>.lng.forms

Hier werden alle statischen Beschriftungen (z.B. von Buttons) gespeichert.

• <Sprache>.lng.variables

Hier werden die dynamischen Textausgaben von DMXControl wie Fehlermeldungen, Abfragen etc. gespeichert.

Beide Files verwenden eine ähnliche Syntax. Auf der linken Seite steht der deutsche Begriff oder der VB6-Bezeichner als Index, nach dem Gleichheitszeichen folgt dann der übersetzte String. Jeder Begriff muss in einer neuen Zeile definiert werden. Die Forms-Datei verwendet zusätzlich Abschnitte mit den jeweiligen Formnamen in eckigen Klammern.

Aus diesen beiden Files und einer Informationsdatei zur Sprache (angezeigter Name, Autor usw.) wird für neue Releases eine Windows-Ressourcendatei generiert. Dazu ist es erforderlich, die VB6-Enterprise Edition zu verwenden, da mit der einfachen Runtime-Version keine ausführbaren Dateien oder DLLs erzeugt werden können. Zum Übersetzen in eine neue Sprache oder für kleine Änderungen kann DMXControl die Übersetzungen auch direkt aus der Textdatei lesen. Eine vorhandene Textdatei ersetzt dabei die in der Ressourcendatei gespeicherte Version.

Erstellung des Sprachfiles

Die Erstellung der endgültigen Sprachressource-Datei erfolgt über ein separates VB6-Projekt.

Im einem Arbeitsverzeichnis "Languages" gibt es das Unterverzeichnis "LangDev", in dem die Ergebnisse der Sprachfile-Generierung abgelegt werden. Dieses Verzeichnis hat wiederum Unterverzeichnisse für jede Sprache. Darin befindet sich auch ein entsprechendes VB-Projektfile für diese Sprache, welches zu laden ist.

Zuerst muss man in der VB6-IDE unter Add-Ins -> Addin-Manager den ResourceEditor aktivieren. Dazu am besten bei "VB6 ResourceEditor" die Option "Load on Startup" einstellen. Daraufhin erscheint ein grünes Symbol in der Werkzeugleiste.

Jede Änderung in den Input-Sprachfiles muss im Resourceeditor bekannt gemacht werden, indem unter dem Zweig "CUSTOMS" das Forms- und/oder das Variables-File gelöscht werden und neu hinzugenommen werden. Löschen kann mit dem Kontextmenü erfolgen, für das Hinzufügen gibt es ein Symbol in der Werkzeugleiste des Resourceeditors. Beim Hinzufügen lässt man den Dateityp auf "customs" stehen. Das ausgewählte File bekommt erstmal einen Standardnamen "101", daher muss man mit dem Kontextmenü "Properties" die Eigenschaften ändern:

Beim Forms-File gibt man als ID FORMS.LANG an, beim Variablen-File ist die ID VARIABLES.LANG

Schließlich sollte noch die "Language" korrekt gewählt werden.

Nun kann das Resourcefile gespeichert werden (Symbol Speichern) und der Resourceeditor geschlossen werden. Im nächsten Schritt geht man in die VB6-Umgebung zurück. Unter File gibt es den Menüpunkt "Make <Sprache>.lng", der nun auszuführen ist. Dabei wird der Dateiname abgefragt, bitte <Sprache>.lng eingeben, z.B. Chinese.lng

Eventuell muss das generierte File trotzdem noch mal umbenannt werden, falls es automatisch die Erweiterung "dll" bekommen hat.

Installation

Die generierte Datei <Sprache>.lng (eventuell noch mal die Zeit überprüfen, damit man kein altes File installiert) muss nun in das Installationsverzeichnis von DMXControl (Unterverzeichnis "Languages") kopiert werden, z.B.

C:\Programme\DMXControl\Languages

Im Menüpunkt Konfiguration muss nun die neue Sprache nach einem Neustart von DMXControl automatisch erscheinen.

Bei Fragen bitte an frank.burghardt@dmxcontrol.de wenden.