Verwendung von ltext2id

Das Befehlszeilentool „ ltext2id “ konvertiert ein Projekt, das textbasierte Übersetzungen verwendet, in ein Projekt mit ID-basierten Übersetzungen. Es durchsucht die Projektstruktur, aktualisiert den Quellcode so, dass die ID-basierten Übersetzungs-APIs aufgerufen werden, und passt die zugehörigen „ TS “-Dateien entsprechend an. Bei fehlgeschlagenen Konvertierungen wird der Quellcode an den betroffenen Stellen mit „ //ltext2id error: “ versehen.

Um optimale Ergebnisse zu erzielen, sollten Sie sowohl die Quelldateien als auch die „ TS “-Dateien in das Projektstammverzeichnis aufnehmen, das Sie dem Tool übergeben, damit die Aktualisierungen zwischen Code und Übersetzungen konsistent bleiben.

ltext2id-Syntax

ltext2id [options] [project-root]

Dabei gilt:

• options steht für eine oder mehrere ltext2id-Optionen.
• project-root ist das Verzeichnis, das rekursiv verarbeitet werden soll.

Um die aktuelle Hilfe anzuzeigen, geben Sie Folgendes ein:

ltext2id -help

ltext2id Optionen

Beispiele

Ein Projekt in ID-basierte Übersetzungen konvertieren

Führen Sie das Tool im Projektstammverzeichnis aus. Die Quellcode- und „ TS “-Dateien in diesem Verzeichnis werden an Ort und Stelle aktualisiert.

ltext2id path/to/project

Nur ID-Vorschläge generieren (keine Codeänderungen)

Verwenden Sie „ -only-meta-id “, um Meta-String-ID-Vorschläge einzufügen, ohne die Aufrufe der ID-basierten API umzuschreiben. Dadurch werden die Übersetzungsaufrufe mit dem Meta-String „//~ meta-id <id>“ (cpp) versehen, der die vorgeschlagenen IDs (Meta-IDs) angibt.

ltext2id -only-meta-id path/to/project

Deaktivieren der Label-Generierung

Verhindern Sie die Label-Generierung, wenn Sie nicht möchten, dass Kontexte in Qt Linguist als Labels gespiegelt werden:

ltext2id -no-labels path/to/project

Automatisch generierte IDs vermeiden

Überspringen Sie die automatische Generierung für Aufrufe, denen Meta-IDs fehlen, d. h. IDs, die bereits über den Meta-String „//~ meta-id <id>“ (cpp) angegeben wurden:

ltext2id -no-auto-id path/to/project

Arbeiten Sie mit UTF-16-Quelldateien

Wenn Ihre Quelldateien UTF-16-kodiert sind, aktivieren Sie die Option:

ltext2id -source-utf16 path/to/project

Beendigungsstatus

ltext2id gibt bei einem Fehler einen Beendigungscode ungleich Null zurück (beispielsweise, wenn bei der Umwandlung von Dateien ein nicht behebbarer Fehler auftritt). Überprüfen Sie die mit „ //ltext2id error: “ gekennzeichneten Anmerkungen in den Quelldateien, um die verbleibenden Probleme zu beheben.