diff options
| -rw-r--r-- | doc/de/weechat_faq.de.adoc | 2 | ||||
| -rw-r--r-- | doc/de/weechat_quickstart.de.adoc | 192 |
2 files changed, 113 insertions, 81 deletions
diff --git a/doc/de/weechat_faq.de.adoc b/doc/de/weechat_faq.de.adoc index aa60166b2..9057123a2 100644 --- a/doc/de/weechat_faq.de.adoc +++ b/doc/de/weechat_faq.de.adoc @@ -808,7 +808,7 @@ von der "irc"-Erweiterung gelöscht. Es gibt somit keine Möglichkeit, diese Nachrichten rückwirkend anzuzeigen, auch dann nicht, wenn die Ignorierung wieder entfernt wird. -Der Befehl `/filter` ist im WeeChat core angsiedelt +Der Befehl `/filter` ist im WeeChat core angesiedelt und beeinflusst die Darstellung der Inhalte aller Buffer. Dieser Befehl eröffnet die Möglichkeit, bestimmte Zeilen in Buffern mittels Tags diff --git a/doc/de/weechat_quickstart.de.adoc b/doc/de/weechat_quickstart.de.adoc index b2013d46b..5dfd8c8a2 100644 --- a/doc/de/weechat_quickstart.de.adoc +++ b/doc/de/weechat_quickstart.de.adoc @@ -22,7 +22,7 @@ Die bevorzugte Terminal-Emulation für X (aber nicht obligatorisch) ist rxvt-unicode: rxvt verfügt über eine gute UTF-8 Unterstützung und hat keine Probleme mit der Standard Tastaturbelegung. -Programmstart aus Deiner shell: +Programmstart aus deiner Shell: ---- $ weechat @@ -64,7 +64,7 @@ Um Optionen zu setzen benutzt man: ---- WeeChat verwendet umgehend einen neu eingestellten Wert (WeeChat muss also zu *keinem* Zeitpunkt -neu gestartet werden, nach dem die Konfiguration verändert wurde). +neu gestartet werden, nachdem die Konfiguration verändert wurde). Beim Beenden von WeeChat werden alle Einstellungen gespeichert (mittels des Befehls `/save` kann das Sichern der Optionen manuell durchgeführt werden). @@ -102,14 +102,16 @@ Um weitere Informationen zum `/fset` Befehl und seine Tastenbefehle zu behalten, siehe `/help fset`. [[core_vs_plugins]] -== Kern (Core) vs Erweiterungen +== Kern (Core) vs. Erweiterungen -Der Kern (core) von WeeChat dient ausschließlich dazu um Daten auf dem Bildschirm -auszugeben und um mit dem Benutzer zu interagieren. Dies bedeutet das WeeChat, --also der WeeChat core-, ohne jedwede Erweiterung, unbrauchbar ist. -(an die treuen User: IRC war Teil des Kerns in den Versionen ≤ 0.2.6) +Der Kern (core) von WeeChat +dient ausschließlich der Ausgabe von Daten auf dem Bildschirm +und der Interaktion mit dem Benutzer. +WeeChat - also der WeeChat-Kern - ist somit ohne jedwede Erweiterung +eigentlich™ unbrauchbar für die Nutzung als Kommunikationswerkzeug im Internet. +Alle Netzwerkprotokolle (z.B. IRC) werden als separate Erweiterung bereitgestellt. -Alle Netzwerkprotokolle, z.B. IRC, werden als separate Erweiterung bereit gestellt. +(an die treuen User: IRC war Teil des Kerns in den Versionen ≤ 0.2.6) Benutze den Befehl `/plugin` um alle Erweiterungen aufzulisten, "irc" sowie andere Erweiterungen sollten aufgelistet werden. @@ -117,18 +119,19 @@ Erweiterungen sollten aufgelistet werden. [[create_irc_server]] == Einen IRC-Server erstellen -Um eine Verbindung zu einem IRC Server herzustellen wird der +Um eine Verbindung zu einem IRC Server herzustellen, wird der `/server` Befehl verwendet. Beispiel: ---- /server add freenode chat.freenode.net ---- -In dieser Zeile ist `freenode` der interne Servername der von WeeChat genutzt wird: -Damit ist es möglich sich mit dem Server zu verbinden `/connect freenode` und um -die Server relevanten Optionen anzupassen _irc.server.freenode.xxx_. +In diesem Beispiel ist `freenode` der interne, von Weechat genutzte Servername. +Mit dem Befehl `/connect freenode` kann jetzt die Verbindung +zu diesem Freenode-IRC-Server aufgebaut werden. +Alle für den Server relevanten Optionen sind unter _irc.server.freenode.xxx_ zu finden. -Falls noch Fragen offen sein sollten, einfach die Hilfe verwenden: +Verwende die Hilfe, falls noch Fragen offen sind: ---- /help server @@ -139,50 +142,53 @@ Falls noch Fragen offen sein sollten, einfach die Hilfe verwenden: WeeChat verwendet Vorgabewerte für alle Server (so genannte "fall backs"), sofern keine individuellen Werte für die entsprechenden Server-Optionen gesetzt worden sind. -Die Vorgabewerte sind in "irc.server_default.*" hinterlegt. +Die Vorgabewerte sind in den Optionen _irc.server_default.xxx_ hinterlegt. Für jede Server-Option benutzt WeeChat den individuellen Wert - falls einer definiert ist (nicht "null"). Andernfalls verwendet WeeChat die Vorgabewerte -("irc.server_default.xxx"). +(_irc.server_default.xxx_). -Beispielsweise werden Standard Nicks verwendet (basierend auf dem Un*x Login). Um -dies nun für den freenode-Server anzupassen, kann folgender Befehl genutzt werden: +Beispielsweise werden Standard Nicks verwendet (basierend auf dem Un*x Login). +Sollen speziell für den freenode-Server andere Nicks genutzt werden, +können diese mit folgendem Befehl angepasst werden: ---- /set irc.server.freenode.nicks "meinNick,meinNick2,meinNick3,meinNick4,meinNick5" ---- -Um den User- und realen Namen anzupassen: +Benutzernamen und wirklichen Namen (realname) anpassen: ---- -/set irc.server.freenode.username "Mein User-Name" +/set irc.server.freenode.username "Mein Benutzername" /set irc.server.freenode.realname "Mein wirklicher Name" ---- -Um beim Start von WeeChat automatisch eine Verbindung zu einem Server -herzustellen: +Beim Start von WeeChat automatisch die Verbindung zu einem Server herstellen: ---- /set irc.server.freenode.autoconnect on ---- -Um eine SSL Verbindung herzustellen: +Beim Verbindungsaufbau SSL (sichere Verbindung) nutzen: ---- /set irc.server.freenode.addresses "chat.freenode.net/7000" /set irc.server.freenode.ssl on ---- -Sollte der Server SASL unterstützen, kann man sich damit automatisch Authentifizieren -(dadurch identifiziert man sich beim Server, bevor man Channels (Chaträume) betritt): +Wenn der Server SASL unterstützt, +kann die Authentifizierung des Benutzers schon beim Aufbau der IRC-Session stattfinden. +Der Benutzer wird auf diese Weise gegenüber dem IRC-Server identifiziert, +noch bevor Server-Befehle übermittelt oder Cannels (Chaträume) betreten werden können. ---- /set irc.server.freenode.sasl_username "mynick" /set irc.server.freenode.sasl_password "xxxxxxx" ---- -Unterstützt der Server keine SASL Authentifizierung, muss man sich bei "nickserv" -identifizieren: +Wenn der Server keine SASL-Authentifizierung unterstützt, +muss der Benutzer sich nach dem Verbindungsaufbau bei "nickserv" identifizieren. +Der dafür notwendige IRC-Server-Befehl kann auch automatisch übermittelt werden: ---- /set irc.server.freenode.command "/msg nickserv identify xxxxxxx" @@ -191,31 +197,34 @@ identifizieren: [NOTE] Mehrere Befehle in der Option _command_ können durch ein `;` (Semikolon) voneinander getrennt werden. -Möchte man seine Passwörter nicht als Klartext in der Konfiguration sichern, kann man die -Erweiterung /secure nutzen. +Sollen Passwörter nicht als Klartext in der Konfiguration sichtbar sein, +kann die Erweiterung _/secure_ genutzt werden. -Zuerst sollte eine Passphrase gesetzt werden: +Zuerst sollte die Passphrase gesetzt werden: ---- /secure passphrase Dies ist meine geheime Passphrase ---- -Dann kann man zum Beispiel für Freenode ein geheimes Passwort setzen: +Jetzt wird das Passwort (`xxxxxx`) +für den Zugang zum Freenode-Server verschlüsselt +und mit dem Bezeichner `freenode_password` verknüpft: ---- -/secure set freenode_password xxxxxxx +/secure set freenode_password xxxxxx ---- -Um nun das geschützte Freenode-Passwort in einer Option zu nutzen setzt man eine -Variable anstelle des Passworts, `+${sec.data.freenode_password}+`: +Das geschützte Freenode-Passwort kann nun in anderen Optionen genutzt werden. +Dazu wird anstelle des Klartext-Passwortes die Variable +`+${sec.data.freenode_password}+` eingesetzt: ---- /set irc.server.freenode.sasl_password "${sec.data.freenode_password}" ---- -Um ein auto-join (automatisches _betreten_) von Channels (Räumen) nach der -Verbindung zum Server durchzuführen, müssen die entsprechenden Channels in -eine Liste eingetragen werden: +Das automatische Betreten (auto-join) von Channels (Chaträume) direkt nach dem +Verbindungsaufbau zum IRC-Server kann durch den Eintrag der gewünschten Channels +in folgender Option erreicht werden: ---- /set irc.server.freenode.autojoin "#channel1,#channel2" @@ -224,19 +233,21 @@ eine Liste eingetragen werden: [TIP] Mittels der kbd:[Tab] Taste kann man sehr einfach Namen und Werte von Optionen vervollständigen und mittels kbd:[Shift+Tab] kann eine teilweise Vervollständigung -durchgeführt werden (was bei langen Wörtern, wie z.B. der Name einer Option, nützlich +durchgeführt werden (was bei langen Wörtern, wie z.B. dem Namen einer Option, nützlich sein kann). -Um einen Wert der Server-Optionen zu entfernen und stattdessen wieder den -Vorgabewert zu nutzen, z.B. Nutzen der vorgegebenen Nicknamen -(irc.server_default.nicks): +Mit dem Befehl `/unset` können Server-Optionen zurückgesetzt werden. +Ist eine Server-Option zurückgesetzt, _wirkt_ der entsprechende Vorgabewert +aus dem fall-back-Bereich `irc.server_default.xxx`. So nimmt, beispielsweise +nach dem Rücksetzen der Freenode-Nicks, diese Server-Option _automatisch_ den Wert +der entsprechenden fall-back-Option `irc.server_default.nicks` an: ---- /unset irc.server.freenode.nicks ---- -Andere Optionen: Du kannst andere Optionen mit folgendem Befehl festlegen ("xxx" -ist der Optionsname): +*Andere Optionen:* +Werte anderer Server-Optionen (`xxx`) können festgelegt werden mit: ---- /set irc.server.freenode.xxx Wert @@ -268,7 +279,7 @@ um dadurch separate Server-Buffer zu erhalten: [[join_part_irc_channels]] == Betreten/verlassen der IRC-Channel -Einen Channel betreten: +Einen Channel (Chatraum) betreten: ---- /join #channel @@ -277,22 +288,23 @@ Einen Channel betreten: Einen Channel verlassen (der Buffer bleibt dabei geöffnet): ---- -/part [quit message] +/part [Verlassen-Nachricht] ---- -Schließt einen Server, Channel oder privaten Buffer (`/close` ist ein Alias -für `/buffer close`): +Einen Buffer schließen (Server, Channel, privater Buffer); +`/close` ist dabei ein Alias für `/buffer close`: ---- /close ---- [WARNING] -Wird ein Server-Buffer geschlossen, werden automatisch die Channel/privaten -Buffer geschlossen. +Wird ein Server-Buffer geschlossen, +schließt WeeChat ebenfalls alle zum Server +gehörenden Channels und privaten Buffer. -Um sich bei einem Server abzumelden, führt man im entsprechenden Server-Buffer -folgenden Befehl aus: +Die Abmeldung von einem Server erfolgt im entsprechenden Server-Buffer +mit Hilfe des Befehls: ---- /disconnect @@ -301,13 +313,15 @@ folgenden Befehl aus: [[irc_private_messages]] == IRC private Nachrichten -Öffnet einen Buffer und schickt eine Nachricht an einen User (Nick _foo_): +Schicke eine Nachricht an einen bestimmten Benutzer (hier: _foo_) +und öffne einen privaten Buffer (Nachrichten in diesem Buffer +sehen nur der andere Benutzer und ich): ---- /query foo Dies ist eine Nachricht ---- -Schließt einen privaten Buffer: +Schließe den privaten Buffer: ---- /close @@ -316,16 +330,19 @@ Schließt einen privaten Buffer: [[buffer_window]] == Buffer/Fenster Verwaltung -Ein Buffer ist einer Erweiterung zugeordnet und besitzt eine Buffer-Nummer, -einen Buffer-Namen und beinhaltet die auf dem Bildschirm dargestellten -Zeilen. +Ein Buffer ist einer Erweiterung zugeordnet +und besitzt sowohl eine Buffer-Nummer als auch einen Buffer-Namen. +Die innerhalb eines Fensters dargestellten Zeilen/Zeichen +werden aus dem Inhalt des Buffers generiert. -Ein Fenster ist die Ansicht eines Buffers. Standardmäßig nutzt WeeChat ein -Fenster, in welchem ein Buffer darstellt wird. Wird der Bildschirm in -mehrere Fenster aufgeteilt, kann man sich entsprechend der Anzahl der -geteilten Fenster einen Buffer pro Fenster anzeigen lassen. +Ein Fenster ist der Ausschnitt der Programmoberfläche, +den WeeChat für einen bestimmten Buffer bereitstellt. +Standardmäßig nutzt WeeChat genau ein Fenster pro darzustellendem Buffer. +Wird der Bildschirm in mehrere Fenster aufgeteilt, +können, entsprechend der Anzahl der Fenster, +die gleiche Anzahl an Buffern angezeigt werden. -Befehle, zum Verwalten von Buffern und Fenstern: +Befehle zum Verwalten von Buffern und Fenstern: ---- /buffer @@ -348,9 +365,9 @@ Um die Teilung des Bildschirms rückgängig zu machen: [[key_bindings]] == Tastaturbelegung -WeeChat verwendet viele Standardtasten. Alle Tastenbelegungen sind in der -Dokumentation beschrieben. Im folgenden werden die wichtigsten Tastenbelegungen -kurz erläutert: +WeeChat verwendet viele Standardtasten. +Alle Tastenbelegungen sind in der Dokumentation beschrieben. +Im Folgenden werden die wichtigsten Tastenbelegungen kurz erläutert: - kbd:[Alt+←] / kbd:[Alt+→] oder kbd:[F5] / kbd:[F6]: Wechsel zum vorherigen/nächsten Buffer @@ -363,11 +380,16 @@ kurz erläutert: - kbd:[PgUp] / kbd:[PgDn]: scrollt den Text im aktiven Buffer - kbd:[Alt+a]: springt zum Buffer mit Aktivität (aus der Hotlist) -Gemäß Deiner Tastatur und/oder Deinen Bedürfnissen kann jede Taste mit Hilfe -des `/key` Befehls durch jedweden Befehl neu belegt werden. -Eine nützliche Tastenkombination um Tastencodes zu ermitteln ist kbd:[Alt+k]. +Die Tastenbelegung WeeChat's kann sowohl an deine persönlichen Vorlieben +als auch an die Besonderheiten deiner Tastatur angepasst werden. +Mit Hilfe des Befehls `/key` wird einer bestimmten Taste oder Tastenkombination +ein WeeChat-Befehl zugeordnet. -Beispiel: Belegung von kbd:[Alt+!] mit dem Befehl `/buffer close`: +In diesem Zusammenhang ist die Standard-Tastenkombination kbd:[Alt+k] besonders +hervorzuheben. Sie ermittelt (auf magische Weise) beliebige Tastaturcodes. + +Beispiel: +Belege die Tastenkombination kbd:[Alt+!] mit dem Befehl `/buffer close`: ---- /key bind (drücke alt-k) (drücke alt-!) /buffer close @@ -379,7 +401,7 @@ Du wirst folgende Befehlszeile erhalten: /key bind meta-! /buffer close ---- -Entfernen der Tastenbelegung: +Entferne die Tastenbelegung kbd:[Alt+!]: ---- /key unbind meta-! @@ -388,28 +410,38 @@ Entfernen der Tastenbelegung: [[plugins_scripts]] == Erweiterungen/Skripten -Bei einigen Distributionen wie z.B. Debian, sind die Erweiterungen über separate Pakete -erhältlich (z.B. weechat-plugins). -Erweiterungen werden -sofern welche gefunden worden sind- automatisch geladen (Bitte beachte -die Dokumentation zum installieren/entfernen von Erweiterungen und/oder Skripten). +Bei einigen Distributionen (z.B. Debian), +sind die WeeChat-Erweiterungen über separate Pakete erhältlich (z.B. _weechat-plugins_). +Erweiterungen werden, insofern sie beim Start von WeeChat gefunden wurden, +automatisch geladen (Bitte beachte die Dokumentation zum Installieren +und Entfernen von Erweiterungen und/oder Skripten). -Viele externe Skripten (von Drittprogrammierern) sind für WeeChat verfügbar. Diese -Skripten können mittels des `/script` Befehls heruntergeladen und installiert werden: +Viele externe Skripten (von Drittprogrammierern) sind für WeeChat verfügbar. +Diese Skripten können mit Hilfe des `/script`-Befehls heruntergeladen +und installiert werden: ---- /script install go.py ---- -siehe `/help script` für weitere Informationen. +Zeige weitere Informationen: +---- +/help script +---- + +Zeige eine liste aller verfügbaren Skripten: +---- +/script +---- -Eine Liste aller verfügbaren Skripten kann man sich in WeeChat mittels -`/script` anzeigen lassen oder man besucht folgende Webseite: -https://weechat.org/scripts +Auf *weechat.org* von Drittanbietern bereitgestellte Scripten: https://weechat.org/scripts [[more_doc]] == Weitere Dokumentation -Nun kannst Du WeeChat nutzen, für weitere Fragen lese die FAQ und/oder Dokumentation: -https://weechat.org/doc +Mit dieser Quickstart-Anleitung wurden dir die wesentlichen +Bedienungswerkzeuge von WeeChat nähergebracht. +Für das eingehende Studium aller verfügbaren Funktionalitäten +sei dir unsere ausführliche FAQ/Dokumentation ans Herz gelegt: https://weechat.org/doc Viel Spass mit WeeChat! |