= WeeChat Quickstart Anleitung
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: de
:toc: left
:toc-title: Inhaltsverzeichnis
:sectnums:
:docinfo1:


Übersetzer:

* Frank Zacharias <frank_zacharias@web.de>, 2006
* Juergen Descher <jhdl@gmx.net>, 2009
* Nils Görs <weechatter@arcor.de>, 2009-2016


[[start]]
== Start von WeeChat

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:

----
$ weechat
----

[[help_options]]
== Online-Hilfe / Optionen

Für jeden Befehl bietet WeeChat eine Hilfe an:

----
/help
----

Um sich eine Hilfe für einen bestimmten Befehl anzeigen
zu lassen:

----
/help Befehl
----

Um Optionen zu setzen benutzt man:

----
/set config.section.option Wert
----

(dabei ist _config_ der Konfigurationsname (_weechat_ für den Kern von weechat,
oder der Name einer Erweiterung), _section_ ein Abschnitt dieser Konfiguration und _option_
der Name der entsprechenden Option).

WeeChat verwendet umgehend einen neu eingestellten Wert (WeeChat muss also zu *keinem* Zeitpunkt
neu gestartet werden, nach dem die Konfiguration verändert wurde).

Beim `/set` Befehl kann beim Optionnamen ein Platzhalter "*" zu Beginn oder am Ende
der Zeichenkette verwendet werden um sich alle Optionen anzeigen zu lassen, die
dem Suchmuster entsprechen.

Zum Beispiel:

zeigt alle Optionen an (WeeChat und Erweiterungen):

----
/set
----

zeigt alle WeeChat Optionen an:

----
/set weechat.*
----

zeigt alle Optionen der IRC-Erweiterung an:

----
/set irc.*
----

Du kannst dir mit dem Befehl `/help` eine Hilfe für Optionen anzeigen lassen, z.B.:

----
/help weechat.look.highlight
----

Beim Beenden von WeeChat werden alle Einstellungen gespeichert (mittels des
Befehls `/save` kann das Sichern der Optionen manuell durchgeführt werden).

[IMPORTANT]
Es wird *nicht empfohlen* die Konfigurationsdateien manuell zu editieren, da WeeChat
diese Dateien zu jeder Zeit überschreiben kann (zum Beispiel: `/quit`).
Außerdem muß eine veränderte Datei manuell mit dem Befehl `/reload` neu
geladen werden (mit dem Risiko von Datenverlust da Optionen kommentarlos überschrieben werden,
bevor man diese ggf. gesichert hat `/save`). +
Aus diesen Gründen sollte immer der `/set` Befehl genutzt werden, da
zusätzlich auch die Eingabe auf Plausibilität geprüft wird und Änderungen sofort wirksam werden.

[[core_vs_plugins]]
== 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)

Alle Netzwerkprotokolle, z.B. IRC, werden als separate Erweiterung bereit gestellt.

Benutze den Befehl `/plugin` um alle Erweiterungen aufzulisten, "irc" sowie andere
Erweiterungen sollten aufgelistet werden.

[[create_irc_server]]
== Einen IRC-Server erstellen

Um eine Verbindung zu einem IRC Server herzustellen wird der
`/server` Befehl verwendet. Beispiel:

----
/server add freenode chat.freenode.net
----

Falls man nicht mehr weiter weiß, einfach die Hilfe verwenden:

----
/help server
----

[[irc_server_options]]
== Setzen eigener IRC-Server Optionen

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.

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").

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:

----
/set irc.server.freenode.nicks "meinNick,meinNick2,meinNick3,meinNick4,meinNick5"
----

Um den User- und realen Namen anzupassen:

----
/set irc.server.freenode.username "Mein User-Name"
/set irc.server.freenode.realname "Mein wirklicher Name"
----

Um beim Start von WeeChat automatisch eine Verbindung zu einem Server
herzustellen:

----
/set irc.server.freenode.autoconnect on
----

Um eine SSL Verbindung herzustellen:

----
/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):

----
/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:

----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
----

