doc: add chapters "Buffers and windows" and "Notify levels" in user guide

This commit is contained in:
Sebastien Helleu 2012-06-10 17:15:28 +02:00
parent 25c795a26f
commit bab252de96
4 changed files with 751 additions and 100 deletions

View File

@ -358,28 +358,29 @@ Beispiel des WeeChat-Terminals:
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel │
│12:52:27 --> | flashy (n=flashcod@hellix.flashtux.org) has joined #test │@ChanServ │
│12:52:27 -- | Nicks #test: [@ChanServ @flashy +_FlashB0t joe mike] │@flashy │
│12:52:27 -- | Channel #test: 5 nicks (2 ops, 0 halfop, 1 voice, 2 normal) │+_FlashB0t│
│12:52:27 -- | Channel created on Tue Jan 27 06:30:17 2009 │joe │
│12:54:15 flashy | hey! │mike │
│12:55:01 joe | hi flashy! │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){5}* [Act: 4:#abc(2,5), 6] │
│[flashy] hi joe!█ │
│Welcome to #test, this is a test channel │ ◀ Bar "title"
│12:52:27 --> | Flashy (flashcode@weechat.org) has joined #test │@Flashy│
│12:52:27 -- | Nicks #test: [@Flashy @joe +weebot] │@joe │
│12:52:27 -- | Channel #test: 4 nicks (2 ops, 0 halfop, 1 voice, 1 normal) │+weebot│
│12:52:27 -- | Channel created on Tue Jan 27 06:30:17 2009 │peter │
│12:54:15 peter | hey! │ │
│12:55:01 @joe | hello │ │
│ │ │
│ │ │
│ │ │
│ │ │ ◀ Chat + Bar "nicklist"
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4}* [Act: 4:#abc(2,5), 6] │ ◀ Bar "status"
│[@Flashy] hi peter!█ │ ◀ Bar "input"
└─────────────────────────────────────────────────────────────────────────────────────────┘
........................................
@ -405,7 +406,7 @@ Die 'status'-Bar besitzt als Standardeinträge:
| buffer_plugin | [irc/freenode] | Erweiterung des aktuellen Buffers (IRC Erweiterung setzt den IRC Servername für den Buffer)
| buffer_number | 3 | aktuelle Nummer des Buffers
| buffer_name | #test(+n) | Name des aktuellen Buffers (mit Channel-Modi für IRC-Channels)
| buffer_nicklist_count | {5} | Anzahl der Nicks in Nickliste
| buffer_nicklist_count | {4} | Anzahl der Nicks in Nickliste
| buffer_filter | * | Filteranzeige: `*` bedeutet das Zeilen gefiltert (unterdrückt) wurden. Ein leerer Eintrag zeigt an dass alle Zeilen dargestellt werden
| lag | [Lag: 2.5] | Verzögerungsanzeige, in Sekunden (keine Anzeige falls Verzögerung gering)
| hotlist | [Act: 4:#abc(2,5), 6] | Liste der Buffer mit Aktivität (ungelesene Nachrichten) (für das Beispiel: 2 Highlights und 5 ungelesene Nachrichten im Channel '#abc', eine ungelesene Nachricht in Buffer #6)
@ -419,12 +420,181 @@ In der 'input' Bar lautet die Standardeinstellung:
|========================================
| Item | Beispiel | Beschreibung
| input_paste | [Paste 7 lines ? [ctrl-Y] Ja [ctrl-N] Nein] | Nachfrage ob sieben Zeilen eingefügt werden sollen
| input_prompt | [flashy] | input prompt (Nickname für den IRC)
| input_prompt | [@Flashy] | input prompt (Nickname für den IRC)
| away | (away) | Abwesenheitsanzeige
| input_search | [Text search] | Textsuche
| input_text | hi joe! | Text der eingegeben wird
| input_text | hi peter! | Text der eingegeben wird
|========================================
// TRANSLATION MISSING
[[buffers_and_windows]]
Buffers and windows
~~~~~~~~~~~~~~~~~~~
Ein 'Buffer' besteht aus einer Nummer, besitzt einem Namen, hat Zeilen die angezeigt
werden (und noch anderen Daten).
// TRANSLATION MISSING
Examples of buffers:
// TRANSLATION MISSING
* core buffer (created by WeeChat on startup, can not be closed)
* irc server (displays messages from server)
* irc channel
* irc private
Ein 'Fenster' ist ein Bildschirmbereich der Buffer darstellt. Es ist möglich
den Bildschirm in mehrere Fenster aufzuteilen.
Jedes Fenster stellt einen Buffer dar. Ein Buffer kann unsichtbar sein (er wird
in einem Fenster nicht angezeigt). Oder ein Buffer wird durch ein oder mehrere Fenster
angezeigt.
// TRANSLATION MISSING
Example of horizontal split (`/window splith`):
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #abc, channel about nothing! │
│12:55:12 Max | hi │@Flashy│
│12:55:20 @Flashy | hi Max! │Max │
│12:55:32 Max | how are you? │ │
│ │ │
│ │ │ ◀ window #2
│ │ │ (buffer #4)
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 4:#abc(+n){2} │
│[@Flashy] │
│─────────────────────────────────────────────────────────────────────────────────────────│
│Welcome to #test, this is a test channel │
│12:54:15 peter | hey! │@Flashy│
│12:55:01 @joe | hello │@joe │
│ │+weebot│
│ │peter │
│ │ │ ◀ window #1
│ │ │ (buffer #3)
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4} │
│[@Flashy] hi peter!█ │
└─────────────────────────────────────────────────────────────────────────────────────────┘
........................................
// TRANSLATION MISSING
Example of vertical split (`/window splitv`):
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel │Welcome to #abc, channel about nothing! │
│12:54:15 peter | hey! │@Flashy│12:55:12 Max | hi │@Flashy│
│12:55:01 @joe | hello │@joe │12:55:20 @Flashy | hi Max! │Max │
│ │+weebot│12:55:32 Max | how are you? │ │
│ │peter │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4} │[12:55] [6] [irc/freenode] 4:#abc(+n){2} │
│[@Flashy] hi peter!█ │[@Flashy] │
└─────────────────────────────────────────────────────────────────────────────────────────┘
▲ window #1 ▲ window #2
(buffer #3) (buffer #4)
........................................
// TRANSLATION MISSING
Example of vertical + horizontal splits:
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel │Welcome to #def, another channel │
│12:54:15 peter | hey! │@Flashy│12:55:42 @Flashy | hello world │@Flashy│
│12:55:01 @joe | hello │@joe │12:55:56 alex | hi Flashy │alex │
│ │+weebot│ │ │
│ │peter │ │ │ ◀ window #3
│ │ │ │ │ (buffer #5)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │[12:55] [6] [irc/freenode] 5:#def(+n){2} │
│ │ │[@Flashy] │
│ │ │────────────────────────────────────────────│
│ │ │Welcome to #abc, channel about nothing! │
│ │ │12:55:12 Max | hi │@Flashy│
│ │ │12:55:20 @Flashy | hi Max! │Max │
│ │ │12:55:32 Max | how are you? │ │
│ │ │ │ │
│ │ │ │ │ ◀ window #2
│ │ │ │ │ (buffer #4)
│ │ │ │ │
│ │ │ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4} │ [12:55] [6] [irc/freenode] 4:#abc(+n){2} │
│[@Flashy] hi peter!█ │ [@Flashy] │
└─────────────────────────────────────────────────────────────────────────────────────────┘
▲ window #1
(buffer #3)
........................................
// TRANSLATION MISSING
[[notify_levels]]
Notify levels
~~~~~~~~~~~~~
// TRANSLATION MISSING
Four levels are possible in messages displayed in buffers, from lower to higher:
// TRANSLATION MISSING
* '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
// TRANSLATION MISSING
Each buffer has a notify level, which is used to decide what messages will add
buffer in hotlist.
// TRANSLATION MISSING
The default notify level can be set using option
<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>,
default is 'all'.
// TRANSLATION MISSING
[width="50%",cols="3m,10",options="header"]
|========================================
| Notify level | Level of messages added to hotlist
| none | (none)
| highlight | 'highlight' + 'private'
| message | 'highlight' + 'private' + 'message'
| all | 'highlight' + 'private' + 'message' + 'low'
|========================================
// TRANSLATION MISSING
Notify level can be defined for a set of buffers, for example all buffers for
irc server "freenode":
----------------------------------------
/set weechat.notify.irc.freenode message
----------------------------------------
// TRANSLATION MISSING
Set notify level 'highlight' on channel "#weechat" only:
----------------------------------------
/set weechat.notify.irc.freenode.#weechat highlight
----------------------------------------
[[key_bindings]]
Standard Tastenbelegung
~~~~~~~~~~~~~~~~~~~~~~~

View File

@ -359,28 +359,29 @@ Example of terminal with WeeChat:
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel │
│12:52:27 --> | flashy (n=flashcod@hellix.flashtux.org) has joined #test │@ChanServ │
│12:52:27 -- | Nicks #test: [@ChanServ @flashy +_FlashB0t joe mike] │@flashy │
│12:52:27 -- | Channel #test: 5 nicks (2 ops, 0 halfop, 1 voice, 2 normal) │+_FlashB0t│
│12:52:27 -- | Channel created on Tue Jan 27 06:30:17 2009 │joe │
│12:54:15 flashy | hey! │mike │
│12:55:01 joe | hi flashy! │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){5}* [Act: 4:#abc(2,5), 6] │
│[flashy] hi joe!█ │
│Welcome to #test, this is a test channel │ ◀ bar "title"
│12:52:27 --> | Flashy (flashcode@weechat.org) has joined #test │@Flashy│
│12:52:27 -- | Nicks #test: [@Flashy @joe +weebot] │@joe │
│12:52:27 -- | Channel #test: 4 nicks (2 ops, 0 halfop, 1 voice, 1 normal) │+weebot│
│12:52:27 -- | Channel created on Tue Jan 27 06:30:17 2009 │peter │
│12:54:15 peter | hey! │ │
│12:55:01 @joe | hello │ │
│ │ │
│ │ │
│ │ │
│ │ │ ◀ chat + bar "nicklist"
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4}* [Act: 4:#abc(2,5), 6] │ ◀ bar "status"
│[@Flashy] hi peter!█ │ ◀ bar "input"
└─────────────────────────────────────────────────────────────────────────────────────────┘
........................................
@ -406,7 +407,7 @@ Bar 'status' has following default items:
| buffer_plugin | [irc/freenode] | plugin of current buffer (irc plugin can add IRC server name used by buffer)
| buffer_number | 3 | current buffer number
| buffer_name | #test(+n) | current buffer name (with channel modes for irc channels)
| buffer_nicklist_count | {5} | number of nicks in nicklist
| buffer_nicklist_count | {4} | number of nicks in nicklist
| buffer_filter | * | filtering indicator: `*` means some lines are filtered (hidden), empty value means all lines are displayed
| lag | [Lag: 2.5] | lag indicator, in seconds (hidden if lag is low)
| hotlist | [Act: 4:#abc(2,5), 6] | list of buffers with activity (unread messages) (in example, 2 highlights and 5 unread messages on '#abc', one unread message on buffer #6)
@ -420,12 +421,166 @@ Bar 'input' has following default items:
|========================================
| Item | Example | Description
| input_paste | [Paste 7 lines ? [ctrl-Y] Yes [ctrl-N] No] | question to user for pasting lines
| input_prompt | [flashy] | input prompt (nick for irc plugin)
| input_prompt | [@Flashy] | input prompt (nick for irc plugin)
| away | (away) | away indicator
| input_search | [Text search] | text search indicator
| input_text | hi joe! | input text
| input_text | hi peter! | input text
|========================================
[[buffers_and_windows]]
Buffers and windows
~~~~~~~~~~~~~~~~~~~
A 'buffer' is composed by a number, a name, lines displayed (and some other
data).
Examples of buffers:
* core buffer (created by WeeChat on startup, can not be closed)
* irc server (displays messages from server)
* irc channel
* irc private
A 'window' is a screen area which displays a buffer. It is possible to split
your screen into many windows.
Each window displays one buffer. A buffer can be hidden (not displayed by a
window) or displayed by one or more windows.
Example of horizontal split (`/window splith`):
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #abc, channel about nothing! │
│12:55:12 Max | hi │@Flashy│
│12:55:20 @Flashy | hi Max! │Max │
│12:55:32 Max | how are you? │ │
│ │ │
│ │ │ ◀ window #2
│ │ │ (buffer #4)
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 4:#abc(+n){2} │
│[@Flashy] │
│─────────────────────────────────────────────────────────────────────────────────────────│
│Welcome to #test, this is a test channel │
│12:54:15 peter | hey! │@Flashy│
│12:55:01 @joe | hello │@joe │
│ │+weebot│
│ │peter │
│ │ │ ◀ window #1
│ │ │ (buffer #3)
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4} │
│[@Flashy] hi peter!█ │
└─────────────────────────────────────────────────────────────────────────────────────────┘
........................................
Example of vertical split (`/window splitv`):
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel │Welcome to #abc, channel about nothing! │
│12:54:15 peter | hey! │@Flashy│12:55:12 Max | hi │@Flashy│
│12:55:01 @joe | hello │@joe │12:55:20 @Flashy | hi Max! │Max │
│ │+weebot│12:55:32 Max | how are you? │ │
│ │peter │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4} │[12:55] [6] [irc/freenode] 4:#abc(+n){2} │
│[@Flashy] hi peter!█ │[@Flashy] │
└─────────────────────────────────────────────────────────────────────────────────────────┘
▲ window #1 ▲ window #2
(buffer #3) (buffer #4)
........................................
Example of vertical + horizontal splits:
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel │Welcome to #def, another channel │
│12:54:15 peter | hey! │@Flashy│12:55:42 @Flashy | hello world │@Flashy│
│12:55:01 @joe | hello │@joe │12:55:56 alex | hi Flashy │alex │
│ │+weebot│ │ │
│ │peter │ │ │ ◀ window #3
│ │ │ │ │ (buffer #5)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │[12:55] [6] [irc/freenode] 5:#def(+n){2} │
│ │ │[@Flashy] │
│ │ │────────────────────────────────────────────│
│ │ │Welcome to #abc, channel about nothing! │
│ │ │12:55:12 Max | hi │@Flashy│
│ │ │12:55:20 @Flashy | hi Max! │Max │
│ │ │12:55:32 Max | how are you? │ │
│ │ │ │ │
│ │ │ │ │ ◀ window #2
│ │ │ │ │ (buffer #4)
│ │ │ │ │
│ │ │ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4} │ [12:55] [6] [irc/freenode] 4:#abc(+n){2} │
│[@Flashy] hi peter!█ │ [@Flashy] │
└─────────────────────────────────────────────────────────────────────────────────────────┘
▲ window #1
(buffer #3)
........................................
[[notify_levels]]
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="50%",cols="3m,10",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 "freenode":
----------------------------------------
/set weechat.notify.irc.freenode message
----------------------------------------
Set notify level 'highlight' on channel "#weechat" only:
----------------------------------------
/set weechat.notify.irc.freenode.#weechat highlight
----------------------------------------
[[key_bindings]]
Default key bindings
~~~~~~~~~~~~~~~~~~~~

View File

@ -367,28 +367,29 @@ Exemple de terminal avec WeeChat :
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Bienvenue sur #test, canal de test │
│12:52:27 --> | flashy (n=flashcod@hellix.flashtux.org) a rejoint #test │@ChanServ │
│12:52:27 -- | Pseudos #test: [@ChanServ @flashy +_FlashB0t joe mike] │@flashy │
│12:52:27 -- | Canal #test: 5 pseudos (2 ops, 0 halfop, 1 voice, 2 normal) │+_FlashB0t│
│12:52:27 -- | Canal créé le Tue Jan 27 06:30:17 2009 │joe │
│12:54:15 flashy | bonjour ! │mike │
│12:55:01 joe | salut flashy ! │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){5}* [Act: 4:#abc(2,5), 6] │
│[flashy] salut joe !█ │
│Bienvenue sur #test, canal de test │ ◀ barre "title"
│12:52:27 --> | Flashy (flashcode@weechat.org) a rejoint #test │@Flashy│
│12:52:27 -- | Pseudos #test: [@Flashy @joe +weebot] │@joe │
│12:52:27 -- | Canal #test: 4 pseudos (2 ops, 0 halfop, 1 voice, 1 normal) │+weebot│
│12:52:27 -- | Canal créé le Tue Jan 27 06:30:17 2009 │peter │
│12:54:15 peter | bonjour ! │ │
│12:55:01 @joe | salut │ │
│ │ │
│ │ │
│ │ │
│ │ │ ◀ discussion + barre "nicklist"
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4}* [Act: 4:#abc(2,5), 6] │ ◀ barre "status"
│[@Flashy] salut peter !█ │ ◀ barre "input"
└─────────────────────────────────────────────────────────────────────────────────────────┘
........................................
@ -415,7 +416,7 @@ La barre 'status' contient les objets (items) suivants par défaut :
| buffer_plugin | [irc/freenode] | extension du tampon courant (l'extension irc peut afficher le nom du serveur IRC auquel est rattaché ce tampon)
| buffer_number | 3 | numéro du tampon courant
| buffer_name | #test(+n) | nom du tampon courant (avec les modes du canal pour les canaux irc)
| buffer_nicklist_count | {5} | nombre de pseudos dans la liste des pseudos
| buffer_nicklist_count | {4} | nombre de pseudos dans la liste des pseudos
| buffer_filter | * | indicateur de filtrage : `*` signifie que des lignes sont filtrées (cachées), une valeur vide signifie que toutes les lignes sont affichées
| lag | [Lag: 2.5] | indicateur de "lag" (ralentissements réseau), en secondes (caché si le lag est faible)
| hotlist | [Act: 4:#abc(2,5), 6] | liste des tampons où il y a de l'activité (messages non lus) (dans cet exemple, 2 highlights et 5 messages non lus sur '#abc', un message non lu sur le buffer numéro 6)
@ -429,12 +430,168 @@ La barre 'input' contient les objets (items) suivants par défaut :
|========================================
| Objet (item) | Exemple | Description
| input_paste | [Coller 7 lignes ? [ctrl-Y] Oui [ctrl-N] Non] | question à l'utilisateur pour coller des lignes
| input_prompt | [flashy] | prompt (pseudo pour l'extension irc)
| input_prompt | [@Flashy] | prompt (pseudo pour l'extension irc)
| away | (absent) | indicateur d'absence
| input_search | [Recherche texte] | indicateur de recherche de texte
| input_text | salut joe ! | texte entré
| input_text | salut peter ! | texte entré
|========================================
[[buffers_and_windows]]
Tampons et fenêtres
~~~~~~~~~~~~~~~~~~~
Un tampon ('buffer') est composé d'un numéro, un nom, des lignes affichées
(ainsi que d'autres données).
Exemples de tampons :
* tampon core (créé par WeeChat au démarrage, ne peut pas être fermé)
* serveur irc (affiche les messages du serveur)
* canal irc
* privé irc
Une fenêtre ('window') est une zone de l'écran affichant un tampon. Il est
possible de découper l'écran horizontalement ou verticalement en plusieurs
fenêtres.
Chaque fenêtre affiche un tampon. Un tampon peut être caché (affiché par
aucune fenêtre) ou affiché par une ou plusieurs fenêtres.
Exemple de découpage horizontal (`/window splith`) :
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Bienvenue sur #abc, canal sur rien ! │
│12:55:12 Max | bonjour │@Flashy│
│12:55:20 @Flashy | salut Max ! │Max │
│12:55:32 Max | ça va bien ? │ │
│ │ │
│ │ │ ◀ fenêtre n°2
│ │ │ (tampon n°4)
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 4:#abc(+n){2} │
│[@Flashy] │
│─────────────────────────────────────────────────────────────────────────────────────────│
│Bienvenue sur #test, canal de test │
│12:54:15 peter | ohé ! │@Flashy│
│12:55:01 @joe | salut │@joe │
│ │+weebot│
│ │peter │
│ │ │ ◀ fenêtre n°1
│ │ │ (tampon n°3)
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4} │
│[@Flashy] salut peter!█ │
└─────────────────────────────────────────────────────────────────────────────────────────┘
........................................
Exemple de découpage vertical (`/window splitv`) :
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Bienvenue sur #test, canal de test │Bienvenue sur #abc, canal sur rien ! │
│12:54:15 peter | ohé ! │@Flashy│12:55:12 Max | bonjour │@Flashy│
│12:55:01 @joe | salut │@joe │12:55:20 @Flashy | salut Max ! │Max │
│ │+weebot│12:55:32 Max | ça va bien ? │ │
│ │peter │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4} │[12:55] [6] [irc/freenode] 4:#abc(+n){2} │
│[@Flashy] salut peter!█ │[@Flashy] │
└─────────────────────────────────────────────────────────────────────────────────────────┘
▲ fenêtre n°1 ▲ fenêtre n°2
(tampon n°3) (tampon n°4)
........................................
Exemple de découpage vertical + horizontal :
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Bienvenue sur #test, canal de test │Bienvenue sur #def, autre canal │
│12:54:15 peter | ohé ! │@Flashy│12:55:42 @Flashy | salut le monde │@Flashy│
│12:55:01 @joe | salut │@joe │12:55:56 alex | salut Flashy │alex │
│ │+weebot│ │ │
│ │peter │ │ │ ◀ fenêtre n°3
│ │ │ │ │ (tampon n°5)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │[12:55] [6] [irc/freenode] 5:#def(+n){2} │
│ │ │[@Flashy] │
│ │ │────────────────────────────────────────────│
│ │ │Bienvenue sur #abc, canal sur rien ! │
│ │ │12:55:12 Max | bonjour │@Flashy│
│ │ │12:55:20 @Flashy | salut Max ! │Max │
│ │ │12:55:32 Max | ça va bien ? │ │
│ │ │ │ │
│ │ │ │ │ ◀ fenêtre n°2
│ │ │ │ │ (tampon n°4)
│ │ │ │ │
│ │ │ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4} │ [12:55] [6] [irc/freenode] 4:#abc(+n){2} │
│[@Flashy] salut peter !█ │ [@Flashy] │
└─────────────────────────────────────────────────────────────────────────────────────────┘
▲ fenêtre n°1
(tampon n°3)
........................................
[[notify_levels]]
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="50%",cols="3m,10",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 "freenode" :
----------------------------------------
/set weechat.notify.irc.freenode message
----------------------------------------
Définir le niveau de notification 'highlight' sur le canal "#weechat" seulement :
----------------------------------------
/set weechat.notify.irc.freenode.#weechat highlight
----------------------------------------
[[key_bindings]]
Raccourcis clavier par défaut
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

View File

@ -367,28 +367,29 @@ Esempio di terminale con WeeChat:
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Benvenuti in #test, questo è un canale di test │
│12:52:27 --> | flashy (n=flashcod@hellix.flashtux.org) è entrato in #test │@ChanServ │
│12:52:27 -- | Nick #test: [@ChanServ @flashy +_FlashB0t joe mike] │@flashy │
│12:52:27 -- | Canale #test: 5 nick (2 ops, 0 halfop, 1 voce, 2 normale) │+_FlashB0t│
│12:52:27 -- | Canale creato il Tue Jan 27 06:30:17 2009 │joe │
│12:54:15 flashy | ehi! │mike │
│12:55:01 joe | ciao flashy! │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){5}* [Att: 4:#abc(2,5), 6] │
│[flashy] ciao joe!█ │
│Benvenuti in #test, questo è un canale di test │ ◀ barra "title"
│12:52:27 --> | Flashy (flashcode@weechat.org) è entrato in #test │@Flashy│
│12:52:27 -- | Nick #test: [@Flashy @joe +weebot] │@joe │
│12:52:27 -- | Canale #test: 4 nick (2 ops, 0 halfop, 1 voce, 1 normale) │+weebot│
│12:52:27 -- | Canale creato il Tue Jan 27 06:30:17 2009 │peter │
│12:54:15 peter | ehi! │ │
│12:55:01 @joe | ciao │ │
│ │ │
│ │ │
│ │ │
│ │ │ ◀ chat + barra "nicklist"
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4}* [Act: 4:#abc(2,5), 6] │ ◀ barra "status"
│[@Flashy] ciao peter!█ │ ◀ barra "input"
└─────────────────────────────────────────────────────────────────────────────────────────┘
........................................
@ -414,7 +415,7 @@ La barra 'stato' ha i seguenti elementi predefiniti:
| buffer_plugin | [irc/freenode] | plugin del buffer attivo (il plugin irc può aggiungere il nome del server irc usato dal buffer)
| buffer_number | 3 | numero del buffer corrente
| buffer_name | #test(+n) | nome del buffer attivo (con le modalità canale per i canali irc)
| buffer_nicklist_count | {5} | numero di nick nella lista nick
| buffer_nicklist_count | {4} | numero di nick nella lista nick
| buffer_filter | * | indicatore filtraggio: `*` significa che alcune righe sono filtrate (nascoste), valori vuoti indicano che tutte le righe sono visualizzate
| lag | [Ritardo: 2.5] | indicatore ritardo, in secondi (nascosto se il ritardo è basso)
| hotlist | [Att: 4:#abc(2,5), 6] | elenco dei buffer con attività (messaggi non letti) (nell'esempio, 2 eventi e 5 messaggi non letti su #abc, un messaggio non letto sul buffer #6)
@ -428,12 +429,180 @@ La barra 'input' ha i seguenti elementi predefiniti:
|========================================
| Elemento | Esempio | Descrizione
| input_paste | [Incollare 7 righe ? [ctrl-Y] Sì [ctrl-N] No] | chiede all'utente se incollare le righe
| input_prompt | [flashy] | prompt per l'input (nick per il plugin irc)
| input_prompt | [@Flashy] | prompt per l'input (nick per il plugin irc)
| away | (assente) | indicatore di assenza
| input_search | [Ricerca testo] | indicatore di ricerca testo
| input_text | ciao joe! | testo in input
| input_text | ciao peter! | testo in input
|========================================
// TRANSLATION MISSING
[[buffers_and_windows]]
Buffers and windows
~~~~~~~~~~~~~~~~~~~
Un 'buffer' è composto da un numero, un nome, delle righe visualizzate (e
qualche altro dato).
// TRANSLATION MISSING
Examples of buffers:
// TRANSLATION MISSING
* core buffer (created by WeeChat on startup, can not be closed)
* irc server (displays messages from server)
* irc channel
* irc private
Una 'finestra' (o window) è un'aread dello schermo in cui viene visualizzato
un buffer. È possibile dividere lo schermo in più finestre.
Ogni finestra visualizza un buffer. Un buffer può essere nascosto (non visualizzato
da una finestra) o visualizzato da una o più finestre.
// TRANSLATION MISSING
Example of horizontal split (`/window splith`):
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #abc, channel about nothing! │
│12:55:12 Max | hi │@Flashy│
│12:55:20 @Flashy | hi Max! │Max │
│12:55:32 Max | how are you? │ │
│ │ │
│ │ │ ◀ window #2
│ │ │ (buffer #4)
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 4:#abc(+n){2} │
│[@Flashy] │
│─────────────────────────────────────────────────────────────────────────────────────────│
│Welcome to #test, this is a test channel │
│12:54:15 peter | hey! │@Flashy│
│12:55:01 @joe | hello │@joe │
│ │+weebot│
│ │peter │
│ │ │ ◀ window #1
│ │ │ (buffer #3)
│ │ │
│ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4} │
│[@Flashy] hi peter!█ │
└─────────────────────────────────────────────────────────────────────────────────────────┘
........................................
// TRANSLATION MISSING
Example of vertical split (`/window splitv`):
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel │Welcome to #abc, channel about nothing! │
│12:54:15 peter | hey! │@Flashy│12:55:12 Max | hi │@Flashy│
│12:55:01 @joe | hello │@joe │12:55:20 @Flashy | hi Max! │Max │
│ │+weebot│12:55:32 Max | how are you? │ │
│ │peter │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4} │[12:55] [6] [irc/freenode] 4:#abc(+n){2} │
│[@Flashy] hi peter!█ │[@Flashy] │
└─────────────────────────────────────────────────────────────────────────────────────────┘
▲ window #1 ▲ window #2
(buffer #3) (buffer #4)
........................................
// TRANSLATION MISSING
Example of vertical + horizontal splits:
........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel │Welcome to #def, another channel │
│12:54:15 peter | hey! │@Flashy│12:55:42 @Flashy | hello world │@Flashy│
│12:55:01 @joe | hello │@joe │12:55:56 alex | hi Flashy │alex │
│ │+weebot│ │ │
│ │peter │ │ │ ◀ window #3
│ │ │ │ │ (buffer #5)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │[12:55] [6] [irc/freenode] 5:#def(+n){2} │
│ │ │[@Flashy] │
│ │ │────────────────────────────────────────────│
│ │ │Welcome to #abc, channel about nothing! │
│ │ │12:55:12 Max | hi │@Flashy│
│ │ │12:55:20 @Flashy | hi Max! │Max │
│ │ │12:55:32 Max | how are you? │ │
│ │ │ │ │
│ │ │ │ │ ◀ window #2
│ │ │ │ │ (buffer #4)
│ │ │ │ │
│ │ │ │ │
│[12:55] [6] [irc/freenode] 3:#test(+n){4} │ [12:55] [6] [irc/freenode] 4:#abc(+n){2} │
│[@Flashy] hi peter!█ │ [@Flashy] │
└─────────────────────────────────────────────────────────────────────────────────────────┘
▲ window #1
(buffer #3)
........................................
// TRANSLATION MISSING
[[notify_levels]]
Notify levels
~~~~~~~~~~~~~
// TRANSLATION MISSING
Four levels are possible in messages displayed in buffers, from lower to higher:
// TRANSLATION MISSING
* '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
// TRANSLATION MISSING
Each buffer has a notify level, which is used to decide what messages will add
buffer in hotlist.
// TRANSLATION MISSING
The default notify level can be set using option
<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>,
default is 'all'.
// TRANSLATION MISSING
[width="50%",cols="3m,10",options="header"]
|========================================
| Notify level | Level of messages added to hotlist
| none | (none)
| highlight | 'highlight' + 'private'
| message | 'highlight' + 'private' + 'message'
| all | 'highlight' + 'private' + 'message' + 'low'
|========================================
// TRANSLATION MISSING
Notify level can be defined for a set of buffers, for example all buffers for
irc server "freenode":
----------------------------------------
/set weechat.notify.irc.freenode message
----------------------------------------
// TRANSLATION MISSING
Set notify level 'highlight' on channel "#weechat" only:
----------------------------------------
/set weechat.notify.irc.freenode.#weechat highlight
----------------------------------------
[[key_bindings]]
Associazione tasti predefinita
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~