Das Handbuch zu Kate - KDE Documentation

6.4.3.2 Globale Funktionen
Das Handbuch zu Kate
Dieser Abschnitt listet alle globalen Funktionen auf.
6.4.3.2.1 Lesen & Einfügen von Dateien
String read(String datei);
Sucht nach der angegebenen datei relativ zum Ordner katepart/script/files und gibt
den Inhalt der Datei als String zurück.
void require(String datei);
Sucht die angegebene datei relativ zum Ordner katepart/script/libraries und wertet
sie aus. require verhindert intern, dass die gleiche datei mehrfach eingeschlossen wird.
6.4.3.2.2 Fehlersuche
void debug(String text);
Gibt den text auf der Standardausgabe stdout in der Konsole aus, von der das Programm
gestartet wurde.
6.4.3.2.3 Übersetzung
Die Lokalisierung wird durch einige Funktionen zum Übersetzen von Zeichenketten in Skripten
unterstützt, so durch i18n, i18nc, i18np und i18ncp. Diese Funktionen arbeiten genau wie auf
der Seite KDE’s Übersetzungsfunktionen beschrieben.
Die Übersetzungsfunktionen übersetzen die eingepackten Zeichenketten durch KDE’s Übersetzungssystem
in die Sprache, die in der Anwendung benutzt wird. Zeichenketten in Skripten,
die in den offiziellen Kate-Quellen entwickelt werden, werden automatisch extrahiert und sind
übersetzbar. Anders gesagt, müssen Sie sich als Entwickler von Kate nicht um das Extrahieren
und Übersetzen kümmern. Allerdings müssen Sie für Skripte, die von Anderen ausserhalb von
KDE entwickelt werden, diese Arbeiten selbst tun. Zusammen mit den von Ihnen entwickelten
Skripten müssen Sie auch den Übersetzungskatalog verteilen, der alle übersetzten Zeichenketten
enthält. Ausserdem muss der Kopf Ihres Skriptes explizit im Parameter i18n-catalog angeben,
welcher Katalog geladen werden muss.
void i18n(String text, arg1, ...);
Übersetzt text in die von der Anwendung benutzte Sprache. Die Argumente arg1, ..., sind
optional und werden benutzt, um die Platzhalter %1, %2 usw. zu ersetzen.
void i18nc(String context, String text, arg1, ...);
Übersetzt text in die von der Anwendung benutzte Sprache. Zusätzlich ist die Zeichenkette
context sichtbar, so dass Übersetzer bessere Übersetzungen anfertigen können. Die
Argumente arg1, ..., sind optional und werden benutzt, um die Platzhalter %1, %2 usw. zu
ersetzen.
void i18np(String singular, String plural, int number, arg1, ...);
Übersetzt entweder singular oder plural in die von der Anwendung benutzte Sprache.
Dies ist abhängig von der angegebenen number. Die Argumente arg1, ..., sind optional und
werden benutzt, um die Platzhalter %1, %2 usw. zu ersetzen.
71