übersetze einen Text in die Sprache des verwendeten InDesigns.

übersetze einen Text in die Sprache des verwendeten InDesigns.

Die Sprache des von Ihnen verwendeten InDesign® wird beim Programmstart ermittelt. Folgende Sprachversionen von InDesign® werden unterstützt:

• enEN : Englisch
• deDE : Deutsch
• frFR : Französisch
• jaJP : Japanisch

Die Übersetzungen von translate dienen vor allem der Unterstützung der InDesign-UI wie den Namen von Menüs, eigenen Dialogen oder den Beschreibungen von Gestaltungsregeln. Für Übersetzungen von Dokumentinhalten kann die Funktion text::translate verwendet werden, die mit Hilfe sogenannter Künstlicher Intelligenz ziemlich gute Ergebnisse liefert.

Zur Übersetzung werden vorbereitete Schlüssel (=Text) : Wert (=Übersetzung) - Zuordnungen verwendet. Dabei werden jeweils nur die Defintionen der aktuellen InDesign-Sprache durchsucht. Übersetzungen werden - in dieser Reihenfolge - an diesen Stellen gesucht:

1. Datenpool
2. Ordner der priint:comet Plugins
3. Integrierte Übersetzungen der priint:comet Plugins

Für jede Sprache, die Sie unterstützen wollen, muß eine Datei namens message_<sprachcode>.xml angelegt werden. Für XML-Datenpools legen Sie diese Datei direkt in den XML-Ordner. Von SOAP-Verbindungen muß die Datei mit der gleichnamigen fieldId ausgeliefert werden. Das folgende Beispiel beschreibt die Syntax der XML-Datei:

<?xml version="1.0" encoding="utf-8"?>
<messages>
  <!-- einfachster Fall: key ohne Platzhalter, translation ohne Platzhalter -->
  <message>
    <key>HELLO_WORLD</key>
    <translation>Hallo Welt!</translation>
  </message>

  <!--
    translation und key können Format-Markierungen wie %d, %s usw. enthalten (sinnvollerweise dieselben,
    damit Eingabeparameter auch dann eingesetzt werden können, wenn keine
    übersetzung für einen key gefunden wird)
  -->
  <message>
    <key>SPRINTF_STR_INT_DOUBLE %s %d %1,2f</key>
    <translation>Formatierte Ausgabe "%s" int: "%d" double: %1,2f</translation>
  </message>
  <!-- etc. -->

</messages>

Erforderlich ist eine Tabelle nach folgendem Schema (MySQL-Dump):

CREATE TABLE messages 
( 
    id INT(11) NOT NULL auto_increment,
    `key` varchar(250) NOT NULL DEFAULT '',
    language varchar(4) NOT NULL DEFAULT '',
    translation text NOT NULL DEFAULT '',
    PRIMARY KEY (id),
    UNIQUE INDEX key_language (`key`, language)
);

Von der Datenverbindung unabhängige Übersetzungen können im Ordner der priint:comet Plugins unter den Namen message_<sprachcode>.xml installiert werden. Die Dateien haben das gleiche Format wie die message_<sprachcode>.xmls der XML-Offline-Ordner und werden zum Programmstart und bei jedem Wechsel des Datenpools gelesen.

Fest eingebaut und in jeder InDesign® Sprachversion verfügbar ist die folgende Liste der deutschen (deDE) übersetzungen.

Fest eingebaut und in jeder InDesign® Sprachversion verfügbar ist die folgende Liste der englischen (enEN) übersetzungen.

Fest eingebaut und in jeder InDesign® Sprachversion verfügbar ist die folgende Liste der französischen (frFR) übersetzungen.

Fest eingebaut und in jeder InDesign® Sprachversion verfügbar ist die folgende Liste der japanischen (jaJP) übersetzungen.

Die übersetzungen werden beim Login oder Setzen des Datenordners gelesen (auch die übersetzungen, die im Comet-Plugins-Ordner liegen). Wenn Sie Änderungen an diesen Daten machen, werden sie erst nach dem nächsten Login/Setzen des Datenordners wirksam.

Mit der zweiten Version des Befehles können Sie Strings ohne Formatangaben (%d, %s, %f) übersetzen und rückübersetzen. Der erste Parameter dient dabei lediglich der Unterscheidung der Aufrufe und muss immer 0 sein! Ist der dritte Parameter ungleich 0, wird eine Rückübersetzung gemacht, d.h. Sie erhalten zu einer übersetzung deren Schlüssel. Diese Möglichkeit wird dann gebraucht, wenn Sie Benutzereingaben, die ja in der Landessprache gemacht werden sollen, auwerten wollen. Sie haben beispielsweise den Schlüssel "Links" mit der übersetzung "left". Gibt ein Benutzer in einem Dialog das Wort "left" an, müssen Sie im Skript den zugehörigen Schlüssel finden können.

Name	Typ	Default	Beschreibung
Return	char*		übersetzung des Texts ggfs. mit den für Markierungen eingesetzten übergebenen Werten. Der Ergebnisstring darf nur zum Lesen verwendet werden, in selbst reservierten Speicher kopiert oder dupliziert werden. Er wird nach einem erneuten Aufruf der Funktion überschrieben.
formatStr	char*	-	Nachricht. Die Nachricht darf Format-Tags enthalten, mehr dazu dazu siehe hier. Für jeden %-Marker wird (in der richtigen Reihenfolge und vom richtigen Datentyp) eine weitere Eingabevariable erwartet.
...	abhängig von den Markierungen	-	Werte oder Variablen gemäß den %-Tags im Formatstring
Unformatierter String
p	int	-	Muss immer 0 sein. Variable zur Unterscheidung der Aufrufe.
char*	keyOrVal	-	Schlüssel oder übersetzung, dessen/deren übersetzung/Schlüssel gefunden werden soll. Schlüssel werden case insensitive ausgewertet
findKey	int	0	0 : Suche die übersetzung zu keyOrVal. 1 : Suche den Schlüssel zu keyOrVal. Ist ein Wert mehrfach definiert, wird der erste gefundene Schlüssel zurückgegeben. Wurde einer der Standardwerte (siehe oben) mit einem weiteren Schlüssel definiert, wird der erste gefundene Standardschlüssel zurückgegeben. (Dieses Verhalten ist nötig, um die richtige Parameterauswertung der Gestaltungs-, Layout- und Tabellenregeln zu gewährleisten.)

Verschiedene Möglichkeiten, die übersetzung bzw. den Schlüssel zu einem String zu bekommen. Der vierte Aufruf sucht den Schlüssel. Achten Sie darauf, wenn Sie hier ein einfaches showmessage (ohne %s) verwenden, erhalten Sie wider die übersetzung, weil showmessage automatisch übersetzt. Folgende übersetzung muss verfügbar sein :

<message>
    <key>deutsches <0x00F6></key>
    <translation>german <0x00F6></translation>
</message>

int main ()
{
    showmessage (translate ("deutsches ö"));
    showmessage (translate (0, "deutsches ö"));
    showmessage (translate (0, "deutsches ö", 0));
    showmessage (translate (0, "german ö", 1));

    return 0;
}

Seit

P/R32, März 2006

Verfügbarkeit

priint:comet InDesign® Plug-Ins, comet_pdf

Siehe auch

comet.translate

Alphabetic index HTML hierarchy of classes or Java