doc: add chapters about highlights and max hotlist level for nicks (user's guide)

v2.8-utf8proc
Sébastien Helleu 2016-11-25 19:54:55 +01:00
parent 1d90d989d3
commit 7fb5691834
6 changed files with 482 additions and 0 deletions

View File

@ -1062,6 +1062,10 @@ natürlich voraus, dass der Terminal das Anwählen von URLs unterstützt).
[[notify_levels]]
=== Benachrichtigungsstufen
// TRANSLATION MISSING
[[setup_notify_levels]]
==== Setup notify levels
Es gibt vier Benachrichtigungsstufen für Nachrichten, welche in Buffern dargestellt
werden. Nachfolgend eine Liste, sortiert von niedrig nach hoch:
@ -1108,6 +1112,82 @@ Befehl festgelegt werden:
/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 autosetbuffer`.
// 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*"
----
[[key_bindings]]
=== Standard Tastenbelegung

View File

@ -1045,6 +1045,9 @@ 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)
@ -1087,6 +1090,80 @@ 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 autosetbuffer`.
[[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*"
----
[[key_bindings]]
=== Default key bindings

View File

@ -1072,6 +1072,10 @@ entendu cela suppose que votre terminal permet le clic sur les URLs).
[[notify_levels]]
=== Niveaux de notification
// TRANSLATION MISSING
[[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 :
@ -1116,6 +1120,87 @@ 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 autosetbuffer`.
[[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*"
----
[[key_bindings]]
=== Raccourcis clavier par défaut

View File

@ -1099,6 +1099,10 @@ 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:
@ -1143,6 +1147,82 @@ Il livello di notifica per un buffer può essere impostato con il comando `/buff
/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 autosetbuffer`.
// 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*"
----
[[key_bindings]]
=== Associazione tasti predefinita

View File

@ -1048,6 +1048,10 @@ WeeChat が以下のような表示状態の場合:
[[notify_levels]]
=== 通知レベル
// TRANSLATION MISSING
[[setup_notify_levels]]
==== Setup notify levels
バッファに表示された各メッセージには 4 つのレベルが設定されています。レベルの低いものから順に:
* _low_: 重要性の低いメッセージ (例えば irc の参加/退出/終了メッセージ)
@ -1089,6 +1093,82 @@ irc サーバ "freenode" に含まれる全てのバッファに対して設定
/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 autosetbuffer`.
// 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*"
----
[[key_bindings]]
=== デフォルトのキー割り当て

View File

@ -1057,6 +1057,10 @@ twój terminal wspiera klikanie w URLe).
[[notify_levels]]
=== Poziomy powiadomień
// TRANSLATION MISSING
[[setup_notify_levels]]
==== Setup notify levels
Dostępne są cztery poziomy dla wiadomości wyświetlanych w buforach, od najniższego
do najwyższego:
@ -1100,6 +1104,82 @@ Poziom powiadomień dla bufora może zostać ustawiony za pomocą komendy `/buff
/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 autosetbuffer`.
// 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*"
----
[[key_bindings]]
=== Domyślne skróty klawiszowe