diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/de/weechat_user.de.adoc | 1116 | ||||
| -rw-r--r-- | doc/en/weechat_user.en.adoc | 1067 | ||||
| -rw-r--r-- | doc/fr/weechat_user.fr.adoc | 1125 | ||||
| -rw-r--r-- | doc/it/weechat_user.it.adoc | 1100 | ||||
| -rw-r--r-- | doc/ja/weechat_user.ja.adoc | 1070 | ||||
| -rw-r--r-- | doc/pl/weechat_user.pl.adoc | 1076 | ||||
| -rw-r--r-- | doc/sr/weechat_user.sr.adoc | 966 |
7 files changed, 3805 insertions, 3715 deletions
diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc index 9fdf8bf89..3ca507f43 100644 --- a/doc/de/weechat_user.de.adoc +++ b/doc/de/weechat_user.de.adoc @@ -643,6 +643,57 @@ Einige Umgebungsvariablen werden von WeeChat genutzt, sofern sie definiert wurde | WEECHAT_EXTRA_LIBDIR | Ein zusätzliches Verzeichnis um Erweiterungen zu installieren (vom "plugins" Verzeichnis in dieses Verzeichnis). |=== +// TRANSLATION MISSING +[[colors_support]] +=== Colors support + +WeeChat kann bis zu 32767 Farbpaarungen nutzen um einen Text in Bars oder im +Chatbereich darzustellen (der Terminal muss natürlich 256 Farben unterstützten). + +Gemäß der Einstellung in der _TERM_-Umgebungsvariable bestehen folgende Einschränkungen +was die Farbdarstellung in WeeChat betrifft: + +[width="75%",cols="8,>3,>3",options="header"] +|=== +| $TERM | Farben | Paare +| "rxvt-unicode", "xterm", ... | 88 | 32767 +| "rxvt-256color", "xterm-256color", ... | 256 | 32767 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 32767 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 32767 +|=== + +Mittels `weechat --colors` oder dem internen WeeChat-Befehl `/color` kann man sich +die Einschränkungen für die jeweilige Umgebungsvariable anzeigen lassen. + +Folgende Werte sind für die _TERM_-Umgebungsvariable zu empfehlen, sofern man 256 Farben +nutzen möchte: + +* falls screen genutzt wird: _screen-256color_ +* für tmux: _screen-256color_ oder _tmux-256color_ +* ausserhalb screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... + +[NOTE] +Es sollte das Paket "ncurses-term" installiert werden um die Werte der _TERM_ +Variable nutzen zu können. + +Sollte screen genutzt werden, fügt man folgende Zeile an das Ende der Datei +_~/.screenrc_: + +---- +term screen-256color +---- + +Sollte die Umgebungsvariable _TERM_ falsch gesetzt worden sein und WeeChat +wird derweil schon ausgeführt, kann die Variable mit folgenden zwei Befehlen +geändert werden: + +---- +/set env TERM screen-256color +/upgrade +---- + [[files_and_directories]] === Dateien und Verzeichnisse @@ -972,158 +1023,6 @@ kbd:[!] Die Farben können in der IRC Erweiterung neu belegt werden, mittels der Option <<option_irc.color.mirc_remap,irc.color.mirc_remap>>. -[[colors]] -=== Farben - -WeeChat kann bis zu 32767 Farbpaarungen nutzen um einen Text in Bars oder im -Chatbereich darzustellen (der Terminal muss natürlich 256 Farben unterstützten). - -Gemäß der Einstellung in der _TERM_-Umgebungsvariable bestehen folgende Einschränkungen -was die Farbdarstellung in WeeChat betrifft: - -[width="75%",cols="8,>3,>3",options="header"] -|=== -| $TERM | Farben | Paare -| "rxvt-unicode", "xterm", ... | 88 | 32767 -| "rxvt-256color", "xterm-256color", ... | 256 | 32767 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 32767 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 32767 -|=== - -Mittels `weechat --colors` oder dem internen WeeChat-Befehl `/color` kann man sich -die Einschränkungen für die jeweilige Umgebungsvariable anzeigen lassen. - -Folgende Werte sind für die _TERM_-Umgebungsvariable zu empfehlen, sofern man 256 Farben -nutzen möchte: - -* falls screen genutzt wird: _screen-256color_ -* für tmux: _screen-256color_ oder _tmux-256color_ -* ausserhalb screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... - -[NOTE] -Es sollte das Paket "ncurses-term" installiert werden um die Werte der _TERM_ -Variable nutzen zu können. - -Sollte screen genutzt werden, fügt man folgende Zeile an das Ende der Datei -_~/.screenrc_: - ----- -term screen-256color ----- - -Sollte die Umgebungsvariable _TERM_ falsch gesetzt worden sein und WeeChat -wird derweil schon ausgeführt, kann die Variable mit folgenden zwei Befehlen -geändert werden: - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== Basisfarben - -Basisfarben in WeeChat sind: - -[width="75%",cols="1m,4",options="header"] -|=== -| Name | Farbe -| default | Standard Terminalfarbe (transparent für Hintergrund) -| black | Schwarz -| darkgray | Dunkelgrau -| red | Dunkelrot -| lightred | Hellrot -| green | Dunkelgrün -| lightgreen | Hellgrün -| brown | Braun -| yellow | Gelb -| blue | Dunkelblau -| lightblue | Hellblau -| magenta | Dunkel magenta -| lightmagenta | Hell magenta -| cyan | Dunkel türkis -| lightcyan | Hell türkis -| gray | Grau -| white | Weiß -|=== - -[[colors_extended]] -==== erweiterte Farbpalette - -WeeChat belegt die Farbpaare dynamisch, sobald die Farbe genutzt werden sollte. Zum Beispiel -um mit einer Farbe Buffer oder Bars zu nutzen. - -Zu den Basisfarben können zusätzlich Farben zwischen eins und der maximalen Anzahl an Farben -genutzt werden die vom jeweiligen Terminal zur Verfügung gestellt werden. - -Mit dem `/color` Befehl kann man sich sowohl die aktuelle Farbpalette anzeigen lassen als -auch die Anzahl der zu nutzenden Farben. Mit kbd:[Alt+c] kann man vorübergehend zu den -Terminalfarben wechseln um eine Farbe auszuwählen. - -Um zum Beispiel die Uhrzeit in einem Buffer in einem schönen Orange darzustellen: - ----- -/set weechat.color.chat_time 214 ----- - -oder falls man den Hintergrund der Statusbar in einm sehr dunklen Grün haben möchte: - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== Alias - -Man kann einer Farbe einen Alias zuordnen um diesen Alias anstelle einer Zahl in -die Optionen einzutragen. Um einen Alias zu definieren nutzt man den Befehl -`/color alias`. - -Beispiel: - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== Attribute - -Er ist möglich einer Farbe ein Attribut hinzuzufügen. Dazu wird dem -Farbnamen oder der Farbnummer ein- oder mehrere Attribute vorangestellt. - -* `+*+` : fett -* `+!+` : invertierte Darstellung -* `+/+` : kursiven -* `+_+` : unterstrichen -* `+|+` : behält Attribut bei: fett, invertierte Darstellung, Unterstrichen wird beim Farbwechsel nicht zurückgesetzt - -Um zum Beispiel dem eigenen Nick die Farbe weiß und unterstrichen -zuzuordnen: - ----- -/set weechat.color.chat_nick_self _white ----- - -oder um die Zeitanzeige in der Statusbar orange, fett und unterstrichen -darzustellen: - ----- -/set weechat.color.status_time *_214 ----- - -Um einer Standard-Terminalfarbe (-1) ein Attribut hinzuzufügen muss eine Zahl -gewählt werden die größer ist als die letzte genutzte Farbe des Terminals. -Zum Beispiel; maximale Farbwahl in WeeChat: 99999. - -Um der Vordergrundfarbe des Terminals das Attribut "fett" zuzuordnen: - ----- -/set weechat.color.status_time *99999 ----- - [[buffers_and_windows]] === Buffer und Fenster @@ -1447,240 +1346,6 @@ Standardmäßig interpretieren WeeChat und seine Standard-Erweitertungen diese V [NOTE] Externe Erweitertungen und Skripte können andere lokale Variablen definieren und verwenden. -[[bars]] -=== Bars - -Eine _Bar_ ist ein Bereich der parallel, zum Chatfenster, jedwede Art von Text enthalten kann. - -Eine Bar kann mittels `weechat.bar.name.option` konfiguriert werden. Dabei steht `name`, -für den Namen der Bar und `option` für die Option dieser Bar. - -Aufzählung von Bar-Optionen: - -[width="100%",cols="2m,2,10",options="header"] -|=== -| Option | Wert | Beschreibung - -| type | `root`, `window` | - Eine Bar vom Typ `root` wird nur einmal auf dem Bildschirm dargestellt und dies - außerhalb von Fenstern. Die Standardbar _buflist_ ist vom Typ `root`. + - Eine Bar vom Typ `window` wird hingegen in jedem Fenster dargestellt, zum Beispiel - wenn man den Bildschirm teilt (mit `/window splith` oder `/window splitv`). Diese - Bar wird nun in jedem einzelnen Fenster angezeigt. Die Standardbar _title_, _status_, - _input_ und _nicklist_ sind vom Typ `window`. - -| position | `top`, `bottom`, `left`, `right` | - Position der Bar: ober- oder unterhalb des Chatfensters, oder links/rechts davon. - -| priority | integer ≥ 0 | - Priorität für die Bar: legt die Reihenfolge fest in der die Bars angeordnet werden sollen, - wenn mehrere Bars den selben Typ und Position besitzen. + - Die Bars werden vom Rand zur Mitte des Bildschirms gezeichnet. Eine höhere Priorität - bewirkt, dass die Bar näher am Rand gezeichnet wird. + - Beispiel: Die _input_ Bar hat eine Priorität von 1000 und wird somit vor der _status_ Bars - gezeichnet, da diese lediglich eine Priorität von 500 besitzt. - -| size | integer ≥ 0 | - Die Größe der Bar: Anzahl der Spalten, falls die Bar links/rechts bzw. Anzahl an Zeilen falls - die Bar oben/unten dargestellt wird. Wird eine Größe `0` gewählt, dann wird die Größe der Bar - automatisch bestimmt. - -| size_max | integer ≥ 0 | - Die maximale Größe der Bar, `0` = keine Limitierung (diese Option wird nur genutzt, falls die - Option `size` = `0` ist). - -| color_bg | color | - Hintergrundfarbe, für die Bar. - -| color_fg | color | - Textfarbe, für die Bar. - -| color_delim | color | - Farbe der Trennzeichen, in der Bar. - -| hidden | `on`, `off` | - Ist diese Option `on`, wird die Bar versteckt. + - Hinweis: anstelle dieser Option sollte vorzugsweise der `/bar` Befehl genutzt werden. - Beispiel: `/bar toggle nicklist` (siehe Befehl <<command_weechat_bar,/bar>>). - -| separator | `on`, `off` | - Ist diese Option `on`, wird ein Separator (Linie) gezeichnet die eine Bar von anderen - Bars oder dem Chatbereich trennt. - -| items | string | - Eine Aufzählung von _items_ (siehe <<bar_items,items>> für weitere Informationen). - -| filling_left_right | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | - Art, wie der Inhalt der Bar die `links` oder `rechts` gezeichnet wird, dargestellt wird (siehe - <<bar_filling,filling>> für weitere Informationen). - -| filling_top_bottom | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | - Art, wie der Inhalt der Bar die `oben` oder `unten` gezeichnet wird, dargestellt wird (siehe - <<bar_filling,filling>> für weitere Informationen). - -| conditions | string | - Bedingungen, wann die Bar angezeigt wird (siehe <<bar_conditions,conditions>> für weitere - Informationen). -|=== - -[[bar_items]] -==== Items - -Die Option _items_ ist ein String, mit einer Anzahl von Bar-Items. Diese werden -durch Kommata voneinander getrennt (auf dem Bildschirm wird das Komma durch ein -Leerzeichen ersetzt). Möchte man die Items ohne Leerzeichen darstellen, nutzt -man ein `+++` um die Items zu trennen. - -Eine Liste von Bar-Items kann man sich mit dem Befehl `/bar listitems` anzeigen lassen. - -Vor oder nach dem Item können Zeichen eingefügt werden. Diese dürfen nicht alphanumerisch, -`+-+` oder `+_+` sein. Die Zeichen werden mit der entsprechenden Farbe, für Trennzeichen, -dargestellt (Option _color_delim_). - -Beispiel einer Bar mit den Items, "[time],buffer_number+:+buffer_plugin+.+buffer_name": - -.... -┌───────────────────────────────────────────────────────────────────────────┐ -│[12:55] 3:irc/libera.#weechat │ -└───────────────────────────────────────────────────────────────────────────┘ -.... - -Eine Besonderheit stellt die Möglichkeit dar, ein Item eines bestimmten Buffers -anzuzeigen. Syntax: "@buffer:item" ("buffer" ist der vollständige Name des Buffers -und "item" der Name der Bar-Item) - -Dies ist für root-Bars sinnvoll, um gezielt ein Item eines bestimmten Buffers -anzuzeigen, welcher nicht im aktuellen Fenster oder überhaupt nicht sichtbar -ist. - -Beispiel: Benutzerliste von bitlbee permanent in einer root-Bar darstellen (die Bar -heißt hierbei _bitlist_ und der Name des bitlbee Servers _bitlbee_): - ----- -/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" ----- - -[[bar_filling]] -==== Darstellung innerhalb einer Bar - -Es gibt folgende vier Möglichkeiten um Text innerhalb einer Bar darzustellen: - -* `+horizontal+`: die Items werden horizontal, von links nach rechts, dargestellt. - Sollten neue Zeilen dargestellt werden, dann werden diese durch ein Leerzeichen - von der vorherigen getrennt. -* `+vertical+`: die Items werden von oben nach unten dargestellt. Neue Zeilen werden - neben der vorherigen dargestellt. -* `+columns_horizontal+`: Item werden in Spalten dargestellt, wobei der Text linksbündig - ausgerichtet ist. Das erste Item wird in der linken oberen Ecke angezeigt und das - zweite Item ist in der selben Zeile, auf der rechten Seite. -* `+columns_vertical+`: Item werden in Spalten dargestellt, wobei der Text linksbündig - ausgerichtet ist. Das erste Item wird in der linken oben Ecke angezeigt und das - zweite Item wird eine Zeile darunter angezeigt. - -Die Standard-Bars _title_, _status_ und _input_ nutzen eine _horizontal_ -Darstellung und die Standard-Bar _nicklist_ nutzt eine _vertical_ Darstellung. - -Einige Beispiele, wie die Bar _nicklist_ dargestellt werden kann: - -.... -┌───────────────────────────────────────────────────────────────────────┐ -│Welcome to #test, this is a test channel │ -│12:54:15 peter | hey! │@carl │ -│12:55:01 +Max | hello │@jessika│ -│ │@maddy │ -│ │%Diego │ -│ │%Melody │ -│ │+Max │ -│ │ celia │ -│ │ Eva │ -│ │ freddy │ -│ │ Harold^│ -│ │ henry4 │ -│ │ jimmy17│ -│ │ jodie ▼│ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│Welcome to #test, this is a test channel │ -│12:54:15 peter | hey! │@carl lee │ -│12:55:01 +Max | hello │@jessika louise │ -│ │@maddy mario │ -│ │%Diego mark │ -│ │%Melody peter │ -│ │+Max Rachel │ -│ │ celia richard│ -│ │ Eva sheryl │ -│ │ freddy Vince │ -│ │ Harold^ warren │ -│ │ henry4 zack │ -│ │ jimmy17 │ -│ │ jodie │ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl %Diego celia Harold^ jodie mario Rachel Vince │ -│@jessika %Melody Eva henry4 lee mark richard warren │ -│@maddy +Max freddy jimmy17 louise peter sheryl zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ -│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ -│ mark peter Rachel richard sheryl Vince warren zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_horizontal ▲ -.... - -[[bar_conditions]] -==== Bedingungen - -Der Inhalt der Option _conditions_ ist evaluiert um festzulegen ob die entsprechende -Bar angezeigt werden soll oder nicht. - -Folgende Zeichenketten sind möglich: - -* _active_ : das Fenster muss das aktive Fenster sein -* _inactive_: das Fenster muss ein inaktives Fenster sein -* _nicklist_: der Buffer der in einem Fenster dargestellt wird, muss eine - Benutzerliste anzeigen. -* ein Ausdruck: wird als boolescher Wert ausgewertet (siehe Befehl - <<command_weechat_eval,/eval>>) - -Für den Ausdruck sind folgende Variablen verfügbar: - -* `+${active}+` : wahr, wenn Fenster aktiv ist -* `+${inactive}+`: wahr, wenn Fenster inaktiv ist -* `+${nicklist}+`: wahr, wenn der Buffer im Fenster eine Nicklist anzeigt. - -Folgende Zeiger sind verfügbar: - -* `+${window}+`: das Fenster in dem der Zustand ausgewertet wird -* `+${buffer}+`: der Buffer eines Fensters in dem der Zustand ausgewertet wird - -Beispiel für die Anzeige der Nicklist-Bar in allen Buffern mit einer Benutzerliste, -allerdings nur dann, wenn die Breite des Terminals größer >100 ist: - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" ----- - -Die selben Bedingungen wie oben, aber diesmal wird die Benutzerliste immer für -den Buffer _&bitlbee_ angezeit (auch dann, wenn das Terminal kleiner ist, als -der angegebene Wert): - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" ----- - [[bare_display]] === einfacher Anzeigemodus @@ -1771,165 +1436,21 @@ Der selbe Bildschirm sieht im vereinfachten Anzeigemodus wie folgt aus: Es kann nun die URL von _joe_ ohne Probleme angeklickt werden (dies setzt natürlich voraus, dass der Terminal das Anwählen von URLs unterstützt). -[[notify_levels]] -=== Benachrichtigungsstufen - -[[setup_notify_levels]] -==== Benachrichtigungsstufen einstellen - -Es gibt vier Benachrichtigungsstufen für Nachrichten, welche in Buffern dargestellt -werden. Nachfolgend eine Liste, sortiert von niedrig nach hoch: - -* _low_: Nachricht mit einer geringen Wertigkeit (zum Beispiel: IRC join/part/quit) -* _message_: Nachricht von einem User -* _private_: Nachricht in einem privaten Buffer -* _highlight_: wenn es sich um eine _highlight_ Nachricht handelt - -Jeder Buffer besitzt eine Benachrichtigungsstufe, um festzulegen, bei welchen Nachrichten -der entsprechende Buffer in der Hotlist angezeigt werden soll. - -Der Wert für die Benachrichtigungsstufe kann mittels folgender Option festgelegt -werden: -<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>, -Der Standardwert ist _all_. - -[width="75%",cols="2m,7",options="header"] -|=== -| Benachrichtigungsstufe | Welche Nachrichten Berücksichtigung in der Hotlist finden -| none | (keine) -| highlight | _highlight_ + _private Nachrichten_ -| message | _highlight_ + _private Nachrichten_ + _normale Nachrichten_ -| all | _highlight_ + _private Nachrichten_ + _normal Nachrichten_ + _Nachrichten mit einer niedrigen Priorität_ -|=== - -Benachrichtigungsstufen können für mehrere Buffer definiert werden. Zum Beispiel -für alle Buffer des IRC Servers "libera": - ----- -/set weechat.notify.irc.libera message ----- - -Setzt die Benachrichtigungsstufe ausschließlich für den Channel "#weechat", -auf die Stufe _highlight_: - ----- -/set weechat.notify.irc.libera.#weechat highlight ----- - -Die Benachrichtigungsstufe für einen Buffer kann mittels dem `/buffer` -Befehl festgelegt werden: - ----- -/buffer notify highlight ----- - -[[max_hotlist_level_nicks]] -==== Maximaler Hotlist-Level für Nicks - -Es ist möglich den sogenannten maximalen Hotlist-Level für einzele Nicks einzustellen, -per Buffer oder für mehrere Gruppen (wie IRC Server). - -Die Buffer-Eigenschaft "hotlist_max_level_nicks" kann mit einer Anzahl von Nicks genutzt werden -und für jeden einzelen Nick kann ein maximler Hotlist-Level eingestellt wertden. Mögliche Stufen sind: - -* -1: keine Änderungen an der Hotlist für den entsprechenden Nick -* 0: niedrige Priorität (zum Beispiel join/part Nachrichten) -* 1: Nachricht -* 2: private Nachricht -* 3: Highlight (eigentlich unnötig, da es standardmäßig die höchste Stufe für alle Nachrichten ist) - -Um zum Beispiel Highlights von "joe" und "mike" im aktuellen Buffer zu deaktivieren: - ----- -/buffer set hotlist_max_level_nicks_add joe:2,mike:2 ----- - -[NOTE] -Die Buffer-Eigenschaft "hotlist_max_level_nicks" ist keine permanente Einstellung und wird nicht -in der Konfigurationsdatei gesichert. + Um diese Einstellung persistent zu machen benötigt man -das Skript _buffer_autoset.py_: Um das Skript zu installieren `+/script install buffer_autoset.py+` -und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. - -[[highlights]] -=== Highlights - -[[highlights_words]] -==== Worte als Highlights hinzufügen - -Standardmäßig werden in WeeChat alle Nachrichten von anderen Personen als highlight -deklariert wenn diese den eigenen Nick beinhalten, deshalb ist ein highlight abhängig -vom jeweiligen Buffer (ein Nick kann in je nach Buffer unterschiedlich sein) - -Es können weitere Wörter zu den highlights hinzugefügt werden, mit der Option -<<option_weechat.look.highlight,weechat.look.highlight>>, zum Beispiel um -neben dem eigenen Nick auch die Wörter "Wort1","Wort2" und alle Wörter die mit -"Test" beginnen zu highlighten: - ----- -/set weechat.look.highlight Wort1,Wort2,Test* ----- - -Wird eine spezielle Regel benötigt, dann können reguläre Ausdrücke -verwendet werden. Dazu sollte man folgende Option nutzen: -<<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, -um zum Beispiel die Wörter "flashcode", "flashcöde" und "flashy" -zu highlighten: - ----- -/set weechat.look.highlight_regex flashc[oö]de|flashy ----- - -Die Trennzeichen die Wörter umschließen können angepasst werden, mit der -Option: <<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>>. - -[[highlights_tags]] -==== Tags zu highlight hinzufügen - -Zeilen die in einem Buffer dargestellt werden enthalten "tags" welche zusätzliche -Informationen über die Herkunft der Nachricht oder über die Nachricht selbst -beinhalten. + Diese "tags" können mit dem Befehl `/debug tags` dargestellt werden -(um die Anzeige wieder zu entfernen, nochmals den Befehl ausführen). - -Um Tags als Highlights zu nutzen wird folgende Option verwendet: -<<option_weechat.look.highlight_tags,weechat.look.highlight_tags>>. -Tags werden durch Kommata getrennt und mehrere Tags können mit -`+++` genutzt werden um ein logischen "und" zu erstellen. - -Zum Beispiel um alle Nachrichten vom Nick "FlashCode" und alle notice-Nachrichten -von Nicks die mit "toto" beginnen zu highlighten: - ----- -/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" ----- - -[[highlights_regex_buffer]] -==== Highlights mit regulärem Ausdruck für einen Buffer nutzen - -Man kann reguläre Ausdrücke für Highlights in einem Buffer nutzen indem man -die Eigenschaft des Buffers mittels "highlight_regex" anpasst. - -Um zum Beispiel jede Nachricht im aktuellen Buffer als Highlight-Nachricht einzustufen: - ----- -/buffer set highlight_regex .* ----- - -[NOTE] -Die Buffer-Eigenschaft "highlight_regex" ist keine permanente Einstellung und wird nicht -in der Konfigurationsdatei gesichert. + Um diese Einstellung persistent zu machen benötigt man -das Skript _buffer_autoset.py_: Um das Skript zu installieren `+/script install buffer_autoset.py+` -und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. - +// TRANSLATION MISSING [[key_bindings]] -=== Standard Tastenbelegung +== Key bindings + +// TRANSLATION MISSING +WeeChat provides a lot of default key bindings, listed in the following chapters. + +They can be changed and new ones can be added with the <<command_weechat_key,/key>> command. // TRANSLATION MISSING [[key_bindings_cmdline]] -==== Command line +=== Command line // TRANSLATION MISSING [[key_bindings_cmdline_cursor_movement]] -===== Cursor movement +==== Cursor movement [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1950,7 +1471,7 @@ und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. // TRANSLATION MISSING [[key_bindings_cmdline_editing]] -===== Editing +==== Editing [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1979,7 +1500,7 @@ und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. // TRANSLATION MISSING [[key_bindings_cmdline_color_codes]] -===== Color codes +==== Color codes [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1994,7 +1515,7 @@ und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. // TRANSLATION MISSING [[key_bindings_cmdline_history]] -===== Command history +==== Command history [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2007,7 +1528,7 @@ und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. // TRANSLATION MISSING [[key_bindings_buffers]] -==== Buffers +=== Buffers [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2046,7 +1567,7 @@ und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. // TRANSLATION MISSING [[key_bindings_windows]] -==== Windows +=== Windows [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2066,7 +1587,7 @@ und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. // TRANSLATION MISSING [[key_bindings_bars]] -==== Bars +=== Bars [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2091,7 +1612,7 @@ und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. // TRANSLATION MISSING [[key_bindings_hotlist]] -==== Hotlist +=== Hotlist [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2105,7 +1626,7 @@ und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. // TRANSLATION MISSING [[key_bindings_toggle_keys]] -==== Toggle keys +=== Toggle keys [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2118,7 +1639,7 @@ und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. // TRANSLATION MISSING [[key_bindings_search_context]] -==== Search context +=== Search context Diese Tasten werden im Kontext "search" verwendet (wenn kbd:[Ctrl+r] genutzt wird um in einem Buffer nach einem Text zu suchen). @@ -2139,7 +1660,7 @@ in einem Buffer nach einem Text zu suchen). // TRANSLATION MISSING [[key_bindings_cursor_context]] -==== Cursor context +=== Cursor context Diese Tasten werden im Kontext "cursor" verwendet (Cursor kann frei auf dem Bildschirm bewegt werden) @@ -2169,7 +1690,7 @@ Diese Tasten werden im Kontext "cursor" verwendet (Cursor kann frei auf dem Bild // TRANSLATION MISSING [[key_bindings_mouse]] -==== Mouse +=== Mouse // TRANSLATION MISSING These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] @@ -2224,7 +1745,7 @@ These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] // TRANSLATION MISSING [[key_bindings_fset_buffer]] -==== Fset buffer +=== Fset buffer Diese Tasten und Aktionen werden im fset-Buffer verwendet (siehe <<fset_plugin,Fset Erweiterung>>). @@ -2271,7 +1792,7 @@ Diese Tasten und Aktionen werden im fset-Buffer verwendet (siehe <<fset_plugin,F // TRANSLATION MISSING [[key_bindings_script_buffer]] -==== Script buffer +=== Script buffer Diese Tasten und Aktionen werden im fset-Buffer verwendet (siehe <<scripts_plugins,Skript Erweiterung>>). @@ -2294,6 +1815,265 @@ Diese Tasten und Aktionen werden im fset-Buffer verwendet (siehe <<scripts_plugi [NOTE] ^(1)^ Die Aktion muss als Eingabe in die Befehlszeile eingegeben werden, gefolgt von kbd:[Enter]. +// TRANSLATION MISSING +[[configuration]] +== Configuration + +// TRANSLATION MISSING +[[colors]] +=== Colors + +[[colors_basic]] +==== Basisfarben + +Basisfarben in WeeChat sind: + +[width="75%",cols="1m,4",options="header"] +|=== +| Name | Farbe +| default | Standard Terminalfarbe (transparent für Hintergrund) +| black | Schwarz +| darkgray | Dunkelgrau +| red | Dunkelrot +| lightred | Hellrot +| green | Dunkelgrün +| lightgreen | Hellgrün +| brown | Braun +| yellow | Gelb +| blue | Dunkelblau +| lightblue | Hellblau +| magenta | Dunkel magenta +| lightmagenta | Hell magenta +| cyan | Dunkel türkis +| lightcyan | Hell türkis +| gray | Grau +| white | Weiß +|=== + +[[colors_extended]] +==== erweiterte Farbpalette + +WeeChat belegt die Farbpaare dynamisch, sobald die Farbe genutzt werden sollte. Zum Beispiel +um mit einer Farbe Buffer oder Bars zu nutzen. + +Zu den Basisfarben können zusätzlich Farben zwischen eins und der maximalen Anzahl an Farben +genutzt werden die vom jeweiligen Terminal zur Verfügung gestellt werden. + +Mit dem `/color` Befehl kann man sich sowohl die aktuelle Farbpalette anzeigen lassen als +auch die Anzahl der zu nutzenden Farben. Mit kbd:[Alt+c] kann man vorübergehend zu den +Terminalfarben wechseln um eine Farbe auszuwählen. + +Um zum Beispiel die Uhrzeit in einem Buffer in einem schönen Orange darzustellen: + +---- +/set weechat.color.chat_time 214 +---- + +oder falls man den Hintergrund der Statusbar in einm sehr dunklen Grün haben möchte: + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== Alias + +Man kann einer Farbe einen Alias zuordnen um diesen Alias anstelle einer Zahl in +die Optionen einzutragen. Um einen Alias zu definieren nutzt man den Befehl +`/color alias`. + +Beispiel: + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== Attribute + +Er ist möglich einer Farbe ein Attribut hinzuzufügen. Dazu wird dem +Farbnamen oder der Farbnummer ein- oder mehrere Attribute vorangestellt. + +* `+*+` : fett +* `+!+` : invertierte Darstellung +* `+/+` : kursiven +* `+_+` : unterstrichen +* `+|+` : behält Attribut bei: fett, invertierte Darstellung, Unterstrichen wird beim Farbwechsel nicht zurückgesetzt + +Um zum Beispiel dem eigenen Nick die Farbe weiß und unterstrichen +zuzuordnen: + +---- +/set weechat.color.chat_nick_self _white +---- + +oder um die Zeitanzeige in der Statusbar orange, fett und unterstrichen +darzustellen: + +---- +/set weechat.color.status_time *_214 +---- + +Um einer Standard-Terminalfarbe (-1) ein Attribut hinzuzufügen muss eine Zahl +gewählt werden die größer ist als die letzte genutzte Farbe des Terminals. +Zum Beispiel; maximale Farbwahl in WeeChat: 99999. + +Um der Vordergrundfarbe des Terminals das Attribut "fett" zuzuordnen: + +---- +/set weechat.color.status_time *99999 +---- + +[[notify_levels]] +=== Benachrichtigungsstufen + +[[setup_notify_levels]] +==== Benachrichtigungsstufen einstellen + +Es gibt vier Benachrichtigungsstufen für Nachrichten, welche in Buffern dargestellt +werden. Nachfolgend eine Liste, sortiert von niedrig nach hoch: + +* _low_: Nachricht mit einer geringen Wertigkeit (zum Beispiel: IRC join/part/quit) +* _message_: Nachricht von einem User +* _private_: Nachricht in einem privaten Buffer +* _highlight_: wenn es sich um eine _highlight_ Nachricht handelt + +Jeder Buffer besitzt eine Benachrichtigungsstufe, um festzulegen, bei welchen Nachrichten +der entsprechende Buffer in der Hotlist angezeigt werden soll. + +Der Wert für die Benachrichtigungsstufe kann mittels folgender Option festgelegt +werden: +<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>, +Der Standardwert ist _all_. + +[width="75%",cols="2m,7",options="header"] +|=== +| Benachrichtigungsstufe | Welche Nachrichten Berücksichtigung in der Hotlist finden +| none | (keine) +| highlight | _highlight_ + _private Nachrichten_ +| message | _highlight_ + _private Nachrichten_ + _normale Nachrichten_ +| all | _highlight_ + _private Nachrichten_ + _normal Nachrichten_ + _Nachrichten mit einer niedrigen Priorität_ +|=== + +Benachrichtigungsstufen können für mehrere Buffer definiert werden. Zum Beispiel +für alle Buffer des IRC Servers "libera": + +---- +/set weechat.notify.irc.libera message +---- + +Setzt die Benachrichtigungsstufe ausschließlich für den Channel "#weechat", +auf die Stufe _highlight_: + +---- +/set weechat.notify.irc.libera.#weechat highlight +---- + +Die Benachrichtigungsstufe für einen Buffer kann mittels dem `/buffer` +Befehl festgelegt werden: + +---- +/buffer notify highlight +---- + +[[max_hotlist_level_nicks]] +==== Maximaler Hotlist-Level für Nicks + +Es ist möglich den sogenannten maximalen Hotlist-Level für einzele Nicks einzustellen, +per Buffer oder für mehrere Gruppen (wie IRC Server). + +Die Buffer-Eigenschaft "hotlist_max_level_nicks" kann mit einer Anzahl von Nicks genutzt werden +und für jeden einzelen Nick kann ein maximler Hotlist-Level eingestellt wertden. Mögliche Stufen sind: + +* -1: keine Änderungen an der Hotlist für den entsprechenden Nick +* 0: niedrige Priorität (zum Beispiel join/part Nachrichten) +* 1: Nachricht +* 2: private Nachricht +* 3: Highlight (eigentlich unnötig, da es standardmäßig die höchste Stufe für alle Nachrichten ist) + +Um zum Beispiel Highlights von "joe" und "mike" im aktuellen Buffer zu deaktivieren: + +---- +/buffer set hotlist_max_level_nicks_add joe:2,mike:2 +---- + +[NOTE] +Die Buffer-Eigenschaft "hotlist_max_level_nicks" ist keine permanente Einstellung und wird nicht +in der Konfigurationsdatei gesichert. + Um diese Einstellung persistent zu machen benötigt man +das Skript _buffer_autoset.py_: Um das Skript zu installieren `+/script install buffer_autoset.py+` +und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. + +[[highlights]] +=== Highlights + +[[highlights_words]] +==== Worte als Highlights hinzufügen + +Standardmäßig werden in WeeChat alle Nachrichten von anderen Personen als highlight +deklariert wenn diese den eigenen Nick beinhalten, deshalb ist ein highlight abhängig +vom jeweiligen Buffer (ein Nick kann in je nach Buffer unterschiedlich sein) + +Es können weitere Wörter zu den highlights hinzugefügt werden, mit der Option +<<option_weechat.look.highlight,weechat.look.highlight>>, zum Beispiel um +neben dem eigenen Nick auch die Wörter "Wort1","Wort2" und alle Wörter die mit +"Test" beginnen zu highlighten: + +---- +/set weechat.look.highlight Wort1,Wort2,Test* +---- + +Wird eine spezielle Regel benötigt, dann können reguläre Ausdrücke +verwendet werden. Dazu sollte man folgende Option nutzen: +<<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, +um zum Beispiel die Wörter "flashcode", "flashcöde" und "flashy" +zu highlighten: + +---- +/set weechat.look.highlight_regex flashc[oö]de|flashy +---- + +Die Trennzeichen die Wörter umschließen können angepasst werden, mit der +Option: <<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>>. + +[[highlights_tags]] +==== Tags zu highlight hinzufügen + +Zeilen die in einem Buffer dargestellt werden enthalten "tags" welche zusätzliche +Informationen über die Herkunft der Nachricht oder über die Nachricht selbst +beinhalten. + Diese "tags" können mit dem Befehl `/debug tags` dargestellt werden +(um die Anzeige wieder zu entfernen, nochmals den Befehl ausführen). + +Um Tags als Highlights zu nutzen wird folgende Option verwendet: +<<option_weechat.look.highlight_tags,weechat.look.highlight_tags>>. +Tags werden durch Kommata getrennt und mehrere Tags können mit +`+++` genutzt werden um ein logischen "und" zu erstellen. + +Zum Beispiel um alle Nachrichten vom Nick "FlashCode" und alle notice-Nachrichten +von Nicks die mit "toto" beginnen zu highlighten: + +---- +/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" +---- + +[[highlights_regex_buffer]] +==== Highlights mit regulärem Ausdruck für einen Buffer nutzen + +Man kann reguläre Ausdrücke für Highlights in einem Buffer nutzen indem man +die Eigenschaft des Buffers mittels "highlight_regex" anpasst. + +Um zum Beispiel jede Nachricht im aktuellen Buffer als Highlight-Nachricht einzustufen: + +---- +/buffer set highlight_regex .* +---- + +[NOTE] +Die Buffer-Eigenschaft "highlight_regex" ist keine permanente Einstellung und wird nicht +in der Konfigurationsdatei gesichert. + Um diese Einstellung persistent zu machen benötigt man +das Skript _buffer_autoset.py_: Um das Skript zu installieren `+/script install buffer_autoset.py+` +und um eine Hilfe zu erhalten wie man es nutzt: `+/help buffer_autoset+`. + [[mouse]] === Mausunterstützung @@ -2417,6 +2197,240 @@ Den Namen eines Mausereignisses kann man mittels des Befehls `+/input grab_mouse Man führt den Befehl in der Eingabezeile aus und startet das Ereignis. Als Ergebnis erhält man in der Eingabezeile den Namen des ausgeführten Mausereignisses. +[[bars]] +=== Bars + +Eine _Bar_ ist ein Bereich der parallel, zum Chatfenster, jedwede Art von Text enthalten kann. + +Eine Bar kann mittels `weechat.bar.name.option` konfiguriert werden. Dabei steht `name`, +für den Namen der Bar und `option` für die Option dieser Bar. + +Aufzählung von Bar-Optionen: + +[width="100%",cols="2m,2,10",options="header"] +|=== +| Option | Wert | Beschreibung + +| type | `root`, `window` | + Eine Bar vom Typ `root` wird nur einmal auf dem Bildschirm dargestellt und dies + außerhalb von Fenstern. Die Standardbar _buflist_ ist vom Typ `root`. + + Eine Bar vom Typ `window` wird hingegen in jedem Fenster dargestellt, zum Beispiel + wenn man den Bildschirm teilt (mit `/window splith` oder `/window splitv`). Diese + Bar wird nun in jedem einzelnen Fenster angezeigt. Die Standardbar _title_, _status_, + _input_ und _nicklist_ sind vom Typ `window`. + +| position | `top`, `bottom`, `left`, `right` | + Position der Bar: ober- oder unterhalb des Chatfensters, oder links/rechts davon. + +| priority | integer ≥ 0 | + Priorität für die Bar: legt die Reihenfolge fest in der die Bars angeordnet werden sollen, + wenn mehrere Bars den selben Typ und Position besitzen. + + Die Bars werden vom Rand zur Mitte des Bildschirms gezeichnet. Eine höhere Priorität + bewirkt, dass die Bar näher am Rand gezeichnet wird. + + Beispiel: Die _input_ Bar hat eine Priorität von 1000 und wird somit vor der _status_ Bars + gezeichnet, da diese lediglich eine Priorität von 500 besitzt. + +| size | integer ≥ 0 | + Die Größe der Bar: Anzahl der Spalten, falls die Bar links/rechts bzw. Anzahl an Zeilen falls + die Bar oben/unten dargestellt wird. Wird eine Größe `0` gewählt, dann wird die Größe der Bar + automatisch bestimmt. + +| size_max | integer ≥ 0 | + Die maximale Größe der Bar, `0` = keine Limitierung (diese Option wird nur genutzt, falls die + Option `size` = `0` ist). + +| color_bg | color | + Hintergrundfarbe, für die Bar. + +| color_fg | color | + Textfarbe, für die Bar. + +| color_delim | color | + Farbe der Trennzeichen, in der Bar. + +| hidden | `on`, `off` | + Ist diese Option `on`, wird die Bar versteckt. + + Hinweis: anstelle dieser Option sollte vorzugsweise der `/bar` Befehl genutzt werden. + Beispiel: `/bar toggle nicklist` (siehe Befehl <<command_weechat_bar,/bar>>). + +| separator | `on`, `off` | + Ist diese Option `on`, wird ein Separator (Linie) gezeichnet die eine Bar von anderen + Bars oder dem Chatbereich trennt. + +| items | string | + Eine Aufzählung von _items_ (siehe <<bar_items,items>> für weitere Informationen). + +| filling_left_right | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | + Art, wie der Inhalt der Bar die `links` oder `rechts` gezeichnet wird, dargestellt wird (siehe + <<bar_filling,filling>> für weitere Informationen). + +| filling_top_bottom | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | + Art, wie der Inhalt der Bar die `oben` oder `unten` gezeichnet wird, dargestellt wird (siehe + <<bar_filling,filling>> für weitere Informationen). + +| conditions | string | + Bedingungen, wann die Bar angezeigt wird (siehe <<bar_conditions,conditions>> für weitere + Informationen). +|=== + +[[bar_items]] +==== Items + +Die Option _items_ ist ein String, mit einer Anzahl von Bar-Items. Diese werden +durch Kommata voneinander getrennt (auf dem Bildschirm wird das Komma durch ein +Leerzeichen ersetzt). Möchte man die Items ohne Leerzeichen darstellen, nutzt +man ein `+++` um die Items zu trennen. + +Eine Liste von Bar-Items kann man sich mit dem Befehl `/bar listitems` anzeigen lassen. + +Vor oder nach dem Item können Zeichen eingefügt werden. Diese dürfen nicht alphanumerisch, +`+-+` oder `+_+` sein. Die Zeichen werden mit der entsprechenden Farbe, für Trennzeichen, +dargestellt (Option _color_delim_). + +Beispiel einer Bar mit den Items, "[time],buffer_number+:+buffer_plugin+.+buffer_name": + +.... +┌───────────────────────────────────────────────────────────────────────────┐ +│[12:55] 3:irc/libera.#weechat │ +└───────────────────────────────────────────────────────────────────────────┘ +.... + +Eine Besonderheit stellt die Möglichkeit dar, ein Item eines bestimmten Buffers +anzuzeigen. Syntax: "@buffer:item" ("buffer" ist der vollständige Name des Buffers +und "item" der Name der Bar-Item) + +Dies ist für root-Bars sinnvoll, um gezielt ein Item eines bestimmten Buffers +anzuzeigen, welcher nicht im aktuellen Fenster oder überhaupt nicht sichtbar +ist. + +Beispiel: Benutzerliste von bitlbee permanent in einer root-Bar darstellen (die Bar +heißt hierbei _bitlist_ und der Name des bitlbee Servers _bitlbee_): + +---- +/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" +---- + +[[bar_filling]] +==== Darstellung innerhalb einer Bar + +Es gibt folgende vier Möglichkeiten um Text innerhalb einer Bar darzustellen: + +* `+horizontal+`: die Items werden horizontal, von links nach rechts, dargestellt. + Sollten neue Zeilen dargestellt werden, dann werden diese durch ein Leerzeichen + von der vorherigen getrennt. +* `+vertical+`: die Items werden von oben nach unten dargestellt. Neue Zeilen werden + neben der vorherigen dargestellt. +* `+columns_horizontal+`: Item werden in Spalten dargestellt, wobei der Text linksbündig + ausgerichtet ist. Das erste Item wird in der linken oberen Ecke angezeigt und das + zweite Item ist in der selben Zeile, auf der rechten Seite. +* `+columns_vertical+`: Item werden in Spalten dargestellt, wobei der Text linksbündig + ausgerichtet ist. Das erste Item wird in der linken oben Ecke angezeigt und das + zweite Item wird eine Zeile darunter angezeigt. + +Die Standard-Bars _title_, _status_ und _input_ nutzen eine _horizontal_ +Darstellung und die Standard-Bar _nicklist_ nutzt eine _vertical_ Darstellung. + +Einige Beispiele, wie die Bar _nicklist_ dargestellt werden kann: + +.... +┌───────────────────────────────────────────────────────────────────────┐ +│Welcome to #test, this is a test channel │ +│12:54:15 peter | hey! │@carl │ +│12:55:01 +Max | hello │@jessika│ +│ │@maddy │ +│ │%Diego │ +│ │%Melody │ +│ │+Max │ +│ │ celia │ +│ │ Eva │ +│ │ freddy │ +│ │ Harold^│ +│ │ henry4 │ +│ │ jimmy17│ +│ │ jodie ▼│ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│Welcome to #test, this is a test channel │ +│12:54:15 peter | hey! │@carl lee │ +│12:55:01 +Max | hello │@jessika louise │ +│ │@maddy mario │ +│ │%Diego mark │ +│ │%Melody peter │ +│ │+Max Rachel │ +│ │ celia richard│ +│ │ Eva sheryl │ +│ │ freddy Vince │ +│ │ Harold^ warren │ +│ │ henry4 zack │ +│ │ jimmy17 │ +│ │ jodie │ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl %Diego celia Harold^ jodie mario Rachel Vince │ +│@jessika %Melody Eva henry4 lee mark richard warren │ +│@maddy +Max freddy jimmy17 louise peter sheryl zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ +│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ +│ mark peter Rachel richard sheryl Vince warren zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_horizontal ▲ +.... + +[[bar_conditions]] +==== Bedingungen + +Der Inhalt der Option _conditions_ ist evaluiert um festzulegen ob die entsprechende +Bar angezeigt werden soll oder nicht. + +Folgende Zeichenketten sind möglich: + +* _active_ : das Fenster muss das aktive Fenster sein +* _inactive_: das Fenster muss ein inaktives Fenster sein +* _nicklist_: der Buffer der in einem Fenster dargestellt wird, muss eine + Benutzerliste anzeigen. +* ein Ausdruck: wird als boolescher Wert ausgewertet (siehe Befehl + <<command_weechat_eval,/eval>>) + +Für den Ausdruck sind folgende Variablen verfügbar: + +* `+${active}+` : wahr, wenn Fenster aktiv ist +* `+${inactive}+`: wahr, wenn Fenster inaktiv ist +* `+${nicklist}+`: wahr, wenn der Buffer im Fenster eine Nicklist anzeigt. + +Folgende Zeiger sind verfügbar: + +* `+${window}+`: das Fenster in dem der Zustand ausgewertet wird +* `+${buffer}+`: der Buffer eines Fensters in dem der Zustand ausgewertet wird + +Beispiel für die Anzeige der Nicklist-Bar in allen Buffern mit einer Benutzerliste, +allerdings nur dann, wenn die Breite des Terminals größer >100 ist: + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" +---- + +Die selben Bedingungen wie oben, aber diesmal wird die Benutzerliste immer für +den Buffer _&bitlbee_ angezeit (auch dann, wenn das Terminal kleiner ist, als +der angegebene Wert): + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" +---- + [[secured_data]] === sensible Daten diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc index d435972a2..bd9c412a0 100644 --- a/doc/en/weechat_user.en.adoc +++ b/doc/en/weechat_user.en.adoc @@ -631,6 +631,53 @@ Some environment variables are used by WeeChat if they are defined: | WEECHAT_EXTRA_LIBDIR | An extra directory to load plugins (from the "plugins" directory in this path). |=== +[[colors_support]] +=== Colors support + +WeeChat can use up to 32767 color pairs to display text in bars and chat area +(your terminal must support 256 colors to use them in WeeChat). + +According to value of _TERM_ environment variable, you may have following limits +for colors in WeeChat: + +[width="75%",cols="8,>3,>3",options="header"] +|=== +| $TERM | Colors | Pairs +| "rxvt-unicode", "xterm", ... | 88 | 32767 +| "rxvt-256color", "xterm-256color", ... | 256 | 32767 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 32767 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 32767 +|=== + +You can run `weechat --colors` or use command `/color` in WeeChat to +display limits for your environment. + +Some recommended values for _TERM_ if you want 256 colors: + +* under screen: _screen-256color_ +* under tmux: _screen-256color_ or _tmux-256color_ +* outside screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... + +[NOTE] +You may have to install package "ncurses-term" to use these values in _TERM_ +variable. + +If you are using screen, you can add this line to your _~/.screenrc_: + +---- +term screen-256color +---- + +If your _TERM_ variable has wrong value and that WeeChat is already running, +you can change it with these two commands: + +---- +/set env TERM screen-256color +/upgrade +---- + [[files_and_directories]] === Files and directories @@ -959,151 +1006,6 @@ kbd:[!] In irc plugin, you can remap these colors using option <<option_irc.color.mirc_remap,irc.color.mirc_remap>>. -[[colors]] -=== Colors - -WeeChat can use up to 32767 color pairs to display text in bars and chat area -(your terminal must support 256 colors to use them in WeeChat). - -According to value of _TERM_ environment variable, you may have following limits -for colors in WeeChat: - -[width="75%",cols="8,>3,>3",options="header"] -|=== -| $TERM | Colors | Pairs -| "rxvt-unicode", "xterm", ... | 88 | 32767 -| "rxvt-256color", "xterm-256color", ... | 256 | 32767 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 32767 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 32767 -|=== - -You can run `weechat --colors` or use command `/color` in WeeChat to -display limits for your environment. - -Some recommended values for _TERM_ if you want 256 colors: - -* under screen: _screen-256color_ -* under tmux: _screen-256color_ or _tmux-256color_ -* outside screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... - -[NOTE] -You may have to install package "ncurses-term" to use these values in _TERM_ -variable. - -If you are using screen, you can add this line to your _~/.screenrc_: - ----- -term screen-256color ----- - -If your _TERM_ variable has wrong value and that WeeChat is already running, -you can change it with these two commands: - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== Basic colors - -Basic colors in WeeChat are: - -[width="75%",cols="1m,4",options="header"] -|=== -| Name | Color -| default | Default terminal color (transparent for background) -| black | Black -| darkgray | Dark gray -| red | Dark red -| lightred | Light red -| green | Dark green -| lightgreen | Light green -| brown | Brown -| yellow | Yellow -| blue | Dark blue -| lightblue | Light blue -| magenta | Dark magenta -| lightmagenta | Light magenta -| cyan | Dark cyan -| lightcyan | Light cyan -| gray | Gray -| white | White -|=== - -[[colors_extended]] -==== Extended colors - -WeeChat dynamically allocates color pairs when colors are used on screen (to -display buffers and bars). - -In addition to basic colors, you can use a color number between 1 and the limit -of your terminal. - -Use command `/color` to see current colors and limits. With kbd:[Alt+c] you can -temporarily switch to terminal colors to choose a color. - -For example if you want to display time in orange in buffer, do: - ----- -/set weechat.color.chat_time 214 ----- - -Or if you want a very dark green background for status bar: - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== Aliases - -You can add color aliases with command `/color alias` and then use this alias -in any color option. - -For example: - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== Attributes - -It is possible to use some attributes for colors. One or more attributes can be -added before color name or number: - -* `+*+`: bold text -* `+!+`: reverse video -* `+/+`: italic -* `+_+`: underlined text -* `+|+`: keep attributes: do not reset bold/reverse/italic/underlined when - changing color - -For example if you want self nick as white underlined, do: - ----- -/set weechat.color.chat_nick_self _white ----- - -Or if you want time in status bar as orange underlined with bold: - ----- -/set weechat.color.status_time *_214 ----- - -To use an attribute with default terminal color (-1), you must use a number -greater than last terminal color, for example max color in WeeChat: 99999. - -Example of bold with terminal foreground color: - ----- -/set weechat.color.status_time *99999 ----- - [[buffers_and_windows]] === Buffers and windows @@ -1426,233 +1328,6 @@ By default WeeChat and its default plugins interpret these variables: [NOTE] External plugins and scripts can define and use other local variables. -[[bars]] -=== Bars - -A _bar_ is an area beside the chat that can contain any type of text. - -The bar options can be set with options `weechat.bar.name.option` where `name` -is the name of the bar and `option` the option for this bar. - -List of bar options: - -[width="100%",cols="2m,2,10",options="header"] -|=== -| Option | Values | Description - -| type | `root`, `window` | - A bar with type `root` is displayed exactly one time on screen, outside all - windows. The default bar _buflist_ has type `root`. + - A bar with type `window` is displayed in each window, for example if you - split one time the screen (with `/window splith` or `/window splitv`), you - will have one bar in each window. The default bars _title_, _status_, - _input_ and _nicklist_ have type `window`. - -| position | `top`, `bottom`, `left`, `right` | - Position of the bar: above/below chat, on the left/right. - -| priority | integer ≥ 0 | - Priority for display of bar: this is used for ordering the bars on screen when - many bars have same type and position. + - The bars are displayed from the edge of the screen to the center. A higher - priority will display bar at the beginning, so closer to the edge. + - Example: _input_ bar has priority 1000, so it is displayed before the _status_ - bar, which has priority 500. - -| size | integer ≥ 0 | - The size of the bar: number of columns for position left/right, number - of lines for position top/bottom. A size of `0` means automatic, so the size - will be computed according to content displayed in bar. - -| size_max | integer ≥ 0 | - The maximum size for a bar, `0` = no limit (this option is used only if - `size` = `0`). - -| color_bg | color | - The default background color for the bar. - -| color_fg | color | - The default text color for the bar. - -| color_delim | color | - The color for delimiters in bar. - -| hidden | `on`, `off` | - When option is `on`, the bar is hidden. + - Note: instead of changing this option, the command `/bar` is preferred, for - example: `/bar toggle nicklist` (see command <<command_weechat_bar,/bar>>). - -| separator | `on`, `off` | - When option is `on`, a separator (line) is displayed between this bar and - other bars (or chat). - -| items | string | - A list of _items_ (see <<bar_items,items>> for more info). - -| filling_left_right | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | - Type of filling for a bar which has position `left` or `right` (see - <<bar_filling,filling>> for more info). - -| filling_top_bottom | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | - Type of filling for a bar which has position `top` or `bottom` (see - <<bar_filling,filling>> for more info). - -| conditions | string | - The conditions to display the bar (see <<bar_conditions,conditions>> for more - info). -|=== - -[[bar_items]] -==== Items - -The option _items_ is a string with a list of bar items, separated by a comma -(space between items on screen) or `+++` (glued items). - -The list of bar items is displayed with command `/bar listitems`. - -Before or after item name, you can use chars (that are not alphanumeric, `+-+` -or `+_+`). They will be displayed before/after item with the delimiters color -defined in bar (option _color_delim_). - -Example of bar with items "[time],buffer_number+:+buffer_plugin+.+buffer_name": - -.... -┌───────────────────────────────────────────────────────────────────────────┐ -│[12:55] 3:irc/libera.#weechat │ -└───────────────────────────────────────────────────────────────────────────┘ -.... - -A special syntax can be used to force the buffer used when displaying the bar -item: "@buffer:item" (where "buffer" is the full name of buffer and "item" is -the name of a bar item). - -This is useful in root bars, to display item for a specific buffer which is -not displayed in the current window (or even not displayed at all). - -Example: nicklist of bitlbee in a root bar (if the bar is called -_bitlist_ and if bitlbee server is called _bitlbee_): - ----- -/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" ----- - -[[bar_filling]] -==== Filling - -There are four types of filling: - -* `+horizontal+`: the items are displayed horizontally, from left to right. If - there are new lines in items, a space is used to separate lines. -* `+vertical+`: the items are displayed from top to bottom. If there are new - lines in items, a new line is used to separate lines. -* `+columns_horizontal+`: items are displayed using columns, where text is - aligned on the left. The first item is on top left, the second is on same - line, on the right. -* `+columns_vertical+`: items are displayed using columns, where text is aligned - on the left. The first item is on top left, the second is one line below. - -Default bars _title_, _status_ and _input_ have _horizontal_ filling, and -default bar _nicklist_ has _vertical_ filling. - -Some examples of filling for bar _nicklist_: - -.... -┌───────────────────────────────────────────────────────────────────────┐ -│Welcome to #test, this is a test channel │ -│12:54:15 peter | hey! │@carl │ -│12:55:01 +Max | hello │@jessika│ -│ │@maddy │ -│ │%Diego │ -│ │%Melody │ -│ │+Max │ -│ │ celia │ -│ │ Eva │ -│ │ freddy │ -│ │ Harold^│ -│ │ henry4 │ -│ │ jimmy17│ -│ │ jodie ▼│ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│Welcome to #test, this is a test channel │ -│12:54:15 peter | hey! │@carl lee │ -│12:55:01 +Max | hello │@jessika louise │ -│ │@maddy mario │ -│ │%Diego mark │ -│ │%Melody peter │ -│ │+Max Rachel │ -│ │ celia richard│ -│ │ Eva sheryl │ -│ │ freddy Vince │ -│ │ Harold^ warren │ -│ │ henry4 zack │ -│ │ jimmy17 │ -│ │ jodie │ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl %Diego celia Harold^ jodie mario Rachel Vince │ -│@jessika %Melody Eva henry4 lee mark richard warren │ -│@maddy +Max freddy jimmy17 louise peter sheryl zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ -│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ -│ mark peter Rachel richard sheryl Vince warren zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_horizontal ▲ -.... - -[[bar_conditions]] -==== Conditions - -The option _conditions_ is a string which is evaluated to know if the bar -must be displayed or not. - -The string can be: - -* _active_: the window must be active -* _inactive_: the window must be inactive -* _nicklist_: the buffer displayed in window must have a nicklist -* an expression: it is evaluated as boolean (see command - <<command_weechat_eval,/eval>>) - -For the expression, following variables are available: - -* `+${active}+`: true if window is active -* `+${inactive}+`: true if window is inactive -* `+${nicklist}+`: true if buffer displayed in window has a nicklist - -Following pointers are available: - -* `+${window}+`: the window where condition is evaluated -* `+${buffer}+`: the buffer of window where condition is evaluated - -Example to display nicklist bar in all buffers with a nicklist, and only if -width of terminal is > 100: - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" ----- - -Same condition, but always display nicklist on buffer _&bitlbee_ -(even if terminal is small): - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" ----- - [[bare_display]] === Bare display @@ -1740,155 +1415,17 @@ The screen will look like that in bare display: So you can click the URL from _joe_ without any problem in your terminal (of course this supposes that your terminal supports click on URLs). -[[notify_levels]] -=== Notify levels - -[[setup_notify_levels]] -==== Setup notify levels - -Four levels are possible in messages displayed in buffers, from lower to higher: - -* _low_: message with low importance (for example irc join/part/quit) -* _message_: message from a user -* _private_: message in a private buffer -* _highlight_: message with highlight - -Each buffer has a notify level, which is used to decide what messages will add -buffer in hotlist. - -The default notify level can be set using option -<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>, -default is _all_. - -[width="75%",cols="2m,7",options="header"] -|=== -| Notify level | Level of messages added to hotlist -| none | (none) -| highlight | _highlight_ + _private_ -| message | _highlight_ + _private_ + _message_ -| all | _highlight_ + _private_ + _message_ + _low_ -|=== - -Notify level can be defined for a set of buffers, for example all buffers of -irc server "libera": - ----- -/set weechat.notify.irc.libera message ----- - -Set notify level _highlight_ on channel "#weechat" only: - ----- -/set weechat.notify.irc.libera.#weechat highlight ----- - -The notify level for a buffer can be set with command `/buffer`: - ----- -/buffer notify highlight ----- - -[[max_hotlist_level_nicks]] -==== Max hotlist level for nicks - -It is possible to set max hotlist level for some nicks, per buffer, or per group -of buffers (like IRC servers). - -The buffer property "hotlist_max_level_nicks" can be set with a list of nicks -and for each nick the max hotlist level to trigger, possible levels are: - -* -1: no hotlist changes for nick -* 0: low priority (like join/part messages) -* 1: message -* 2: private message -* 3: highlight (in fact useless, since it's already the default max for all messages) - -For example to disable highlights from "joe" and "mike" on current buffer: - ----- -/buffer set hotlist_max_level_nicks_add joe:2,mike:2 ----- - -[NOTE] -The buffer property "hotlist_max_level_nicks" is not saved in configuration. + -You can easily save it with the script _buffer_autoset.py_: you can install it -with `+/script install buffer_autoset.py+` and get help with -`+/help buffer_autoset+`. - -[[highlights]] -=== Highlights - -[[highlights_words]] -==== Add words to highlight - -By default, WeeChat highlights messages from other users containing your nick, -therefore the highlight depends on the buffer (the nick can be different from -one buffer to another). - -You can add other words to highlight with the option -<<option_weechat.look.highlight,weechat.look.highlight>>, for example to -highlight your nick and "word1", "word2" and all words beginning with "test": - ----- -/set weechat.look.highlight word1,word2,test* ----- - -If you need a more specific rule for the word, you can use regular expressions -with the option <<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, -for example to highlight words "flashcode", "flashcöde" and "flashy": - ----- -/set weechat.look.highlight_regex flashc[oö]de|flashy ----- - -The delimiters around words to highlight can be customized with the option -<<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>>. - -[[highlights_tags]] -==== Add tags to highlight - -Lines displayed can contain "tags", which give some info about the origin of -message or the message itself. + -You can display tags with the command `/debug tags` (same command to hide them). - -You can add specific tags to highlight with the option -<<option_weechat.look.highlight_tags,weechat.look.highlight_tags>>. -Tags are separated by commas, and multiple tags can be separated by `+++` to do -a logical "and" between them. - -For example to highlight all messages from nick "FlashCode" and all notices -from nicks beginning with "toto": - ----- -/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" ----- - -[[highlights_regex_buffer]] -==== Set extra highlights on buffer - -You can force highlight using a regular expression with the buffer property -"highlight_regex". - -For example to force the highlight on all messages in the current buffer: - ----- -/buffer set highlight_regex .* ----- - -[NOTE] -The buffer property "highlight_regex" is not saved in configuration. + -You can easily save it with the script _buffer_autoset.py_: you can install it -with `+/script install buffer_autoset.py+` and get help with -`+/help buffer_autoset+`. - [[key_bindings]] -=== Default key bindings +== Key bindings + +WeeChat provides a lot of default key bindings, listed in the following chapters. + +They can be changed and new ones can be added with the <<command_weechat_key,/key>> command. [[key_bindings_cmdline]] -==== Command line +=== Command line [[key_bindings_cmdline_cursor_movement]] -===== Cursor movement +==== Cursor movement [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1908,7 +1445,7 @@ with `+/script install buffer_autoset.py+` and get help with |=== [[key_bindings_cmdline_editing]] -===== Editing +==== Editing [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1936,7 +1473,7 @@ with `+/script install buffer_autoset.py+` and get help with |=== [[key_bindings_cmdline_color_codes]] -===== Color codes +==== Color codes [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1950,7 +1487,7 @@ with `+/script install buffer_autoset.py+` and get help with |=== [[key_bindings_cmdline_history]] -===== Command history +==== Command history [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1962,7 +1499,7 @@ with `+/script install buffer_autoset.py+` and get help with |=== [[key_bindings_buffers]] -==== Buffers +=== Buffers [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2000,7 +1537,7 @@ with `+/script install buffer_autoset.py+` and get help with |=== [[key_bindings_windows]] -==== Windows +=== Windows [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2019,7 +1556,7 @@ with `+/script install buffer_autoset.py+` and get help with |=== [[key_bindings_bars]] -==== Bars +=== Bars [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2043,7 +1580,7 @@ with `+/script install buffer_autoset.py+` and get help with |=== [[key_bindings_hotlist]] -==== Hotlist +=== Hotlist [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2056,7 +1593,7 @@ with `+/script install buffer_autoset.py+` and get help with |=== [[key_bindings_toggle_keys]] -==== Toggle keys +=== Toggle keys [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2068,7 +1605,7 @@ with `+/script install buffer_autoset.py+` and get help with |=== [[key_bindings_search_context]] -==== Search context +=== Search context These keys are used in context "search" (when kbd:[Ctrl+r] is pressed to search text in buffer). @@ -2088,7 +1625,7 @@ text in buffer). |=== [[key_bindings_cursor_context]] -==== Cursor context +=== Cursor context These keys are used in context "cursor" (free movement of cursor on screen). @@ -2117,7 +1654,7 @@ These keys are used in context "cursor" (free movement of cursor on screen). |=== [[key_bindings_mouse]] -==== Mouse +=== Mouse These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] (command: `+/mouse toggle+`). @@ -2170,7 +1707,7 @@ These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] ^(1)^ kbd:[▲] and kbd:[▼] are wheel up and down. [[key_bindings_fset_buffer]] -==== Fset buffer +=== Fset buffer These keys and actions are used on the fset buffer (see <<fset_plugin,Fset plugin>>). @@ -2216,7 +1753,7 @@ These keys and actions are used on the fset buffer (see <<fset_plugin,Fset plugi ^(1)^ The action must be entered as input on the command line, followed by kbd:[Enter]. [[key_bindings_script_buffer]] -==== Script buffer +=== Script buffer These keys and actions are used on the script buffer (see <<scripts_plugins,Script plugin>>). @@ -2239,6 +1776,251 @@ These keys and actions are used on the script buffer (see <<scripts_plugins,Scri [NOTE] ^(1)^ The action must be entered as input on the command line, followed by kbd:[Enter]. +[[configuration]] +== Configuration + +[[colors]] +=== Colors + +[[colors_basic]] +==== Basic colors + +Basic colors in WeeChat are: + +[width="75%",cols="1m,4",options="header"] +|=== +| Name | Color +| default | Default terminal color (transparent for background) +| black | Black +| darkgray | Dark gray +| red | Dark red +| lightred | Light red +| green | Dark green +| lightgreen | Light green +| brown | Brown +| yellow | Yellow +| blue | Dark blue +| lightblue | Light blue +| magenta | Dark magenta +| lightmagenta | Light magenta +| cyan | Dark cyan +| lightcyan | Light cyan +| gray | Gray +| white | White +|=== + +[[colors_extended]] +==== Extended colors + +WeeChat dynamically allocates color pairs when colors are used on screen (to +display buffers and bars). + +In addition to basic colors, you can use a color number between 1 and the limit +of your terminal. + +Use command `/color` to see current colors and limits. With kbd:[Alt+c] you can +temporarily switch to terminal colors to choose a color. + +For example if you want to display time in orange in buffer, do: + +---- +/set weechat.color.chat_time 214 +---- + +Or if you want a very dark green background for status bar: + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== Aliases + +You can add color aliases with command `/color alias` and then use this alias +in any color option. + +For example: + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== Attributes + +It is possible to use some attributes for colors. One or more attributes can be +added before color name or number: + +* `+*+`: bold text +* `+!+`: reverse video +* `+/+`: italic +* `+_+`: underlined text +* `+|+`: keep attributes: do not reset bold/reverse/italic/underlined when + changing color + +For example if you want self nick as white underlined, do: + +---- +/set weechat.color.chat_nick_self _white +---- + +Or if you want time in status bar as orange underlined with bold: + +---- +/set weechat.color.status_time *_214 +---- + +To use an attribute with default terminal color (-1), you must use a number +greater than last terminal color, for example max color in WeeChat: 99999. + +Example of bold with terminal foreground color: + +---- +/set weechat.color.status_time *99999 +---- + +[[notify_levels]] +=== Notify levels + +[[setup_notify_levels]] +==== Setup notify levels + +Four levels are possible in messages displayed in buffers, from lower to higher: + +* _low_: message with low importance (for example irc join/part/quit) +* _message_: message from a user +* _private_: message in a private buffer +* _highlight_: message with highlight + +Each buffer has a notify level, which is used to decide what messages will add +buffer in hotlist. + +The default notify level can be set using option +<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>, +default is _all_. + +[width="75%",cols="2m,7",options="header"] +|=== +| Notify level | Level of messages added to hotlist +| none | (none) +| highlight | _highlight_ + _private_ +| message | _highlight_ + _private_ + _message_ +| all | _highlight_ + _private_ + _message_ + _low_ +|=== + +Notify level can be defined for a set of buffers, for example all buffers of +irc server "libera": + +---- +/set weechat.notify.irc.libera message +---- + +Set notify level _highlight_ on channel "#weechat" only: + +---- +/set weechat.notify.irc.libera.#weechat highlight +---- + +The notify level for a buffer can be set with command `/buffer`: + +---- +/buffer notify highlight +---- + +[[max_hotlist_level_nicks]] +==== Max hotlist level for nicks + +It is possible to set max hotlist level for some nicks, per buffer, or per group +of buffers (like IRC servers). + +The buffer property "hotlist_max_level_nicks" can be set with a list of nicks +and for each nick the max hotlist level to trigger, possible levels are: + +* -1: no hotlist changes for nick +* 0: low priority (like join/part messages) +* 1: message +* 2: private message +* 3: highlight (in fact useless, since it's already the default max for all messages) + +For example to disable highlights from "joe" and "mike" on current buffer: + +---- +/buffer set hotlist_max_level_nicks_add joe:2,mike:2 +---- + +[NOTE] +The buffer property "hotlist_max_level_nicks" is not saved in configuration. + +You can easily save it with the script _buffer_autoset.py_: you can install it +with `+/script install buffer_autoset.py+` and get help with +`+/help buffer_autoset+`. + +[[highlights]] +=== Highlights + +[[highlights_words]] +==== Add words to highlight + +By default, WeeChat highlights messages from other users containing your nick, +therefore the highlight depends on the buffer (the nick can be different from +one buffer to another). + +You can add other words to highlight with the option +<<option_weechat.look.highlight,weechat.look.highlight>>, for example to +highlight your nick and "word1", "word2" and all words beginning with "test": + +---- +/set weechat.look.highlight word1,word2,test* +---- + +If you need a more specific rule for the word, you can use regular expressions +with the option <<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, +for example to highlight words "flashcode", "flashcöde" and "flashy": + +---- +/set weechat.look.highlight_regex flashc[oö]de|flashy +---- + +The delimiters around words to highlight can be customized with the option +<<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>>. + +[[highlights_tags]] +==== Add tags to highlight + +Lines displayed can contain "tags", which give some info about the origin of +message or the message itself. + +You can display tags with the command `/debug tags` (same command to hide them). + +You can add specific tags to highlight with the option +<<option_weechat.look.highlight_tags,weechat.look.highlight_tags>>. +Tags are separated by commas, and multiple tags can be separated by `+++` to do +a logical "and" between them. + +For example to highlight all messages from nick "FlashCode" and all notices +from nicks beginning with "toto": + +---- +/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" +---- + +[[highlights_regex_buffer]] +==== Set extra highlights on buffer + +You can force highlight using a regular expression with the buffer property +"highlight_regex". + +For example to force the highlight on all messages in the current buffer: + +---- +/buffer set highlight_regex .* +---- + +[NOTE] +The buffer property "highlight_regex" is not saved in configuration. + +You can easily save it with the script _buffer_autoset.py_: you can install it +with `+/script install buffer_autoset.py+` and get help with +`+/help buffer_autoset+`. + [[mouse]] === Mouse support @@ -2358,6 +2140,233 @@ any gesture made using left button. You can find an event name with command `+/input grab_mouse+` then doing event with mouse. This will insert event name on command line. +[[bars]] +=== Bars + +A _bar_ is an area beside the chat that can contain any type of text. + +The bar options can be set with options `weechat.bar.name.option` where `name` +is the name of the bar and `option` the option for this bar. + +List of bar options: + +[width="100%",cols="2m,2,10",options="header"] +|=== +| Option | Values | Description + +| type | `root`, `window` | + A bar with type `root` is displayed exactly one time on screen, outside all + windows. The default bar _buflist_ has type `root`. + + A bar with type `window` is displayed in each window, for example if you + split one time the screen (with `/window splith` or `/window splitv`), you + will have one bar in each window. The default bars _title_, _status_, + _input_ and _nicklist_ have type `window`. + +| position | `top`, `bottom`, `left`, `right` | + Position of the bar: above/below chat, on the left/right. + +| priority | integer ≥ 0 | + Priority for display of bar: this is used for ordering the bars on screen when + many bars have same type and position. + + The bars are displayed from the edge of the screen to the center. A higher + priority will display bar at the beginning, so closer to the edge. + + Example: _input_ bar has priority 1000, so it is displayed before the _status_ + bar, which has priority 500. + +| size | integer ≥ 0 | + The size of the bar: number of columns for position left/right, number + of lines for position top/bottom. A size of `0` means automatic, so the size + will be computed according to content displayed in bar. + +| size_max | integer ≥ 0 | + The maximum size for a bar, `0` = no limit (this option is used only if + `size` = `0`). + +| color_bg | color | + The default background color for the bar. + +| color_fg | color | + The default text color for the bar. + +| color_delim | color | + The color for delimiters in bar. + +| hidden | `on`, `off` | + When option is `on`, the bar is hidden. + + Note: instead of changing this option, the command `/bar` is preferred, for + example: `/bar toggle nicklist` (see command <<command_weechat_bar,/bar>>). + +| separator | `on`, `off` | + When option is `on`, a separator (line) is displayed between this bar and + other bars (or chat). + +| items | string | + A list of _items_ (see <<bar_items,items>> for more info). + +| filling_left_right | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | + Type of filling for a bar which has position `left` or `right` (see + <<bar_filling,filling>> for more info). + +| filling_top_bottom | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | + Type of filling for a bar which has position `top` or `bottom` (see + <<bar_filling,filling>> for more info). + +| conditions | string | + The conditions to display the bar (see <<bar_conditions,conditions>> for more + info). +|=== + +[[bar_items]] +==== Items + +The option _items_ is a string with a list of bar items, separated by a comma +(space between items on screen) or `+++` (glued items). + +The list of bar items is displayed with command `/bar listitems`. + +Before or after item name, you can use chars (that are not alphanumeric, `+-+` +or `+_+`). They will be displayed before/after item with the delimiters color +defined in bar (option _color_delim_). + +Example of bar with items "[time],buffer_number+:+buffer_plugin+.+buffer_name": + +.... +┌───────────────────────────────────────────────────────────────────────────┐ +│[12:55] 3:irc/libera.#weechat │ +└───────────────────────────────────────────────────────────────────────────┘ +.... + +A special syntax can be used to force the buffer used when displaying the bar +item: "@buffer:item" (where "buffer" is the full name of buffer and "item" is +the name of a bar item). + +This is useful in root bars, to display item for a specific buffer which is +not displayed in the current window (or even not displayed at all). + +Example: nicklist of bitlbee in a root bar (if the bar is called +_bitlist_ and if bitlbee server is called _bitlbee_): + +---- +/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" +---- + +[[bar_filling]] +==== Filling + +There are four types of filling: + +* `+horizontal+`: the items are displayed horizontally, from left to right. If + there are new lines in items, a space is used to separate lines. +* `+vertical+`: the items are displayed from top to bottom. If there are new + lines in items, a new line is used to separate lines. +* `+columns_horizontal+`: items are displayed using columns, where text is + aligned on the left. The first item is on top left, the second is on same + line, on the right. +* `+columns_vertical+`: items are displayed using columns, where text is aligned + on the left. The first item is on top left, the second is one line below. + +Default bars _title_, _status_ and _input_ have _horizontal_ filling, and +default bar _nicklist_ has _vertical_ filling. + +Some examples of filling for bar _nicklist_: + +.... +┌───────────────────────────────────────────────────────────────────────┐ +│Welcome to #test, this is a test channel │ +│12:54:15 peter | hey! │@carl │ +│12:55:01 +Max | hello │@jessika│ +│ │@maddy │ +│ │%Diego │ +│ │%Melody │ +│ │+Max │ +│ │ celia │ +│ │ Eva │ +│ │ freddy │ +│ │ Harold^│ +│ │ henry4 │ +│ │ jimmy17│ +│ │ jodie ▼│ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│Welcome to #test, this is a test channel │ +│12:54:15 peter | hey! │@carl lee │ +│12:55:01 +Max | hello │@jessika louise │ +│ │@maddy mario │ +│ │%Diego mark │ +│ │%Melody peter │ +│ │+Max Rachel │ +│ │ celia richard│ +│ │ Eva sheryl │ +│ │ freddy Vince │ +│ │ Harold^ warren │ +│ │ henry4 zack │ +│ │ jimmy17 │ +│ │ jodie │ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl %Diego celia Harold^ jodie mario Rachel Vince │ +│@jessika %Melody Eva henry4 lee mark richard warren │ +│@maddy +Max freddy jimmy17 louise peter sheryl zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ +│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ +│ mark peter Rachel richard sheryl Vince warren zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_horizontal ▲ +.... + +[[bar_conditions]] +==== Conditions + +The option _conditions_ is a string which is evaluated to know if the bar +must be displayed or not. + +The string can be: + +* _active_: the window must be active +* _inactive_: the window must be inactive +* _nicklist_: the buffer displayed in window must have a nicklist +* an expression: it is evaluated as boolean (see command + <<command_weechat_eval,/eval>>) + +For the expression, following variables are available: + +* `+${active}+`: true if window is active +* `+${inactive}+`: true if window is inactive +* `+${nicklist}+`: true if buffer displayed in window has a nicklist + +Following pointers are available: + +* `+${window}+`: the window where condition is evaluated +* `+${buffer}+`: the buffer of window where condition is evaluated + +Example to display nicklist bar in all buffers with a nicklist, and only if +width of terminal is > 100: + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" +---- + +Same condition, but always display nicklist on buffer _&bitlbee_ +(even if terminal is small): + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" +---- + [[secured_data]] === Secured data diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index 1b95929de..6ded8b0e4 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -646,6 +646,56 @@ Des variables d'environnement sont utilisées par WeeChat si elles sont définie | WEECHAT_EXTRA_LIBDIR | Un répertoire supplémentaire pour charger les extensions (depuis le répertoire "plugins" sous ce chemin). |=== +[[colors_support]] +=== Support des Couleurs + +WeeChat peut utiliser jusqu'à 32767 paires de couleur pour afficher le texte dans +les barres et la zone de discussion (votre terminal doit supporter 256 couleurs +pour pouvoir les utiliser dans WeeChat). + +Selon la valeur de la variable d'environnement _TERM_, vous pouvez avoir les +limites suivantes pour les couleurs dans WeeChat : + +[width="75%",cols="8,>3,>3",options="header"] +|=== +| $TERM | Couleurs | Paires +| "rxvt-unicode", "xterm", ... | 88 | 32767 +| "rxvt-256color", "xterm-256color", ... | 256 | 32767 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 32767 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 32767 +|=== + +Vous pouvez lancer `weechat --colors` ou utiliser la commande `/color` +dans WeeChat pour afficher les limites de votre environnement. + +Quelques valeurs recommandées pour _TERM_ si vous voulez 256 couleurs : + +* sous screen : _screen-256color_ +* sous tmux : _screen-256color_ ou _tmux-256color_ +* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_, + _putty-256color_, ... + +Si vous utilisez screen, vous pouvez ajouter cette ligne dans votre +_~/.screenrc_ : + +[NOTE] +Vous devrez peut-être installer le paquet "ncurses-term" pour utiliser ces +valeurs dans la variable _TERM_. + +---- +term screen-256color +---- + +Si votre variable _TERM_ a une valeur erronée et que WeeChat est déjà lancé, +vous pouvez la changer avec ces deux commandes : + +---- +/set env TERM screen-256color +/upgrade +---- + [[files_and_directories]] === Fichiers et répertoires @@ -981,157 +1031,6 @@ kbd:[Espace] kbd:[!] Dans l'extension irc, vous pouvez réassigner les couleurs en utilisant l'option <<option_irc.color.mirc_remap,irc.color.mirc_remap>>. -[[colors]] -=== Couleurs - -WeeChat peut utiliser jusqu'à 32767 paires de couleur pour afficher le texte dans -les barres et la zone de discussion (votre terminal doit supporter 256 couleurs -pour pouvoir les utiliser dans WeeChat). - -Selon la valeur de la variable d'environnement _TERM_, vous pouvez avoir les -limites suivantes pour les couleurs dans WeeChat : - -[width="75%",cols="8,>3,>3",options="header"] -|=== -| $TERM | Couleurs | Paires -| "rxvt-unicode", "xterm", ... | 88 | 32767 -| "rxvt-256color", "xterm-256color", ... | 256 | 32767 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 32767 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 32767 -|=== - -Vous pouvez lancer `weechat --colors` ou utiliser la commande `/color` -dans WeeChat pour afficher les limites de votre environnement. - -Quelques valeurs recommandées pour _TERM_ si vous voulez 256 couleurs : - -* sous screen : _screen-256color_ -* sous tmux : _screen-256color_ ou _tmux-256color_ -* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_, - _putty-256color_, ... - -Si vous utilisez screen, vous pouvez ajouter cette ligne dans votre -_~/.screenrc_ : - -[NOTE] -Vous devrez peut-être installer le paquet "ncurses-term" pour utiliser ces -valeurs dans la variable _TERM_. - ----- -term screen-256color ----- - -Si votre variable _TERM_ a une valeur erronée et que WeeChat est déjà lancé, -vous pouvez la changer avec ces deux commandes : - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== Couleurs de base - -Les couleurs de base dans WeeChat sont : - -[width="75%",cols="1m,4",options="header"] -|=== -| Nom | Couleur -| default | Couleur par défaut du terminal (transparent pour le fond) -| black | Noir -| darkgray | Gris foncé -| red | Rouge foncé -| lightred | Rouge clair -| green | Vert foncé -| lightgreen | Vert clair -| brown | Marron -| yellow | Jaune -| blue | Bleu foncé -| lightblue | Bleu clair -| magenta | Violet foncé -| lightmagenta | Violet clair -| cyan | Cyan foncé -| lightcyan | Cyan clair -| gray | Gris -| white | Blanc -|=== - -[[colors_extended]] -==== Couleurs étendues - -WeeChat alloue dynamiquement les paires de couleurs quand elles sont utilisées -sur l'écran (pour afficher les tampons et les barres). - -En plus des couleurs de base, vous pouvez utiliser un numéro de couleur entre 1 -et la limite de votre terminal. - -Utilisez la commande `/color` pour voir les couleurs et les limites. Avec la -touche kbd:[Alt+c], vous pouvez basculer temporairement vers les couleurs du -terminal pour choisir une couleur. - -Par exemple si vous souhaitez afficher l'heure en orange dans le tampon, -faites : - ----- -/set weechat.color.chat_time 214 ----- - -Ou si vous voulez un fond vert très foncé pour la barre de statut : - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== Alias - -Vous pouvez ajouter des alias de couleur avec la commande `/color alias` puis -utiliser cet alias dans n'importe quelle option de couleur. - -Par exemple : - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== Attributs - -Il est possible d'utiliser des attributs pour les couleurs. Un ou plusieurs -attributs peuvent être ajoutés avant le nom ou le numéro de la couleur : - -* `+*+` : texte gras -* `+!+` : mode vidéo inverse -* `+/+` : italique -* `+_+` : texte souligné -* `+|+` : garder les attributs : ne pas réinitialiser gras/inverse/souligné lors - du changement de couleur - -Par exemple si vous voulez votre pseudo en blanc souligné, faites : - ----- -/set weechat.color.chat_nick_self _white ----- - -Ou si vous voulez l'heure dans la barre de statut en orange souligné avec gras : - ----- -/set weechat.color.status_time *_214 ----- - -Pour utiliser un attribut avec la couleur par défaut du terminal (-1), vous -devez utiliser un nombre supérieur à la dernière couleur du terminal, par -exemple la couleur maximum de WeeChat : 99999. - -Exemple de gras avec la couleur de texte du terminal : - ----- -/set weechat.color.status_time *99999 ----- - [[buffers_and_windows]] === Tampons et fenêtres @@ -1467,245 +1366,6 @@ Par défaut WeeChat et ses extensions par défaut interprètent ces variables : Les extensions et script externes peuvent définir et utiliser d'autres variables locales. -[[bars]] -=== Barres - -Une _barre_ est une zone à côté de la discussion qui peut contenir tout type de -texte. - -Les options de barre sont définies avec les options `weechat.bar.nom.option` où -`nom` et le nom de la barre et `option` l'option pour cette barre. - -Liste des options de barre : - -[width="100%",cols="2m,2,10",options="header"] -|=== -| Option | Valeurs | Description - -| type | `root`, `window` | - Une barre avec le type `root` est affichée exactement une fois à l'écran, en - dehors de toutes les fenêtres. La barre par défaut _buflist_ est de type - `root`. + - Une barre avec le type `window` est affichée dans chaque fenêtre, par exemple - si vous découpez l'écran (avec `/window splith` ou `/window splitv`), vous - aurez une barre dans chaque fenêtre. Les barres par défaut _title_, _status_, - _input_ et _nicklist_ sont de type `window`. - -| position | `top`, `bottom`, `left`, `right` | - Position de la barre : au dessus/en dessous de la discussion, sur la - gauche/droite. - -| priority | entier ≥ 0 | - Priorité de la barre : elle est utilisée pour ordonner les barres à l'écran, - quand plusieurs barres utilisent le même type et position. + - Les barres sont affichées depuis le bord de l'écran vers le centre. Une - priorité plus haute affichera la barre au début, donc près du bord. + - Exemple : la barre _input_ a une priorité de 1000, donc elle est affichée - avant la barre _status_, qui a une priorité de 500. - -| size | entier ≥ 0 | - La taille de la barre : nombre de colonnes pour une position left/right, - nombre de lignes pour une position top/bottom. Une taille de `0` signifie - automatique, donc la taille sera calculée en fonction du contenu affiché dans - la barre. - -| size_max | entier ≥ 0 | - La taille maximum pour la barre, `0` = pas de limite (cette option est - utilisée seulement si `size` = `0`). - -| color_bg | couleur | - La couleur par défaut du fond de la barre. - -| color_fg | couleur | - La couleur par défaut du texte dans la barre. - -| color_delim | couleur | - La couleur des délimiteurs dans la barre. - -| hidden | `on`, `off` | - Lorsque l'option est `on`, la barre est cachée. + - Note : plutôt que de changer cette option, il est préférable d'utiliser la - commande `/bar`, par exemple : `/bar toggle nicklist` (voir la commande - <<command_weechat_bar,/bar>>). - -| separator | `on`, `off` | - Lorsque l'option est `on`, un séparateur (ligne) est affiché entre la barre et - les autres barres (ou la discussion). - -| items | chaîne | - Une liste d'objets (voir <<bar_items,objets>> pour plus d'infos). - -| filling_left_right | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | - Type de remplissage pour la barre lorsqu'elle a une position `left` ou - `right` (voir <<bar_filling,remplissage>> pour plus d'infos). - -| filling_top_bottom | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | - Type de remplissage pour la barre lorsqu'elle a une position `top` ou `bottom` - (voir <<bar_filling,remplissage>> pour plus d'infos). - -| conditions | chaîne | - Les conditions pour afficher la barre (voir <<bar_conditions,conditions>> pour - plus d'infos). -|=== - -[[bar_items]] -==== Objets - -L'option _items_ est une chaîne avec une liste d'objets de barre, séparés par -une virgule (espace entre les objets à l'écran) ou un `+++` (objets collés). - -La liste des objets de barre est affichée avec la commande `/bar listitems`. - -Avant ou après l'objet de barre, vous pouvez utiliser des caractères (qui ne -sont pas alphanumériques, `+-+` ou `+_+`). Ils seront affichés avant/après -l'objet de barre avec la couleur des délimiteurs définie dans la barre (option -_color_delim_). - -Exemple de barre avec les objets -"[time],buffer_number+:+buffer_plugin+.+buffer_name" : - -.... -┌───────────────────────────────────────────────────────────────────────────┐ -│[12:55] 3:irc/libera.#weechat │ -└───────────────────────────────────────────────────────────────────────────┘ -.... - -Une syntaxe spéciale peut être utilisée pour forcer le tampon utilisé lors de -l'affichage de l'objet de barre : "@tampon:objet" (où "tampon" est le nom -complet du tampon et "objet" est le nom d'un objet de barre). - -Ceci peut être pratique dans les barres "root", pour afficher un objet de barre -pour un tampon qui n'est pas affiché dans la fenêtre courante (ou même pas -affiché du tout). - -Exemple : liste de pseudos de bitlbee dans une barre "root" (si la barre -s'appelle _bitlist_ et si le serveur bitlbee s'appelle _bitlbee_) : - ----- -/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" ----- - -[[bar_filling]] -==== Remplissage - -Il y a quatre types de remplissage : - -* `+horizontal+` : les objets sont affichés horizontalement, de gauche à droite. - S'il y a des retours à la ligne dans les objets, un espace est utilisé pour - séparer les lignes. -* `+vertical+` : les objets sont affichés de haut en bas. S'il y a des retours à - la ligne dans les objets, une nouvelle ligne est utilisée pour séparer les - lignes. -* `+columns_horizontal+` : les objets sont affichés en utilisant des colonnes, où - le texte est aligné à gauche. Le premier objet est en haut à gauche, le second - est sur la même ligne, sur la droite. -* `+columns_vertical+` : les objets sont affichés en utilisant des colonnes, où - le texte est aligné à gauche. Le premier objet est en haut à gauche, le second - est sur la ligne en dessous. - -Les barres par défaut _title_, _status_ et _input_ ont un remplissage -_horizontal_, et la barre par défaut _nicklist_ a un remplissage _vertical_. - -Quelques exemples de remplissage pour la barre _nicklist_ : - -.... -┌───────────────────────────────────────────────────────────────────────┐ -│Welcome to #test, this is a test channel │ -│12:54:15 peter | hey! │@carl │ -│12:55:01 +Max | hello │@jessika│ -│ │@maddy │ -│ │%Diego │ -│ │%Melody │ -│ │+Max │ -│ │ celia │ -│ │ Eva │ -│ │ freddy │ -│ │ Harold^│ -│ │ henry4 │ -│ │ jimmy17│ -│ │ jodie ▼│ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│Welcome to #test, this is a test channel │ -│12:54:15 peter | hey! │@carl lee │ -│12:55:01 +Max | hello │@jessika louise │ -│ │@maddy mario │ -│ │%Diego mark │ -│ │%Melody peter │ -│ │+Max Rachel │ -│ │ celia richard│ -│ │ Eva sheryl │ -│ │ freddy Vince │ -│ │ Harold^ warren │ -│ │ henry4 zack │ -│ │ jimmy17 │ -│ │ jodie │ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl %Diego celia Harold^ jodie mario Rachel Vince │ -│@jessika %Melody Eva henry4 lee mark richard warren │ -│@maddy +Max freddy jimmy17 louise peter sheryl zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ -│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ -│ mark peter Rachel richard sheryl Vince warren zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_horizontal ▲ -.... - -[[bar_conditions]] -==== Conditions - -L'option _conditions_ est une chaîne qui est évaluée pour savoir si la barre -doit être affichée ou non. - -La chaîne peut être : - -* _active_ : la fenêtre doit être active -* _inactive_ : la fenêtre doit être inactive -* _nicklist_ : le tampon affiché dans la fenêtre doit avoir une liste de pseudos -* une expression : elle est évaluée comme booléen (voir la commande - <<command_weechat_eval,/eval>>) - -Pour une expression, les variables suivantes sont disponibles : - -* `+${active}+` : vrai si la fenêtre est active -* `+${inactive}+` : vrai si la fenêtre est inactive -* `+${nicklist}+` : vrai si le tampon affiché dans la fenêtre a une liste de - pseudos - -Les pointeurs suivants sont disponibles : - -* `+${window}+` : la fenêtre où la condition est évaluée -* `+${buffer}+` : le tampon de la fenêtre où la condition est évaluée - -Exemple pour afficher la liste de pseudos dans tous les tampons possédant une -liste de pseudos, et seulement si la largeur du terminal est supérieure à 100 : - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" ----- - -Même condition, mais afficher toujours la liste de pseudos sur le tampon -_&bitlbee_ (même si le terminal est petit) : - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" ----- - [[bare_display]] === Affichage dépouillé @@ -1796,165 +1456,19 @@ L'écran ressemblera à ça en mode dépouillé : Donc vous pouvez cliquer l'URL de _joe_ sans problème dans votre terminal (bien entendu cela suppose que votre terminal permet le clic sur les URLs). -[[notify_levels]] -=== Niveaux de notification - -[[setup_notify_levels]] -==== Configurer les niveaux de notification - -Quatre niveaux sont possibles dans les messages affichés dans les tampons, du -moins important au plus important : - -* _low_ : message avec faible importance (par exemple un join/part/quit irc) -* _message_ : message d'un utilisateur -* _private_ : message dans un tampon privé -* _highlight_ : message avec highlight - -Chaque tampon a un niveau de notification, qui est utilisé pour décider quels -messages ajouteront le tampon dans la hotlist. - -Le niveau de notification par défaut peut être défini avec l'option -<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>, -la valeur par défaut est _all_. - -[width="75%",cols="2m,7",options="header"] -|=== -| Niveau de notification | Niveau des messages ajoutés à la hotlist -| none | (aucun) -| highlight | _highlight_ + _private_ -| message | _highlight_ + _private_ + _message_ -| all | _highlight_ + _private_ + _message_ + _low_ -|=== - -Le niveau de notification peut être défini pour un ensemble de tampons, par -exemple tous les tampons du serveur irc "libera" : - ----- -/set weechat.notify.irc.libera message ----- - -Définir le niveau de notification _highlight_ sur le canal "#weechat" seulement : - ----- -/set weechat.notify.irc.libera.#weechat highlight ----- - -Le niveau de notification pour un tampon peut aussi être défini avec la -commande `/buffer` : - ----- -/buffer notify highlight ----- - -[[max_hotlist_level_nicks]] -==== Niveau maximal de hotlist pour des pseudos - -Il est possible de définir un niveau maximal de hotlist pour certains pseudos, -par tampon ou groupe de tampons (comme des serveurs IRC). - -La propriété de tampon "hotlist_max_level_nicks" peut être définie avec une -liste de pseudos et pour chaque pseudo le niveau maximal de hotlist à déclencher, -les niveaux possibles sont : - -* -1 : pas de changement dans la hotlist pour ce pseudo -* 0 : faible priorité (comme les messages join/part) -* 1 : message -* 2 : message privé -* 3 : highlight (en réalité inutile, car il s'agit déjà du niveau maximal par - défaut pour tous les messages) - -Par exemple pour désactiver les « highlights » de "joe" et "mike" sur le tampon -courant : - ----- -/buffer set hotlist_max_level_nicks_add joe:2,mike:2 ----- - -[NOTE] -La propriété de tampon "hotlist_max_level_nicks" n'est pas sauvegardée dans la -configuration. + -Vous pouvez facilement la sauvegarder avec le script _buffer_autoset.py_ : vous -pouvez l'installer avec `+/script install buffer_autoset.py+` et obtenir de l'aide -avec `+/help buffer_autoset+`. - -[[highlights]] -=== Highlights - -[[highlights_words]] -==== Ajouter des mots pour le « highlight » - -Par défaut, WeeChat met en valeur les messages des autres utilisateurs qui -contiennent votre pseudo, par conséquent le highlight dépend du tampon -(le pseudo peut être différent d'un tampon à l'autre). - -Vous pouvez ajouter d'autres mots à mettre en valeur avec l'option -<<option_weechat.look.highlight,weechat.look.highlight>>, par exemple pour mettre -en valeur votre pseudo, "mot1", "mot2" et tous les mots commençants par "test" : - ----- -/set weechat.look.highlight mot1,mot2,test* ----- - -Si vous avez besoin d'une règle plus spécifique pour un mot, vous pouvez utiliser -des expressions régulières avec l'option -<<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, -par exemple pour mettre en valeur les mots "flashcode", "flashcöde" et "flashy" : - ----- -/set weechat.look.highlight_regex flashc[oö]de|flashy ----- - -Les délimiteurs autour des mots à mettre en valeur peuvent être paramétrés avec -l'option <<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>>. - -[[highlights_tags]] -==== Ajouter des étiquettes pour le « highlight » - -Les lignes affichées contiennent des étiquettes (« tags »), qui donnent des -informations sur l'origine du message ou le message lui-même. + -Vous pouvez afficher les étiquettes avec la commande `/debug tags` (même commande -pour les cacher). - -Vous pouvez ajouter des étiquettes à mettre en valeur avec l'option -<<option_weechat.look.highlight_tags,weechat.look.highlight_tags>>. -Les étiquettes sont séparées par des virgules, et plusieurs étiquettes peuvent -être séparées par `+++` pour faire un "et" logique entre elles. - -Par exemple pour mettre en valeur tous les messages du pseudo "FlashCode" et -toutes les notices des pseudos commençant par "toto" : - ----- -/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" ----- - -[[highlights_regex_buffer]] -==== Définir des highlights supplémentaires sur le tampon - -Vous pouvez forcer le highlight en utilisant une expression regulière avec la -propriété de tampon "highlight_regex". - -Par exemple pour forcer le highlight sur tous les messages dans le canal -courant : - ----- -/buffer set highlight_regex .* ----- - -[NOTE] -La propriété de tampon "highlight_regex" n'est pas sauvegardée dans la -configuration. + -Vous pouvez facilement la sauvegarder avec le script _buffer_autoset.py_ : vous -pouvez l'installer avec `+/script install buffer_autoset.py+` et obtenir de l'aide -avec `+/help buffer_autoset+`. - [[key_bindings]] -=== Raccourcis clavier par défaut +== Raccourcis clavier + +WeeChat fournit beaucoup de raccourcis clavier par défaut, listés dans les chapitres +suivants. + +Ils peuvent être modifiés et de nouveaux peuvent être ajoutés avec la commande +<<command_weechat_key,/key>>. [[key_bindings_cmdline]] -==== Ligne de commande +=== Ligne de commande [[key_bindings_cmdline_cursor_movement]] -===== Mouvement du curseur +==== Mouvement du curseur [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1974,7 +1488,7 @@ avec `+/help buffer_autoset+`. |=== [[key_bindings_cmdline_editing]] -===== Édition +==== Édition [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2002,7 +1516,7 @@ avec `+/help buffer_autoset+`. |=== [[key_bindings_cmdline_color_codes]] -===== Codes couleur +==== Codes couleur [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2016,7 +1530,7 @@ avec `+/help buffer_autoset+`. |=== [[key_bindings_cmdline_history]] -===== Historique de commandes +==== Historique de commandes [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2028,7 +1542,7 @@ avec `+/help buffer_autoset+`. |=== [[key_bindings_buffers]] -==== Tampons +=== Tampons [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2066,7 +1580,7 @@ avec `+/help buffer_autoset+`. |=== [[key_bindings_windows]] -==== Fenêtres +=== Fenêtres [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2085,7 +1599,7 @@ avec `+/help buffer_autoset+`. |=== [[key_bindings_bars]] -==== Barres +=== Barres [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2109,7 +1623,7 @@ avec `+/help buffer_autoset+`. |=== [[key_bindings_hotlist]] -==== Hotlist +=== Hotlist [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2122,7 +1636,7 @@ avec `+/help buffer_autoset+`. |=== [[key_bindings_toggle_keys]] -==== Touches de bascule +=== Touches de bascule [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2134,7 +1648,7 @@ avec `+/help buffer_autoset+`. |=== [[key_bindings_search_context]] -==== Contexte de recherche +=== Contexte de recherche Ces touches sont utilisées dans le contexte "search" (lorsque kbd:[Ctrl+r] est pressé pour chercher du texte dans le tampon). @@ -2154,7 +1668,7 @@ pressé pour chercher du texte dans le tampon). |=== [[key_bindings_cursor_context]] -==== Contexte curseur +=== Contexte curseur Ces touches sont utilisées dans le contexte "cursor" (mouvement libre du curseur à l'écran). @@ -2184,7 +1698,7 @@ Ces touches sont utilisées dans le contexte "cursor" (mouvement libre du curseu |=== [[key_bindings_mouse]] -==== Souris +=== Souris Ces actions avec la souris sont possibles seulement si la souris est activée avec la touche kbd:[Alt+m] (commande : `+/mouse toggle+`). @@ -2237,7 +1751,7 @@ avec la touche kbd:[Alt+m] (commande : `+/mouse toggle+`). ^(1)^ kbd:[▲] et kbd:[▼] sont la roulette vers le haut et le bas. [[key_bindings_fset_buffer]] -==== Tampon fset +=== Tampon fset Ces touches et actions sont utilisées sur le tampon fset (voir <<fset_plugin,l'extension Fset>>). @@ -2284,7 +1798,7 @@ Ces touches et actions sont utilisées sur le tampon fset ^(1)^ L'action doit être tapée comme entrée dans la ligne de commande, suivie de kbd:[Enter]. [[key_bindings_script_buffer]] -==== Tampon script +=== Tampon script Ces touches et actions sont utilisées sur le tampon script (voir <<scripts_plugins,l'extension Script>>). @@ -2308,6 +1822,264 @@ Ces touches et actions sont utilisées sur le tampon script [NOTE] ^(1)^ L'action doit être tapée comme entrée dans la ligne de commande, suivie de kbd:[Enter]. +[[configuration]] +== Configuration + +[[colors]] +=== Couleurs + +[[colors_basic]] +==== Couleurs de base + +Les couleurs de base dans WeeChat sont : + +[width="75%",cols="1m,4",options="header"] +|=== +| Nom | Couleur +| default | Couleur par défaut du terminal (transparent pour le fond) +| black | Noir +| darkgray | Gris foncé +| red | Rouge foncé +| lightred | Rouge clair +| green | Vert foncé +| lightgreen | Vert clair +| brown | Marron +| yellow | Jaune +| blue | Bleu foncé +| lightblue | Bleu clair +| magenta | Violet foncé +| lightmagenta | Violet clair +| cyan | Cyan foncé +| lightcyan | Cyan clair +| gray | Gris +| white | Blanc +|=== + +[[colors_extended]] +==== Couleurs étendues + +WeeChat alloue dynamiquement les paires de couleurs quand elles sont utilisées +sur l'écran (pour afficher les tampons et les barres). + +En plus des couleurs de base, vous pouvez utiliser un numéro de couleur entre 1 +et la limite de votre terminal. + +Utilisez la commande `/color` pour voir les couleurs et les limites. Avec la +touche kbd:[Alt+c], vous pouvez basculer temporairement vers les couleurs du +terminal pour choisir une couleur. + +Par exemple si vous souhaitez afficher l'heure en orange dans le tampon, +faites : + +---- +/set weechat.color.chat_time 214 +---- + +Ou si vous voulez un fond vert très foncé pour la barre de statut : + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== Alias + +Vous pouvez ajouter des alias de couleur avec la commande `/color alias` puis +utiliser cet alias dans n'importe quelle option de couleur. + +Par exemple : + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== Attributs + +Il est possible d'utiliser des attributs pour les couleurs. Un ou plusieurs +attributs peuvent être ajoutés avant le nom ou le numéro de la couleur : + +* `+*+` : texte gras +* `+!+` : mode vidéo inverse +* `+/+` : italique +* `+_+` : texte souligné +* `+|+` : garder les attributs : ne pas réinitialiser gras/inverse/souligné lors + du changement de couleur + +Par exemple si vous voulez votre pseudo en blanc souligné, faites : + +---- +/set weechat.color.chat_nick_self _white +---- + +Ou si vous voulez l'heure dans la barre de statut en orange souligné avec gras : + +---- +/set weechat.color.status_time *_214 +---- + +Pour utiliser un attribut avec la couleur par défaut du terminal (-1), vous +devez utiliser un nombre supérieur à la dernière couleur du terminal, par +exemple la couleur maximum de WeeChat : 99999. + +Exemple de gras avec la couleur de texte du terminal : + +---- +/set weechat.color.status_time *99999 +---- + +[[notify_levels]] +=== Niveaux de notification + +[[setup_notify_levels]] +==== Configurer les niveaux de notification + +Quatre niveaux sont possibles dans les messages affichés dans les tampons, du +moins important au plus important : + +* _low_ : message avec faible importance (par exemple un join/part/quit irc) +* _message_ : message d'un utilisateur +* _private_ : message dans un tampon privé +* _highlight_ : message avec highlight + +Chaque tampon a un niveau de notification, qui est utilisé pour décider quels +messages ajouteront le tampon dans la hotlist. + +Le niveau de notification par défaut peut être défini avec l'option +<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>, +la valeur par défaut est _all_. + +[width="75%",cols="2m,7",options="header"] +|=== +| Niveau de notification | Niveau des messages ajoutés à la hotlist +| none | (aucun) +| highlight | _highlight_ + _private_ +| message | _highlight_ + _private_ + _message_ +| all | _highlight_ + _private_ + _message_ + _low_ +|=== + +Le niveau de notification peut être défini pour un ensemble de tampons, par +exemple tous les tampons du serveur irc "libera" : + +---- +/set weechat.notify.irc.libera message +---- + +Définir le niveau de notification _highlight_ sur le canal "#weechat" seulement : + +---- +/set weechat.notify.irc.libera.#weechat highlight +---- + +Le niveau de notification pour un tampon peut aussi être défini avec la +commande `/buffer` : + +---- +/buffer notify highlight +---- + +[[max_hotlist_level_nicks]] +==== Niveau maximal de hotlist pour des pseudos + +Il est possible de définir un niveau maximal de hotlist pour certains pseudos, +par tampon ou groupe de tampons (comme des serveurs IRC). + +La propriété de tampon "hotlist_max_level_nicks" peut être définie avec une +liste de pseudos et pour chaque pseudo le niveau maximal de hotlist à déclencher, +les niveaux possibles sont : + +* -1 : pas de changement dans la hotlist pour ce pseudo +* 0 : faible priorité (comme les messages join/part) +* 1 : message +* 2 : message privé +* 3 : highlight (en réalité inutile, car il s'agit déjà du niveau maximal par + défaut pour tous les messages) + +Par exemple pour désactiver les « highlights » de "joe" et "mike" sur le tampon +courant : + +---- +/buffer set hotlist_max_level_nicks_add joe:2,mike:2 +---- + +[NOTE] +La propriété de tampon "hotlist_max_level_nicks" n'est pas sauvegardée dans la +configuration. + +Vous pouvez facilement la sauvegarder avec le script _buffer_autoset.py_ : vous +pouvez l'installer avec `+/script install buffer_autoset.py+` et obtenir de l'aide +avec `+/help buffer_autoset+`. + +[[highlights]] +=== Highlights + +[[highlights_words]] +==== Ajouter des mots pour le « highlight » + +Par défaut, WeeChat met en valeur les messages des autres utilisateurs qui +contiennent votre pseudo, par conséquent le highlight dépend du tampon +(le pseudo peut être différent d'un tampon à l'autre). + +Vous pouvez ajouter d'autres mots à mettre en valeur avec l'option +<<option_weechat.look.highlight,weechat.look.highlight>>, par exemple pour mettre +en valeur votre pseudo, "mot1", "mot2" et tous les mots commençants par "test" : + +---- +/set weechat.look.highlight mot1,mot2,test* +---- + +Si vous avez besoin d'une règle plus spécifique pour un mot, vous pouvez utiliser +des expressions régulières avec l'option +<<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, +par exemple pour mettre en valeur les mots "flashcode", "flashcöde" et "flashy" : + +---- +/set weechat.look.highlight_regex flashc[oö]de|flashy +---- + +Les délimiteurs autour des mots à mettre en valeur peuvent être paramétrés avec +l'option <<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>>. + +[[highlights_tags]] +==== Ajouter des étiquettes pour le « highlight » + +Les lignes affichées contiennent des étiquettes (« tags »), qui donnent des +informations sur l'origine du message ou le message lui-même. + +Vous pouvez afficher les étiquettes avec la commande `/debug tags` (même commande +pour les cacher). + +Vous pouvez ajouter des étiquettes à mettre en valeur avec l'option +<<option_weechat.look.highlight_tags,weechat.look.highlight_tags>>. +Les étiquettes sont séparées par des virgules, et plusieurs étiquettes peuvent +être séparées par `+++` pour faire un "et" logique entre elles. + +Par exemple pour mettre en valeur tous les messages du pseudo "FlashCode" et +toutes les notices des pseudos commençant par "toto" : + +---- +/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" +---- + +[[highlights_regex_buffer]] +==== Définir des highlights supplémentaires sur le tampon + +Vous pouvez forcer le highlight en utilisant une expression regulière avec la +propriété de tampon "highlight_regex". + +Par exemple pour forcer le highlight sur tous les messages dans le canal +courant : + +---- +/buffer set highlight_regex .* +---- + +[NOTE] +La propriété de tampon "highlight_regex" n'est pas sauvegardée dans la +configuration. + +Vous pouvez facilement la sauvegarder avec le script _buffer_autoset.py_ : vous +pouvez l'installer avec `+/script install buffer_autoset.py+` et obtenir de l'aide +avec `+/help buffer_autoset+`. + [[mouse]] === Support souris @@ -2434,6 +2206,245 @@ Vous pouvez trouver le nom de l'évènement avec la commande `+/input grab_mouse puis en faisant l'action avec la souris. Cela insérera le nom de l'évènement sur la ligne de commande. +[[bars]] +=== Barres + +Une _barre_ est une zone à côté de la discussion qui peut contenir tout type de +texte. + +Les options de barre sont définies avec les options `weechat.bar.nom.option` où +`nom` et le nom de la barre et `option` l'option pour cette barre. + +Liste des options de barre : + +[width="100%",cols="2m,2,10",options="header"] +|=== +| Option | Valeurs | Description + +| type | `root`, `window` | + Une barre avec le type `root` est affichée exactement une fois à l'écran, en + dehors de toutes les fenêtres. La barre par défaut _buflist_ est de type + `root`. + + Une barre avec le type `window` est affichée dans chaque fenêtre, par exemple + si vous découpez l'écran (avec `/window splith` ou `/window splitv`), vous + aurez une barre dans chaque fenêtre. Les barres par défaut _title_, _status_, + _input_ et _nicklist_ sont de type `window`. + +| position | `top`, `bottom`, `left`, `right` | + Position de la barre : au dessus/en dessous de la discussion, sur la + gauche/droite. + +| priority | entier ≥ 0 | + Priorité de la barre : elle est utilisée pour ordonner les barres à l'écran, + quand plusieurs barres utilisent le même type et position. + + Les barres sont affichées depuis le bord de l'écran vers le centre. Une + priorité plus haute affichera la barre au début, donc près du bord. + + Exemple : la barre _input_ a une priorité de 1000, donc elle est affichée + avant la barre _status_, qui a une priorité de 500. + +| size | entier ≥ 0 | + La taille de la barre : nombre de colonnes pour une position left/right, + nombre de lignes pour une position top/bottom. Une taille de `0` signifie + automatique, donc la taille sera calculée en fonction du contenu affiché dans + la barre. + +| size_max | entier ≥ 0 | + La taille maximum pour la barre, `0` = pas de limite (cette option est + utilisée seulement si `size` = `0`). + +| color_bg | couleur | + La couleur par défaut du fond de la barre. + +| color_fg | couleur | + La couleur par défaut du texte dans la barre. + +| color_delim | couleur | + La couleur des délimiteurs dans la barre. + +| hidden | `on`, `off` | + Lorsque l'option est `on`, la barre est cachée. + + Note : plutôt que de changer cette option, il est préférable d'utiliser la + commande `/bar`, par exemple : `/bar toggle nicklist` (voir la commande + <<command_weechat_bar,/bar>>). + +| separator | `on`, `off` | + Lorsque l'option est `on`, un séparateur (ligne) est affiché entre la barre et + les autres barres (ou la discussion). + +| items | chaîne | + Une liste d'objets (voir <<bar_items,objets>> pour plus d'infos). + +| filling_left_right | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | + Type de remplissage pour la barre lorsqu'elle a une position `left` ou + `right` (voir <<bar_filling,remplissage>> pour plus d'infos). + +| filling_top_bottom | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | + Type de remplissage pour la barre lorsqu'elle a une position `top` ou `bottom` + (voir <<bar_filling,remplissage>> pour plus d'infos). + +| conditions | chaîne | + Les conditions pour afficher la barre (voir <<bar_conditions,conditions>> pour + plus d'infos). +|=== + +[[bar_items]] +==== Objets + +L'option _items_ est une chaîne avec une liste d'objets de barre, séparés par +une virgule (espace entre les objets à l'écran) ou un `+++` (objets collés). + +La liste des objets de barre est affichée avec la commande `/bar listitems`. + +Avant ou après l'objet de barre, vous pouvez utiliser des caractères (qui ne +sont pas alphanumériques, `+-+` ou `+_+`). Ils seront affichés avant/après +l'objet de barre avec la couleur des délimiteurs définie dans la barre (option +_color_delim_). + +Exemple de barre avec les objets +"[time],buffer_number+:+buffer_plugin+.+buffer_name" : + +.... +┌───────────────────────────────────────────────────────────────────────────┐ +│[12:55] 3:irc/libera.#weechat │ +└───────────────────────────────────────────────────────────────────────────┘ +.... + +Une syntaxe spéciale peut être utilisée pour forcer le tampon utilisé lors de +l'affichage de l'objet de barre : "@tampon:objet" (où "tampon" est le nom +complet du tampon et "objet" est le nom d'un objet de barre). + +Ceci peut être pratique dans les barres "root", pour afficher un objet de barre +pour un tampon qui n'est pas affiché dans la fenêtre courante (ou même pas +affiché du tout). + +Exemple : liste de pseudos de bitlbee dans une barre "root" (si la barre +s'appelle _bitlist_ et si le serveur bitlbee s'appelle _bitlbee_) : + +---- +/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" +---- + +[[bar_filling]] +==== Remplissage + +Il y a quatre types de remplissage : + +* `+horizontal+` : les objets sont affichés horizontalement, de gauche à droite. + S'il y a des retours à la ligne dans les objets, un espace est utilisé pour + séparer les lignes. +* `+vertical+` : les objets sont affichés de haut en bas. S'il y a des retours à + la ligne dans les objets, une nouvelle ligne est utilisée pour séparer les + lignes. +* `+columns_horizontal+` : les objets sont affichés en utilisant des colonnes, où + le texte est aligné à gauche. Le premier objet est en haut à gauche, le second + est sur la même ligne, sur la droite. +* `+columns_vertical+` : les objets sont affichés en utilisant des colonnes, où + le texte est aligné à gauche. Le premier objet est en haut à gauche, le second + est sur la ligne en dessous. + +Les barres par défaut _title_, _status_ et _input_ ont un remplissage +_horizontal_, et la barre par défaut _nicklist_ a un remplissage _vertical_. + +Quelques exemples de remplissage pour la barre _nicklist_ : + +.... +┌───────────────────────────────────────────────────────────────────────┐ +│Welcome to #test, this is a test channel │ +│12:54:15 peter | hey! │@carl │ +│12:55:01 +Max | hello │@jessika│ +│ │@maddy │ +│ │%Diego │ +│ │%Melody │ +│ │+Max │ +│ │ celia │ +│ │ Eva │ +│ │ freddy │ +│ │ Harold^│ +│ │ henry4 │ +│ │ jimmy17│ +│ │ jodie ▼│ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│Welcome to #test, this is a test channel │ +│12:54:15 peter | hey! │@carl lee │ +│12:55:01 +Max | hello │@jessika louise │ +│ │@maddy mario │ +│ │%Diego mark │ +│ │%Melody peter │ +│ │+Max Rachel │ +│ │ celia richard│ +│ │ Eva sheryl │ +│ │ freddy Vince │ +│ │ Harold^ warren │ +│ │ henry4 zack │ +│ │ jimmy17 │ +│ │ jodie │ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl %Diego celia Harold^ jodie mario Rachel Vince │ +│@jessika %Melody Eva henry4 lee mark richard warren │ +│@maddy +Max freddy jimmy17 louise peter sheryl zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ +│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ +│ mark peter Rachel richard sheryl Vince warren zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_horizontal ▲ +.... + +[[bar_conditions]] +==== Conditions + +L'option _conditions_ est une chaîne qui est évaluée pour savoir si la barre +doit être affichée ou non. + +La chaîne peut être : + +* _active_ : la fenêtre doit être active +* _inactive_ : la fenêtre doit être inactive +* _nicklist_ : le tampon affiché dans la fenêtre doit avoir une liste de pseudos +* une expression : elle est évaluée comme booléen (voir la commande + <<command_weechat_eval,/eval>>) + +Pour une expression, les variables suivantes sont disponibles : + +* `+${active}+` : vrai si la fenêtre est active +* `+${inactive}+` : vrai si la fenêtre est inactive +* `+${nicklist}+` : vrai si le tampon affiché dans la fenêtre a une liste de + pseudos + +Les pointeurs suivants sont disponibles : + +* `+${window}+` : la fenêtre où la condition est évaluée +* `+${buffer}+` : le tampon de la fenêtre où la condition est évaluée + +Exemple pour afficher la liste de pseudos dans tous les tampons possédant une +liste de pseudos, et seulement si la largeur du terminal est supérieure à 100 : + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" +---- + +Même condition, mais afficher toujours la liste de pseudos sur le tampon +_&bitlbee_ (même si le terminal est petit) : + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" +---- + [[secured_data]] === Données sécurisées diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc index 679ece67e..98eaadbf9 100644 --- a/doc/it/weechat_user.it.adoc +++ b/doc/it/weechat_user.it.adoc @@ -697,6 +697,58 @@ Some environment variables are used by WeeChat if they are defined: |=== // TRANSLATION MISSING +[[colors_support]] +=== Colors support + +WeeChat può usare fino a 32767 coppie di colore per visualizzare il testo nelle barre e +nell'area di chat(il terminale deve supportare 256 colori per essere utilizzati in WeeChat). + +In base al valore della variabile di ambiente _TERM_, potrebbero verificarsi i +seguenti limiti per i colori in WeeChat: + +[width="75%",cols="8,>3,>3",options="header"] +|=== +| $TERM | Colori | Coppie +| "rxvt-unicode", "xterm", ... | 88 | 32767 +| "rxvt-256color", "xterm-256color", ... | 256 | 32767 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 32767 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 32767 +|=== + +È possibile eseguire `weechat --colors` o utilizzare il comando `/color` in +WeeChat per visualizzare i limiti del proprio ambiente. + +Alcuni valori raccomandati per _TERM_ se si desiderano 256 colori: + +* con screen: _screen-256color_ +// TRANSLATION MISSING +* under tmux: _screen-256color_ or _tmux-256color_ +// TRANSLATION MISSING +* outside screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... + +[NOTE] +Potrebbe essere necessario installare il pacchetto "ncurses-term" per usare +questi valori nella variabile _TERM_. + +Se si sta utilizzando screen, è possibile aggiungere questa riga al +proprio _~/.screenrc_: + +---- +term screen-256color +---- + +// TRANSLATION MISSING +If your _TERM_ variable has wrong value and that WeeChat is already running, +you can change it with these two commands: + +---- +/set env TERM screen-256color +/upgrade +---- + +// TRANSLATION MISSING [[files_and_directories]] === Files and directories @@ -1047,157 +1099,6 @@ kbd:[!] Nel plugin irc, si possono riorganizzare i colori usando l'opzione <<option_irc.color.mirc_remap,irc.color.mirc_remap>>. -[[colors]] -=== Colori - -WeeChat può usare fino a 32767 coppie di colore per visualizzare il testo nelle barre e -nell'area di chat(il terminale deve supportare 256 colori per essere utilizzati in WeeChat). - -In base al valore della variabile di ambiente _TERM_, potrebbero verificarsi i -seguenti limiti per i colori in WeeChat: - -[width="75%",cols="8,>3,>3",options="header"] -|=== -| $TERM | Colori | Coppie -| "rxvt-unicode", "xterm", ... | 88 | 32767 -| "rxvt-256color", "xterm-256color", ... | 256 | 32767 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 32767 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 32767 -|=== - -È possibile eseguire `weechat --colors` o utilizzare il comando `/color` in -WeeChat per visualizzare i limiti del proprio ambiente. - -Alcuni valori raccomandati per _TERM_ se si desiderano 256 colori: - -* con screen: _screen-256color_ -// TRANSLATION MISSING -* under tmux: _screen-256color_ or _tmux-256color_ -// TRANSLATION MISSING -* outside screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... - -[NOTE] -Potrebbe essere necessario installare il pacchetto "ncurses-term" per usare -questi valori nella variabile _TERM_. - -Se si sta utilizzando screen, è possibile aggiungere questa riga al -proprio _~/.screenrc_: - ----- -term screen-256color ----- - -// TRANSLATION MISSING -If your _TERM_ variable has wrong value and that WeeChat is already running, -you can change it with these two commands: - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== Colori base - -I colori base in WeeChat sono: - -[width="75%",cols="1m,4",options="header"] -|=== -| Nome | Colore -| default | Colore predefinito del terminale (trasparente per lo sfondo) -| black | Nero -| darkgray | Grigio scuro -| red | Rosso scuro -| lightred | Rosso chiaro -| green | Verde scuro -| lightgreen | Verde chiaro -| brown | Marrone -| yellow | Giallo -| blue | Blu scuro -| lightblue | Blu chiaro -| magenta | Rosa scuro -| lightmagenta | Rosa chiaro -| cyan | Azzurro scuro -| lightcyan | Azzurro chiaro -| gray | Grigio -| white | Bianco -|=== - -[[colors_extended]] -==== Colori estesi - -WeeChat alloca dinamicamente le coppie colore quando vengono usati i colori -sullo schermo (per mostrare buffer e barre). - -In aggiunta ai colori di base, si può usare un numero per il colore compreso -tra 1 e il limite del proprio terminale. - -Il comando `/color` mostra i colori attivi ed i limiti. Com kbd:[Alt+c] si può -passare temporaneamente ai colori del terminale per sceglierne uno. - -Se ad esempio si desidera visualizzare l'ora in arancione nel buffer: - ----- -/set weechat.color.chat_time 214 ----- - -O se si desidera uno sfondo verde scuro per la barra di stato: - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== Alias - -Si possono aggiungere degli alias ai colori con il comando `/color alias` e -usarli in ogni opzione relativa al colore. - -Ad esempio: - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== Attributi - -Esistono alcuni attributi per i colori. Uno o più attributi vanno aggiunti prima -del nome o del numero del colore: - -* `+*+` : testo in grassetto -* `+!+` : video inverso -* `+/+` : testo in corsivo -* `+_+` : testo sottolineato -* `+|+` : mantiene attributi: non ripristina grassetto/inverso/sottolineato - al cambio di colore - -Ad esempio se si vuole il proprio nick bianco e sottolineato: - ----- -/set weechat.color.chat_nick_self _white ----- - -O se si desidera l'ora nella barra di stato arancione sottolineata -e in grassetto: - ----- -/set weechat.color.status_time *_214 ----- - -Per usare un attributo con il colore predefinito del terminale (-1), bisogna -usare un numero maggiore dell'ultimo colore del terminale, ad esempio il -numero massimo in WeeChat: 99999. - -Esempio di grassetto con il colore di primo piano del terminale: - ----- -/set weechat.color.status_time *99999 ----- - [[buffers_and_windows]] === Buffer e finestre @@ -1537,240 +1438,6 @@ By default WeeChat and its default plugins interpret these variables: External plugins and scripts can define and use other local variables. // TRANSLATION MISSING -[[bars]] -=== Bars - -A _bar_ is an area beside the chat that can contain any type of text. - -The bar options can be set with options `weechat.bar.name.option` where `name` -is the name of the bar and `option` the option for this bar. - -List of bar options: - -[width="100%",cols="2m,2,10",options="header"] -|=== -| Option | Values | Description - -| type | `root`, `window` | -// TRANSLATION MISSING - A bar with type `root` is displayed exactly one time on screen, outside all - windows. The default bar _buflist_ has type `root`. + - A bar with type `window` is displayed in each window, for example if you - split one time the screen (with `/window splith` or `/window splitv`), you - will have one bar in each window. The default bars _title_, _status_, - _input_ and _nicklist_ have type `window`. - -| position | `top`, `bottom`, `left`, `right` | - Position of the bar: above/below chat, on the left/right. - -| priority | integer ≥ 0 | - Priority for display of bar: this is used for ordering the bars on screen when - many bars have same type and position. + - The bars are displayed from the edge of the screen to the center. A higher - priority will display bar at the beginning, so closer to the edge. + - Example: _input_ bar has priority 1000, so it is displayed before the _status_ - bar, which has priority 500. - -| size | integer ≥ 0 | - The size of the bar: number of columns for position left/right, number - of lines for position top/bottom. A size of `0` means automatic, so the size - will be computed according to content displayed in bar. - -| size_max | integer ≥ 0 | - The maximum size for a bar, `0` = no limit (this option is used only if - `size` = `0`). - -| color_bg | color | - The default background color for the bar. - -| color_fg | color | - The default text color for the bar. - -| color_delim | color | - The color for delimiters in bar. - -| hidden | `on`, `off` | - When option is `on`, the bar is hidden. + - Note: instead of changing this option, the command `/bar` is preferred, for - example: `/bar toggle nicklist` (see command <<command_weechat_bar,/bar>>). - -| separator | `on`, `off` | - When option is `on`, a separator (line) is displayed between this bar and - other bars (or chat). - -| items | string | - A list of _items_ (see <<bar_items,items>> for more info). - -| filling_left_right | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | - Type of filling for a bar which has position `left` or `right` (see - <<bar_filling,filling>> for more info). - -| filling_top_bottom | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | - Type of filling for a bar which has position `top` or `bottom` (see - <<bar_filling,filling>> for more info). - -| conditions | string | - The conditions to display the bar (see <<bar_conditions,conditions>> for more - info). -|=== - -[[bar_items]] -==== Items - -The option _items_ is a string with a list of bar items, separated by a comma -(space between items on screen) or `+++` (glued items). - -The list of bar items is displayed with command `/bar listitems`. - -// TRANSLATION MISSING -Before or after item name, you can use chars (that are not alphanumeric, `+-+` -or `+_+`). They will be displayed before/after item with the delimiters color -defined in bar (option _color_delim_). - -Example of bar with items "[time],buffer_number+:+buffer_plugin+.+buffer_name": - -.... -┌───────────────────────────────────────────────────────────────────────────┐ -│[12:55] 3:irc/libera.#weechat │ -└───────────────────────────────────────────────────────────────────────────┘ -.... - -// TRANSLATION MISSING -A special syntax can be used to force the buffer used when displaying the bar -item: "@buffer:item" (where "buffer" is the full name of buffer and "item" is -the name of a bar item). - -// TRANSLATION MISSING -This is useful in root bars, to display item for a specific buffer which is -not displayed in the current window (or even not displayed at all). - -// TRANSLATION MISSING -Example: nicklist of bitlbee in a root bar (if the bar is called -_bitlist_ and if bitlbee server is called _bitlbee_): - ----- -/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" ----- - -[[bar_filling]] -==== Filling - -There are four types of filling: - -* `+horizontal+`: the items are displayed horizontally, from left to right. If - there are new lines in items, a space is used to separate lines. -* `+vertical+`: the items are displayed from top to bottom. If there are new - lines in items, a new line is used to separate lines. -* `+columns_horizontal+`: items are displayed using columns, where text is - aligned on the left. The first item is on top left, the second is on same - line, on the right. -* `+columns_vertical+`: items are displayed using columns, where text is aligned - on the left. The first item is on top left, the second is one line below. - -Default bars _title_, _status_ and _input_ have _horizontal_ filling, and -default bar _nicklist_ has _vertical_ filling. - -Some examples of filling for bar _nicklist_: - -.... -┌───────────────────────────────────────────────────────────────────────┐ -│Welcome to #test, this is a test channel │ -│12:54:15 peter | hey! │@carl │ -│12:55:01 +Max | hello │@jessika│ -│ │@maddy │ -│ │%Diego │ -│ │%Melody │ -│ │+Max │ -│ │ celia │ -│ │ Eva │ -│ │ freddy │ -│ │ Harold^│ -│ │ henry4 │ -│ │ jimmy17│ -│ │ jodie ▼│ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│Welcome to #test, this is a test channel │ -│12:54:15 peter | hey! │@carl lee │ -│12:55:01 +Max | hello │@jessika louise │ -│ │@maddy mario │ -│ │%Diego mark │ -│ │%Melody peter │ -│ │+Max Rachel │ -│ │ celia richard│ -│ │ Eva sheryl │ -│ │ freddy Vince │ -│ │ Harold^ warren │ -│ │ henry4 zack │ -│ │ jimmy17 │ -│ │ jodie │ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl %Diego celia Harold^ jodie mario Rachel Vince │ -│@jessika %Melody Eva henry4 lee mark richard warren │ -│@maddy +Max freddy jimmy17 louise peter sheryl zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ -│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ -│ mark peter Rachel richard sheryl Vince warren zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_horizontal ▲ -.... - -[[bar_conditions]] -==== Conditions - -// TRANSLATION MISSING -The option _conditions_ is a string which is evaluated to know if the bar -must be displayed or not. - -The string can be: - -* _active_: the window must be active -* _inactive_: the window must be inactive -* _nicklist_: the buffer displayed in window must have a nicklist -* an expression: it is evaluated as boolean (see command - <<command_weechat_eval,/eval>>) - -For the expression, following variables are available: - -* `+${active}+`: true if window is active -* `+${inactive}+`: true if window is inactive -* `+${nicklist}+`: true if buffer displayed in window has a nicklist - -Following pointers are available: - -* `+${window}+`: the window where condition is evaluated -* `+${buffer}+`: the buffer of window where condition is evaluated - -Example to display nicklist bar in all buffers with a nicklist, and only if -width of terminal is > 100: - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" ----- - -Same condition, but always display nicklist on buffer _&bitlbee_ -(even if terminal is small): - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" ----- - -// TRANSLATION MISSING [[bare_display]] === Bare display @@ -1858,159 +1525,20 @@ The screen will look like that in bare display: So you can click the URL from _joe_ without any problem in your terminal (of course this supposes that your terminal supports click on URLs). -[[notify_levels]] -=== Livelli di notifica - -// TRANSLATION MISSING -[[setup_notify_levels]] -==== Setup notify levels - -Sono possibili quattro livelli per i messaggi mostrati nei buffer, dal più basso -al più alto: - -* _low_: messaggio di bassa importanza (ad esempio entrata/uscita/disconnessione - di irc) -* _message_: messaggio da un utente -* _private_: messaggio in un buffer privato -* _highlight_: messaggio con notifica - -Ogni buffer ha un livello di notifica, che viene usato per decidere quale -messaggio il buffer andrà ad aggiungere nella hotlist. - -Il livello predefinito di notifica può essere impostato usando l'opzione -<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>, -il valore predefinito è _all_. - -[width="75%",cols="2m,7",options="header"] -|=== -| Livello di notifica | Livello del messaggio aggiunto alla hotlist -| none | (nessuno) -| highlight | _highlight_ + _private_ -| message | _highlight_ + _private_ + _message_ -| all | _highlight_ + _private_ + _message_ + _low_ -|=== - -Il livello di notifica può essere definito per un set di buffer, ad esempio -tutti i buffer per il server irc "libera": - ----- -/set weechat.notify.irc.libera message ----- - -Imposta il livello di notifica _highlight_ solo sul canale _#weechat_: - ----- -/set weechat.notify.irc.libera.#weechat highlight ----- - -Il livello di notifica per un buffer può essere impostato con il comando `/buffer`: - ----- -/buffer notify highlight ----- - // TRANSLATION MISSING -[[max_hotlist_level_nicks]] -==== Max hotlist level for nicks - -It is possible to set max hotlist level for some nicks, per buffer, or per group -of buffers (like IRC servers). - -The buffer property "hotlist_max_level_nicks" can be set with a list of nicks -and for each nick the max hotlist level to trigger, possible levels are: - -* -1: no hotlist changes for nick -* 0: low priority (like join/part messages) -* 1: message -* 2: private message -* 3: highlight (in fact useless, since it's already the default max for all messages) - -For example to disable highlights from "joe" and "mike" on current buffer: - ----- -/buffer set hotlist_max_level_nicks_add joe:2,mike:2 ----- - -[NOTE] -The buffer property "hotlist_max_level_nicks" is not saved in configuration. + -You can easily save it with the script _buffer_autoset.py_: you can install it -with `+/script install buffer_autoset.py+` and get help with `+/help buffer_autoset+`. +[[key_bindings]] +== Key bindings // TRANSLATION MISSING -[[highlights]] -=== Highlights - -[[highlights_words]] -==== Add words to highlight - -By default, WeeChat highlights messages from other users containing your nick, -therefore the highlight depends on the buffer (the nick can be different from -one buffer to another). - -You can add other words to highlight with the option -<<option_weechat.look.highlight,weechat.look.highlight>>, for example to -highlight your nick and "word1", "word2" and all words beginning with "test": - ----- -/set weechat.look.highlight word1,word2,test* ----- - -If you need a more specific rule for the word, you can use regular expressions -with the option <<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, -for example to highlight words "flashcode", "flashcöde" and "flashy": - ----- -/set weechat.look.highlight_regex flashc[oö]de|flashy ----- - -The delimiters around words to highlight can be customized with the option -<<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>>. - -[[highlights_tags]] -==== Add tags to highlight - -Lines displayed can contain "tags", which give some info about the origin of -message or the message itself. + -You can display tags with the command `/debug tags` (same command to hide them). - -You can add specific tags to highlight with the option -<<option_weechat.look.highlight_tags,weechat.look.highlight_tags>>. -Tags are separated by commas, and multiple tags can be separated by `+++` to do -a logical "and" between them. - -For example to highlight all messages from nick "FlashCode" and all notices -from nicks beginning with "toto": - ----- -/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" ----- - -[[highlights_regex_buffer]] -==== Set extra highlights on buffer - -You can force highlight using a regular expression with the buffer property -"highlight_regex". - -For example to force the highlight on all messages in the current buffer: - ----- -/buffer set highlight_regex .* ----- - -[NOTE] -The buffer property "highlight_regex" is not saved in configuration. + -You can easily save it with the script _buffer_autoset.py_: you can install it -with `+/script install buffer_autoset.py+` and get help with `+/help buffer_autoset+`. - -[[key_bindings]] -=== Associazione tasti predefinita +WeeChat provides a lot of default key bindings, listed in the following chapters. + +They can be changed and new ones can be added with the <<command_weechat_key,/key>> command. [[key_bindings_command_line]] -==== Tasti per la riga di comando +=== Tasti per la riga di comando // TRANSLATION MISSING [[key_bindings_cmdline_cursor_movement]] -===== Cursor movement +==== Cursor movement [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2031,7 +1559,7 @@ with `+/script install buffer_autoset.py+` and get help with `+/help buffer_auto // TRANSLATION MISSING [[key_bindings_cmdline_editing]] -===== Editing +==== Editing [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2066,7 +1594,7 @@ with `+/script install buffer_autoset.py+` and get help with `+/help buffer_auto // TRANSLATION MISSING [[key_bindings_cmdline_color_codes]] -===== Color codes +==== Color codes [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2081,7 +1609,7 @@ with `+/script install buffer_autoset.py+` and get help with `+/help buffer_auto // TRANSLATION MISSING [[key_bindings_cmdline_history]] -===== Command history +==== Command history [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2094,7 +1622,7 @@ with `+/script install buffer_autoset.py+` and get help with `+/help buffer_auto // TRANSLATION MISSING [[key_bindings_buffers]] -==== Buffers +=== Buffers [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2135,7 +1663,7 @@ with `+/script install buffer_autoset.py+` and get help with `+/help buffer_auto // TRANSLATION MISSING [[key_bindings_windows]] -==== Windows +=== Windows [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2155,7 +1683,7 @@ with `+/script install buffer_autoset.py+` and get help with `+/help buffer_auto |=== [[key_bindings_bars]] -==== Bars +=== Bars [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2185,7 +1713,7 @@ with `+/script install buffer_autoset.py+` and get help with `+/help buffer_auto |=== [[key_bindings_hotlist]] -==== Hotlist +=== Hotlist [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2203,7 +1731,7 @@ with `+/script install buffer_autoset.py+` and get help with `+/help buffer_auto // TRANSLATION MISSING [[key_bindings_toggle_keys]] -==== Toggle keys +=== Toggle keys [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2218,7 +1746,7 @@ with `+/script install buffer_autoset.py+` and get help with `+/help buffer_auto // TRANSLATION MISSING [[key_bindings_search_context]] -==== Search context +=== Search context Questi tasti sono usati nel contesto "search" (quando viene digitato kbd:[Ctrl+r] per cercare del testo nel buffer). @@ -2243,7 +1771,7 @@ kbd:[Ctrl+r] per cercare del testo nel buffer). // TRANSLATION MISSING [[key_bindings_cursor_context]] -==== Cursor context +=== Cursor context Questi tasti sono usati nel contesto "cursor" (movimento libero del cursore sullo schermo. @@ -2274,7 +1802,7 @@ sullo schermo. // TRANSLATION MISSING [[key_bindings_mouse]] -==== Mouse +=== Mouse // TRANSLATION MISSING These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] @@ -2349,7 +1877,7 @@ These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] // TRANSLATION MISSING [[key_bindings_fset_buffer]] -==== Fset buffer +=== Fset buffer // TRANSLATION MISSING These keys and actions are used on the fset buffer (see <<fset_plugin,Fset plugin>>). @@ -2399,7 +1927,7 @@ These keys and actions are used on the fset buffer (see <<fset_plugin,Fset plugi // TRANSLATION MISSING [[key_bindings_script_buffer]] -==== Script buffer +=== Script buffer // TRANSLATION MISSING These keys and actions are used on the script buffer (see <<scripts_plugins,Script plugin>>). @@ -2425,6 +1953,258 @@ These keys and actions are used on the script buffer (see <<scripts_plugins,Scri [NOTE] ^(1)^ The action must be entered as input on the command line, followed by kbd:[Enter]. +// TRANSLATION MISSING +[[configuration]] +== Configuration + +// TRANSLATION MISSING +[[colors]] +=== Colors + +[[colors_basic]] +==== Colori base + +I colori base in WeeChat sono: + +[width="75%",cols="1m,4",options="header"] +|=== +| Nome | Colore +| default | Colore predefinito del terminale (trasparente per lo sfondo) +| black | Nero +| darkgray | Grigio scuro +| red | Rosso scuro +| lightred | Rosso chiaro +| green | Verde scuro +| lightgreen | Verde chiaro +| brown | Marrone +| yellow | Giallo +| blue | Blu scuro +| lightblue | Blu chiaro +| magenta | Rosa scuro +| lightmagenta | Rosa chiaro +| cyan | Azzurro scuro +| lightcyan | Azzurro chiaro +| gray | Grigio +| white | Bianco +|=== + +[[colors_extended]] +==== Colori estesi + +WeeChat alloca dinamicamente le coppie colore quando vengono usati i colori +sullo schermo (per mostrare buffer e barre). + +In aggiunta ai colori di base, si può usare un numero per il colore compreso +tra 1 e il limite del proprio terminale. + +Il comando `/color` mostra i colori attivi ed i limiti. Com kbd:[Alt+c] si può +passare temporaneamente ai colori del terminale per sceglierne uno. + +Se ad esempio si desidera visualizzare l'ora in arancione nel buffer: + +---- +/set weechat.color.chat_time 214 +---- + +O se si desidera uno sfondo verde scuro per la barra di stato: + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== Alias + +Si possono aggiungere degli alias ai colori con il comando `/color alias` e +usarli in ogni opzione relativa al colore. + +Ad esempio: + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== Attributi + +Esistono alcuni attributi per i colori. Uno o più attributi vanno aggiunti prima +del nome o del numero del colore: + +* `+*+` : testo in grassetto +* `+!+` : video inverso +* `+/+` : testo in corsivo +* `+_+` : testo sottolineato +* `+|+` : mantiene attributi: non ripristina grassetto/inverso/sottolineato + al cambio di colore + +Ad esempio se si vuole il proprio nick bianco e sottolineato: + +---- +/set weechat.color.chat_nick_self _white +---- + +O se si desidera l'ora nella barra di stato arancione sottolineata +e in grassetto: + +---- +/set weechat.color.status_time *_214 +---- + +Per usare un attributo con il colore predefinito del terminale (-1), bisogna +usare un numero maggiore dell'ultimo colore del terminale, ad esempio il +numero massimo in WeeChat: 99999. + +Esempio di grassetto con il colore di primo piano del terminale: + +---- +/set weechat.color.status_time *99999 +---- + +[[notify_levels]] +=== Livelli di notifica + +// TRANSLATION MISSING +[[setup_notify_levels]] +==== Setup notify levels + +Sono possibili quattro livelli per i messaggi mostrati nei buffer, dal più basso +al più alto: + +* _low_: messaggio di bassa importanza (ad esempio entrata/uscita/disconnessione + di irc) +* _message_: messaggio da un utente +* _private_: messaggio in un buffer privato +* _highlight_: messaggio con notifica + +Ogni buffer ha un livello di notifica, che viene usato per decidere quale +messaggio il buffer andrà ad aggiungere nella hotlist. + +Il livello predefinito di notifica può essere impostato usando l'opzione +<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>, +il valore predefinito è _all_. + +[width="75%",cols="2m,7",options="header"] +|=== +| Livello di notifica | Livello del messaggio aggiunto alla hotlist +| none | (nessuno) +| highlight | _highlight_ + _private_ +| message | _highlight_ + _private_ + _message_ +| all | _highlight_ + _private_ + _message_ + _low_ +|=== + +Il livello di notifica può essere definito per un set di buffer, ad esempio +tutti i buffer per il server irc "libera": + +---- +/set weechat.notify.irc.libera message +---- + +Imposta il livello di notifica _highlight_ solo sul canale _#weechat_: + +---- +/set weechat.notify.irc.libera.#weechat highlight +---- + +Il livello di notifica per un buffer può essere impostato con il comando `/buffer`: + +---- +/buffer notify highlight +---- + +// TRANSLATION MISSING +[[max_hotlist_level_nicks]] +==== Max hotlist level for nicks + +It is possible to set max hotlist level for some nicks, per buffer, or per group +of buffers (like IRC servers). + +The buffer property "hotlist_max_level_nicks" can be set with a list of nicks +and for each nick the max hotlist level to trigger, possible levels are: + +* -1: no hotlist changes for nick +* 0: low priority (like join/part messages) +* 1: message +* 2: private message +* 3: highlight (in fact useless, since it's already the default max for all messages) + +For example to disable highlights from "joe" and "mike" on current buffer: + +---- +/buffer set hotlist_max_level_nicks_add joe:2,mike:2 +---- + +[NOTE] +The buffer property "hotlist_max_level_nicks" is not saved in configuration. + +You can easily save it with the script _buffer_autoset.py_: you can install it +with `+/script install buffer_autoset.py+` and get help with `+/help buffer_autoset+`. + +// TRANSLATION MISSING +[[highlights]] +=== Highlights + +[[highlights_words]] +==== Add words to highlight + +By default, WeeChat highlights messages from other users containing your nick, +therefore the highlight depends on the buffer (the nick can be different from +one buffer to another). + +You can add other words to highlight with the option +<<option_weechat.look.highlight,weechat.look.highlight>>, for example to +highlight your nick and "word1", "word2" and all words beginning with "test": + +---- +/set weechat.look.highlight word1,word2,test* +---- + +If you need a more specific rule for the word, you can use regular expressions +with the option <<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, +for example to highlight words "flashcode", "flashcöde" and "flashy": + +---- +/set weechat.look.highlight_regex flashc[oö]de|flashy +---- + +The delimiters around words to highlight can be customized with the option +<<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>>. + +[[highlights_tags]] +==== Add tags to highlight + +Lines displayed can contain "tags", which give some info about the origin of +message or the message itself. + +You can display tags with the command `/debug tags` (same command to hide them). + +You can add specific tags to highlight with the option +<<option_weechat.look.highlight_tags,weechat.look.highlight_tags>>. +Tags are separated by commas, and multiple tags can be separated by `+++` to do +a logical "and" between them. + +For example to highlight all messages from nick "FlashCode" and all notices +from nicks beginning with "toto": + +---- +/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" +---- + +[[highlights_regex_buffer]] +==== Set extra highlights on buffer + +You can force highlight using a regular expression with the buffer property +"highlight_regex". + +For example to force the highlight on all messages in the current buffer: + +---- +/buffer set highlight_regex .* +---- + +[NOTE] +The buffer property "highlight_regex" is not saved in configuration. + +You can easily save it with the script _buffer_autoset.py_: you can install it +with `+/script install buffer_autoset.py+` and get help with `+/help buffer_autoset+`. + [[mouse]] === Supporto del mouse @@ -2549,6 +2329,240 @@ poi eseguire l'evento col mouse. Il comando inserisce il nome dell'evento nella riga di comando. // TRANSLATION MISSING +[[bars]] +=== Bars + +A _bar_ is an area beside the chat that can contain any type of text. + +The bar options can be set with options `weechat.bar.name.option` where `name` +is the name of the bar and `option` the option for this bar. + +List of bar options: + +[width="100%",cols="2m,2,10",options="header"] +|=== +| Option | Values | Description + +| type | `root`, `window` | +// TRANSLATION MISSING + A bar with type `root` is displayed exactly one time on screen, outside all + windows. The default bar _buflist_ has type `root`. + + A bar with type `window` is displayed in each window, for example if you + split one time the screen (with `/window splith` or `/window splitv`), you + will have one bar in each window. The default bars _title_, _status_, + _input_ and _nicklist_ have type `window`. + +| position | `top`, `bottom`, `left`, `right` | + Position of the bar: above/below chat, on the left/right. + +| priority | integer ≥ 0 | + Priority for display of bar: this is used for ordering the bars on screen when + many bars have same type and position. + + The bars are displayed from the edge of the screen to the center. A higher + priority will display bar at the beginning, so closer to the edge. + + Example: _input_ bar has priority 1000, so it is displayed before the _status_ + bar, which has priority 500. + +| size | integer ≥ 0 | + The size of the bar: number of columns for position left/right, number + of lines for position top/bottom. A size of `0` means automatic, so the size + will be computed according to content displayed in bar. + +| size_max | integer ≥ 0 | + The maximum size for a bar, `0` = no limit (this option is used only if + `size` = `0`). + +| color_bg | color | + The default background color for the bar. + +| color_fg | color | + The default text color for the bar. + +| color_delim | color | + The color for delimiters in bar. + +| hidden | `on`, `off` | + When option is `on`, the bar is hidden. + + Note: instead of changing this option, the command `/bar` is preferred, for + example: `/bar toggle nicklist` (see command <<command_weechat_bar,/bar>>). + +| separator | `on`, `off` | + When option is `on`, a separator (line) is displayed between this bar and + other bars (or chat). + +| items | string | + A list of _items_ (see <<bar_items,items>> for more info). + +| filling_left_right | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | + Type of filling for a bar which has position `left` or `right` (see + <<bar_filling,filling>> for more info). + +| filling_top_bottom | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | + Type of filling for a bar which has position `top` or `bottom` (see + <<bar_filling,filling>> for more info). + +| conditions | string | + The conditions to display the bar (see <<bar_conditions,conditions>> for more + info). +|=== + +[[bar_items]] +==== Items + +The option _items_ is a string with a list of bar items, separated by a comma +(space between items on screen) or `+++` (glued items). + +The list of bar items is displayed with command `/bar listitems`. + +// TRANSLATION MISSING +Before or after item name, you can use chars (that are not alphanumeric, `+-+` +or `+_+`). They will be displayed before/after item with the delimiters color +defined in bar (option _color_delim_). + +Example of bar with items "[time],buffer_number+:+buffer_plugin+.+buffer_name": + +.... +┌───────────────────────────────────────────────────────────────────────────┐ +│[12:55] 3:irc/libera.#weechat │ +└───────────────────────────────────────────────────────────────────────────┘ +.... + +// TRANSLATION MISSING +A special syntax can be used to force the buffer used when displaying the bar +item: "@buffer:item" (where "buffer" is the full name of buffer and "item" is +the name of a bar item). + +// TRANSLATION MISSING +This is useful in root bars, to display item for a specific buffer which is +not displayed in the current window (or even not displayed at all). + +// TRANSLATION MISSING +Example: nicklist of bitlbee in a root bar (if the bar is called +_bitlist_ and if bitlbee server is called _bitlbee_): + +---- +/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" +---- + +[[bar_filling]] +==== Filling + +There are four types of filling: + +* `+horizontal+`: the items are displayed horizontally, from left to right. If + there are new lines in items, a space is used to separate lines. +* `+vertical+`: the items are displayed from top to bottom. If there are new + lines in items, a new line is used to separate lines. +* `+columns_horizontal+`: items are displayed using columns, where text is + aligned on the left. The first item is on top left, the second is on same + line, on the right. +* `+columns_vertical+`: items are displayed using columns, where text is aligned + on the left. The first item is on top left, the second is one line below. + +Default bars _title_, _status_ and _input_ have _horizontal_ filling, and +default bar _nicklist_ has _vertical_ filling. + +Some examples of filling for bar _nicklist_: + +.... +┌───────────────────────────────────────────────────────────────────────┐ +│Welcome to #test, this is a test channel │ +│12:54:15 peter | hey! │@carl │ +│12:55:01 +Max | hello │@jessika│ +│ │@maddy │ +│ │%Diego │ +│ │%Melody │ +│ │+Max │ +│ │ celia │ +│ │ Eva │ +│ │ freddy │ +│ │ Harold^│ +│ │ henry4 │ +│ │ jimmy17│ +│ │ jodie ▼│ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│Welcome to #test, this is a test channel │ +│12:54:15 peter | hey! │@carl lee │ +│12:55:01 +Max | hello │@jessika louise │ +│ │@maddy mario │ +│ │%Diego mark │ +│ │%Melody peter │ +│ │+Max Rachel │ +│ │ celia richard│ +│ │ Eva sheryl │ +│ │ freddy Vince │ +│ │ Harold^ warren │ +│ │ henry4 zack │ +│ │ jimmy17 │ +│ │ jodie │ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl %Diego celia Harold^ jodie mario Rachel Vince │ +│@jessika %Melody Eva henry4 lee mark richard warren │ +│@maddy +Max freddy jimmy17 louise peter sheryl zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ +│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ +│ mark peter Rachel richard sheryl Vince warren zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_horizontal ▲ +.... + +[[bar_conditions]] +==== Conditions + +// TRANSLATION MISSING +The option _conditions_ is a string which is evaluated to know if the bar +must be displayed or not. + +The string can be: + +* _active_: the window must be active +* _inactive_: the window must be inactive +* _nicklist_: the buffer displayed in window must have a nicklist +* an expression: it is evaluated as boolean (see command + <<command_weechat_eval,/eval>>) + +For the expression, following variables are available: + +* `+${active}+`: true if window is active +* `+${inactive}+`: true if window is inactive +* `+${nicklist}+`: true if buffer displayed in window has a nicklist + +Following pointers are available: + +* `+${window}+`: the window where condition is evaluated +* `+${buffer}+`: the buffer of window where condition is evaluated + +Example to display nicklist bar in all buffers with a nicklist, and only if +width of terminal is > 100: + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" +---- + +Same condition, but always display nicklist on buffer _&bitlbee_ +(even if terminal is small): + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" +---- + +// TRANSLATION MISSING [[secured_data]] === Secured data diff --git a/doc/ja/weechat_user.ja.adoc b/doc/ja/weechat_user.ja.adoc index 71a0c0a03..4907e054e 100644 --- a/doc/ja/weechat_user.ja.adoc +++ b/doc/ja/weechat_user.ja.adoc @@ -655,6 +655,54 @@ include::includes/cmdline_options.ja.adoc[tag=debug] | WEECHAT_EXTRA_LIBDIR | プラグインをロードするための追加ディレクトリパス (設定したパス内の "plugins" ディレクトリからロードします) |=== +// TRANSLATION MISSING +[[colors_support]] +=== Colors support + +WeeChat ではバーやチャットエリアにおけるテキスト表示に 32767 個の色ペアを利用できます +(この機能を利用するには WeeChat が実行されている端末が 256 色表示に対応している必要があります)。 + +_TERM_ 環境変数の値によって、WeeChat +で利用できる色と色ペアに以下の制限があります: + +[width="75%",cols="8,>3,>3",options="header"] +|=== +| $TERM | 色 | ペア +| "rxvt-unicode", "xterm", ... | 88 | 32767 +| "rxvt-256color", "xterm-256color", ... | 256 | 32767 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 32767 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 32767 +|=== + +`weechat --colors` を実行するか、`/color` コマンドを WeeChat +の中で実行することで、色表示の制限を確認できます。 + +256 色を利用したい場合に推奨される _TERM_ 環境変数の値は: + +* screen 内の場合: _screen-256color_ +* tmux 内の場合: _screen-256color_、_tmux-256color_ +* screen および tmux の外の場合: _xterm-256color_、_rxvt-256color_、_putty-256color_、... + +[NOTE] +_TERM_ 環境変数の値に上の値を設定するには、"ncurses-term" +パッケージをインストールする必要があるかもしれません。 + +screen を使っている場合、_~/.screenrc_ に以下の内容を追加してください: + +---- +term screen-256color +---- + +_TERM_ 変数が間違った値に設定された状態で WeeChat が起動完了している場合は、以下の +2 つのコマンドを使って変数の値を変更してください: + +---- +/set env TERM screen-256color +/upgrade +---- + [[files_and_directories]] === ファイルとディレクトリ @@ -1012,151 +1060,6 @@ kbd:[!] irc プラグインでは、<<option_irc.color.mirc_remap,irc.color.mirc_remap>> を使ってこれらの色を別の色に対応付けることができます。 -[[colors]] -=== 色 - -WeeChat ではバーやチャットエリアにおけるテキスト表示に 32767 個の色ペアを利用できます -(この機能を利用するには WeeChat が実行されている端末が 256 色表示に対応している必要があります)。 - -_TERM_ 環境変数の値によって、WeeChat -で利用できる色と色ペアに以下の制限があります: - -[width="75%",cols="8,>3,>3",options="header"] -|=== -| $TERM | 色 | ペア -| "rxvt-unicode", "xterm", ... | 88 | 32767 -| "rxvt-256color", "xterm-256color", ... | 256 | 32767 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 32767 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 32767 -|=== - -`weechat --colors` を実行するか、`/color` コマンドを WeeChat -の中で実行することで、色表示の制限を確認できます。 - -256 色を利用したい場合に推奨される _TERM_ 環境変数の値は: - -* screen 内の場合: _screen-256color_ -* tmux 内の場合: _screen-256color_、_tmux-256color_ -* screen および tmux の外の場合: _xterm-256color_、_rxvt-256color_、_putty-256color_、... - -[NOTE] -_TERM_ 環境変数の値に上の値を設定するには、"ncurses-term" -パッケージをインストールする必要があるかもしれません。 - -screen を使っている場合、_~/.screenrc_ に以下の内容を追加してください: - ----- -term screen-256color ----- - -_TERM_ 変数が間違った値に設定された状態で WeeChat が起動完了している場合は、以下の -2 つのコマンドを使って変数の値を変更してください: - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== 基本色 - -WeeChat における基本色とは: - -[width="75%",cols="1m,4",options="header"] -|=== -| 名前 | 色 -| default | デフォルトの端末色 (背景色を透過色とする) -| black | 黒 -| darkgray | 暗い灰色 -| red | 暗い赤 -| lightred | 明るい赤 -| green | 暗い緑色 -| lightgreen | 明るい緑色 -| brown | 茶色 -| yellow | 黄色 -| blue | 暗い青 -| lightblue | 明るい青 -| magenta | 暗い赤紫色 -| lightmagenta | 明るい赤紫色 -| cyan | 暗い青緑色 -| lightcyan | 明るい青緑色 -| gray | 灰色 -| white | 白 -|=== - -[[colors_extended]] -==== 拡張色 - -WeeChat は画面に色が表示された時点で色ペアを動的に割り当てます -(バッファとバーを表示する時点で)。 - -基本色に加えて、1 番 -から端末の対応状況に依存する番号までの色番号を利用できます。 - -`/color` コマンドで現在の色と色制限を確認できます。kbd:[Alt+c] -をタイプすることで、一時的に端末色を選択された色に変更できます。 - -例えば、バッファ中のに表示される時刻をオレンジ色にしたい場合、以下のようにしてください: - ----- -/set weechat.color.chat_time 214 ----- - -ステータスバーの色を非常に暗い緑色にしたい場合: - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== 別名 - -`/color alias` コマンドを使えば色の別名を追加できます。 -追加後は任意の色関連オプションで別名を使えます。 - -例: - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== 属性 - -色に対していくつかの属性を付加することができます。1 -つ以上の属性を色名または色番号の前に付加できます: - -* `+*+` : テキストを太字に -* `+!+` : テキストを反転 -* `+/+` : テキストをイタリック体に -* `+_+` : テキストに下線を引く -* `+|+` : 属性を保持: - 色を変えた際に太字/反転/下線属性をリセットしない - -例えば、自分自身のニックネームの表示色を白にして、下線を引きたい場合: - ----- -/set weechat.color.chat_nick_self _white ----- - -ステータスバーの時刻の表示色を橙色にして、下線を引いて、太字にしたい場合: - ----- -/set weechat.color.status_time *_214 ----- - -デフォルト端末色 (-1) に対して属性を設定したい場合、端末色番号の最大値よりも大きな値を利用してください。例えば、WeeChat -における色番号の最大値は 99999 です。 - -端末の表示色に太字の属性を付加する例: - ----- -/set weechat.color.status_time *99999 ----- - [[buffers_and_windows]] === バッファとウィンドウ @@ -1490,235 +1393,6 @@ By default WeeChat and its default plugins interpret these variables: [NOTE] External plugins and scripts can define and use other local variables. -[[bars]] -=== バー - -_バー_ とは任意のテキストを含めることができるチャットエリア以外の場所です。 - -バーオプションは `weechat.bar.name.option` オプションで設定します。ここで -`name` はバーの名前、`option` はこのバーのオプション名です。 - -バーオプションのリスト: - -[width="100%",cols="2m,2,10",options="header"] -|=== -| オプション名 | 値 | 説明 - -| type | `root`、`window` | - `root` 型バーは画面上の全ウィンドウの外側にきっかり 1 回だけ表示されます。 - デフォルトバーである _buflist_ は `root` 型のバーです。 + - `window` 型バーは各ウィンドウの中に表示されます。例えば、`/window splith` - や `/window splitv` などの方法で画面を 1 回分割した場合、1 - つのバーがそれぞれのウィンドウに表示されます。デフォルトの `window` - 型バーには _title_、_status_、_input_、_nicklist_ などがあります。 - -| position | `top`、`bottom`、`left`、`right` | - バーの位置: チャットエリアの上、下、左、右。 - -| priority | 0 以上の整数 | - バーの表示優先度: - 型と位置が同じ複数のバーを画面に表示する順番に利用される。 + - バーは画面の端から中心に向かって表示される。高い優先度を持つバーが先に - (画面の端に近い側に) 表示される。 + - 例: 優先度 1000 の _input_ バーは優先度 500 の _status_ - バーよりも先に表示される。 - -| size | 0 以上の整数 | - バーのサイズ: - 位置が右/左の場合は列数、位置が上/下の場合は行数。値が `0` - の場合は自動 (バーのサイズはバーの内容を基に計算される)。 - -| size_max | 0 以上の整数 | - バーの最大サイズ、`0` = 制限無し (このオプションは - `size` = `0` の場合のみ使われる)。 - -| color_bg | 色 | - バーのデフォルトの背景色 - -| color_fg | 色 | - バーのデフォルトのテキスト色 - -| color_delim | 色 | - バーの区切り文字の色 - -| hidden | `on`、`off` | - このオプションが `on` の場合、バーは表示されません。 + - 注意: このオプションを変更する代わりに、`/bar` コマンドを使うと便利です。例: - `/bar toggle nicklist` (<<command_weechat_bar,/bar>> コマンドを参照)。 - -| separator | `on`、`off` | - このオプションが `on` の場合、セパレータ (区切り線) - がバー同士またはバーとチャットエリアの間に表示されます。 - -| items | 文字列 | - _items_ のリスト (詳細は<<bar_items,バー要素>>を参照)。 - -| filling_left_right | `+horizontal+`、`+vertical+`、`+columns_horizontal+`、`+columns_vertical+` | - 位置が `left` または `right` のバーに対するフィリングタイプ - (詳細は<<bar_filling,バーフィリング>>を参照)。 - -| filling_top_bottom | `+horizontal+`、`+vertical+`、`+columns_horizontal+`、`+columns_vertical+` | - 位置が `top` または `bottom` のバーに対するフィリングタイプ - (詳細は<<bar_filling,バーフィリング>>を参照)。 - -| conditions | 文字列 | - バーを表示する状態 - (詳細は<<bar_conditions,バー状態>>を参照)。 -|=== - -[[bar_items]] -==== バー要素 - -_items_ オプションはバー要素をコンマ (画面上の要素同士に間隔を空ける) -または `+++` (間隔を空けない) で区切った文字列です。 - -バー要素のリストは `/bar listitems` コマンドで表示されます。 - -要素名の前または後に文字を表示させることができます (英数字以外の文字、`+-+` -または `+_+`)。この文字はバー (_color_delim_ オプション) -で定義された区切り文字の色をつけて要素の前または後に表示されます。 - -バー要素を含むバーの例 "[time],buffer_number+:+buffer_plugin+.+buffer_name": - -.... -┌───────────────────────────────────────────────────────────────────────────┐ -│[12:55] 3:irc/libera.#weechat │ -└───────────────────────────────────────────────────────────────────────────┘ -.... - -特殊構文を使うことで、バー要素: "@buffer:item" -("buffer" はバッファの完全な名前、"item" はバー要素の名前) -を表示する際に強制的に指定されたバッファを利用することが可能です。 - -これはルートバーに現在のウィンドウで表示されない (またはどこにも表示されない) -特定のバッファの要素を表示させる際に便利です。 - -例: bitlbee のニックネームリストをルートバーに表示させる -(バーが _bitlist_ で bitlbee サーバが _bitlbee_ の場合): - ----- -/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" ----- - -[[bar_filling]] -==== バーフィリング - -フィリングタイプには 4 つの種類があります: - -* `+horizontal+`: - 左から右に向かって要素を水平に表示。要素内に改行がある場合、空白を行区切りに利用します。 -* `+vertical+`: - 上から下に向かって要素を表示。要素内に改行がある場合、改行を行区切りに利用します。 -* `+columns_horizontal+`: - テキストを左寄せして、列形式で要素を表示。最初の要素は左上、2 - 番目は同じ行の 1 列右側。 -* `+columns_vertical+`: テキストを左寄せして、列形式で要素を表示。最初の要素は左上、2 - 番目は同じ列の 1 行下側。 - -デフォルトバーである _title_、_status_、_input_ は -_horizontal_ フィリング、_nicklist_ は _vertical_ フィリング。 - -_nicklist_ バーに対するフィリングの例: - -.... -┌───────────────────────────────────────────────────────────────────────┐ -│Welcome to #test, this is a test channel │ -│12:54:15 peter | hey! │@carl │ -│12:55:01 +Max | hello │@jessika│ -│ │@maddy │ -│ │%Diego │ -│ │%Melody │ -│ │+Max │ -│ │ celia │ -│ │ Eva │ -│ │ freddy │ -│ │ Harold^│ -│ │ henry4 │ -│ │ jimmy17│ -│ │ jodie ▼│ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│Welcome to #test, this is a test channel │ -│12:54:15 peter | hey! │@carl lee │ -│12:55:01 +Max | hello │@jessika louise │ -│ │@maddy mario │ -│ │%Diego mark │ -│ │%Melody peter │ -│ │+Max Rachel │ -│ │ celia richard│ -│ │ Eva sheryl │ -│ │ freddy Vince │ -│ │ Harold^ warren │ -│ │ henry4 zack │ -│ │ jimmy17 │ -│ │ jodie │ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl %Diego celia Harold^ jodie mario Rachel Vince │ -│@jessika %Melody Eva henry4 lee mark richard warren │ -│@maddy +Max freddy jimmy17 louise peter sheryl zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ -│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ -│ mark peter Rachel richard sheryl Vince warren zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_horizontal ▲ -.... - -[[bar_conditions]] -==== バー状態 - -_conditions_ -オプションはバーを表示するか否かを評価する文字列です。 - -文字列は以下のいずれか: - -* _active_: 非アクティブ状態のウィンドウ -* _inactive_: 非アクティブ状態のウィンドウ -* _nicklist_: ニックネームリストが含まれるバッファのウィンドウ -* 式: ブール値として評価 - (<<command_weechat_eval,/eval>> コマンドを参照) - -式に使える変数は以下: - -* `+${active}+`: ウィンドウがアクティブ状態の時に真 -* `+${inactive}+`: ウィンドウが非アクティブ状態の時に真 -* `+${nicklist}+`: ウィンドウに表示されるバッファがニックネームリストの場合に真。 - -式に使えるポインタは以下: - -* `+${window}+`: 状態が評価されたウィンドウ -* `+${buffer}+`: 状態が評価されたウィンドウのバッファ - -// TRANSLATION MISSING -Example to display nicklist bar in all buffers with a nicklist, and only if -width of terminal is > 100: - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" ----- - -// TRANSLATION MISSING -Same condition, but always display nicklist on buffer _&bitlbee_ -(even if terminal is small): - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" ----- - [[bare_display]] === 最小限表示 @@ -1806,153 +1480,20 @@ WeeChat が以下のような表示状態の場合: このため、端末で問題なく _joe_ さんからの URL をクリックできます (もちろん、使用中の端末で URL をクリックできるように設定されていなければいけませんが)。 -[[notify_levels]] -=== 通知レベル - -[[setup_notify_levels]] -==== 通知レベルの設定 - -バッファに表示された各メッセージには 4 つのレベルが設定されています。レベルの低いものから順に: - -* _low_: 重要性の低いメッセージ (例えば irc の参加/退出/終了メッセージ) -* _message_: ユーザからのメッセージ -* _private_: プライベートバッファのメッセージ -* _highlight_: ハイライトされたメッセージ - -それぞれのバッファには通知レベルが設定されており、通知レベルに対応するメッセージの数がホットリストに表示されます。 - -デフォルトの通知レベルは -<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>> -オプションで指定し、デフォルトは _all_ です。 - -[width="75%",cols="2m,7",options="header"] -|=== -| 通知レベル | ホットリストに追加されるメッセージのレベル -| none | (無効) -| highlight | _highlight_ + _private_ -| message | _highlight_ + _private_ + _message_ -| all | _highlight_ + _private_ + _message_ + _low_ -|=== - -通知レベルはバッファグループに対して設定することも可能で、例えば -irc サーバ "libera" に含まれる全てのバッファに対して設定する場合: - ----- -/set weechat.notify.irc.libera message ----- - -"#weechat" チャンネルだけに対して、通知レベルを _highlight_ に設定する場合: - ----- -/set weechat.notify.irc.libera.#weechat highlight ----- - -`/buffer` コマンドで、あるバッファに対する通知レベルを設定できます: - ----- -/buffer notify highlight ----- - -[[max_hotlist_level_nicks]] -==== ニックネームに対するホットリストレベルの最大値 - -ニックネーム、バッファ、バッファグループ (IRC サーバなど) -に対してホットリストレベルの最大値を設定することが可能です。 - -あるニックネームのリストに対してバッファプロパティ "hotlist_max_level_nicks" -を設定したり、各ニックネームに対してホットリストレベルの最大値を設定することも可能です。設定可能なレベルは以下です: - -* -1: ニックネームがホットリストを変更しない優先度 -* 0: 低優先度 (参加および退出メッセージなど) -* 1: 通常メッセージ -* 2: プライベートメッセージ -* 3: ハイライト (これはすべてのメッセージのデフォルト最大値であるため、通常これを指定することはありません) - -例えば現在のバッファで "joe" と "mike" からのメッセージに対するハイライトを無効化するには以下のように設定します: - ----- -/buffer set hotlist_max_level_nicks_add joe:2,mike:2 ----- - -[NOTE] -バッファプロパティ "hotlist_max_level_nicks" は設定ファイルに保存されません。 + -これを保存するには _buffer_autoset.py_ スクリプトを使ってください: このスクリプトをインストールするには -`+/script install buffer_autoset.py+` コマンドを使い、ヘルプを見るには `+/help buffer_autoset+` コマンドを使ってください。 - -[[highlights]] -=== ハイライト - -[[highlights_words]] -==== ハイライトする単語の追加 - -デフォルトで WeeChat -は自分のニックネームが含まれる他のユーザからのメッセージをハイライトします。このため、ハイライトはバッファに依存します -(ニックネームはバッファごとに異なる場合があります)。 - -他の単語を追加するには <<option_weechat.look.highlight,weechat.look.highlight>> -オプションを使います。例えば自分のニックネーム、"word1"、"word2"、"test" -から始まる任意の単語をハイライトするには以下のように設定します: - ----- -/set weechat.look.highlight word1,word2,test* ----- - -単語に対してさらに具体的なルールを設定する必要がある場合、<<option_weechat.look.highlight_regex,weechat.look.highlight_regex>> -オプションを使って正規表現で指定することも可能です。例えば "flashcode"、"flashcöde"、"flashy" -という単語をハイライトするには以下のように設定します: - ----- -/set weechat.look.highlight_regex flashc[oö]de|flashy ----- - -ハイライトする単語の区切りは <<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>> -オプションを使って設定します。 - -[[highlights_tags]] -==== ハイライトするタグの追加 - -表示される行には「タグ」を含めることが可能です。「タグ」とはメッセージの出自やメッセージ自身に関する情報を与えるものです。 + -`/debug tags` コマンドでタグを表示することが可能です -(タグを非表示にする場合も同じコマンドを使います)。 - -ハイライトするタグを明示するには -<<option_weechat.look.highlight_tags,weechat.look.highlight_tags>> -オプションを使います。複数のタグを指定するにはコンマで区切り、複数のタグの論理 -"and" を表すには `+++` で区切ります。 - -例えば "FlashCode" というニックネームからのすべてのメッセージと "toto" -で始まるニックネームからのすべての通知メッセージをハイライトするには以下のように設定します: - ----- -/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" ----- - -[[highlights_regex_buffer]] -==== バッファに対する特別なハイライトの設定 - -バッファプロパティ "highlight_regex" -と正規表現を使ってハイライトを強制できます。 - -例えば現在のバッファ宛のすべてのメッセージをハイライトするには以下のように設定します: - ----- -/buffer set highlight_regex .* ----- - -[NOTE] -バッファプロパティ "highlight_regex" は設定ファイルに保存されません。 + -これを保存するには _buffer_autoset.py_ スクリプトを使ってください: このスクリプトをインストールするには -`+/script install buffer_autoset.py+` コマンドを使い、ヘルプを見るには `+/help buffer_autoset+` コマンドを使ってください。 - +// TRANSLATION MISSING [[key_bindings]] -=== デフォルトのキー割り当て +== Key bindings + +// TRANSLATION MISSING +WeeChat provides a lot of default key bindings, listed in the following chapters. + +They can be changed and new ones can be added with the <<command_weechat_key,/key>> command. [[key_bindings_command_line]] -==== コマンドライン用のキー +=== コマンドライン用のキー // TRANSLATION MISSING [[key_bindings_cmdline_cursor_movement]] -===== Cursor movement +==== Cursor movement [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1973,7 +1514,7 @@ irc サーバ "libera" に含まれる全てのバッファに対して設定す // TRANSLATION MISSING [[key_bindings_cmdline_editing]] -===== Editing +==== Editing [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2003,7 +1544,7 @@ irc サーバ "libera" に含まれる全てのバッファに対して設定す // TRANSLATION MISSING [[key_bindings_cmdline_color_codes]] -===== Color codes +==== Color codes [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2018,7 +1559,7 @@ irc サーバ "libera" に含まれる全てのバッファに対して設定す // TRANSLATION MISSING [[key_bindings_cmdline_history]] -===== Command history +==== Command history [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2031,7 +1572,7 @@ irc サーバ "libera" に含まれる全てのバッファに対して設定す // TRANSLATION MISSING [[key_bindings_buffers]] -==== Buffers +=== Buffers [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2070,7 +1611,7 @@ irc サーバ "libera" に含まれる全てのバッファに対して設定す // TRANSLATION MISSING [[key_bindings_windows]] -==== Windows +=== Windows [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2090,7 +1631,7 @@ irc サーバ "libera" に含まれる全てのバッファに対して設定す // TRANSLATION MISSING [[key_bindings_bars]] -==== Bars +=== Bars [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2117,7 +1658,7 @@ irc サーバ "libera" に含まれる全てのバッファに対して設定す // TRANSLATION MISSING [[key_bindings_hotlist]] -==== Hotlist +=== Hotlist [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2135,7 +1676,7 @@ irc サーバ "libera" に含まれる全てのバッファに対して設定す // TRANSLATION MISSING [[key_bindings_toggle_keys]] -==== Toggle keys +=== Toggle keys [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2148,7 +1689,7 @@ irc サーバ "libera" に含まれる全てのバッファに対して設定す // TRANSLATION MISSING [[key_bindings_search_context]] -==== Search context +=== Search context 以下のキーは「検索」検索モード (バッファ内のテキスト検索用に kbd:[Ctrl+r] が押された状態) でのみ有効です。 @@ -2169,7 +1710,7 @@ kbd:[Ctrl+r] が押された状態) でのみ有効です。 // TRANSLATION MISSING [[key_bindings_cursor_context]] -==== Cursor context +=== Cursor context 以下のキーは「カーソル」モード (画面上でカーソルを自由に動かせる状態) でのみ有効です。 @@ -2199,7 +1740,7 @@ kbd:[Ctrl+r] が押された状態) でのみ有効です。 // TRANSLATION MISSING [[key_bindings_mouse]] -==== Mouse +=== Mouse // TRANSLATION MISSING These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] @@ -2261,7 +1802,7 @@ These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] // TRANSLATION MISSING [[key_bindings_fset_buffer]] -==== Fset buffer +=== Fset buffer // TRANSLATION MISSING These keys and actions are used on the fset buffer (see <<fset_plugin,Fset plugin>>). @@ -2311,7 +1852,7 @@ These keys and actions are used on the fset buffer (see <<fset_plugin,Fset plugi // TRANSLATION MISSING [[key_bindings_script_buffer]] -==== Script buffer +=== Script buffer // TRANSLATION MISSING These keys and actions are used on the script buffer (see <<scripts_plugins,Script plugin>>). @@ -2337,6 +1878,250 @@ These keys and actions are used on the script buffer (see <<scripts_plugins,Scri [NOTE] ^(1)^ The action must be entered as input on the command line, followed by kbd:[Enter]. +// TRANSLATION MISSING +[[configuration]] +== Configuration + +// TRANSLATION MISSING +[[colors]] +=== Colors + +[[colors_basic]] +==== 基本色 + +WeeChat における基本色とは: + +[width="75%",cols="1m,4",options="header"] +|=== +| 名前 | 色 +| default | デフォルトの端末色 (背景色を透過色とする) +| black | 黒 +| darkgray | 暗い灰色 +| red | 暗い赤 +| lightred | 明るい赤 +| green | 暗い緑色 +| lightgreen | 明るい緑色 +| brown | 茶色 +| yellow | 黄色 +| blue | 暗い青 +| lightblue | 明るい青 +| magenta | 暗い赤紫色 +| lightmagenta | 明るい赤紫色 +| cyan | 暗い青緑色 +| lightcyan | 明るい青緑色 +| gray | 灰色 +| white | 白 +|=== + +[[colors_extended]] +==== 拡張色 + +WeeChat は画面に色が表示された時点で色ペアを動的に割り当てます +(バッファとバーを表示する時点で)。 + +基本色に加えて、1 番 +から端末の対応状況に依存する番号までの色番号を利用できます。 + +`/color` コマンドで現在の色と色制限を確認できます。kbd:[Alt+c] +をタイプすることで、一時的に端末色を選択された色に変更できます。 + +例えば、バッファ中のに表示される時刻をオレンジ色にしたい場合、以下のようにしてください: + +---- +/set weechat.color.chat_time 214 +---- + +ステータスバーの色を非常に暗い緑色にしたい場合: + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== 別名 + +`/color alias` コマンドを使えば色の別名を追加できます。 +追加後は任意の色関連オプションで別名を使えます。 + +例: + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== 属性 + +色に対していくつかの属性を付加することができます。1 +つ以上の属性を色名または色番号の前に付加できます: + +* `+*+` : テキストを太字に +* `+!+` : テキストを反転 +* `+/+` : テキストをイタリック体に +* `+_+` : テキストに下線を引く +* `+|+` : 属性を保持: + 色を変えた際に太字/反転/下線属性をリセットしない + +例えば、自分自身のニックネームの表示色を白にして、下線を引きたい場合: + +---- +/set weechat.color.chat_nick_self _white +---- + +ステータスバーの時刻の表示色を橙色にして、下線を引いて、太字にしたい場合: + +---- +/set weechat.color.status_time *_214 +---- + +デフォルト端末色 (-1) に対して属性を設定したい場合、端末色番号の最大値よりも大きな値を利用してください。例えば、WeeChat +における色番号の最大値は 99999 です。 + +端末の表示色に太字の属性を付加する例: + +---- +/set weechat.color.status_time *99999 +---- + +[[notify_levels]] +=== 通知レベル + +[[setup_notify_levels]] +==== 通知レベルの設定 + +バッファに表示された各メッセージには 4 つのレベルが設定されています。レベルの低いものから順に: + +* _low_: 重要性の低いメッセージ (例えば irc の参加/退出/終了メッセージ) +* _message_: ユーザからのメッセージ +* _private_: プライベートバッファのメッセージ +* _highlight_: ハイライトされたメッセージ + +それぞれのバッファには通知レベルが設定されており、通知レベルに対応するメッセージの数がホットリストに表示されます。 + +デフォルトの通知レベルは +<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>> +オプションで指定し、デフォルトは _all_ です。 + +[width="75%",cols="2m,7",options="header"] +|=== +| 通知レベル | ホットリストに追加されるメッセージのレベル +| none | (無効) +| highlight | _highlight_ + _private_ +| message | _highlight_ + _private_ + _message_ +| all | _highlight_ + _private_ + _message_ + _low_ +|=== + +通知レベルはバッファグループに対して設定することも可能で、例えば +irc サーバ "libera" に含まれる全てのバッファに対して設定する場合: + +---- +/set weechat.notify.irc.libera message +---- + +"#weechat" チャンネルだけに対して、通知レベルを _highlight_ に設定する場合: + +---- +/set weechat.notify.irc.libera.#weechat highlight +---- + +`/buffer` コマンドで、あるバッファに対する通知レベルを設定できます: + +---- +/buffer notify highlight +---- + +[[max_hotlist_level_nicks]] +==== ニックネームに対するホットリストレベルの最大値 + +ニックネーム、バッファ、バッファグループ (IRC サーバなど) +に対してホットリストレベルの最大値を設定することが可能です。 + +あるニックネームのリストに対してバッファプロパティ "hotlist_max_level_nicks" +を設定したり、各ニックネームに対してホットリストレベルの最大値を設定することも可能です。設定可能なレベルは以下です: + +* -1: ニックネームがホットリストを変更しない優先度 +* 0: 低優先度 (参加および退出メッセージなど) +* 1: 通常メッセージ +* 2: プライベートメッセージ +* 3: ハイライト (これはすべてのメッセージのデフォルト最大値であるため、通常これを指定することはありません) + +例えば現在のバッファで "joe" と "mike" からのメッセージに対するハイライトを無効化するには以下のように設定します: + +---- +/buffer set hotlist_max_level_nicks_add joe:2,mike:2 +---- + +[NOTE] +バッファプロパティ "hotlist_max_level_nicks" は設定ファイルに保存されません。 + +これを保存するには _buffer_autoset.py_ スクリプトを使ってください: このスクリプトをインストールするには +`+/script install buffer_autoset.py+` コマンドを使い、ヘルプを見るには `+/help buffer_autoset+` コマンドを使ってください。 + +[[highlights]] +=== ハイライト + +[[highlights_words]] +==== ハイライトする単語の追加 + +デフォルトで WeeChat +は自分のニックネームが含まれる他のユーザからのメッセージをハイライトします。このため、ハイライトはバッファに依存します +(ニックネームはバッファごとに異なる場合があります)。 + +他の単語を追加するには <<option_weechat.look.highlight,weechat.look.highlight>> +オプションを使います。例えば自分のニックネーム、"word1"、"word2"、"test" +から始まる任意の単語をハイライトするには以下のように設定します: + +---- +/set weechat.look.highlight word1,word2,test* +---- + +単語に対してさらに具体的なルールを設定する必要がある場合、<<option_weechat.look.highlight_regex,weechat.look.highlight_regex>> +オプションを使って正規表現で指定することも可能です。例えば "flashcode"、"flashcöde"、"flashy" +という単語をハイライトするには以下のように設定します: + +---- +/set weechat.look.highlight_regex flashc[oö]de|flashy +---- + +ハイライトする単語の区切りは <<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>> +オプションを使って設定します。 + +[[highlights_tags]] +==== ハイライトするタグの追加 + +表示される行には「タグ」を含めることが可能です。「タグ」とはメッセージの出自やメッセージ自身に関する情報を与えるものです。 + +`/debug tags` コマンドでタグを表示することが可能です +(タグを非表示にする場合も同じコマンドを使います)。 + +ハイライトするタグを明示するには +<<option_weechat.look.highlight_tags,weechat.look.highlight_tags>> +オプションを使います。複数のタグを指定するにはコンマで区切り、複数のタグの論理 +"and" を表すには `+++` で区切ります。 + +例えば "FlashCode" というニックネームからのすべてのメッセージと "toto" +で始まるニックネームからのすべての通知メッセージをハイライトするには以下のように設定します: + +---- +/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" +---- + +[[highlights_regex_buffer]] +==== バッファに対する特別なハイライトの設定 + +バッファプロパティ "highlight_regex" +と正規表現を使ってハイライトを強制できます。 + +例えば現在のバッファ宛のすべてのメッセージをハイライトするには以下のように設定します: + +---- +/buffer set highlight_regex .* +---- + +[NOTE] +バッファプロパティ "highlight_regex" は設定ファイルに保存されません。 + +これを保存するには _buffer_autoset.py_ スクリプトを使ってください: このスクリプトをインストールするには +`+/script install buffer_autoset.py+` コマンドを使い、ヘルプを見るには `+/help buffer_autoset+` コマンドを使ってください。 + [[mouse]] === マウスサポート @@ -2455,6 +2240,235 @@ WeeChat はデフォルトマウスイベントの多くを定義しています `+/input grab_mouse+` コマンドの後にマウスを動かすことでコマンドラインにマウスイベントが入力されます。これにより対応するイベントを確認できます。 +[[bars]] +=== バー + +_バー_ とは任意のテキストを含めることができるチャットエリア以外の場所です。 + +バーオプションは `weechat.bar.name.option` オプションで設定します。ここで +`name` はバーの名前、`option` はこのバーのオプション名です。 + +バーオプションのリスト: + +[width="100%",cols="2m,2,10",options="header"] +|=== +| オプション名 | 値 | 説明 + +| type | `root`、`window` | + `root` 型バーは画面上の全ウィンドウの外側にきっかり 1 回だけ表示されます。 + デフォルトバーである _buflist_ は `root` 型のバーです。 + + `window` 型バーは各ウィンドウの中に表示されます。例えば、`/window splith` + や `/window splitv` などの方法で画面を 1 回分割した場合、1 + つのバーがそれぞれのウィンドウに表示されます。デフォルトの `window` + 型バーには _title_、_status_、_input_、_nicklist_ などがあります。 + +| position | `top`、`bottom`、`left`、`right` | + バーの位置: チャットエリアの上、下、左、右。 + +| priority | 0 以上の整数 | + バーの表示優先度: + 型と位置が同じ複数のバーを画面に表示する順番に利用される。 + + バーは画面の端から中心に向かって表示される。高い優先度を持つバーが先に + (画面の端に近い側に) 表示される。 + + 例: 優先度 1000 の _input_ バーは優先度 500 の _status_ + バーよりも先に表示される。 + +| size | 0 以上の整数 | + バーのサイズ: + 位置が右/左の場合は列数、位置が上/下の場合は行数。値が `0` + の場合は自動 (バーのサイズはバーの内容を基に計算される)。 + +| size_max | 0 以上の整数 | + バーの最大サイズ、`0` = 制限無し (このオプションは + `size` = `0` の場合のみ使われる)。 + +| color_bg | 色 | + バーのデフォルトの背景色 + +| color_fg | 色 | + バーのデフォルトのテキスト色 + +| color_delim | 色 | + バーの区切り文字の色 + +| hidden | `on`、`off` | + このオプションが `on` の場合、バーは表示されません。 + + 注意: このオプションを変更する代わりに、`/bar` コマンドを使うと便利です。例: + `/bar toggle nicklist` (<<command_weechat_bar,/bar>> コマンドを参照)。 + +| separator | `on`、`off` | + このオプションが `on` の場合、セパレータ (区切り線) + がバー同士またはバーとチャットエリアの間に表示されます。 + +| items | 文字列 | + _items_ のリスト (詳細は<<bar_items,バー要素>>を参照)。 + +| filling_left_right | `+horizontal+`、`+vertical+`、`+columns_horizontal+`、`+columns_vertical+` | + 位置が `left` または `right` のバーに対するフィリングタイプ + (詳細は<<bar_filling,バーフィリング>>を参照)。 + +| filling_top_bottom | `+horizontal+`、`+vertical+`、`+columns_horizontal+`、`+columns_vertical+` | + 位置が `top` または `bottom` のバーに対するフィリングタイプ + (詳細は<<bar_filling,バーフィリング>>を参照)。 + +| conditions | 文字列 | + バーを表示する状態 + (詳細は<<bar_conditions,バー状態>>を参照)。 +|=== + +[[bar_items]] +==== バー要素 + +_items_ オプションはバー要素をコンマ (画面上の要素同士に間隔を空ける) +または `+++` (間隔を空けない) で区切った文字列です。 + +バー要素のリストは `/bar listitems` コマンドで表示されます。 + +要素名の前または後に文字を表示させることができます (英数字以外の文字、`+-+` +または `+_+`)。この文字はバー (_color_delim_ オプション) +で定義された区切り文字の色をつけて要素の前または後に表示されます。 + +バー要素を含むバーの例 "[time],buffer_number+:+buffer_plugin+.+buffer_name": + +.... +┌───────────────────────────────────────────────────────────────────────────┐ +│[12:55] 3:irc/libera.#weechat │ +└───────────────────────────────────────────────────────────────────────────┘ +.... + +特殊構文を使うことで、バー要素: "@buffer:item" +("buffer" はバッファの完全な名前、"item" はバー要素の名前) +を表示する際に強制的に指定されたバッファを利用することが可能です。 + +これはルートバーに現在のウィンドウで表示されない (またはどこにも表示されない) +特定のバッファの要素を表示させる際に便利です。 + +例: bitlbee のニックネームリストをルートバーに表示させる +(バーが _bitlist_ で bitlbee サーバが _bitlbee_ の場合): + +---- +/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" +---- + +[[bar_filling]] +==== バーフィリング + +フィリングタイプには 4 つの種類があります: + +* `+horizontal+`: + 左から右に向かって要素を水平に表示。要素内に改行がある場合、空白を行区切りに利用します。 +* `+vertical+`: + 上から下に向かって要素を表示。要素内に改行がある場合、改行を行区切りに利用します。 +* `+columns_horizontal+`: + テキストを左寄せして、列形式で要素を表示。最初の要素は左上、2 + 番目は同じ行の 1 列右側。 +* `+columns_vertical+`: テキストを左寄せして、列形式で要素を表示。最初の要素は左上、2 + 番目は同じ列の 1 行下側。 + +デフォルトバーである _title_、_status_、_input_ は +_horizontal_ フィリング、_nicklist_ は _vertical_ フィリング。 + +_nicklist_ バーに対するフィリングの例: + +.... +┌───────────────────────────────────────────────────────────────────────┐ +│Welcome to #test, this is a test channel │ +│12:54:15 peter | hey! │@carl │ +│12:55:01 +Max | hello │@jessika│ +│ │@maddy │ +│ │%Diego │ +│ │%Melody │ +│ │+Max │ +│ │ celia │ +│ │ Eva │ +│ │ freddy │ +│ │ Harold^│ +│ │ henry4 │ +│ │ jimmy17│ +│ │ jodie ▼│ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│Welcome to #test, this is a test channel │ +│12:54:15 peter | hey! │@carl lee │ +│12:55:01 +Max | hello │@jessika louise │ +│ │@maddy mario │ +│ │%Diego mark │ +│ │%Melody peter │ +│ │+Max Rachel │ +│ │ celia richard│ +│ │ Eva sheryl │ +│ │ freddy Vince │ +│ │ Harold^ warren │ +│ │ henry4 zack │ +│ │ jimmy17 │ +│ │ jodie │ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl %Diego celia Harold^ jodie mario Rachel Vince │ +│@jessika %Melody Eva henry4 lee mark richard warren │ +│@maddy +Max freddy jimmy17 louise peter sheryl zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ +│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ +│ mark peter Rachel richard sheryl Vince warren zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_horizontal ▲ +.... + +[[bar_conditions]] +==== バー状態 + +_conditions_ +オプションはバーを表示するか否かを評価する文字列です。 + +文字列は以下のいずれか: + +* _active_: 非アクティブ状態のウィンドウ +* _inactive_: 非アクティブ状態のウィンドウ +* _nicklist_: ニックネームリストが含まれるバッファのウィンドウ +* 式: ブール値として評価 + (<<command_weechat_eval,/eval>> コマンドを参照) + +式に使える変数は以下: + +* `+${active}+`: ウィンドウがアクティブ状態の時に真 +* `+${inactive}+`: ウィンドウが非アクティブ状態の時に真 +* `+${nicklist}+`: ウィンドウに表示されるバッファがニックネームリストの場合に真。 + +式に使えるポインタは以下: + +* `+${window}+`: 状態が評価されたウィンドウ +* `+${buffer}+`: 状態が評価されたウィンドウのバッファ + +// TRANSLATION MISSING +Example to display nicklist bar in all buffers with a nicklist, and only if +width of terminal is > 100: + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" +---- + +// TRANSLATION MISSING +Same condition, but always display nicklist on buffer _&bitlbee_ +(even if terminal is small): + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" +---- + [[secured_data]] === 暗号化データ diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc index 0da09a3c3..225580c35 100644 --- a/doc/pl/weechat_user.pl.adoc +++ b/doc/pl/weechat_user.pl.adoc @@ -641,6 +641,54 @@ Niektóre zmienne śwodowiskowe są używane przez WeeChat o ile zostały zdefin | WEECHAT_EXTRA_LIBDIR | Dodatkowy katalog do ładowania wtyczek (z katalogu "plugins" znajdującego się pod tą ścieżką). |=== +// TRANSLATION MISSING +[[colors_support]] +=== Colors support + +WeeChat może użyć do 32767 par kolorów do wyświetlania tekstu w paskach i obszarze +rozmów (twój terminal musi wspierać do 256 par kolorów, aby użyć ich w WeeChat). + +Zgodnie z wartością zmiennej środowiskowej _TERM_, możesz posiadać następujące +limity dla kolorów w WeeChat: + +[width="75%",cols="8,>3,>3",options="header"] +|=== +| $TERM | Kolory | Pary +| "rxvt-unicode", "xterm", ... | 88 | 32767 +| "rxvt-256color", "xterm-256color", ... | 256 | 32767 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 32767 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 32767 +|=== + +Możesz wykonać `weechat --colors` lub użyć komendy `/color` w WeeChat, aby +wyświetlić limity dla twojego środowiska. + +Niektóre z zalecanych wartości dla _TERM_ jeśli chcesz używać 256 kolorów: + +* dla screena: _screen-256color_ +* pod tmux: _screen-256color_ lub _tmux-256color_ +* poza screenem/tmuxem: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... + +[NOTE] +Być może konieczne jest zainstalowanie pakietu "ncurses-term", w celu użycia +tych wartości dla zmiennej _TERM_. + +Jeśli używasz screena, możesz dodać to do swojego _~/.screenrc_: + +---- +term screen-256color +---- + +Jeśli wartość zmiennej _TERM_ ma złą wartość, a WeeChat jest już uruchomiony, +możesz ją zmienić za pomocą tych dwóch komend: + +---- +/set env TERM screen-256color +/upgrade +---- + [[files_and_directories]] === Pliki i foldery @@ -971,152 +1019,6 @@ kbd:[!] We wtyczce irc, można zmienić przypisania tych kolorów za pomocą opcji <<option_irc.color.mirc_remap,irc.color.mirc_remap>>. -[[colors]] -=== Kolory - -WeeChat może użyć do 32767 par kolorów do wyświetlania tekstu w paskach i obszarze -rozmów (twój terminal musi wspierać do 256 par kolorów, aby użyć ich w WeeChat). - -Zgodnie z wartością zmiennej środowiskowej _TERM_, możesz posiadać następujące -limity dla kolorów w WeeChat: - -[width="75%",cols="8,>3,>3",options="header"] -|=== -| $TERM | Kolory | Pary -| "rxvt-unicode", "xterm", ... | 88 | 32767 -| "rxvt-256color", "xterm-256color", ... | 256 | 32767 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 32767 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 32767 -|=== - -Możesz wykonać `weechat --colors` lub użyć komendy `/color` w WeeChat, aby -wyświetlić limity dla twojego środowiska. - -Niektóre z zalecanych wartości dla _TERM_ jeśli chcesz używać 256 kolorów: - -* dla screena: _screen-256color_ -* pod tmux: _screen-256color_ lub _tmux-256color_ -* poza screenem/tmuxem: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... - -[NOTE] -Być może konieczne jest zainstalowanie pakietu "ncurses-term", w celu użycia -tych wartości dla zmiennej _TERM_. - -Jeśli używasz screena, możesz dodać to do swojego _~/.screenrc_: - ----- -term screen-256color ----- - -Jeśli wartość zmiennej _TERM_ ma złą wartość, a WeeChat jest już uruchomiony, -możesz ją zmienić za pomocą tych dwóch komend: - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== Podstawowe kolory - -Podstawowe kolory w WeeChat to: - -[width="75%",cols="1m,4",options="header"] -|=== -| Nazwa | Kolor -| default | Domyślny kolor terminala (przezroczysty dla tła) -| black | Czarny -| darkgray | Ciemny szary -| red | Ciemny czerwony -| lightred | Jasny czerwony -| green | Ciemny zielony -| lightgreen | Jasny zielony -| brown | Brązowy -| yellow | Żółty -| blue | Ciemny niebieski -| lightblue | Jasny niebieski -| magenta | Ciemny karmazynowy -| lightmagenta | Jasny karmazynowy -| cyan | Ciemny błękitny -| lightcyan | Jasny błękitny -| gray | Szary -| white | Biały -|=== - -[[colors_extended]] -==== Rozszerzone kolory - -WeeChat dynamicznie alokuje pary kolorów, kiedy kolory są używane na ekranie (do -wyświetlania buforów i pasków). - -W dodatku do podstawowych kolorów, możesz użyć numer koloru pomiędzy 1 a limitem -twojego terminala. - -Użyj komendy `/color`, aby zobaczyć obecne kolory i limity. Za pomocą kbd:[Alt+c] -możesz tymczasowo przełączyć się na kolory terminala, żeby wybrać kolor. - -Na przykład jeśli chcesz wyświetlać czas na pomarańczowo w buforze: - ----- -/set weechat.color.chat_time 214 ----- - -Lub jeśli chcesz mocno ciemno zielonego tła dla pasku statusu: - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== Aliasy - -Możesz dodać aliasy do kolorów za pomocą komendy `/color alias` i używać ich w -dowolnej opcji jako koloru. - -Na przykład: - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== Atrybuty - -Możliwe jest użycie niektórych atrybutów dla kolorów. Jeden lub więcej z nich -może zostać użyty przed nazwą lub numerem koloru: - -* `+*+` : pogrubiony tekst -* `+!+` : odwrócenie video -* `+/+` : pochyły -* `+_+` : podkreślony tekst -* `+|+` : zachowaj atrybuty: nie resetuj pogrubienia/odwrócenia/pochylenia/podkreślenia, - podczas zmiany koloru - -Na przykład jeśli chcesz, żeby twój nick był biały i podkreślony: - ----- -/set weechat.color.chat_nick_self _white ----- - -Lub jeśli chcesz, żeby czas w pasku statusu był pomarańczowy, podkreślony i -pogrubiony: - ----- -/set weechat.color.status_time *_214 ----- - -Aby użyć atrybutu z domyślnym kolorem terminala (-1), należy użyć numeru większego -od ostatniego koloru terminala, na przykład maksymalny kolor w WeeChat: 99999. - -Przykład pogrubienia z domyślnym kolorem terminala: - ----- -/set weechat.color.status_time *99999 ----- - [[buffers_and_windows]] === Bufory i okna @@ -1441,236 +1343,6 @@ WeeChat i jego wtyczki domyślnie tworzą następujące zmienne: [NOTE] External plugins and scripts can define and use other local variables. -[[bars]] -=== Paski - -_Pasek_ to obszar poza rozmową, mogący zawierać dowolny rodzaj tekstu. - -Opcje paska mogą być ustawiane za pomocą opcji `weechat.bar.nazwa.opcja`, -gdzie `nazwa` to nazwa paska i `opcja` to opcja dla tego paska. - -Lista opcji dla pasków: - -[width="100%",cols="2m,2,10",options="header"] -|=== -| Opcja | Wartości | Opis - -| type | `root`, `window` | - Pasek z typem `root` jest wyświetlany dokładnie jeden raz na ekranie, poza - wszystkimi oknami. Domyślny pasek _buflist_ ma typ `root`. + - Pasek z typem `window` wyświetlany jest w każdym oknie, na przykład jeśli - podzielisz jednorazowo ekran (używając `/window splith` lun `/window splitv`) - otrzymasz po jednym pasku w każdym oknie. Domyślnie paski _title_, _status_, - _input_ i _nicklist_ mają typ `window`. - -| position | `top`, `bottom`, `left`, `right` | - Pozycja paska: powyżej/poniżej ekranu rozmowy, po jego lewej/prawej stronie. - -| priority | integer ≥ 0 | - Priorytet wyświetlania paska: jest on używany do uporządkowania pasków na - ekranie, kiedy więcej niż jeden pasek posiada ten sam typ i położenie. + - Paski są wyświetlane od brzegu do środka ekranu. Paski z wyższym priorytetem - zostaną wyświetlone na początku, czyli bliżej krawędzi. + - Przykład: pasek _input_ ma priorytet 1000, dlatego jest wyświetlany przed - paskiem _status_, który ma priorytet 500. - -| size | integer ≥ 0 | - Rozmiar paska: ilość kolumn dla pozycji lewo/prawo, numer linii dla pozycji - góra/dół. Rozmiar `0` oznacza automatyczny - rozmiar zostanie wyliczony zgodnie - z wyświetlaną zawartością. - -| size_max | integer ≥ 0 | - Maksymalny rozmiar paska, `0` = brak limitu (opcja ta jest używana tylko jeśli - `size` = 0). - -| color_bg | color | - Domyślny kolor tła paska. - -| color_fg | color | - Domyślny kolor tekstu na pasku. - -| color_delim | color | - Kolor separatorów na pasku. - -| hidden | `on`, `off` | - Kiedy ta opcja jest ustawiona na `on`, pasek jest ukrywany. + - Uwaga: zamiast zmiany tej opcji zaleca się użycie komendy `/bar`, na przykład: - `/bar toggle nicklist` (zobacz komendę <<command_weechat_bar,/bar>> po więcej - informacji). - -| separator | `on`, `off` | - Kiedy ta opcja jest ustawiona na `on`, separator (linia) jest wyświetlany - pomiędzy tym paskiem a pozostałymi (lub oknem rozmowy). - -| items | string | - Lista _elementów_ (zobacz <<bar_items,elementy>> po więcej informacji). - -| filling_left_right | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | - Typ wypełnienia paska dla pozycji o pozycji `left` lub `right` (zobacz - <<bar_filling,wypełnienie>> po więcej informacji). - -| filling_top_bottom | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | - Typ wypełnienia paska dla pozycji o pozycji `top` lub `bottom` (zobacz - <<bar_filling,wypełnienie>> po więcej informacji). - -| conditions | string | - Warunki wyświetlania paska (zobacz <<bar_conditions,warunki>> po więcej - informacji). -|=== - -[[bar_items]] -==== Elementy - -Opcja _items_ jest ciągiem z listą elementów paska oddzielonych przecinkiem -(spacja pomiędzy elementami na ekranie) lub `+++` (elementy sklejone). - -Lista wszystkich elementów paska jest wyświetlana za pomocą komendy `/bar listitems`. - -Przed i za nazwą elementu można używać znaków (nie będących alfanumerycznymi, -`+-+` lub `+_+`). Będą one wyświetlane przed/za elementem z kolorem separatorów -zdefiniowanych dla paska (opcja _color_delim_). - -Przykład paska z elementami "[time],buffer_number+:+buffer_plugin+.+buffer_name": - -.... -┌───────────────────────────────────────────────────────────────────────────┐ -│[12:55] 3:irc/libera.#weechat │ -└───────────────────────────────────────────────────────────────────────────┘ -.... - -Specjalna składnia może zostać użyta, żeby wymusić bufor używany do wyświetlenia -elementów paska: "@bufor:element" (gdzie "bufor" to pełna nazwa bufora i "element" -to nazwa elementu paska). - -Jest to przydatne w paskach typu `root` do wyświetlania elementów dla konkretnych -buforów, które nie są wyświetlane w obecnym oknie (lub nawet nie wyświetlanych -w ogóle). - -Przykład: lista nicków dla bitlbee w pasku `root` (jeśli pasek nazywa się _bitlist_ -i serwer bitlbee nazywa sie _bitlbee_): - ----- -/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" ----- - -[[bar_filling]] -==== Wypełnienie - -Są cztery typy wypełnień: - -* `+horizontal+`: elementy są wyświetlane poziomo, od lewej do prawej. Jeśli - w elementach występują nowe linie, odstęp jest używany do ich oddzielenia. -* `+vertical+`: elementy są wyświetlane od góry do dołu. Jeśli w elementach - występują nowe linie, do ich oddzielenia używana jest nowa linia. -* `+columns_horizontal+`: elementy są wyświetlane z użyciem kolumn, gdzie tekst - tekst jest wyrównany do lewej. Pierwszy element znajduje się na górze z lewej, - kolejny w tej samej linii z prawej. -* `+columns_vertical+`: elementy są wyświetlane z użyciem kolumn, gdzie tekst - tekst jest wyrównany do lewej. Pierwszy element znajduje się na górze z lewej, - kolejny jest linię niżej. - -Domyślne paski _title_, _status_ i _input_ mają wypełnienie _horizontal_, -domyślny pasek _nicklist_ ma wypełnienie _vertical_. - -Przykłady wypełnień paska _nicklist_: - -.... -┌───────────────────────────────────────────────────────────────────────┐ -│Welcome to #test, this is a test channel │ -│12:54:15 peter | hey! │@carl │ -│12:55:01 +Max | hello │@jessika│ -│ │@maddy │ -│ │%Diego │ -│ │%Melody │ -│ │+Max │ -│ │ celia │ -│ │ Eva │ -│ │ freddy │ -│ │ Harold^│ -│ │ henry4 │ -│ │ jimmy17│ -│ │ jodie ▼│ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│Welcome to #test, this is a test channel │ -│12:54:15 peter | hey! │@carl lee │ -│12:55:01 +Max | hello │@jessika louise │ -│ │@maddy mario │ -│ │%Diego mark │ -│ │%Melody peter │ -│ │+Max Rachel │ -│ │ celia richard│ -│ │ Eva sheryl │ -│ │ freddy Vince │ -│ │ Harold^ warren │ -│ │ henry4 zack │ -│ │ jimmy17 │ -│ │ jodie │ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl %Diego celia Harold^ jodie mario Rachel Vince │ -│@jessika %Melody Eva henry4 lee mark richard warren │ -│@maddy +Max freddy jimmy17 louise peter sheryl zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ -│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ -│ mark peter Rachel richard sheryl Vince warren zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_horizontal ▲ -.... - -[[bar_conditions]] -==== Warunki - -Opcja _conditions_ jest jest przetwarzana w celu sprawdzenia czy pasek ma być -wyświetlony czy nie. - -Dostępne opcje: - -* _active_: okno musi być aktywne -* _inactive_: okno musi być nieaktywne -* _nicklist_: bufor wyświetlany w oknie musi mieć listę nicków -* wyrażenie: jest wykonywane jako wyrażenie logiczne (zobacz komendę - <<command_weechat_eval,/eval>>) - -Dla wyrażeń dostępne są następujące zmienne: - -* `+${active}+`: prawda, jeśli okno jest aktywne -* `+${inactive}+`: prawda, jeśli okno jest nieaktywne -* `+${nicklist}+`: prawda, jeśli okno posiada listę nicków - -Następujące wskaźniki są dostępne: - -* `+${window}+`: okno, dla którego warunek jest sprawdzany -* `+${buffer}+`: bufor okna, dla którego warunek jest sprawdzany - -Przykład pokazujący pasek z listą nicków we wszystkich buforach, które mają -ją włączoną i tylko jeśli szerokość terminala jest > 100: - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" ----- - -Ten sam warunek, ale lista nicków jest zawsze wyświetlana w buforze _&bitlbee_ -(nawet jeśli jest mały): - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" ----- - [[bare_display]] === Niesformatowany ekran @@ -1759,154 +1431,20 @@ Ekran w trybie niesformatowanego wyświetlania będzie wyglądać tak: Możesz więc kliknąć w URL od _joe_ bez żadnych problemów w swoim terminalu (jeśli twój terminal wspiera klikanie w URLe). -[[notify_levels]] -=== Poziomy powiadomień - -[[setup_notify_levels]] -==== Ustawienia poziomu powiadomień - -Dostępne są cztery poziomy dla wiadomości wyświetlanych w buforach, od najniższego -do najwyższego: - -* _low_: wiadomości mało istotne (na przykład dla irc join/part/quit) -* _message_: wiadomość od użytkownika -* _private_: wiadomość w buforze prywatnym -* _highlight_: wiadomość z powiadomieniem - -Każdy bufor posiada poziom powiadomień, który decyduje o tym, jakie wiadomości -zostaną dodane do bufora w hotliście. - -Domyślny poziom powiadomień można ustawić za pomocą opcji -<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>, -domyślna wartość to _all_. - -[width="75%",cols="2m,7",options="header"] -|=== -| Poziom powiadomień | Poziom wiadomości dodawanej do hotlisty -| none | (brak) -| highlight | _highlight_ + _private_ -| message | _highlight_ + _private_ + _message_ -| all | _highlight_ + _private_ + _message_ + _low_ -|=== - -Poziom powiadomień może być definiowany dla zestawu buforów, na przykład dla -wszystkich buforów serwera irc "libera": - ----- -/set weechat.notify.irc.libera message ----- - -Ustawienie poziomu powiadomień na _highlight_ tylko dla kanału "#weechat": - ----- -/set weechat.notify.irc.libera.#weechat highlight ----- - -Poziom powiadomień dla bufora może zostać ustawiony za pomocą komendy `/buffer`: - ----- -/buffer notify highlight ----- - -[[max_hotlist_level_nicks]] -==== Maksymalny poziom hotlisty dla nicków - -Jest możliwe ustawienie maksymalnego poziomu hotlist dla nicków, dla bufora lub grupy buforów -(jak erwery IRC). - -Właściwość bufora "hotlist_max_level_nicks" może być ustawiona na listę nicków, -z ustawonym dla każdego z nich maksymalnym poziomem hotlisty, możliwe poziomy to: - -* -1: brak zmiany hotlisty dla nicka -* 0: niski priorytet (jak wiadomości join/part) -* 1: wiadomość -* 2: prywatna wiadomość -* 3: podświetlenie (mało przydatne, jest to domyślny poziom dla wszytkich wiadomości) - -Na przykład, żeby wyłączyć podświetlenia od "joe" oraz "mike" w obecnym buforze: - ----- -/buffer set hotlist_max_level_nicks_add joe:2,mike:2 ----- - -[NOTE] -Właściwość bufora "hotlist_max_level_nicks" nie jest zapisywana w konfiguracji. + -Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalować za pomocą -`+/script install buffer_autoset.py+`, informacje o używaniu `+/help buffer_autoset+`. - -[[highlights]] -=== Podświetlenia - -[[highlights_words]] -==== Dodawanie słów do podświetleń - -Domyślnie WeeChat podświetla wiadomości od innych użytkowników zawierające Twój nick, -dlatego podświetlenia zależą od buforu (nick może być inny w zależności od buforu). - -Możesz dodawać inne słowa do podświetlen używając opcji -<<option_weechat.look.highlight,weechat.look.highlight>>, na przykład, żeby -podświetlać Twój nick oraz słowa "słowo1", "słowo2" oraz wszystko co zaczyna się od "test": - ----- -/set weechat.look.highlight słowo1,słowo2,test* ----- - -Jeżeli potrzebujesz bardziej przecyzyjnej reguły, możesz użyć wyrażenia reglarnego -używając opcji <<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, -na przydład do podświetlania słów "flashcode", "flashcöde" i "flashy": - ----- -/set weechat.look.highlight_regex flashc[oö]de|flashy ----- - -Separatory do okoła podświetlanych słów można zmienić za pomocą opcji -<<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>>. - -[[highlights_tags]] -==== Dodawanie tagów do podświetleń - -Wyświetlane linie moga zawierać "tagi", które dają troche informacji o pochodzeniu -wiasomości lub o samej wiadmości. + -Możesz wyświetlić tagi za pomocą komendy `/debug tags` (ta sama komenda je ukrywa). - -Możesz dodać konkretne tagi do podświetleń za pomocą opcji -<<option_weechat.look.highlight_tags,weechat.look.highlight_tags>>. -Tagi są oddzielane przecinkami, kilka tagów może być oddzielone przez `+++` dla wykonania -logicznego "i" między nimi. - -Na przykład dla podświetlenia wszytkich wiadomości od nicka "FlashCode" oraz powiadomień od -nicków zaczynających się od "toto": - ----- -/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" ----- - -[[highlights_regex_buffer]] -==== Ustawianie dodatkowych podświetleń dla bufora - -Możesz wymusić podświetlenia używając wyrażenia regularnego z właściwościa bufora -"highlight_regex". - -Na przykład żeby wymusić podświetlenie dla wszytkich wiadomości w obecnym buforze: - ----- -/buffer set highlight_regex .* ----- - -[NOTE] -Właściwość bufora "highlight_regex" nie jest zapisywana w konfiguracji. + -Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalować za pomocą -`+/script install buffer_autoset.py+`, informacje o używaniu `+/help buffer_autoset+`. - +// TRANSLATION MISSING [[key_bindings]] -=== Domyślne skróty klawiszowe +== Key bindings + +// TRANSLATION MISSING +WeeChat provides a lot of default key bindings, listed in the following chapters. + +They can be changed and new ones can be added with the <<command_weechat_key,/key>> command. [[key_bindings_command_line]] -==== Skróty dla linii poleceń +=== Skróty dla linii poleceń // TRANSLATION MISSING [[key_bindings_cmdline_cursor_movement]] -===== Cursor movement +==== Cursor movement [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1927,7 +1465,7 @@ Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalowa // TRANSLATION MISSING [[key_bindings_cmdline_editing]] -===== Editing +==== Editing [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1956,7 +1494,7 @@ Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalowa // TRANSLATION MISSING [[key_bindings_cmdline_color_codes]] -===== Color codes +==== Color codes [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1971,7 +1509,7 @@ Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalowa // TRANSLATION MISSING [[key_bindings_cmdline_history]] -===== Command history +==== Command history [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -1984,7 +1522,7 @@ Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalowa // TRANSLATION MISSING [[key_bindings_buffers]] -==== Buffers +=== Buffers [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2023,7 +1561,7 @@ Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalowa // TRANSLATION MISSING [[key_bindings_windows]] -==== Windows +=== Windows [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2043,7 +1581,7 @@ Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalowa // TRANSLATION MISSING [[key_bindings_bars]] -==== Bars +=== Bars [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2068,7 +1606,7 @@ Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalowa // TRANSLATION MISSING [[key_bindings_hotlist]] -==== Hotlist +=== Hotlist [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2082,7 +1620,7 @@ Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalowa // TRANSLATION MISSING [[key_bindings_toggle_keys]] -==== Toggle keys +=== Toggle keys [width="100%",cols="^.^3,.^8,.^5",options="header"] |=== @@ -2095,7 +1633,7 @@ Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalowa // TRANSLATION MISSING [[key_bindings_search_context]] -==== Search context +=== Search context Te skróty są używane w kontekście wyszukiwania (kiedy kombinacja kbd:[Ctrl+r] zostanie wciśnięta w buforze tekstowym). @@ -2116,7 +1654,7 @@ zostanie wciśnięta w buforze tekstowym). // TRANSLATION MISSING [[key_bindings_cursor_context]] -==== Cursor context +=== Cursor context Te skróty są używane s kontekście kursora (dowolne przemieszczanie kursora na ekranie). @@ -2147,7 +1685,7 @@ ekranie). // TRANSLATION MISSING [[key_bindings_mouse]] -==== Mouse +=== Mouse // TRANSLATION MISSING These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] @@ -2202,7 +1740,7 @@ These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] // TRANSLATION MISSING [[key_bindings_fset_buffer]] -==== Fset buffer +=== Fset buffer Poniższe skróty i akcje mogą zostać użyte w buforze fset (zobacz <<fset_plugin,wtyczka fset>>). @@ -2249,7 +1787,7 @@ Poniższe skróty i akcje mogą zostać użyte w buforze fset (zobacz <<fset_plu // TRANSLATION MISSING [[key_bindings_script_buffer]] -==== Script buffer +=== Script buffer Te skróty klawiszowe i akcje mogą zostać użyte w oknie skryptów (zobacz <<scripts_plugins,wtyczka script>>). @@ -2272,6 +1810,252 @@ Te skróty klawiszowe i akcje mogą zostać użyte w oknie skryptów (zobacz <<s [NOTE] ^(1)^ Akcja musi zostać wprowadzona z linii poleceń i potwierdzona przez kbd:[Enter]. +// TRANSLATION MISSING +[[configuration]] +== Configuration + +// TRANSLATION MISSING +[[colors]] +=== Colors + +[[colors_basic]] +==== Podstawowe kolory + +Podstawowe kolory w WeeChat to: + +[width="75%",cols="1m,4",options="header"] +|=== +| Nazwa | Kolor +| default | Domyślny kolor terminala (przezroczysty dla tła) +| black | Czarny +| darkgray | Ciemny szary +| red | Ciemny czerwony +| lightred | Jasny czerwony +| green | Ciemny zielony +| lightgreen | Jasny zielony +| brown | Brązowy +| yellow | Żółty +| blue | Ciemny niebieski +| lightblue | Jasny niebieski +| magenta | Ciemny karmazynowy +| lightmagenta | Jasny karmazynowy +| cyan | Ciemny błękitny +| lightcyan | Jasny błękitny +| gray | Szary +| white | Biały +|=== + +[[colors_extended]] +==== Rozszerzone kolory + +WeeChat dynamicznie alokuje pary kolorów, kiedy kolory są używane na ekranie (do +wyświetlania buforów i pasków). + +W dodatku do podstawowych kolorów, możesz użyć numer koloru pomiędzy 1 a limitem +twojego terminala. + +Użyj komendy `/color`, aby zobaczyć obecne kolory i limity. Za pomocą kbd:[Alt+c] +możesz tymczasowo przełączyć się na kolory terminala, żeby wybrać kolor. + +Na przykład jeśli chcesz wyświetlać czas na pomarańczowo w buforze: + +---- +/set weechat.color.chat_time 214 +---- + +Lub jeśli chcesz mocno ciemno zielonego tła dla pasku statusu: + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== Aliasy + +Możesz dodać aliasy do kolorów za pomocą komendy `/color alias` i używać ich w +dowolnej opcji jako koloru. + +Na przykład: + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== Atrybuty + +Możliwe jest użycie niektórych atrybutów dla kolorów. Jeden lub więcej z nich +może zostać użyty przed nazwą lub numerem koloru: + +* `+*+` : pogrubiony tekst +* `+!+` : odwrócenie video +* `+/+` : pochyły +* `+_+` : podkreślony tekst +* `+|+` : zachowaj atrybuty: nie resetuj pogrubienia/odwrócenia/pochylenia/podkreślenia, + podczas zmiany koloru + +Na przykład jeśli chcesz, żeby twój nick był biały i podkreślony: + +---- +/set weechat.color.chat_nick_self _white +---- + +Lub jeśli chcesz, żeby czas w pasku statusu był pomarańczowy, podkreślony i +pogrubiony: + +---- +/set weechat.color.status_time *_214 +---- + +Aby użyć atrybutu z domyślnym kolorem terminala (-1), należy użyć numeru większego +od ostatniego koloru terminala, na przykład maksymalny kolor w WeeChat: 99999. + +Przykład pogrubienia z domyślnym kolorem terminala: + +---- +/set weechat.color.status_time *99999 +---- + +[[notify_levels]] +=== Poziomy powiadomień + +[[setup_notify_levels]] +==== Ustawienia poziomu powiadomień + +Dostępne są cztery poziomy dla wiadomości wyświetlanych w buforach, od najniższego +do najwyższego: + +* _low_: wiadomości mało istotne (na przykład dla irc join/part/quit) +* _message_: wiadomość od użytkownika +* _private_: wiadomość w buforze prywatnym +* _highlight_: wiadomość z powiadomieniem + +Każdy bufor posiada poziom powiadomień, który decyduje o tym, jakie wiadomości +zostaną dodane do bufora w hotliście. + +Domyślny poziom powiadomień można ustawić za pomocą opcji +<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>, +domyślna wartość to _all_. + +[width="75%",cols="2m,7",options="header"] +|=== +| Poziom powiadomień | Poziom wiadomości dodawanej do hotlisty +| none | (brak) +| highlight | _highlight_ + _private_ +| message | _highlight_ + _private_ + _message_ +| all | _highlight_ + _private_ + _message_ + _low_ +|=== + +Poziom powiadomień może być definiowany dla zestawu buforów, na przykład dla +wszystkich buforów serwera irc "libera": + +---- +/set weechat.notify.irc.libera message +---- + +Ustawienie poziomu powiadomień na _highlight_ tylko dla kanału "#weechat": + +---- +/set weechat.notify.irc.libera.#weechat highlight +---- + +Poziom powiadomień dla bufora może zostać ustawiony za pomocą komendy `/buffer`: + +---- +/buffer notify highlight +---- + +[[max_hotlist_level_nicks]] +==== Maksymalny poziom hotlisty dla nicków + +Jest możliwe ustawienie maksymalnego poziomu hotlist dla nicków, dla bufora lub grupy buforów +(jak erwery IRC). + +Właściwość bufora "hotlist_max_level_nicks" może być ustawiona na listę nicków, +z ustawonym dla każdego z nich maksymalnym poziomem hotlisty, możliwe poziomy to: + +* -1: brak zmiany hotlisty dla nicka +* 0: niski priorytet (jak wiadomości join/part) +* 1: wiadomość +* 2: prywatna wiadomość +* 3: podświetlenie (mało przydatne, jest to domyślny poziom dla wszytkich wiadomości) + +Na przykład, żeby wyłączyć podświetlenia od "joe" oraz "mike" w obecnym buforze: + +---- +/buffer set hotlist_max_level_nicks_add joe:2,mike:2 +---- + +[NOTE] +Właściwość bufora "hotlist_max_level_nicks" nie jest zapisywana w konfiguracji. + +Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalować za pomocą +`+/script install buffer_autoset.py+`, informacje o używaniu `+/help buffer_autoset+`. + +[[highlights]] +=== Podświetlenia + +[[highlights_words]] +==== Dodawanie słów do podświetleń + +Domyślnie WeeChat podświetla wiadomości od innych użytkowników zawierające Twój nick, +dlatego podświetlenia zależą od buforu (nick może być inny w zależności od buforu). + +Możesz dodawać inne słowa do podświetlen używając opcji +<<option_weechat.look.highlight,weechat.look.highlight>>, na przykład, żeby +podświetlać Twój nick oraz słowa "słowo1", "słowo2" oraz wszystko co zaczyna się od "test": + +---- +/set weechat.look.highlight słowo1,słowo2,test* +---- + +Jeżeli potrzebujesz bardziej przecyzyjnej reguły, możesz użyć wyrażenia reglarnego +używając opcji <<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, +na przydład do podświetlania słów "flashcode", "flashcöde" i "flashy": + +---- +/set weechat.look.highlight_regex flashc[oö]de|flashy +---- + +Separatory do okoła podświetlanych słów można zmienić za pomocą opcji +<<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>>. + +[[highlights_tags]] +==== Dodawanie tagów do podświetleń + +Wyświetlane linie moga zawierać "tagi", które dają troche informacji o pochodzeniu +wiasomości lub o samej wiadmości. + +Możesz wyświetlić tagi za pomocą komendy `/debug tags` (ta sama komenda je ukrywa). + +Możesz dodać konkretne tagi do podświetleń za pomocą opcji +<<option_weechat.look.highlight_tags,weechat.look.highlight_tags>>. +Tagi są oddzielane przecinkami, kilka tagów może być oddzielone przez `+++` dla wykonania +logicznego "i" między nimi. + +Na przykład dla podświetlenia wszytkich wiadomości od nicka "FlashCode" oraz powiadomień od +nicków zaczynających się od "toto": + +---- +/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" +---- + +[[highlights_regex_buffer]] +==== Ustawianie dodatkowych podświetleń dla bufora + +Możesz wymusić podświetlenia używając wyrażenia regularnego z właściwościa bufora +"highlight_regex". + +Na przykład żeby wymusić podświetlenie dla wszytkich wiadomości w obecnym buforze: + +---- +/buffer set highlight_regex .* +---- + +[NOTE] +Właściwość bufora "highlight_regex" nie jest zapisywana w konfiguracji. + +Można ją zapisać za pomocą skryptu _buffer_autoset.py_: można go zaintalować za pomocą +`+/script install buffer_autoset.py+`, informacje o używaniu `+/help buffer_autoset+`. + [[mouse]] === Wsparcie myszy @@ -2393,6 +2177,236 @@ przycisku myszy. Możesz znaleźć nazwę zdarzenia za pomocą komendy `+/input grab_mouse+` wykonując następnie zdarzenie za pomocą myszy. Umieści to zdarzenie w linii poleceń. +[[bars]] +=== Paski + +_Pasek_ to obszar poza rozmową, mogący zawierać dowolny rodzaj tekstu. + +Opcje paska mogą być ustawiane za pomocą opcji `weechat.bar.nazwa.opcja`, +gdzie `nazwa` to nazwa paska i `opcja` to opcja dla tego paska. + +Lista opcji dla pasków: + +[width="100%",cols="2m,2,10",options="header"] +|=== +| Opcja | Wartości | Opis + +| type | `root`, `window` | + Pasek z typem `root` jest wyświetlany dokładnie jeden raz na ekranie, poza + wszystkimi oknami. Domyślny pasek _buflist_ ma typ `root`. + + Pasek z typem `window` wyświetlany jest w każdym oknie, na przykład jeśli + podzielisz jednorazowo ekran (używając `/window splith` lun `/window splitv`) + otrzymasz po jednym pasku w każdym oknie. Domyślnie paski _title_, _status_, + _input_ i _nicklist_ mają typ `window`. + +| position | `top`, `bottom`, `left`, `right` | + Pozycja paska: powyżej/poniżej ekranu rozmowy, po jego lewej/prawej stronie. + +| priority | integer ≥ 0 | + Priorytet wyświetlania paska: jest on używany do uporządkowania pasków na + ekranie, kiedy więcej niż jeden pasek posiada ten sam typ i położenie. + + Paski są wyświetlane od brzegu do środka ekranu. Paski z wyższym priorytetem + zostaną wyświetlone na początku, czyli bliżej krawędzi. + + Przykład: pasek _input_ ma priorytet 1000, dlatego jest wyświetlany przed + paskiem _status_, który ma priorytet 500. + +| size | integer ≥ 0 | + Rozmiar paska: ilość kolumn dla pozycji lewo/prawo, numer linii dla pozycji + góra/dół. Rozmiar `0` oznacza automatyczny - rozmiar zostanie wyliczony zgodnie + z wyświetlaną zawartością. + +| size_max | integer ≥ 0 | + Maksymalny rozmiar paska, `0` = brak limitu (opcja ta jest używana tylko jeśli + `size` = 0). + +| color_bg | color | + Domyślny kolor tła paska. + +| color_fg | color | + Domyślny kolor tekstu na pasku. + +| color_delim | color | + Kolor separatorów na pasku. + +| hidden | `on`, `off` | + Kiedy ta opcja jest ustawiona na `on`, pasek jest ukrywany. + + Uwaga: zamiast zmiany tej opcji zaleca się użycie komendy `/bar`, na przykład: + `/bar toggle nicklist` (zobacz komendę <<command_weechat_bar,/bar>> po więcej + informacji). + +| separator | `on`, `off` | + Kiedy ta opcja jest ustawiona na `on`, separator (linia) jest wyświetlany + pomiędzy tym paskiem a pozostałymi (lub oknem rozmowy). + +| items | string | + Lista _elementów_ (zobacz <<bar_items,elementy>> po więcej informacji). + +| filling_left_right | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | + Typ wypełnienia paska dla pozycji o pozycji `left` lub `right` (zobacz + <<bar_filling,wypełnienie>> po więcej informacji). + +| filling_top_bottom | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | + Typ wypełnienia paska dla pozycji o pozycji `top` lub `bottom` (zobacz + <<bar_filling,wypełnienie>> po więcej informacji). + +| conditions | string | + Warunki wyświetlania paska (zobacz <<bar_conditions,warunki>> po więcej + informacji). +|=== + +[[bar_items]] +==== Elementy + +Opcja _items_ jest ciągiem z listą elementów paska oddzielonych przecinkiem +(spacja pomiędzy elementami na ekranie) lub `+++` (elementy sklejone). + +Lista wszystkich elementów paska jest wyświetlana za pomocą komendy `/bar listitems`. + +Przed i za nazwą elementu można używać znaków (nie będących alfanumerycznymi, +`+-+` lub `+_+`). Będą one wyświetlane przed/za elementem z kolorem separatorów +zdefiniowanych dla paska (opcja _color_delim_). + +Przykład paska z elementami "[time],buffer_number+:+buffer_plugin+.+buffer_name": + +.... +┌───────────────────────────────────────────────────────────────────────────┐ +│[12:55] 3:irc/libera.#weechat │ +└───────────────────────────────────────────────────────────────────────────┘ +.... + +Specjalna składnia może zostać użyta, żeby wymusić bufor używany do wyświetlenia +elementów paska: "@bufor:element" (gdzie "bufor" to pełna nazwa bufora i "element" +to nazwa elementu paska). + +Jest to przydatne w paskach typu `root` do wyświetlania elementów dla konkretnych +buforów, które nie są wyświetlane w obecnym oknie (lub nawet nie wyświetlanych +w ogóle). + +Przykład: lista nicków dla bitlbee w pasku `root` (jeśli pasek nazywa się _bitlist_ +i serwer bitlbee nazywa sie _bitlbee_): + +---- +/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" +---- + +[[bar_filling]] +==== Wypełnienie + +Są cztery typy wypełnień: + +* `+horizontal+`: elementy są wyświetlane poziomo, od lewej do prawej. Jeśli + w elementach występują nowe linie, odstęp jest używany do ich oddzielenia. +* `+vertical+`: elementy są wyświetlane od góry do dołu. Jeśli w elementach + występują nowe linie, do ich oddzielenia używana jest nowa linia. +* `+columns_horizontal+`: elementy są wyświetlane z użyciem kolumn, gdzie tekst + tekst jest wyrównany do lewej. Pierwszy element znajduje się na górze z lewej, + kolejny w tej samej linii z prawej. +* `+columns_vertical+`: elementy są wyświetlane z użyciem kolumn, gdzie tekst + tekst jest wyrównany do lewej. Pierwszy element znajduje się na górze z lewej, + kolejny jest linię niżej. + +Domyślne paski _title_, _status_ i _input_ mają wypełnienie _horizontal_, +domyślny pasek _nicklist_ ma wypełnienie _vertical_. + +Przykłady wypełnień paska _nicklist_: + +.... +┌───────────────────────────────────────────────────────────────────────┐ +│Welcome to #test, this is a test channel │ +│12:54:15 peter | hey! │@carl │ +│12:55:01 +Max | hello │@jessika│ +│ │@maddy │ +│ │%Diego │ +│ │%Melody │ +│ │+Max │ +│ │ celia │ +│ │ Eva │ +│ │ freddy │ +│ │ Harold^│ +│ │ henry4 │ +│ │ jimmy17│ +│ │ jodie ▼│ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│Welcome to #test, this is a test channel │ +│12:54:15 peter | hey! │@carl lee │ +│12:55:01 +Max | hello │@jessika louise │ +│ │@maddy mario │ +│ │%Diego mark │ +│ │%Melody peter │ +│ │+Max Rachel │ +│ │ celia richard│ +│ │ Eva sheryl │ +│ │ freddy Vince │ +│ │ Harold^ warren │ +│ │ henry4 zack │ +│ │ jimmy17 │ +│ │ jodie │ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl %Diego celia Harold^ jodie mario Rachel Vince │ +│@jessika %Melody Eva henry4 lee mark richard warren │ +│@maddy +Max freddy jimmy17 louise peter sheryl zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ +│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ +│ mark peter Rachel richard sheryl Vince warren zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_horizontal ▲ +.... + +[[bar_conditions]] +==== Warunki + +Opcja _conditions_ jest jest przetwarzana w celu sprawdzenia czy pasek ma być +wyświetlony czy nie. + +Dostępne opcje: + +* _active_: okno musi być aktywne +* _inactive_: okno musi być nieaktywne +* _nicklist_: bufor wyświetlany w oknie musi mieć listę nicków +* wyrażenie: jest wykonywane jako wyrażenie logiczne (zobacz komendę + <<command_weechat_eval,/eval>>) + +Dla wyrażeń dostępne są następujące zmienne: + +* `+${active}+`: prawda, jeśli okno jest aktywne +* `+${inactive}+`: prawda, jeśli okno jest nieaktywne +* `+${nicklist}+`: prawda, jeśli okno posiada listę nicków + +Następujące wskaźniki są dostępne: + +* `+${window}+`: okno, dla którego warunek jest sprawdzany +* `+${buffer}+`: bufor okna, dla którego warunek jest sprawdzany + +Przykład pokazujący pasek z listą nicków we wszystkich buforach, które mają +ją włączoną i tylko jeśli szerokość terminala jest > 100: + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" +---- + +Ten sam warunek, ale lista nicków jest zawsze wyświetlana w buforze _&bitlbee_ +(nawet jeśli jest mały): + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" +---- + [[secured_data]] === Zabezpieczone dane diff --git a/doc/sr/weechat_user.sr.adoc b/doc/sr/weechat_user.sr.adoc index 4ee9a73bf..2514551ed 100644 --- a/doc/sr/weechat_user.sr.adoc +++ b/doc/sr/weechat_user.sr.adoc @@ -583,6 +583,49 @@ include::includes/cmdline_options.sr.adoc[tag=debug] | WEECHAT_EXTRA_LIBDIR | Додатни директоријум из кога се учитавају додаци (из „plugins” директоријума на овој путањи). |=== +// TRANSLATION MISSING +[[colors_support]] +=== Colors support + +За приказ текста у тракама и простору за чет, програм WeeChat може да користи до 32767 парова боја (ваш терминал мора да подржава 256 боја како могле да се користе у програму WeeChat). + +Сагласно са вредности променљиве окружења _TERM_, можете имати следећа ограничења за боје у програму WeeChat: + +[width="75%", cols="8,>3,>3", options="header"] +|=== +| $TERM | Боја | Парова +| "rxvt-unicode", "xterm", ... | 88 | 32767 +| "rxvt-256color", "xterm-256color", ... | 256 | 32767 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 32767 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 32767 +|=== + +Ако желите да прикажете ограничења за своје окружење, покрените `weechat --colors`, или извршите команду `/color` у програму WeeChat. + +Неке од препоручених вредности за _TERM_ ако желите 256 боја: + +* под screen: _screen-256color_ +* под tmux: _screen-256color_ или _tmux-256color_ +* ван screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... + +[NOTE] +Можда ће бити потребно да инсталирате пакет „ncurses-term” како бисте могли да у _TERM_ променљивој користите ове вредности. + +Ако користите screen, можете да додате следећу линију у свој _~/.screenrc_: + +---- +term screen-256color +---- + +Ако је вредност ваше _TERM_ променљиве погрешна, а програм WeeChat се већ извршава, можете да је промените помоћу следеће две команде: + +---- +/set env TERM screen-256color +/upgrade +---- + [[files_and_directories]] === Фајлови и директоријуми @@ -890,139 +933,6 @@ kbd:[!] [NOTE] У irc додатку можете да ремапирате ове боје употребом опције <<option_irc.color.mirc_remap,irc.color.mirc_remap>>. -[[colors]] -=== Боје - -За приказ текста у тракама и простору за чет, програм WeeChat може да користи до 32767 парова боја (ваш терминал мора да подржава 256 боја како могле да се користе у програму WeeChat). - -Сагласно са вредности променљиве окружења _TERM_, можете имати следећа ограничења за боје у програму WeeChat: - -[width="75%", cols="8,>3,>3", options="header"] -|=== -| $TERM | Боја | Парова -| "rxvt-unicode", "xterm", ... | 88 | 32767 -| "rxvt-256color", "xterm-256color", ... | 256 | 32767 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 32767 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 32767 -|=== - -Ако желите да прикажете ограничења за своје окружење, покрените `weechat --colors`, или извршите команду `/color` у програму WeeChat. - -Неке од препоручених вредности за _TERM_ ако желите 256 боја: - -* под screen: _screen-256color_ -* под tmux: _screen-256color_ или _tmux-256color_ -* ван screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... - -[NOTE] -Можда ће бити потребно да инсталирате пакет „ncurses-term” како бисте могли да у _TERM_ променљивој користите ове вредности. - -Ако користите screen, можете да додате следећу линију у свој _~/.screenrc_: - ----- -term screen-256color ----- - -Ако је вредност ваше _TERM_ променљиве погрешна, а програм WeeChat се већ извршава, можете да је промените помоћу следеће две команде: - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== Основне боје - -Основне боје у програму WeeChat су: - -[width="75%", cols="1m,4", options="header"] -|=== -| Име | Боја -| default | Подразумевана боја терминала (провидна за позадину) -| black | Црна -| darkgray | Тамносива -| red | Тамноцрвена -| lightred | Светлоцрвена -| green | Тамнозелена -| lightgreen | Светлозелена -| brown | Браон -| yellow | Жута -| blue | Тамноплава -| lightblue | Светлоплава -| magenta | Тамномагента -| lightmagenta | Светломагента -| cyan | Тамноцијан -| lightcyan | Светлоцијан -| gray | Сива -| white | Бела -|=== - -[[colors_extended]] -==== Проширене боје - -Програм WeeChat динамички алоцира парове боја када се боје употребе на екрану (за приказ бафера и трака). - -Уз основне боје, можете да користите и број боје између 1 и границе вашег терминала. - -Употребите команду `/color` да видите текуће боје и ограничења. Са kbd:[Alt+c] можете привремено да се пребаците на боје терминала како бисте изабрали боју. - -На пример, ако желите да се време у баферу приказује у наранџастој боји, извршите: - ----- -/set weechat.color.chat_time 214 ----- - -Или ако желите тамну тамнозелену позадину за статусну линију: - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== Алијаси - -Алијасе боја можете додати командом `/color alias`, па затим користити тај алијас у било којој опцији за боје. - -На пример: - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== Атрибути - -За боје можете да користите и неке атрибуте. Испред имена или броја боје можете додати један или више атрибута: - -* `+*+`: подебљани текст -* `+!+`: обрнути видео -* `+/+`: курзив -* `+_+`: подвучен текст -* `+|+`: задржавање атрибута: када се мења боја, подебљано/обрнуто/курзив/подвучено се не ресетује - -На пример, ако желите да ваш надимак исписује у белој боји, подвучено, извршите: - ----- -/set weechat.color.chat_nick_self _white ----- - -Или ако желите да се у статусној траци време исписује у наранџастој боји, подебљано: - ----- -/set weechat.color.status_time *_214 ----- - -Ако атрибуте желите да користите са подразумеваном бојом терминала (-1), морате да употребите број већи од последње боје терминала, на пример, максималну боју у програму WeeChat: 99999. - -Пример подебљаног текста са бојом предњег плана терминала: - ----- -/set weechat.color.status_time *99999 ----- - [[buffers_and_windows]] === Бафери и прозори @@ -1335,215 +1245,6 @@ _прозор_ је површина екрана која приказује б [NOTE] Спољни додаци и скрипте могу да дефинишу и користе остале локалне променљиве. -[[bars]] -=== Траке - -_трака_ је површина уз разговор која може да садржи било коју врсту текста. - -Опције траке могу да се поставе опцијама `weechat.bar.име.опција` где је `име` име траке, а `опција` опција за ту траку. - -Листа опција траке: - -[width="100%", cols="2m,2,10", options="header"] -|=== -| Опција | Вредности | Опис - -| type | `root`, `window` | - Трака типа `root` се приказује тачно једном на екрану, ван свих прозора. - Тип подразумеване траке _buflist_ је `root`. + - Трака са типом `window` се приказује у сваком прозору, на пример ако поделите - једном екран (са `/window splith` или `/window splitv`), имаћете - једну траку у сваком прозору. Подразумеване траке _title_, _status_, - _input_ и _nicklist_ су типа `window`. - -| position | `top`, `bottom`, `left`, `right` | - Позиција траке: изнад/испод разговора, са леве/десне стране. - -| priority | цео број ≥ 0 | - Приоритет за приказ траке: ово се користи за ређање трака на екрану када - више трака имају исти тип и исту позицију. + - Траке се приказују од ивице екрана према центру. Виши приоритет значи да - ће се трака приказивати на почетку, дакле, ближе ивици. + - Пример: _input_ трака има приоритет 1000, тако да се приказује испред _status_ - траке, која има приоритет 500. - -| size | цео број ≥ 0 | - Величина траке: број колона за позицију left/right, број линија за - позицију top/bottom. Величина `0` значи аутоматски, тако да ће се - величина израчунати у зависности од садржаја који се приказује у траци. - -| size_max | цео број ≥ 0 | - Максимална величина траке, `0` = нема ограничења (ова опција се користи - само ако је `size` = `0`). - -| color_bg | боја | - Подразумевана боја позадине траке. - -| color_fg | боја | - Подразумевана боја текста у траци. - -| color_delim | боја | - Боја граничника у траци. - -| hidden | `on`, `off` | - Када је ова опција `on`, трака је скривена. + - Напомена: уместо да мењате ову опцију, боље је да користите команду `/bar`, - на пример: `/bar toggle nicklist` (погледајте команду <<command_weechat_bar,/bar>>). - -| separator | `on`, `off` | - Када је ова опција `on`, између ове траке и осталих (или разговора) се - приказује граничник (линија). - -| items | стринг | - Листа _items_ (погледајте <<bar_items,ставке>> за више информација). - -| filling_left_right | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | - Тип испуне за траку која има позицију `left` или `right` (погледајте - <<bar_filling,испуну>> за више информација). - -| filling_top_bottom | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | - Тип испуне за траку која има позицију `top` или `bottom` (погледајте - <<bar_filling,испуну>> за више информација). - -| conditions | стринг | - Услови под којима се трака приказује (погледајте <<bar_conditions,услове>> за - више информација). -|=== - -[[bar_items]] -==== Ставке - -Опција _items_ је стринг са листом ставки траке, раздвојених запетом (ставке су на екрану раздвојене размаком) или `+++` (спојене ставке). - -Листа ставки траке се приказује командом `/bar listitems`. - -Испред или након имена ставке можете да употребите карактере (који нису слова или цифре, `+-+` или `+_+`). Они ће се приказивати испред/иза ставке у боји граничника која је дефинисана за траку (опција _color_delim_). - -Пример за траку са ставкама „[time],buffer_number+:+buffer_plugin+.+buffer_name”: - -.... -┌───────────────────────────────────────────────────────────────────────────┐ -│[12:55] 3:irc/libera.#weechat │ -└───────────────────────────────────────────────────────────────────────────┘ -.... - -Ако желите да форсирате бафер у којем ће се приказивати ставка траке, употребите посебну синтаксу: „@бафер:ставка” (где је „бафер” пуно име бафера, а „ставка” је име ставке траке). - -Ово је корисно у кореним (root) тракама код приказа ставке за неки одређени бафер који се не приказује у текућем прозору (или се чак уопште не приказује). - -Пример: листа надимака за bitlbee у кореној траци (ако се трака зове _bitlist_ а bitlbee сервер се зове _bitlbee_): - ----- -/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" ----- - -[[bar_filling]] -==== Испуна - -Постоји четири врсте испуне: - -* `+horizontal+`: ставке се приказују хоризонтално, с лева у десно. Ако у ставкама постоје преломи линија, за раздвајање линија се користи размак. -* `+vertical+`: ставке се приказују од врха ка дну. Ако у ставкама постоје преломи линија, за раздвајање линија се користи прелом линија. -* `+columns_horizontal+`: ставке се приказују по колонама, уз лево поравнат текст. Прва ставка је горе лево, друга у истој линији, са њене десне стране. -* `+columns_vertical+`: ставке се приказују по колонама, уз лево поравнат текст. Прва ставка је горе лево, друга ставка је једну линију испод. - -Подразумеване траке _title_, _status_ и _input_ имају _horizontal_ испуну, а подразумевана трака _nicklist_ има _vertical_ испуну. - -Неки примери испуне за траку _nicklist_: - -.... -┌───────────────────────────────────────────────────────────────────────┐ -│Добродошли на #test, ово је тест канал │ -│12:54:15 peter | hey! │@carl │ -│12:55:01 +Max | hello │@jessika│ -│ │@maddy │ -│ │%Diego │ -│ │%Melody │ -│ │+Max │ -│ │ celia │ -│ │ Eva │ -│ │ freddy │ -│ │ Harold^│ -│ │ henry4 │ -│ │ jimmy17│ -│ │ jodie ▼│ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│Добродошли на #test, ово је тест канал │ -│12:54:15 peter | hey! │@carl lee │ -│12:55:01 +Max | hello │@jessika louise │ -│ │@maddy mario │ -│ │%Diego mark │ -│ │%Melody peter │ -│ │+Max Rachel │ -│ │ celia richard│ -│ │ Eva sheryl │ -│ │ freddy Vince │ -│ │ Harold^ warren │ -│ │ henry4 zack │ -│ │ jimmy17 │ -│ │ jodie │ -│[12:55] [6] [irc/libera] 3:#test(+n){24} │ -│[@carl] █ │ -└───────────────────────────────────────────────────────────────────────┘ - filling_left_right = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl %Diego celia Harold^ jodie mario Rachel Vince │ -│@jessika %Melody Eva henry4 lee mark richard warren │ -│@maddy +Max freddy jimmy17 louise peter sheryl zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_vertical ▲ - -┌───────────────────────────────────────────────────────────────────────┐ -│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ -│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ -│ mark peter Rachel richard sheryl Vince warren zack │ -│───────────────────────────────────────────────────────────────────────│ -│ │ - filling_top_bottom = columns_horizontal ▲ -.... - -[[bar_conditions]] -==== Услови - -Опција _conditions_ је стринг који се израчунава како би се одредило да ли трака сме да се прикаже или не. - -Стринг може да буде: - -* _active_: прозор мора бити активан -* _inactive_: прозор мора бити неактиван -* _nicklist_: бафер који се приказује у прозору мора имати листу надимака -* израз: израчунава се као логичка вредност (погледајте команду <<command_weechat_eval,/eval>>) - -У изразу су доступне следеће променљиве: - -* `+${active}+`: истинито ако је прозор активан -* `+${inactive}+`: истинито ако је прозор неактиван -* `+${nicklist}+`: истинито ако бафер приказан у прозору има листу надимака - -Доступни су следећи показивачи: - -* `+${window}+`: прозор за који се израчунава услов -* `+${buffer}+`: бафер прозора за који се израчунава услов - -Пример за приказ nicklist траке у свим баферима са листом надимака, само ако је ширина терминала > 100: - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" ----- - -Исти услов, само што се листа надимака увек приказује у баферу _&bitlbee_ (чак и ако је терминал мали): - ----- -/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" ----- - [[bare_display]] === Огољени приказ @@ -1623,134 +1324,21 @@ _трака_ је површина уз разговор која може да Тако да у свом терминалу без проблема можете кликнути на URL адресу од надимка _joe_ (наравно, ово претпоставља да ваш терминал подржава кликове на URL адресе). -[[notify_levels]] -=== Нивои обавештавања - -[[setup_notify_levels]] -==== Постављање нивоа обавештавања - -У порукама које се приказују у баферима може постојати четири нивоа, од нижег ка вишем: - -* _low_: важност поруке је мала (на пример, irc join/part/quit порука) -* _message_: порука од корисника -* _private_: порука у приватном баферу -* _highlight_: порука са истицањем - -Сваки бафер поседује ниво обавештавања који се користи за одлуку које поруке се додају на врућу листу бафера. - -Подразумевани ниво обавештавања може да се постави опцијом <<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>, подразумевана вредност је _all_. - -[width="75%", cols="2m,7", options="header"] -|=== -| Ниво обавештавања | Ниво порука које се додају на врућу листу -| none | (ниједна) -| highlight | _highlight_ + _private_ -| message | _highlight_ + _private_ + _message_ -| all | _highlight_ + _private_ + _message_ + _low_ -|=== - -Ниво обавештавања може да се дефинише за скуп бафера, на пример за све бафере irc сервера „libera”: - ----- -/set weechat.notify.irc.libera message ----- - -Постављање нивоа обавештавања _highlight_ само на каналу „#weechat”: - ----- -/set weechat.notify.irc.libera.#weechat highlight ----- - -Ниво обавештавања за бафер може да се постави командом `/buffer`: - ----- -/buffer notify highlight ----- - -[[max_hotlist_level_nicks]] -==== Максимални ниво вруће листе за надимке - -За неке надимке је могуће постављање максималног нивоа вруће листе, по баферу или по групи бафера (као што су IRC сервери). - -Особина бафера „hotlist_max_level_nicks” може да се постави на листу надимака, а за сваки надимак у листи максимални ниво вруће листе који се окида. Могући су следећи нивои: - -* -1: за надимак нема измене вруће листе -* 0: ниски приоритет (као што су join/part поруке) -* 1: порука -* 2: приватна порука -* 3: истицање (у суштини је бескорисно, јер је за све поруке већ подразумевани максимум) - -На пример, ако желите да искључите истицања од „joe” и „mike” у текућем баферу: - ----- -/buffer set hotlist_max_level_nicks_add joe:2,mike:2 ----- - -[NOTE] -Особина бафера „hotlist_max_level_nicks” се не чува у конфигурацији. + -Лако можете да је сачувате скриптом _buffer_autoset.py_: инсталирате је командом `+/script install buffer_autoset.py+`, а помоћ добијате са `+/help buffer_autoset+`. - -[[highlights]] -=== Истицања - -[[highlights_words]] -==== Додавање речи које се истичу - -Програм WeeChat подразумевано истиче поруке од осталих корисника које садрже у себи ваш надимак, тако да истицање зависи од бафера (ваш надимак не мора да буде исти у свим баферима). - -Остале речи моожете да додате опцијом <<option_weechat.look.highlight,weechat.look.highlight>>, на пример ако желите да се истиче ваш надимак и „реч1”, „реч2”, као и све речи које почињу са „test”: - ----- -/set weechat.look.highlight реч1,реч2,test* ----- - -Ако вам је потребно одређеније правило за реч, можете да употребите регуларне изразе опцијом <<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, на пример да истакнете речи „flashcode”, „flashcöde” и „flashy”: - ----- -/set weechat.look.highlight_regex flashc[oö]de|flashy ----- - -Граничници око речи које се истичу могу да се прилагоде опцијом <<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>>. - -[[highlights_tags]] -==== Додавање ознака истицању - -Приказане линије могу да садрже „ознаке” које пружају неке информације о пореклу само поруке. + -Ознаке можете приказати командом `/debug tags` (иста команда их и сакрива). - -Опцијом <<option_weechat.look.highlight_tags,weechat.look.highlight_tags>> можете да додате одређене ознаке истицању. Ознаке се раздвајају запетама и више ознака можете да раздвојите са `+++` чиме наводите логичко „и” међу њима. - -На пример, ако желите да се истичу све поруке од надимка „FlashCode” и сва обавештења од надимака који почињу са „toto”: - ----- -/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" ----- - -[[highlights_regex_buffer]] -==== Постављање посебних истицања у баферу - -Истицање помоћу регуларног израза можете да форсирате особином бафера „highlight_regex”. - -На пример, да форсирате истицање свих порука у текућем баферу: - ----- -/buffer set highlight_regex .* ----- - -[NOTE] -Особина бафера „highlight_regex” се не чува у конфигурацији. + -Лако можете да је сачувате скриптом _buffer_autoset.py_: инсталирате је командом `+/script install buffer_autoset.py+`, а помоћ добијате са `+/help buffer_autoset+`. - +// TRANSLATION MISSING [[key_bindings]] -=== Подразумеване тастерске пречице +== Key bindings + +// TRANSLATION MISSING +WeeChat provides a lot of default key bindings, listed in the following chapters. + +They can be changed and new ones can be added with the <<command_weechat_key,/key>> command. // TRANSLATION MISSING [[key_bindings_cmdline]] -==== Command line +=== Command line // TRANSLATION MISSING [[key_bindings_cmdline_cursor_movement]] -===== Cursor movement +==== Cursor movement [width="100%", cols="^.^3,.^8,.^5", options="header"] |=== @@ -1771,7 +1359,7 @@ _трака_ је површина уз разговор која може да // TRANSLATION MISSING [[key_bindings_cmdline_editing]] -===== Editing +==== Editing [width="100%", cols="^.^3,.^8,.^5", options="header"] |=== @@ -1800,7 +1388,7 @@ _трака_ је површина уз разговор која може да // TRANSLATION MISSING [[key_bindings_cmdline_color_codes]] -===== Color codes +==== Color codes [width="100%", cols="^.^3,.^8,.^5", options="header"] |=== @@ -1815,7 +1403,7 @@ _трака_ је површина уз разговор која може да // TRANSLATION MISSING [[key_bindings_cmdline_history]] -===== Command history +==== Command history [width="100%", cols="^.^3,.^8,.^5", options="header"] |=== @@ -1828,7 +1416,7 @@ _трака_ је површина уз разговор која може да // TRANSLATION MISSING [[key_bindings_buffers]] -==== Buffers +=== Buffers [width="100%", cols="^.^3,.^8,.^5", options="header"] |=== @@ -1867,7 +1455,7 @@ _трака_ је површина уз разговор која може да // TRANSLATION MISSING [[key_bindings_windows]] -==== Windows +=== Windows [width="100%", cols="^.^3,.^8,.^5", options="header"] |=== @@ -1887,7 +1475,7 @@ _трака_ је површина уз разговор која може да // TRANSLATION MISSING [[key_bindings_bars]] -==== Bars +=== Bars [width="100%", cols="^.^3,.^8,.^5", options="header"] |=== @@ -1912,7 +1500,7 @@ _трака_ је површина уз разговор која може да // TRANSLATION MISSING [[key_bindings_hotlist]] -==== Hotlist +=== Hotlist [width="100%", cols="^.^3,.^8,.^5", options="header"] |=== @@ -1926,7 +1514,7 @@ _трака_ је површина уз разговор која може да // TRANSLATION MISSING [[key_bindings_toggle_keys]] -==== Toggle keys +=== Toggle keys [width="100%", cols="^.^3,.^8,.^5", options="header"] |=== @@ -1939,7 +1527,7 @@ _трака_ је површина уз разговор која може да // TRANSLATION MISSING [[key_bindings_search_context]] -==== Search context +=== Search context Следећи тастери се користе у „search” контексту (када се притисне kbd:[Ctrl+r] за претрагу текста у баферу). @@ -1959,7 +1547,7 @@ _трака_ је површина уз разговор која може да // TRANSLATION MISSING [[key_bindings_cursor_context]] -==== Cursor context +=== Cursor context Ови тастери се користе у „cursor” контексту (слободно померање курсора по екрану). @@ -1989,7 +1577,7 @@ _трака_ је површина уз разговор која може да // TRANSLATION MISSING [[key_bindings_mouse]] -==== Mouse +=== Mouse // TRANSLATION MISSING These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] @@ -2044,7 +1632,7 @@ These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] // TRANSLATION MISSING [[key_bindings_fset_buffer]] -==== Fset buffer +=== Fset buffer Ови тастери и акције се користе у fset баферу (погледајте<<fset_plugin,Fset додатак>>). @@ -2091,7 +1679,7 @@ These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] // TRANSLATION MISSING [[key_bindings_script_buffer]] -==== Script buffer +=== Script buffer Ови тастери и акције се користе у script баферу (погледајте <<scripts_plugins,Script додатак>>). @@ -2114,6 +1702,223 @@ These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] [NOTE] ^(1)^ Акција мора да се унесе као унос у командну линију, након чега се притисне kbd:[Ентер]. +// TRANSLATION MISSING +[[configuration]] +== Configuration + +// TRANSLATION MISSING +[[colors]] +=== Colors + +[[colors_basic]] +==== Основне боје + +Основне боје у програму WeeChat су: + +[width="75%", cols="1m,4", options="header"] +|=== +| Име | Боја +| default | Подразумевана боја терминала (провидна за позадину) +| black | Црна +| darkgray | Тамносива +| red | Тамноцрвена +| lightred | Светлоцрвена +| green | Тамнозелена +| lightgreen | Светлозелена +| brown | Браон +| yellow | Жута +| blue | Тамноплава +| lightblue | Светлоплава +| magenta | Тамномагента +| lightmagenta | Светломагента +| cyan | Тамноцијан +| lightcyan | Светлоцијан +| gray | Сива +| white | Бела +|=== + +[[colors_extended]] +==== Проширене боје + +Програм WeeChat динамички алоцира парове боја када се боје употребе на екрану (за приказ бафера и трака). + +Уз основне боје, можете да користите и број боје између 1 и границе вашег терминала. + +Употребите команду `/color` да видите текуће боје и ограничења. Са kbd:[Alt+c] можете привремено да се пребаците на боје терминала како бисте изабрали боју. + +На пример, ако желите да се време у баферу приказује у наранџастој боји, извршите: + +---- +/set weechat.color.chat_time 214 +---- + +Или ако желите тамну тамнозелену позадину за статусну линију: + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== Алијаси + +Алијасе боја можете додати командом `/color alias`, па затим користити тај алијас у било којој опцији за боје. + +На пример: + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== Атрибути + +За боје можете да користите и неке атрибуте. Испред имена или броја боје можете додати један или више атрибута: + +* `+*+`: подебљани текст +* `+!+`: обрнути видео +* `+/+`: курзив +* `+_+`: подвучен текст +* `+|+`: задржавање атрибута: када се мења боја, подебљано/обрнуто/курзив/подвучено се не ресетује + +На пример, ако желите да ваш надимак исписује у белој боји, подвучено, извршите: + +---- +/set weechat.color.chat_nick_self _white +---- + +Или ако желите да се у статусној траци време исписује у наранџастој боји, подебљано: + +---- +/set weechat.color.status_time *_214 +---- + +Ако атрибуте желите да користите са подразумеваном бојом терминала (-1), морате да употребите број већи од последње боје терминала, на пример, максималну боју у програму WeeChat: 99999. + +Пример подебљаног текста са бојом предњег плана терминала: + +---- +/set weechat.color.status_time *99999 +---- + +[[notify_levels]] +=== Нивои обавештавања + +[[setup_notify_levels]] +==== Постављање нивоа обавештавања + +У порукама које се приказују у баферима може постојати четири нивоа, од нижег ка вишем: + +* _low_: важност поруке је мала (на пример, irc join/part/quit порука) +* _message_: порука од корисника +* _private_: порука у приватном баферу +* _highlight_: порука са истицањем + +Сваки бафер поседује ниво обавештавања који се користи за одлуку које поруке се додају на врућу листу бафера. + +Подразумевани ниво обавештавања може да се постави опцијом <<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>, подразумевана вредност је _all_. + +[width="75%", cols="2m,7", options="header"] +|=== +| Ниво обавештавања | Ниво порука које се додају на врућу листу +| none | (ниједна) +| highlight | _highlight_ + _private_ +| message | _highlight_ + _private_ + _message_ +| all | _highlight_ + _private_ + _message_ + _low_ +|=== + +Ниво обавештавања може да се дефинише за скуп бафера, на пример за све бафере irc сервера „libera”: + +---- +/set weechat.notify.irc.libera message +---- + +Постављање нивоа обавештавања _highlight_ само на каналу „#weechat”: + +---- +/set weechat.notify.irc.libera.#weechat highlight +---- + +Ниво обавештавања за бафер може да се постави командом `/buffer`: + +---- +/buffer notify highlight +---- + +[[max_hotlist_level_nicks]] +==== Максимални ниво вруће листе за надимке + +За неке надимке је могуће постављање максималног нивоа вруће листе, по баферу или по групи бафера (као што су IRC сервери). + +Особина бафера „hotlist_max_level_nicks” може да се постави на листу надимака, а за сваки надимак у листи максимални ниво вруће листе који се окида. Могући су следећи нивои: + +* -1: за надимак нема измене вруће листе +* 0: ниски приоритет (као што су join/part поруке) +* 1: порука +* 2: приватна порука +* 3: истицање (у суштини је бескорисно, јер је за све поруке већ подразумевани максимум) + +На пример, ако желите да искључите истицања од „joe” и „mike” у текућем баферу: + +---- +/buffer set hotlist_max_level_nicks_add joe:2,mike:2 +---- + +[NOTE] +Особина бафера „hotlist_max_level_nicks” се не чува у конфигурацији. + +Лако можете да је сачувате скриптом _buffer_autoset.py_: инсталирате је командом `+/script install buffer_autoset.py+`, а помоћ добијате са `+/help buffer_autoset+`. + +[[highlights]] +=== Истицања + +[[highlights_words]] +==== Додавање речи које се истичу + +Програм WeeChat подразумевано истиче поруке од осталих корисника које садрже у себи ваш надимак, тако да истицање зависи од бафера (ваш надимак не мора да буде исти у свим баферима). + +Остале речи моожете да додате опцијом <<option_weechat.look.highlight,weechat.look.highlight>>, на пример ако желите да се истиче ваш надимак и „реч1”, „реч2”, као и све речи које почињу са „test”: + +---- +/set weechat.look.highlight реч1,реч2,test* +---- + +Ако вам је потребно одређеније правило за реч, можете да употребите регуларне изразе опцијом <<option_weechat.look.highlight_regex,weechat.look.highlight_regex>>, на пример да истакнете речи „flashcode”, „flashcöde” и „flashy”: + +---- +/set weechat.look.highlight_regex flashc[oö]de|flashy +---- + +Граничници око речи које се истичу могу да се прилагоде опцијом <<option_weechat.look.word_chars_highlight,weechat.look.word_chars_highlight>>. + +[[highlights_tags]] +==== Додавање ознака истицању + +Приказане линије могу да садрже „ознаке” које пружају неке информације о пореклу само поруке. + +Ознаке можете приказати командом `/debug tags` (иста команда их и сакрива). + +Опцијом <<option_weechat.look.highlight_tags,weechat.look.highlight_tags>> можете да додате одређене ознаке истицању. Ознаке се раздвајају запетама и више ознака можете да раздвојите са `+++` чиме наводите логичко „и” међу њима. + +На пример, ако желите да се истичу све поруке од надимка „FlashCode” и сва обавештења од надимака који почињу са „toto”: + +---- +/set weechat.look.highlight_tags "nick_flashcode,irc_notice+nick_toto*" +---- + +[[highlights_regex_buffer]] +==== Постављање посебних истицања у баферу + +Истицање помоћу регуларног израза можете да форсирате особином бафера „highlight_regex”. + +На пример, да форсирате истицање свих порука у текућем баферу: + +---- +/buffer set highlight_regex .* +---- + +[NOTE] +Особина бафера „highlight_regex” се не чува у конфигурацији. + +Лако можете да је сачувате скриптом _buffer_autoset.py_: инсталирате је командом `+/script install buffer_autoset.py+`, а помоћ добијате са `+/help buffer_autoset+`. + [[mouse]] === Подршка за миша @@ -2220,6 +2025,215 @@ These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m] [TIP] Име догађаја можете сазнати командом `+/input grab_mouse+`, па извршавањем догађаја мишем. Ово ће да уметне име догађаја који сете извели у командну линију. +[[bars]] +=== Траке + +_трака_ је површина уз разговор која може да садржи било коју врсту текста. + +Опције траке могу да се поставе опцијама `weechat.bar.име.опција` где је `име` име траке, а `опција` опција за ту траку. + +Листа опција траке: + +[width="100%", cols="2m,2,10", options="header"] +|=== +| Опција | Вредности | Опис + +| type | `root`, `window` | + Трака типа `root` се приказује тачно једном на екрану, ван свих прозора. + Тип подразумеване траке _buflist_ је `root`. + + Трака са типом `window` се приказује у сваком прозору, на пример ако поделите + једном екран (са `/window splith` или `/window splitv`), имаћете + једну траку у сваком прозору. Подразумеване траке _title_, _status_, + _input_ и _nicklist_ су типа `window`. + +| position | `top`, `bottom`, `left`, `right` | + Позиција траке: изнад/испод разговора, са леве/десне стране. + +| priority | цео број ≥ 0 | + Приоритет за приказ траке: ово се користи за ређање трака на екрану када + више трака имају исти тип и исту позицију. + + Траке се приказују од ивице екрана према центру. Виши приоритет значи да + ће се трака приказивати на почетку, дакле, ближе ивици. + + Пример: _input_ трака има приоритет 1000, тако да се приказује испред _status_ + траке, која има приоритет 500. + +| size | цео број ≥ 0 | + Величина траке: број колона за позицију left/right, број линија за + позицију top/bottom. Величина `0` значи аутоматски, тако да ће се + величина израчунати у зависности од садржаја који се приказује у траци. + +| size_max | цео број ≥ 0 | + Максимална величина траке, `0` = нема ограничења (ова опција се користи + само ако је `size` = `0`). + +| color_bg | боја | + Подразумевана боја позадине траке. + +| color_fg | боја | + Подразумевана боја текста у траци. + +| color_delim | боја | + Боја граничника у траци. + +| hidden | `on`, `off` | + Када је ова опција `on`, трака је скривена. + + Напомена: уместо да мењате ову опцију, боље је да користите команду `/bar`, + на пример: `/bar toggle nicklist` (погледајте команду <<command_weechat_bar,/bar>>). + +| separator | `on`, `off` | + Када је ова опција `on`, између ове траке и осталих (или разговора) се + приказује граничник (линија). + +| items | стринг | + Листа _items_ (погледајте <<bar_items,ставке>> за више информација). + +| filling_left_right | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | + Тип испуне за траку која има позицију `left` или `right` (погледајте + <<bar_filling,испуну>> за више информација). + +| filling_top_bottom | `+horizontal+`, `+vertical+`, `+columns_horizontal+`, `+columns_vertical+` | + Тип испуне за траку која има позицију `top` или `bottom` (погледајте + <<bar_filling,испуну>> за више информација). + +| conditions | стринг | + Услови под којима се трака приказује (погледајте <<bar_conditions,услове>> за + више информација). +|=== + +[[bar_items]] +==== Ставке + +Опција _items_ је стринг са листом ставки траке, раздвојених запетом (ставке су на екрану раздвојене размаком) или `+++` (спојене ставке). + +Листа ставки траке се приказује командом `/bar listitems`. + +Испред или након имена ставке можете да употребите карактере (који нису слова или цифре, `+-+` или `+_+`). Они ће се приказивати испред/иза ставке у боји граничника која је дефинисана за траку (опција _color_delim_). + +Пример за траку са ставкама „[time],buffer_number+:+buffer_plugin+.+buffer_name”: + +.... +┌───────────────────────────────────────────────────────────────────────────┐ +│[12:55] 3:irc/libera.#weechat │ +└───────────────────────────────────────────────────────────────────────────┘ +.... + +Ако желите да форсирате бафер у којем ће се приказивати ставка траке, употребите посебну синтаксу: „@бафер:ставка” (где је „бафер” пуно име бафера, а „ставка” је име ставке траке). + +Ово је корисно у кореним (root) тракама код приказа ставке за неки одређени бафер који се не приказује у текућем прозору (или се чак уопште не приказује). + +Пример: листа надимака за bitlbee у кореној траци (ако се трака зове _bitlist_ а bitlbee сервер се зове _bitlbee_): + +---- +/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" +---- + +[[bar_filling]] +==== Испуна + +Постоји четири врсте испуне: + +* `+horizontal+`: ставке се приказују хоризонтално, с лева у десно. Ако у ставкама постоје преломи линија, за раздвајање линија се користи размак. +* `+vertical+`: ставке се приказују од врха ка дну. Ако у ставкама постоје преломи линија, за раздвајање линија се користи прелом линија. +* `+columns_horizontal+`: ставке се приказују по колонама, уз лево поравнат текст. Прва ставка је горе лево, друга у истој линији, са њене десне стране. +* `+columns_vertical+`: ставке се приказују по колонама, уз лево поравнат текст. Прва ставка је горе лево, друга ставка је једну линију испод. + +Подразумеване траке _title_, _status_ и _input_ имају _horizontal_ испуну, а подразумевана трака _nicklist_ има _vertical_ испуну. + +Неки примери испуне за траку _nicklist_: + +.... +┌───────────────────────────────────────────────────────────────────────┐ +│Добродошли на #test, ово је тест канал │ +│12:54:15 peter | hey! │@carl │ +│12:55:01 +Max | hello │@jessika│ +│ │@maddy │ +│ │%Diego │ +│ │%Melody │ +│ │+Max │ +│ │ celia │ +│ │ Eva │ +│ │ freddy │ +│ │ Harold^│ +│ │ henry4 │ +│ │ jimmy17│ +│ │ jodie ▼│ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│Добродошли на #test, ово је тест канал │ +│12:54:15 peter | hey! │@carl lee │ +│12:55:01 +Max | hello │@jessika louise │ +│ │@maddy mario │ +│ │%Diego mark │ +│ │%Melody peter │ +│ │+Max Rachel │ +│ │ celia richard│ +│ │ Eva sheryl │ +│ │ freddy Vince │ +│ │ Harold^ warren │ +│ │ henry4 zack │ +│ │ jimmy17 │ +│ │ jodie │ +│[12:55] [6] [irc/libera] 3:#test(+n){24} │ +│[@carl] █ │ +└───────────────────────────────────────────────────────────────────────┘ + filling_left_right = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl %Diego celia Harold^ jodie mario Rachel Vince │ +│@jessika %Melody Eva henry4 lee mark richard warren │ +│@maddy +Max freddy jimmy17 louise peter sheryl zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_vertical ▲ + +┌───────────────────────────────────────────────────────────────────────┐ +│@carl @jessika @maddy %Diego %Melody +Max celia Eva │ +│ freddy Harold^ henry4 jimmy17 jodie lee louise mario │ +│ mark peter Rachel richard sheryl Vince warren zack │ +│───────────────────────────────────────────────────────────────────────│ +│ │ + filling_top_bottom = columns_horizontal ▲ +.... + +[[bar_conditions]] +==== Услови + +Опција _conditions_ је стринг који се израчунава како би се одредило да ли трака сме да се прикаже или не. + +Стринг може да буде: + +* _active_: прозор мора бити активан +* _inactive_: прозор мора бити неактиван +* _nicklist_: бафер који се приказује у прозору мора имати листу надимака +* израз: израчунава се као логичка вредност (погледајте команду <<command_weechat_eval,/eval>>) + +У изразу су доступне следеће променљиве: + +* `+${active}+`: истинито ако је прозор активан +* `+${inactive}+`: истинито ако је прозор неактиван +* `+${nicklist}+`: истинито ако бафер приказан у прозору има листу надимака + +Доступни су следећи показивачи: + +* `+${window}+`: прозор за који се израчунава услов +* `+${buffer}+`: бафер прозора за који се израчунава услов + +Пример за приказ nicklist траке у свим баферима са листом надимака, само ако је ширина терминала > 100: + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && ${info:term_width} > 100" +---- + +Исти услов, само што се листа надимака увек приказује у баферу _&bitlbee_ (чак и ако је терминал мали): + +---- +/set weechat.bar.nicklist.conditions "${nicklist} && (${info:term_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" +---- + [[secured_data]] === Обезбеђени подаци |