[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.

Zuerst sollte eine Passphrase gesetzt werden:

----
/secure passphrase Dies ist meine geheime Passphrase
----

Dann kann man zum Beispiel für Freenode ein geheimes Passwort setzen:

----
/secure set freenode_password xxxxxxx
----

Um nun das geschützte Freenode-Passwort in einer Option zu nutzen setzt man eine
Variable anstelle des Passworts, `+${sec.data.freenode_password}+`:

----
/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:

----
/set irc.server.freenode.autojoin "#channel1,#channel2"
----

[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
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):

----
/set irc.server.freenode.nicks null
----

Andere Optionen: Du kannst andere Optionen mit folgendem Befehl festlegen ("xxx"
ist der Optionsname):

----
/set irc.server.freenode.xxx Wert
----

[[connect_to_irc_server]]
== Verbinden mit dem IRC-Server und auto-join der Channel

----
/connect freenode
----

[NOTE]
Dieser Befehl kann dazu benutzt werden um einen neuen Server zu erstellen und
sich mit ihm zu verbinden, ohne den Befehl `/server` zu benutzen (muss ich
erwähnen, dass Du die Hilfe zu diesem Befehl mit `/help connect` aufrufen
kannst?).

Standardmäßig werden alle Server-Buffer und der Buffer des Kerns von WeeChat -der
core-Buffer- zusammengelegt. Um zwischen dem core-Buffer und den Server-Buffern
zu wechseln, kannst Du kbd:[Ctrl+x] benutzen.

Es ist möglich das automatische Zusammenlegen der Server-Buffer zu deaktivieren,
um eigenständige Server-Buffer zu verwenden:

----
/set irc.look.server_buffer independent
----

[[join_part_irc_channels]]
== Betreten/verlassen der IRC-Channel

Einen Channel betreten:

----
/join #channel
----

Einen Channel verlassen (der Buffer bleibt dabei geöffnet):

----
/part [quit message]
----

Schließt einen Server, Channel oder privaten Buffer (`/close` ist ein Alias
für `/buffer close`):

----
/close
----

[WARNING]
Wird ein Server-Buffer geschlossen, werden automatisch die Channel/privaten
Buffer geschlossen.

Um sich bei einem Server abzumelden, führt man im entsprechenden Server-Buffer
folgenden Befehl aus:

----
/disconnect
----

[[irc_private_messages]]
== IRC private Nachrichten

Öffnet einen Buffer und schickt eine Nachricht an einen User (Nick _foo_):

----
/query foo Dies ist eine Nachricht
----

Schließt einen privaten Buffer:

----
/close
----

[[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 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.

Befehle, zum Verwalten von Buffern und Fenstern:

----
/buffer
/window
----

(Ich muss nicht erwähnen, dass man mit /help einen Hilfstext zu dem Befehl erhält)

Beispiel: Um den Bildschirm vertikal in ein kleineres Fenster (1/3 Bildschirmbreite)
und ein größeres Fenster (2/3 Bildschirmbreite) aufzuteilen:

----
/window splitv 33
----

Um die Teilung des Bildschirms rückgängig zu machen:

----
/window merge
----

[[key_bindings]]
== Tastaturbelegung

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
- kbd:[F7] / kbd:[F8]: Wechsel zum vorherigen/nächsten Fenster (falls der
  Bildschirm aufgeteilt ist)
- kbd:[F9] / kbd:[F10]: scrollt die Titelleiste
- kbd:[F11] / kbd:[F12]: scrollt die Liste mit den Nicks
- kbd:[Tab]: komplettiert den Text in der Eingabezeile, ähnlich Deiner shell
- 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].

Beispiel: Belegung von kbd:[Alt+!] mit dem Befehl `/buffer close`:

----
/key bind (drücke alt-k) (drücke alt-!) /buffer close
----

Du wirst folgende Befehlszeile erhalten:

----
/key bind meta-! /buffer close
----

Entfernen der Tastenbelegung:

----
/key unbind meta-!
----

[[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).

Viele externe Skripten (von Drittprogrammierern) sind für WeeChat verfügbar. Diese
Skripten können mittels des `/script` Befehls heruntergeladen und installiert werden:

----
/script install go.py
----

siehe `/help script` für weitere Informationen.

Eine Liste aller verfügbaren Skripten kann man sich in WeeChat mittels
`/script` anzeigen lassen oder man besucht folgende Webseite:
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

Viel Spass mit WeeChat!
