diff --git a/doc/de/weechat_scripting.de.txt b/doc/de/weechat_scripting.de.txt index 9cf59990f..0ac0428ca 100644 --- a/doc/de/weechat_scripting.de.txt +++ b/doc/de/weechat_scripting.de.txt @@ -22,17 +22,17 @@ ruby, lua und tcl. [NOTE] Beinahe alle Beispiele in dieser Dokumentation beziehen sich auf Python. -Allerdings ist dieser API für andere Skriptsprachen identisch. +Allerdings ist die API für alle Skriptsprachen nahezu identisch. [[scripts_in_weechat]] -Scripten in WeeChat +Skripten in WeeChat ------------------- [[languages_specifities]] Besonderheiten der einzelnen Skriptsprachen ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Es existieren einige Besonderheiten in jeder Skriptsprache: +Es existieren einige Besonderheiten für jede Skriptsprache: * perl: ** Funktionen werden im Format `weechat::xxx(arg1, arg2, ...);` ausgeführt @@ -54,7 +54,7 @@ Die "Register" Funktion Jedes WeeChat Skript muss sich bei WeeChat "registrieren". Die "register" Funktion muss deshalb der erste WeeChat Befehl sein der durch das Skript genutzt wird. -Prototype: +Prototyp: [source,python] ---------------------------------------- @@ -67,7 +67,7 @@ Argumente: * 'author': Name des Authors (String) * 'version': Version des Skripts (String) * 'license': Lizenz für das Skripts (String) -* 'description': string, short description of script +* 'description': kurze Beschreibung des Skripts (String) * 'shutdown_function': Name der Funktion die beim Beenden des Skripts aufgerufen werden soll (String) * 'charset': Skript Zeichensatz (optional, liegt das Skript im UTF-8 Format vor kann dieser Wert leer bleiben. UTF-8 ist der Standardzeichensatz) (String) @@ -134,7 +134,7 @@ genutzt werden soll: /tcl load tcl/skript.tcl ---------------------------------------- -Um Skripten automatisch beim Start von WeeChat zu laden kann mal einen Link +Um Skripten automatisch beim Start von WeeChat zu laden kann man einen Link in das Verzeichnis 'Skriptsprache/autoload' setzen. Ein Beispiel für ein Python-Skript: @@ -148,7 +148,7 @@ $ ln -s ../script.py Unterschiede zur C API ---------------------- -Die Skripten API ist nahezu identisch mit der C Erweiterung API. +Die Skripten API ist nahezu identisch mit der API der C Erweiterung. Um einen Überblick über alle API Funktionen (Prototyp, Argumente, Rückgabe werte, Beispiele) zu erhalten werfen Sie einen Blick in die 'WeeChat Plugin API Reference'. @@ -179,19 +179,19 @@ WeeChat core -------> python Erweiterung (python.so) -------> test.py Pointer ~~~~~~~ -Wie Sie vermutlich wissen existieren in Skripten keine "Pointer". Wird nun -von der API Funktion ein Pointer als Rückgabewert an das Skript weitergereicht -wird der Pointer in einen String konvertiert. +Wie Sie vermutlich wissen existieren in Skripten keine "Pointer". Sendet nun +die API Funktion einen Pointer als Rückgabewert an das Skript, dann wird der +Pointer in einen String konvertiert. -Beispiel: Wenn eine Funktion den Pointer 0x1234ab56 zurück gibt erhält das +Beispiel: Falls eine Funktion den Pointer 0x1234ab56 zurück gibt erhält das Skript einen String in der Form "0x1234ab56". -Erwartet die API Funktionen einen Pointer als Argument muss das Skript diesen +Erwartet die API Funktion als Argument einen Pointer, dann muss das Skript diesen Pointer als String übergeben. Die C Erweiterung konvertiert den String in einen echten Pointer bevor die C API Funktion ausgeführt wird. -Ein leerer String oder "0x0" sind erlaubt. Beides wird in C als NULL interpretiert. -Beispiel: Um Daten im Core Buffer (WeeChat Hauptbuffer) auszugeben: +Ein leerer String oder "0x0" sind hierbei erlaubt. Beides wird in C als NULL interpretiert. +Im folgenden ein Beispiel um Daten im Core Buffer (WeeChat Hauptbuffer) auszugeben: [source,python] ---------------------------------------- @@ -200,16 +200,16 @@ weechat.prnt("", "Hi!") [WARNING] Aus Gründen der Geschwindigkeit wird in vielen Funktionen darauf verzichtet -die Pointer auf Korrektheit zu überprüfen. Es obliegt Ihrer Verantwortung -einen gültigen Pointer zu übergeben. Sollte Sie dies nicht beachten werden +die Pointer auf ihre Korrektheit zu überprüfen. Es obliegt Ihrer Verantwortung +einen gültigen Pointer zu übergeben. Sollten Sie dies nicht beachten dann werden Sie mit einem netten Crash-Report belohnt ;) [[callbacks]] Callbacks ~~~~~~~~~ -Beinahe alle WeeChat Callbacks müssen WEECHAT_RC_OK oder WEECHAT_RC_ERROR -zurück geben. Eine Ausnahme bildet das modifier Callback, hier wird ein +Beinahe alle WeeChat Callbacks müssen entweder WEECHAT_RC_OK oder WEECHAT_RC_ERROR als +Ergebnis zurück liefern. Eine Ausnahme bildet das modifier Callback, hier wird ein String als Rückgabewert erwartet. C Callbacks nutzen ein "Data" Argument welches ein Pointer ist. In der @@ -361,8 +361,8 @@ Nachrichten anzeigen ^^^^^^^^^^^^^^^^^^^^ Eine leere Zeichenkette wird häufig verwendet um den WeeChat Core Buffer zu nutzen. -Soll ein anderer Buffer genutzt werden dann muss der Pointer dieses Buffers verwendet -werden (Übergabe als String, siehe <>). +Möchten Sie einen anderen Buffer nutzen dann muss der Pointer dieses Buffers verwendet +werden (Übergabe als String, siehe <>). Beispiele: @@ -371,7 +371,7 @@ Beispiele: # Gibt den Text "Hallo" im Core Buffer aus weechat.prnt("", "Hallo") -# Gibt den Text "Hallo" im Core Buffer aus, schreibt ihn aber nicht in die Protokolldatei +# Gibt den Text "Hallo" im Core Buffer aus, schreibt diesen aber nicht in die Protokolldatei # (nur Version >= 0.3.3) weechat.prnt_date_tags("", 0, "no_log", "hello") @@ -390,8 +390,8 @@ weechat.prnt("", "Text %sGeld auf Blau" % weechat.color("yellow,blue")) buffer = weechat.buffer_search("irc", "freenode.#weechat") weechat.prnt(buffer, "Nachricht im #weechat Channel") -# die zweite Möglichkeit einen Buffer zu suchen (zu empfehlen) -# (bitte beachten dass der Server- und Channelname durch ein Komma zu trennen sind) +# die zweite Möglichkeit einen Buffer zu suchen (empfohlen!) +# (bitte beachten Sie dass der Server- und Channelname durch ein Komma zu trennen sind) buffer = weechat.info_get("irc_buffer", "freenode,#weechat") weechat.prnt(buffer, "Nachricht im #weechat Channel") ---------------------------------------- @@ -404,8 +404,8 @@ Text in einen Buffer senden ^^^^^^^^^^^^^^^^^^^^^^^^^^^ Sie können einen Text oder einen Befehl zu einem Buffer senden. Dies entspricht exakt dem -Verhalten wenn Sie einen Text oder ein Befehl in der Befehlszeile eingeben und die [Enter] -Taste drücken. +Verhalten als ob Sie einen Text oder einen Befehl in der Befehlszeile eingeben und diesen +mit der [Enter] Taste bestätigen. Beispiele: @@ -414,7 +414,7 @@ Beispiele: # führt den Befehl "/help" im Core Buffer aus weechat.command("", "/help") -# sendet den Text "Hallo" in den #weechat IRC Channel (die Teilnehmer des Channels sehen diese Nachricht) +# sendet den Text "Hallo" in den IRC Channel #weechat (die Teilnehmer des Channels sehen diese Nachricht) buffer = weechat.info_get("irc_buffer", "freenode,#weechat") weechat.command(buffer, "Hallo") ---------------------------------------- @@ -425,10 +425,10 @@ neuen Buffer öffnen Sie können aus Ihrem Skript einen neuen Buffer öffnen um dort Nachrichten auszugeben. -Zwei Callbacks können aufgerufen werden (diese sind optional): der erste dient dazu -eine Routine aufzurufen wenn ein Text eingegeben und mit [Enter] bestätigt wird. Der -zweite ruft eine Routine auf die beim Schließen des Buffers ausgeführt wird (zum -Beispiel wenn `/buffer close` genutzt wurde). +Zwei Callbacks können aufgerufen werden (diese sind optional): der erste Callback dient dazu +eine Routine aufzurufen sobald ein Text eingegeben und mit [Enter] bestätigt wird. Der zweite +Callback ruft eine Routine auf die beim Schließen des Buffers ausgeführt wird (zum Beispiel +wenn `/buffer close` genutzt wurde). Beispiele: @@ -450,7 +450,7 @@ buffer = weechat.buffer_new("Mein_Buffer", "buffer_input_cb", "", "buffer_close_ # Überschrift für Buffer bestimmen weechat.buffer_set(buffer, "Titel", "Dies ist die Überschrift für meinen Buffer") -# deaktiviert die Protokollierung, dazu wird die lokale Variable "no_log" auf "1" gesetzt +# deaktiviert die Protokollierung. Dazu wird die lokale Variable "no_log" auf "1" gesetzt weechat.buffer_set(buffer, "localvar_set_no_log", "1") ---------------------------------------- @@ -458,7 +458,7 @@ weechat.buffer_set(buffer, "localvar_set_no_log", "1") Eigenschaften von Buffern ^^^^^^^^^^^^^^^^^^^^^^^^^ -Die Eigenschaften von Buffern können in Form eines Strings, Integer oder als Pointer +Die verschiedenen Eigenschaften von Buffern können in Form eines Strings, Integer oder als Pointer vorliegen und gelesen werden. Beispiele: @@ -505,7 +505,7 @@ neuen Befehl hinzufügen Erstellt mittels `hook_command` einen benutzerdefinierten Befehl. Dabei kann eine benutzerdefinierte Vervollständigung der Argumente genutzt werden. -Beispiele: +Beispiel: [source,python] ---------------------------------------- @@ -612,7 +612,7 @@ for option, default_value in skript_optionen.iteritems(): Veränderungen bemerken ^^^^^^^^^^^^^^^^^^^^^^ -Die Funktion `hook_config` wird dazu benutzt um festzustellen wenn ein Anwender +Die Funktion `hook_config` wird dazu benutzt um festzustellen falls ein Anwender eine Option des Skripts verändert hat. Beispiele: