379 lines
14 KiB
Plaintext
379 lines
14 KiB
Plaintext
WeeChat FAQ (Frequently Asked Questions)
|
|
========================================
|
|
FlashCode <flashcode@flashtux.org>
|
|
|
|
|
|
Allgemein
|
|
---------
|
|
|
|
|
|
[[why_choose_weechat]]
|
|
Weshalb WeeChat? - X-Chat und Irssi sind sehr gut...
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Weil WeeChat schlank ist und neue Funktionen besitzt.
|
|
Einige Funktionen (Version > = 0.3.x):
|
|
|
|
* Unterstützung mehrerer Protokolle durch Erweiterungen (IRC, Jabber)
|
|
* mehrere Remote GUIs als Ergänzung zu Curses (in Kürze)
|
|
* in mehreren Sprachen verfügbar
|
|
* Erweiterungsfähig durch Erweiterungen (C, Perl, Python, Ruby, Lua, Tcl)
|
|
* Buffer mit unabhängigem Inhalt
|
|
* Filterung der Anzeige mittels Tags und regulären Ausdrücken
|
|
* horizontale und vertikale Teilung der Fenster
|
|
* anpass- und erweiterbare Leisten
|
|
* Nickliste in allen GUI's verfügbar
|
|
* inkrementelle Textsuche in Buffern, zu Highlights springen
|
|
* FIFO Pipe für Fernsteuerung
|
|
* Unterstützung für Aspell
|
|
* Doppelter Zeichensatz (Kodierung/Dekodierung)
|
|
* Neuentwicklung (basiert auf keinem anderem Programm)
|
|
* Lauffähig auf einer Vielzahl von Plattformen
|
|
* 100% GPL und Frei
|
|
|
|
Weitere Informationen gibt es auf der folgenden Internetseite:
|
|
http://www.weechat.org/features
|
|
|
|
|
|
Kompilierung / Installation
|
|
---------------------------
|
|
|
|
|
|
[[gui]]
|
|
Ich habe gehört, es gibt mehrere GUIs für WeeChat. Wie kann ich diese kompilieren bzw nutzen?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Zur Zeit ist nur die GUI für Curses verfügbar.
|
|
|
|
Andere GUIs (zur Zeit in der Entwicklung) werden als Remote Clients verfügbar
|
|
sein.
|
|
|
|
|
|
[[compile_git]]
|
|
Ich kann WeeChat nach Cloning des git Repository nicht kompilieren - warum?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Der empfohlene Weg WeeChat zu komilieren ist die Nutzung von cmake.
|
|
|
|
Falls Du mit Hilfe der autotools kompilierst (also nicht cmake), stelle sicher,
|
|
dass Du die neueste Version von autoconf und automake besitzt (WeeChat wird mit
|
|
autoconf 2.61 und automake 1.10.1 entwickelt).
|
|
|
|
Der andere Weg ist, das "Entwickler-Paket" zu installieren, dieses hat weniger
|
|
Abhängigkeiten. Dieses Paket wird quasi täglich aus dem git Repository erstellt.
|
|
Beachte, dass dieses Paket nicht immer exakt mit dem git Repository übereinstimmt
|
|
und daher auch weniger brauchbar sein kann als wenn man selbst das Repository
|
|
klont und daraus Updates installiert.
|
|
|
|
|
|
WeeChat anwenden
|
|
----------------
|
|
|
|
|
|
[[lost]]
|
|
Ich habe WeeChat gestartet, komme aber nicht mehr weiter - was kann ich tun?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Um Hilfe zu erhalten, gebe `/help` ein. Hilfe zu einem Befehl erhälst Du durch
|
|
die Eingabe von: `help Befehlsname`.
|
|
Befehle sowie die Belegung der jeweiligen Tasten sind in der Dokumentation
|
|
aufgeführt.
|
|
FIXME: (Tip: Mit den Tasten <Bild-hoch>/<Bild-runter> kannst Du die Anzeige
|
|
scrollen)
|
|
|
|
Neue Benutzer sollten unbedingt die 'quickstart'-Anleitung lesen (siehe
|
|
Dokumentation auf der Internetseite).
|
|
|
|
|
|
[[buffer_vs_window]]
|
|
Ich habe von "Buffern" und "Fenstern" gehört - was ist der Unterschied?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Ein 'Buffer' besteht aus einer Nummer, einem Namen, anzuzeigenden Zeilen (und
|
|
anderen Daten)
|
|
|
|
Ein 'Fenster' ist ein Bildschirmbereich der Buffer darstellt. Es ist möglich
|
|
den Bildschirm in mehrere Fenster aufzuteilen.
|
|
|
|
Jedes Fenster stellt einen Buffer dar. Ein Buffer kann unsichtbar sein (er wird
|
|
nicht durch ein Fenster angezeigt), oder durch ein sowie mehrere Fenster
|
|
angezeigt werden.
|
|
|
|
|
|
[[charset]]
|
|
Teilweise fehlen bei Zeichen die Akzente, was kann ich tun?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Dies ist ein bekanntes Problem, bitte lese nachfolgendes sorgfältig und
|
|
prüfe *alle* aufgezeigten Lösungsmöglichkeiten.
|
|
|
|
Für Versionen < 0.2.3, bitte auf die neueste stabile Version upgraden.
|
|
|
|
Für Versionen > = 0.2.3:
|
|
|
|
* prüfe, dass weechat-curses mit libncursesw gelinkt ist (Warnung: nötig bei den
|
|
meißten Distributionen - jedoch nicht bei allen):
|
|
`ldd /path/to/weechat-curses`
|
|
* prüfe mit dem Befehl `/plugin`, dass die "Charset" Erweiterung geladen ist (falls
|
|
nicht, benötigst Du wahrscheinlich noch das Paket "weechat-plugins")
|
|
* prüfe die Ausgabe des Befehls /charset (auf dem Server-Buffer). Du solltest
|
|
'ISO-XXXXXX' oder 'UTF-8' für den Terminal Zeichensatz sehen. Falls Du
|
|
'ANSI_X3.4-1968' oder andere Werte siehst, ist Deine Einstellung der locale
|
|
möglicherweise falsch.
|
|
* setzen des globalen decode Wertes, z.B.:
|
|
** WeeChat < = 0.2.6: `/setp charset.global.decode = ISO-8859-15`
|
|
** WeeChat > = 0.3.x: `/set charset.default.decode "ISO-8859-15"`
|
|
* Falls Du UTF-8 locale nutzt:
|
|
** prüfe, ob Dein Terminal UTF-8 fähig ist (der empfohlene Terminal für UTF-8
|
|
ist rxvt-unicode)
|
|
** Solltest Du screen nutzten, prüfe ob er im UTF-8 Modus läuft
|
|
("`defutf8 on`" in der Datei ~/.screenrc oder `screen -U` zum Sarten von
|
|
screen)
|
|
|
|
[NOTE]
|
|
Die Nutzung der UTF-8 locale wird für WeeChat empfohlen. Nutzt Du jedoch ISO
|
|
oder andere locale, bitte vergewissere Dich dann, dass *alle* Deine
|
|
Einstellungen (Terminal, screen, ...) sich auch auf ISO beziehen und *nicht* auf
|
|
UTF-8.
|
|
|
|
|
|
[[bars_background]]
|
|
Leisten, z.B. Titel und Status sind nicht ausgefüllt, die Hintergrundfarbe endet direkt nach dem Text, warum?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Dies kann durch einen falschen Wert der Variablen TERM Deiner Shell verursacht
|
|
werden (schaue Dir die Ausgabe von `echo $TERM` in Deinem Terminal an).
|
|
|
|
Abhängig davon wo Du WeeChat startest, solltest Du folgenden Wert haben:
|
|
|
|
* falls WeeChat lokal oder auf einem entfernten Rechner läuft, je nach benutztem
|
|
Terminal: 'xterm', 'rxvt', ...
|
|
* falls WeeChat unter screen läuft, sollte der Wert 'screen' sein.
|
|
|
|
Wenn nötig korrigiere den Wert Deiner Variablen TERM: `export TERM="xxx"`.
|
|
|
|
|
|
[[screen_weird_chars]]
|
|
Wenn ich Weechat unter screen nutze, habe ich merkwürdige Zeichen, wie kann ich dies beheben?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Dies kann durch einen falschen Wert der Variablen TERM Deiner Shell verursacht
|
|
werden (schaue Dir die Ausgabe von `echo $TERM` in Deinem Terminal an).
|
|
|
|
Als Beispiel, 'xterm-color' könnte solche merkwürdigen Zeichen produzieren,
|
|
nutzte stattdessen 'xterm' - die ist ok (wie mehrer andere Werte).
|
|
|
|
Wenn nötig korrigiere den Wert Deiner Variablen TERM: `export TERM="xxx"`.
|
|
|
|
|
|
[[key_bindings]]
|
|
Wie kann ich die Tastaturbelegung anpassen?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Die Tasten werden mit dem Befehl /key belegt.
|
|
|
|
Per Voreinstellung kannst Du mit der Tastenkombination Meta-k (normal Alt-k) den
|
|
Code der jeweiligen Taste herausfinden und in die Eingabezeile einfügen.
|
|
|
|
|
|
[[openbsd_plugins]]
|
|
Ich benutze BSD, und WeeChat lädt keine Erweiterungen - warum?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Unter BSD Enden die Dateinamen der Erweiterungen mit ".so.0.0" (".so" bei Linux).
|
|
|
|
Um dies zu beheben muss folgendes konfiguriert werden:
|
|
|
|
* WeeChat < = 0.2.6: +
|
|
`/set plugins_extension = ".so.0.0"`
|
|
* WeeChat > = 0.3.x: +
|
|
`/set weechat.plugin.extension ".so.0.0"`
|
|
|
|
Danach: `/plugin autoload`.
|
|
|
|
|
|
[[scripts]]
|
|
Wie kann ich Perl/Python/Ruby/Lua/Tcl Skripten laden? Sind Skripten kompatibel zu anderen IRC-Clients?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Benutze die Befehle: `/perl`, `/python`, `/ruby`, `/lua` und `/tcl` um Skripten
|
|
zu laden (Voreingestellter Pfad zu den Skripten: '~/.weechat/<Skriptsprache>/').
|
|
|
|
Die Skripten sind mit den anderer IRC-Clients nicht kompatibel.
|
|
|
|
Anmerkung:
|
|
|
|
* Skripten, die sich unter '~/.weechat/<Skriptsprache>/autoload/' befinden, werden
|
|
beim Start von WeeChat automatisch geladen.
|
|
* Eine 'tcl' Erweiterung ist ab version > = 0.3.x verfügbar.
|
|
|
|
|
|
[[change_locale_without_quit]]
|
|
Ich möchte die Sprache der Meldungen, die WeeChat ausgibt, ändern ohne WeeChat zu verlassen. Ist dies möglich?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Ja, dazu kannst Du das Python-Skript shell.py verwenden (erhältlich auf der
|
|
Internetseite). Nach dem laden des Skripts führe folgende Befehle aus:
|
|
|
|
/shell setenv LANG=en_US.UTF-8
|
|
/upgrade
|
|
|
|
Hierdurch erhält man für das Terminal englische, UTF-8 kodierte Meldungen.
|
|
Benutzer von ISO-Kodierungen können folgendes eingeben:
|
|
`/shell setenv LANG=en_US`.
|
|
|
|
|
|
[[terminal_copy_paste]]
|
|
Wie kann ich einen Text kopieren und einfügen ohne das die Nickliste auch eingefügt wird?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Du kannst hierzu ein Terminal nutzen, welches Block-Selektierung erlaubt
|
|
(wie rxvt-unicode, konsole, gnome-terminal, ...). Im Normalfall erfolgt diese
|
|
mittels der Tasten ctrl + alt in Verbindung mit der Auswahl durch die Maus.
|
|
|
|
Eine andere Lösung ist, die Nickliste nach oben oder unten zu verschieben, z.B.:
|
|
|
|
* WeeChat < = 0.2.6: +
|
|
`set look_nicklist_position = top`
|
|
* WeeChat > = 0.3.x: +
|
|
`/bar set nicklist position top`
|
|
|
|
|
|
[[urls]]
|
|
Wie kann ich eine URL aufrufen, die einen Zeilenumbruch besitzt?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Da WeeChat sowohl die Uhrzeit als auch einen Präfix für jede Zeile darstellt und
|
|
man optional auch noch Bars nutzen kann, die das Chatfenster zusätzlich
|
|
verkleinern, kann es passieren das sehr lange URLs abgeschnitten und nicht mehr
|
|
aufgerufen werden können.
|
|
|
|
Deshalb sollte man eines der folgenden Skripten nutzen:
|
|
|
|
urlbar.py::
|
|
stellt die URL in einer Bar dar.
|
|
|
|
urlgrab.py::
|
|
protokolliert URLs und öffnet diese im Standardbrowser.
|
|
|
|
url_shorten.rb::
|
|
tinyurl.py::
|
|
shortenurl.py::
|
|
URLs werden durch einen Internet-Dienst gekürzt.
|
|
|
|
Liste der Skripten die sich mit URLs befassen: http://www.weechat.org/scripts/stable/tag/url
|
|
|
|
|
|
[[highlight_notification]]
|
|
Wie kann ich informiert werden, wenn jemand in einem Channel highlightet
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
((A.d.Ü) highlight bedeutet, dass der eigene Nick z.B. im Channel genannt wird,
|
|
der Nick dessen der ihn schrieb wird farblich hervorgehoben)
|
|
|
|
Abhängig der WeeChat Version:
|
|
|
|
* WeeChat < = 0.2.6: nutze das Skript 'sound.pl' (verfügbar auf der Skript-Site),
|
|
und nehme Einstellungen für einen System-Befehl (um einen Klang zu spielen,
|
|
eine Meldung anzuzeigen, ...) mit folgendem Befehl vor: +
|
|
`/setp perl.sound.cmd_highlight = "/path/to/command arguments"`
|
|
* WeeChat > = 0.3.x: nutze das Skript 'launcher.pl' (verfügbar auf der Skript-Site),
|
|
und nehme Einstellungen für einen System-Befehl (um einen Klang zu spielen,
|
|
eine Meldung anzuzeigen, ...) mit folgendem Befehl vor: +
|
|
`/set plugins.var.perl.launcher.signal.weechat_highlight "/path/to/command arguments"`
|
|
|
|
Es gibt noch andere Skripten, die über solche Ereignisse informieren , bitte
|
|
besuche dazu die Skripten-Webseite: http://www.weechat.org/scripts/
|
|
|
|
|
|
[[filter_irc_join_part_quit]]
|
|
Wie kann ich join/part/quit Meldungen der IRC Channels filtern (A.d.ü.: unterdrücken)?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Entsprechend der WeeChat-Version:
|
|
|
|
* WeeChat < = 0.2.6: +
|
|
`/ignore * join #weechat freenode` +
|
|
`/ignore * part #weechat freenode` +
|
|
`/ignore * quit #weechat freenode` +
|
|
(Channel und/oder Server können durch "*" ersetzt werden, Hilfe mit: `/help ignore`)
|
|
|
|
* WeeChat > = 0.3.x:
|
|
|
|
** Intelligenter Filter (erhalte join/part/quit der User, mit denen Du kürzlich gesprochen hast): +
|
|
`/set irc.look.smart_filter on` +
|
|
`/filter add irc_smart * irc_smart_filter *` +
|
|
(Hilfe mit: `/help irc.look.smart_filter` und `/help filter`)
|
|
|
|
** globaler Filter (unterdrückt *alle* join/part/quit): +
|
|
`/filter add jpk * irc_join,irc_part,irc_quit *` +
|
|
(Hilfe mit: `/help filter`)
|
|
|
|
[[ignore_vs_filter]]
|
|
Was ist der Unterschied zwischen den Befehlen /ignore und /filter?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Der Befehl `/ignore` ist ein IRC-Befehl und beeinflußt somit nur die IRC-Buffer
|
|
(Server und Channel).
|
|
Durch den Befehl kann man bestimmte Nicks oder Hostnamen von Usern eines Servers oder
|
|
Channels ignorieren (Der Befehl wird nicht auf den Inhalt der Meldung angewandt).
|
|
Passende Meldungen werden von dem IRC-Plugin vor der Anzeige gelöscht (Du wirst
|
|
sie niemals zu Gesicht bekommen).
|
|
|
|
Der Befehl `/filter` ist ein Kern-Befehl (A.d.Ü.: wird in WeeChat ausgeführt und
|
|
nicht an den Server gesendet) und beeinflußt somit jeden Buffer.
|
|
Dieser Befehl eröffnet die Möglichkeit bestimmte Zeilen in Buffern, mittels Tags und
|
|
regulären Ausdrücken nach Präfix und Zeileninhalt zu filtern.
|
|
Gefilterte Zeilen werden nur unsichtbar - nicht gelöscht. Sehen kannst Du sie
|
|
wenn Du den Filter deaktivierst (Voreinstellung zum Aktivieren/Deaktivieren der
|
|
Filter: Alt-Taste + "=").
|
|
|
|
|
|
Entwicklung
|
|
-----------
|
|
|
|
|
|
[[bug_task_patch]]
|
|
Was mache ich um Fehler zu melden, nach neuen Funktionen zu fragen oder Patches einzusenden?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Es gibt drei Möglichkeiten:
|
|
|
|
. Du kannst zu uns in den IRC kommen: 'irc.freenode.net', channel '#weechat'
|
|
. Du kannst die Internetseite savannah nutzen:
|
|
* Fehler melden: https://savannah.nongnu.org/bugs/?group=weechat
|
|
* Nach einer neuen Funktion fragen: https://savannah.nongnu.org/task/?group=weechat
|
|
* Patch senden: https://savannah.nongnu.org/patch/?group=weechat
|
|
. Du kannst den Entwicklern mailen, entsprechende Mail-Adressen auf der Supportseite:
|
|
http://www.weechat.org/about
|
|
(Um emails an die "support" Mailing-Liste zu schicken, kannst Du diese abonnieren)
|
|
|
|
|
|
[[supported_os]]
|
|
Auf welchen Plattformen läuft WeeChat? Wird es noch auf anderen Betriebssystemen portiert?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Die gesamte Liste gibt es unter: http://www.weechat.org/download
|
|
|
|
Wir geben unser Bestes um WeeChat auf möglichst vielen Plattformen lauffähig zu
|
|
machen. Um WeeChat auf Betriebssystemen zu testen, zu denen wir keinen Zugang
|
|
haben, ist Hilfe willkommenen.
|
|
|
|
|
|
[[help_developers]]
|
|
Ich möchte den Entwicklern von WeeChat helfen. Was kann ich tun?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Es gibt einiges zu tun z.B. Testen, Programmieren, Dokumentation, ...
|
|
|
|
Bitte kontaktiere uns via IRC oder email, schaue auf die Support-Seite:
|
|
http://www.weechat.org/about
|
|
|
|
|
|
[[donate]]
|
|
Kann ich Geld oder Anderes an die Entwickler von WeeChat spenden?
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Du kannst uns Geld zur Unterstützung der weitern Entwicklung spenden.
|
|
Details hierzu gibt es auf: http://www.weechat.org/donate
|