1
0
mirror of https://github.com/weechat/weechat.git synced 2026-06-25 04:16:38 +02:00

doc: move section "Logger" in "Configuration" (user's guide)

This commit is contained in:
Sébastien Helleu
2021-12-05 14:51:45 +01:00
parent 66384544b5
commit a5ffd8b800
7 changed files with 1135 additions and 1130 deletions
+168 -167
View File
@@ -246,7 +246,7 @@ Liste von häufig verwendeten Optionen:
Unterstützung großer Dateien.
| ENABLE_LOGGER | `ON`, `OFF` | ON |
kompiliert <<logger_plugin,Logger Erweiterung>>.
kompiliert <<buffer_logging,Logger Erweiterung>>.
| ENABLE_LUA | `ON`, `OFF` | ON |
kompiliert <<scripts_plugins,Lua Erweiterung>>.
@@ -2284,6 +2284,173 @@ in der Konfigurationsdatei gesichert. + Um diese Einstellung persistent zu mache
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
[[buffer_logging]]
=== Buffer logging
Die Logger Erweiterung erlaubt es den Inhalt von Buffern in Dateien zu sichern.
Dabei kann man über Optionen Einfluss darauf nehmen was gesichert und wie etwas
gesichert werden soll.
[[logger_log_levels]]
==== Log Levels
Die Protokollierung wird durch einen sogenannten Level für jeden Buffer sichergestellt.
Der Standardlevel ist dabei 9 (damit werden alle Nachrichten die im Buffer angezeigt
werden protokolliert). Der Grad einer Protokollierung kann separat für jeden einzelnen
Buffer oder aber für eine Anzahl von Buffern festgelegt werden.
Mögliche Level sind hierbei 0 bis 9. Null bedeutet, es findet keine Protokollierung
statt und neun, dass alle Nachrichten protokolliert werden.
Erweiterungen nutzen unterschiedliche Level um Nachrichten anzuzeigen.
Die IRC Erweiterung nutzt folgende Level:
* Level 1: Nachrichten eines Users (im Channel oder privat)
* Level 2: Nick wurde geändert (der eigene oder von einer anderen Person)
* Level 3: jedwede Server Nachricht (ausgenommen join/part/quit)
* Level 4: Server Nachrichten join/part/quit
Setzen Sie also den Grad der Protokollierung für einen IRC Channel auf "3"
wird WeeChat alle Nachrichten protokollieren, ausgenommen join/part/quit
Nachrichten.
weitere Beispiele:
* Level 3 für IRC Channel #weechat nutzen:
----
/set logger.level.irc.libera.#weechat 3
----
* Level 3 für libera Server Buffer nutzen:
----
/set logger.level.irc.server.libera 3
----
* Level 3 für alle Channels auf dem Server libera nutzen:
----
/set logger.level.irc.libera 3
----
* Level 2 für alle IRC Buffers nutzen:
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== Dateinamenmaske
Es ist möglich eine Dateinamenmaske für jeden Buffer zu erstellen und diese Maske
mit lokalen Buffervariablen zu füllen. Um sich die verfügbaren lokalen Variablen
für den aktuellen Buffer anzeigen zu lassen:
----
/buffer listvar
----
Masken werden in absteigender Reihenfolge abgeglichen, beginnend mit
`logger.mask.$plugin.*`, dabei fungiert `logger.file.mask` als Fallback-Option.
Zum Beispiel für den Buffer "irc.libera.#weechat". WeeChat sucht in dieser
Reihenfolge nach einer Maske:
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
Dies bedeutet dass man eine Maske speziell für einen IRC Server
("logger.mask.irc.libera") anlegen kann oder aber global für
die Erweiterung ("logger.mask.irc").
[[logger_files_by_date]]
===== Protokolldatei nach Datum
Um Protokolldateien mit einer Datumsrelevanz zu erstellen müssen
Datumsspezifikationen in der Maske genutzt werden (siehe
`man strftime` für das Format). Zum Beispiel:
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
Erstellt eine Struktur in folgender Form:
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== Protokolldateien nach Server und Channel
Soll für jeden IRC Server ein Verzeichnis erstellt werden mit jeweils
einer Protokolldatei für jeden Channel:
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
Erstellt eine Struktur in folgender Form:
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #mychan.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #channel1.weechatlog
│ └── #channel2.weechatlog
...
....
[[logger_commands]]
==== Befehle
include::includes/autogen_user_commands.de.adoc[tag=logger_commands]
[[logger_options]]
==== Optionen
Sektionen in Datei _logger.conf_:
[width="100%",cols="3m,6m,16",options="header"]
|===
| Sektion | Steuerbefehl | Beschreibung
| look | /set logger.look.* | Erscheinungsbild.
| color | /set logger.color.* | Farben.
| file | /set logger.file.* | Optionen für Protokolldateien.
| level | /set logger.level.* | Protokollierungslevel pro Buffer (Optionen können in Sektion hinzugefügt/entfernt werden).
| mask | /set logger.mask.* | Dateinamenmaske pro buffer (Optionen können in Sektion hinzugefügt/entfernt werden).
|===
Optionen:
include::includes/autogen_user_options.de.adoc[tag=logger_options]
[[mouse]]
=== Mausunterstützung
@@ -3713,172 +3880,6 @@ Optionen:
include::includes/autogen_user_options.de.adoc[tag=fifo_options]
[[logger_plugin]]
=== Logger
Die Logger Erweiterung erlaubt es den Inhalt von Buffern in Dateien zu sichern.
Dabei kann man über Optionen Einfluss darauf nehmen was gesichert und wie etwas
gesichert werden soll.
[[logger_log_levels]]
==== Log Levels
Die Protokollierung wird durch einen sogenannten Level für jeden Buffer sichergestellt.
Der Standardlevel ist dabei 9 (damit werden alle Nachrichten die im Buffer angezeigt
werden protokolliert). Der Grad einer Protokollierung kann separat für jeden einzelnen
Buffer oder aber für eine Anzahl von Buffern festgelegt werden.
Mögliche Level sind hierbei 0 bis 9. Null bedeutet, es findet keine Protokollierung
statt und neun, dass alle Nachrichten protokolliert werden.
Erweiterungen nutzen unterschiedliche Level um Nachrichten anzuzeigen.
Die IRC Erweiterung nutzt folgende Level:
* Level 1: Nachrichten eines Users (im Channel oder privat)
* Level 2: Nick wurde geändert (der eigene oder von einer anderen Person)
* Level 3: jedwede Server Nachricht (ausgenommen join/part/quit)
* Level 4: Server Nachrichten join/part/quit
Setzen Sie also den Grad der Protokollierung für einen IRC Channel auf "3"
wird WeeChat alle Nachrichten protokollieren, ausgenommen join/part/quit
Nachrichten.
weitere Beispiele:
* Level 3 für IRC Channel #weechat nutzen:
----
/set logger.level.irc.libera.#weechat 3
----
* Level 3 für libera Server Buffer nutzen:
----
/set logger.level.irc.server.libera 3
----
* Level 3 für alle Channels auf dem Server libera nutzen:
----
/set logger.level.irc.libera 3
----
* Level 2 für alle IRC Buffers nutzen:
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== Dateinamenmaske
Es ist möglich eine Dateinamenmaske für jeden Buffer zu erstellen und diese Maske
mit lokalen Buffervariablen zu füllen. Um sich die verfügbaren lokalen Variablen
für den aktuellen Buffer anzeigen zu lassen:
----
/buffer listvar
----
Masken werden in absteigender Reihenfolge abgeglichen, beginnend mit
`logger.mask.$plugin.*`, dabei fungiert `logger.file.mask` als Fallback-Option.
Zum Beispiel für den Buffer "irc.libera.#weechat". WeeChat sucht in dieser
Reihenfolge nach einer Maske:
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
Dies bedeutet dass man eine Maske speziell für einen IRC Server
("logger.mask.irc.libera") anlegen kann oder aber global für
die Erweiterung ("logger.mask.irc").
[[logger_files_by_date]]
===== Protokolldatei nach Datum
Um Protokolldateien mit einer Datumsrelevanz zu erstellen müssen
Datumsspezifikationen in der Maske genutzt werden (siehe
`man strftime` für das Format). Zum Beispiel:
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
Erstellt eine Struktur in folgender Form:
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== Protokolldateien nach Server und Channel
Soll für jeden IRC Server ein Verzeichnis erstellt werden mit jeweils
einer Protokolldatei für jeden Channel:
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
Erstellt eine Struktur in folgender Form:
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #mychan.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #channel1.weechatlog
│ └── #channel2.weechatlog
...
....
[[logger_commands]]
==== Befehle
include::includes/autogen_user_commands.de.adoc[tag=logger_commands]
[[logger_options]]
==== Optionen
Sektionen in Datei _logger.conf_:
[width="100%",cols="3m,6m,16",options="header"]
|===
| Sektion | Steuerbefehl | Beschreibung
| look | /set logger.look.* | Erscheinungsbild.
| color | /set logger.color.* | Farben.
| file | /set logger.file.* | Optionen für Protokolldateien.
| level | /set logger.level.* | Protokollierungslevel pro Buffer (Optionen können in Sektion hinzugefügt/entfernt werden).
| mask | /set logger.mask.* | Dateinamenmaske pro buffer (Optionen können in Sektion hinzugefügt/entfernt werden).
|===
Optionen:
include::includes/autogen_user_options.de.adoc[tag=logger_options]
[[relay_plugin]]
=== Relay
+160 -160
View File
@@ -238,7 +238,7 @@ List of commonly used options:
Support of large files.
| ENABLE_LOGGER | `ON`, `OFF` | ON |
Compile <<logger_plugin,Logger plugin>>.
Compile <<buffer_logging,Logger plugin>>.
| ENABLE_LUA | `ON`, `OFF` | ON |
Compile <<scripts_plugins,Lua plugin>>.
@@ -2224,6 +2224,165 @@ 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+`.
[[buffer_logging]]
=== Buffer logging
The Logger plugin lets you save content of buffers to files, with options
about what and how it is saved.
[[logger_log_levels]]
==== Log levels
Logging is made with a level for each buffer. Default level is 9 (log
all messages displayed on buffer).
You can change level for one buffer, or a group of buffers.
Possible levels are 0 to 9. Zero means "do not log anything" and 9 means
"log all messages".
Plugins are using different levels for messages displayed.
IRC plugin uses following levels:
* level 1: message from user (on channel or private)
* level 2: nick change (you or someone else)
* level 3: any server message (except join/part/quit)
* level 4: server message join/part/quit
So if you set level 3 for an IRC channel, WeeChat will log all messages,
but not join/part/quit.
Some examples:
* Set level 3 for IRC channel #weechat:
----
/set logger.level.irc.libera.#weechat 3
----
* Set level 3 for libera server buffer:
----
/set logger.level.irc.server.libera 3
----
* Set level 3 for all channels on server libera:
----
/set logger.level.irc.libera 3
----
* Set level 2 for all IRC buffers:
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== Filenames masks
It is possible to define a filename mask for each buffer, and use local buffer
variables to build filename. To see available local variables for current buffer:
----
/buffer listvar
----
Masks will be matched on options in descending order of specificity on
`logger.mask.$plugin.*`, with `logger.file.mask` as fallback option.
For example, on buffer "irc.libera.#weechat", WeeChat will search a mask with
option name, in this order:
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
That means you can have masks specific for some IRC servers
("logger.mask.irc.libera") or for a plugin ("logger.mask.irc").
[[logger_files_by_date]]
===== Log files by date
To have log files by date, you can use date/time specifiers in mask (see
`man strftime` for formats), for example:
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
You'll have following files:
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== IRC log files by server and channel
If you want one directory by IRC server and one file by channel inside:
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
You'll have following files:
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #mychan.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #channel1.weechatlog
│ └── #channel2.weechatlog
...
....
[[logger_commands]]
==== Commands
include::includes/autogen_user_commands.en.adoc[tag=logger_commands]
[[logger_options]]
==== Options
Sections in file _logger.conf_:
[width="100%",cols="3m,6m,16",options="header"]
|===
| Section | Control command | Description
| look | /set logger.look.* | Look and feel.
| color | /set logger.color.* | Colors.
| file | /set logger.file.* | Options for log files.
| level | /set logger.level.* | Log level by buffer (options can be added/removed in section).
| mask | /set logger.mask.* | Filename mask by buffer (options can be added/removed in section).
|===
Options:
include::includes/autogen_user_options.en.adoc[tag=logger_options]
[[mouse]]
=== Mouse support
@@ -3612,165 +3771,6 @@ Options:
include::includes/autogen_user_options.en.adoc[tag=fifo_options]
[[logger_plugin]]
=== Logger
The Logger plugin lets you save content of buffers to files, with options
about what and how it is saved.
[[logger_log_levels]]
==== Log levels
Logging is made with a level for each buffer. Default level is 9 (log
all messages displayed on buffer).
You can change level for one buffer, or a group of buffers.
Possible levels are 0 to 9. Zero means "do not log anything" and 9 means
"log all messages".
Plugins are using different levels for messages displayed.
IRC plugin uses following levels:
* level 1: message from user (on channel or private)
* level 2: nick change (you or someone else)
* level 3: any server message (except join/part/quit)
* level 4: server message join/part/quit
So if you set level 3 for an IRC channel, WeeChat will log all messages,
but not join/part/quit.
Some examples:
* Set level 3 for IRC channel #weechat:
----
/set logger.level.irc.libera.#weechat 3
----
* Set level 3 for libera server buffer:
----
/set logger.level.irc.server.libera 3
----
* Set level 3 for all channels on server libera:
----
/set logger.level.irc.libera 3
----
* Set level 2 for all IRC buffers:
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== Filenames masks
It is possible to define a filename mask for each buffer, and use local buffer
variables to build filename. To see available local variables for current buffer:
----
/buffer listvar
----
Masks will be matched on options in descending order of specificity on
`logger.mask.$plugin.*`, with `logger.file.mask` as fallback option.
For example, on buffer "irc.libera.#weechat", WeeChat will search a mask with
option name, in this order:
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
That means you can have masks specific for some IRC servers
("logger.mask.irc.libera") or for a plugin ("logger.mask.irc").
[[logger_files_by_date]]
===== Log files by date
To have log files by date, you can use date/time specifiers in mask (see
`man strftime` for formats), for example:
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
You'll have following files:
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== IRC log files by server and channel
If you want one directory by IRC server and one file by channel inside:
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
You'll have following files:
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #mychan.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #channel1.weechatlog
│ └── #channel2.weechatlog
...
....
[[logger_commands]]
==== Commands
include::includes/autogen_user_commands.en.adoc[tag=logger_commands]
[[logger_options]]
==== Options
Sections in file _logger.conf_:
[width="100%",cols="3m,6m,16",options="header"]
|===
| Section | Control command | Description
| look | /set logger.look.* | Look and feel.
| color | /set logger.color.* | Colors.
| file | /set logger.file.* | Options for log files.
| level | /set logger.level.* | Log level by buffer (options can be added/removed in section).
| mask | /set logger.mask.* | Filename mask by buffer (options can be added/removed in section).
|===
Options:
include::includes/autogen_user_options.en.adoc[tag=logger_options]
[[relay_plugin]]
=== Relay
+162 -162
View File
@@ -242,7 +242,7 @@ Liste des options couramment utilisées :
Support des gros fichiers.
| ENABLE_LOGGER | `ON`, `OFF` | ON |
Compiler <<logger_plugin,l'extension Logger>>.
Compiler <<buffer_logging,l'extension Logger>>.
| ENABLE_LUA | `ON`, `OFF` | ON |
Compiler <<scripts_plugins,l'extension Lua>>.
@@ -2292,6 +2292,167 @@ 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+`.
[[buffer_logging]]
=== Enregistrement des tampons
L'extension Logger permet de sauvegarder le contenu des tampons dans des
fichiers, avec des options sur comment et quoi sauvegarder.
[[logger_log_levels]]
==== Niveaux d'enregistrement
L'enregistrement est fait selon un niveau pour chaque tampon. Le niveau par
défaut est 9 (enregistrer tous les messages affichés dans le tampon).
Vous pouvez changer ce niveau pour un tampon, ou un groupe de tampons.
Les niveaux possibles vont de 0 à 9. Zéro signifie "ne rien enregistrer" et 9
signifie "enregistrer tous les messages".
Les extensions utilisent différent niveaux pour les messages affichés.
L'extension IRC utilise les niveaux suivants :
* niveau 1 : message d'un utilisateur (sur un canal ou en privé)
* niveau 2 : changement de pseudo (vous ou quelqu'un d'autre)
* niveau 3 : tout message du serveur (sauf join/part/quit)
* niveau 4 : message join/part/quit du serveur
Donc si vous affectez le niveau 3 pour un canal IRC, WeeChat enregistrera
tous les messages sauf les join/part/quit.
Quelques exemples :
* Affecter le niveau 3 pour le canal IRC #weechat :
----
/set logger.level.irc.libera.#weechat 3
----
* Affecter le niveau 3 pour le tampon serveur libera :
----
/set logger.level.irc.server.libera 3
----
* Affecter le niveau 3 pour tous les canaux sur le serveur libera :
----
/set logger.level.irc.libera 3
----
* Affecter le niveau 2 pour tous les tampons IRC :
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== Masques de noms de fichiers
Il est possible de définir un masque de nom de fichier pour chaque tampon, et
d'utiliser les variables locales du tampon pour construire le nom de fichier.
Pour voir les variables disponibles sur le tampon courant :
----
/buffer listvar
----
Les masques seront utilisés par ordre de priorité descendante sur
`logger.mask.$plugin.*`, avec `logger.file.mask` comme option par défaut.
Par exemple, sur le tampon "irc.libera.#weechat", WeeChat cherchera un masque
avec le nom de l'option, dans cet ordre :
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
Cela signifie que vous pouvez avoir un masque spécifique pour certaines
serveurs IRC ("logger.mask.irc.libera") ou pour une extension
("logger.mask.irc").
[[logger_files_by_date]]
===== Fichiers de log par date
Pour avoir des fichiers de log par date, vous pouvez utiliser des marqueurs
dans le masque (voir `man strftime` pour le format), par exemple :
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
Vous obtiendrez les fichiers suivants :
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== Fichiers de log IRC par serveur et canal
Si vous voulez un répertoire par serveur IRC et un fichier par canal dedans :
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
Vous obtiendrez les fichiers suivants :
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #moncanal.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #canal1.weechatlog
│ └── #canal2.weechatlog
...
....
[[logger_commands]]
==== Commandes
include::includes/autogen_user_commands.fr.adoc[tag=logger_commands]
[[logger_options]]
==== Options
Sections dans le fichier _logger.conf_ :
[width="100%",cols="3m,6m,16",options="header"]
|===
| Section | Commande de contrôle | Description
| look | /set logger.look.* | Aspect/présentation.
| color | /set logger.color.* | Couleurs.
| file | /set logger.file.* | Options pour les fichiers de log.
| level | /set logger.level.* | Niveau de log par tampon (les options peuvent être ajoutées/supprimées dans la section).
| mask | /set logger.mask.* | Masque de nom de fichier par tampon (les options peuvent être ajoutées/supprimées dans la section).
|===
Options :
include::includes/autogen_user_options.fr.adoc[tag=logger_options]
[[mouse]]
=== Support souris
@@ -3730,167 +3891,6 @@ Options :
include::includes/autogen_user_options.fr.adoc[tag=fifo_options]
[[logger_plugin]]
=== Logger
L'extension Logger permet de sauvegarder le contenu des tampons dans des
fichiers, avec des options sur comment et quoi sauvegarder.
[[logger_log_levels]]
==== Niveaux d'enregistrement
L'enregistrement est fait selon un niveau pour chaque tampon. Le niveau par
défaut est 9 (enregistrer tous les messages affichés dans le tampon).
Vous pouvez changer ce niveau pour un tampon, ou un groupe de tampons.
Les niveaux possibles vont de 0 à 9. Zéro signifie "ne rien enregistrer" et 9
signifie "enregistrer tous les messages".
Les extensions utilisent différent niveaux pour les messages affichés.
L'extension IRC utilise les niveaux suivants :
* niveau 1 : message d'un utilisateur (sur un canal ou en privé)
* niveau 2 : changement de pseudo (vous ou quelqu'un d'autre)
* niveau 3 : tout message du serveur (sauf join/part/quit)
* niveau 4 : message join/part/quit du serveur
Donc si vous affectez le niveau 3 pour un canal IRC, WeeChat enregistrera
tous les messages sauf les join/part/quit.
Quelques exemples :
* Affecter le niveau 3 pour le canal IRC #weechat :
----
/set logger.level.irc.libera.#weechat 3
----
* Affecter le niveau 3 pour le tampon serveur libera :
----
/set logger.level.irc.server.libera 3
----
* Affecter le niveau 3 pour tous les canaux sur le serveur libera :
----
/set logger.level.irc.libera 3
----
* Affecter le niveau 2 pour tous les tampons IRC :
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== Masques de noms de fichiers
Il est possible de définir un masque de nom de fichier pour chaque tampon, et
d'utiliser les variables locales du tampon pour construire le nom de fichier.
Pour voir les variables disponibles sur le tampon courant :
----
/buffer listvar
----
Les masques seront utilisés par ordre de priorité descendante sur
`logger.mask.$plugin.*`, avec `logger.file.mask` comme option par défaut.
Par exemple, sur le tampon "irc.libera.#weechat", WeeChat cherchera un masque
avec le nom de l'option, dans cet ordre :
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
Cela signifie que vous pouvez avoir un masque spécifique pour certaines
serveurs IRC ("logger.mask.irc.libera") ou pour une extension
("logger.mask.irc").
[[logger_files_by_date]]
===== Fichiers de log par date
Pour avoir des fichiers de log par date, vous pouvez utiliser des marqueurs
dans le masque (voir `man strftime` pour le format), par exemple :
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
Vous obtiendrez les fichiers suivants :
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== Fichiers de log IRC par serveur et canal
Si vous voulez un répertoire par serveur IRC et un fichier par canal dedans :
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
Vous obtiendrez les fichiers suivants :
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #moncanal.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #canal1.weechatlog
│ └── #canal2.weechatlog
...
....
[[logger_commands]]
==== Commandes
include::includes/autogen_user_commands.fr.adoc[tag=logger_commands]
[[logger_options]]
==== Options
Sections dans le fichier _logger.conf_ :
[width="100%",cols="3m,6m,16",options="header"]
|===
| Section | Commande de contrôle | Description
| look | /set logger.look.* | Aspect/présentation.
| color | /set logger.color.* | Couleurs.
| file | /set logger.file.* | Options pour les fichiers de log.
| level | /set logger.level.* | Niveau de log par tampon (les options peuvent être ajoutées/supprimées dans la section).
| mask | /set logger.mask.* | Masque de nom de fichier par tampon (les options peuvent être ajoutées/supprimées dans la section).
|===
Options :
include::includes/autogen_user_options.fr.adoc[tag=logger_options]
[[relay_plugin]]
=== Relay
+168 -167
View File
@@ -276,7 +276,7 @@ List of commonly used options:
Support of large files.
| ENABLE_LOGGER | `ON`, `OFF` | ON |
Compile <<logger_plugin,Logger plugin>>.
Compile <<buffer_logging,Logger plugin>>.
| ENABLE_LUA | `ON`, `OFF` | ON |
Compile <<scripts_plugins,Lua plugin>>.
@@ -2427,6 +2427,173 @@ 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+`.
// TRANSLATION MISSING
[[buffer_logging]]
=== Buffer logging
Il plugin Logger consente di salvare il contenuto dei buffer su file, con
opzioni a proposito su cosa e come viene salvato.
[[logger_log_levels]]
==== Livelli di log
Il logging viene effettuato con un livello per ogni buffer. Il livello
predefinito è il 9 (registra tutti i messaggi visualizzati sul buffer).
È possibile cambiare il livello per un buffer, oppure per un gruppo di buffer.
I livelli possibili sono da 0 a 9. Zero vuol dire "non registrare nulla" mentre
9 "registra tutto".
I plugin utilizzano livelli diversi per i messaggi visualizzati.
Il plugin IRC usa i seguenti livelli:
* livello 1: messaggio da un utente (su canale o privato)
* livello 2: cambio nick (proprio o di qualcun altro)
* livello 3: ogni messaggio del server (esclui entrata/uscita/disconnessione)
* livello 4: messaggio del server entrata/uscita/disconnessione
Se viene impostato il livello 3 per un canale IRC, WeeChat registrerà
tutti i messaggi, ma non quelli di entrata/uscita/disconnessione.
Alcuni esempi:
* imposta il livello 3 per il canale IRC #weechat:
----
/set logger.level.irc.libera.#weechat 3
----
* set level 3 for libera server buffer:
----
/set logger.level.irc.server.libera 3
----
* imposta il livello 3 per tutti i canali sul server libera:
----
/set logger.level.irc.libera 3
----
* imposta il livello 2 per tutti i buffer IRC:
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== Mask per il nome file
// TRANSLATION MISSING
È possibile definire un mask per il nome del file di ogni buffer, ed utilizzare
le variabili buffer locali per costruire il nome del file. To see available
local variables for current buffer:
----
/buffer listvar
----
// TRANSLATION MISSING
Masks will be matched on options in descending order of specificity on
`logger.mask.$plugin.*`, with `logger.file.mask` as fallback option.
Ad esempio, sul buffer "irc.libera.#weechat", WeeChat cercherà un mask con il
nome dell'opzione, in quest'ordine:
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
Ciò vuol dire che si hanno dei mask specifici per alcuni server
IRC ("logger.mask.irc.libera") o per un plugin ("logger.mask.irc").
[[logger_files_by_date]]
===== File di log per data
Per avere file di log per data, è possibile usare specificatori data/ora
nei mask (consultare `man stfrtime` per i formati), ad esempio:
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
Si avranno i seguenti file:
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== File di log IRC per server e canale
Se si desidera avere una directory per il server IRC ed una per il canale
al suo interno:
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
Si avranno i seguenti file:
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #mychan.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #channel1.weechatlog
│ └── #channel2.weechatlog
...
....
[[logger_commands]]
==== Comandi
include::includes/autogen_user_commands.it.adoc[tag=logger_commands]
[[logger_options]]
==== Opzioni
// TRANSLATION MISSING
Sections in file _logger.conf_:
// TRANSLATION MISSING
[width="100%",cols="3m,6m,16",options="header"]
|===
| Section | Control command | Description
| look | /set logger.look.* | Look and feel.
| color | /set logger.color.* | Colors.
| file | /set logger.file.* | Options for log files.
| level | /set logger.level.* | Log level by buffer (options can be added/removed in section).
| mask | /set logger.mask.* | Filename mask by buffer (options can be added/removed in section).
|===
// TRANSLATION MISSING
Options:
include::includes/autogen_user_options.it.adoc[tag=logger_options]
[[mouse]]
=== Supporto del mouse
@@ -3906,172 +4073,6 @@ Options:
include::includes/autogen_user_options.it.adoc[tag=fifo_options]
[[logger_plugin]]
=== Logger
Il plugin Logger consente di salvare il contenuto dei buffer su file, con
opzioni a proposito su cosa e come viene salvato.
[[logger_log_levels]]
==== Livelli di log
Il logging viene effettuato con un livello per ogni buffer. Il livello
predefinito è il 9 (registra tutti i messaggi visualizzati sul buffer).
È possibile cambiare il livello per un buffer, oppure per un gruppo di buffer.
I livelli possibili sono da 0 a 9. Zero vuol dire "non registrare nulla" mentre
9 "registra tutto".
I plugin utilizzano livelli diversi per i messaggi visualizzati.
Il plugin IRC usa i seguenti livelli:
* livello 1: messaggio da un utente (su canale o privato)
* livello 2: cambio nick (proprio o di qualcun altro)
* livello 3: ogni messaggio del server (esclui entrata/uscita/disconnessione)
* livello 4: messaggio del server entrata/uscita/disconnessione
Se viene impostato il livello 3 per un canale IRC, WeeChat registrerà
tutti i messaggi, ma non quelli di entrata/uscita/disconnessione.
Alcuni esempi:
* imposta il livello 3 per il canale IRC #weechat:
----
/set logger.level.irc.libera.#weechat 3
----
* set level 3 for libera server buffer:
----
/set logger.level.irc.server.libera 3
----
* imposta il livello 3 per tutti i canali sul server libera:
----
/set logger.level.irc.libera 3
----
* imposta il livello 2 per tutti i buffer IRC:
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== Mask per il nome file
// TRANSLATION MISSING
È possibile definire un mask per il nome del file di ogni buffer, ed utilizzare
le variabili buffer locali per costruire il nome del file. To see available
local variables for current buffer:
----
/buffer listvar
----
// TRANSLATION MISSING
Masks will be matched on options in descending order of specificity on
`logger.mask.$plugin.*`, with `logger.file.mask` as fallback option.
Ad esempio, sul buffer "irc.libera.#weechat", WeeChat cercherà un mask con il
nome dell'opzione, in quest'ordine:
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
Ciò vuol dire che si hanno dei mask specifici per alcuni server
IRC ("logger.mask.irc.libera") o per un plugin ("logger.mask.irc").
[[logger_files_by_date]]
===== File di log per data
Per avere file di log per data, è possibile usare specificatori data/ora
nei mask (consultare `man stfrtime` per i formati), ad esempio:
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
Si avranno i seguenti file:
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== File di log IRC per server e canale
Se si desidera avere una directory per il server IRC ed una per il canale
al suo interno:
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
Si avranno i seguenti file:
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #mychan.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #channel1.weechatlog
│ └── #channel2.weechatlog
...
....
[[logger_commands]]
==== Comandi
include::includes/autogen_user_commands.it.adoc[tag=logger_commands]
[[logger_options]]
==== Opzioni
// TRANSLATION MISSING
Sections in file _logger.conf_:
// TRANSLATION MISSING
[width="100%",cols="3m,6m,16",options="header"]
|===
| Section | Control command | Description
| look | /set logger.look.* | Look and feel.
| color | /set logger.color.* | Colors.
| file | /set logger.file.* | Options for log files.
| level | /set logger.level.* | Log level by buffer (options can be added/removed in section).
| mask | /set logger.mask.* | Filename mask by buffer (options can be added/removed in section).
|===
// TRANSLATION MISSING
Options:
include::includes/autogen_user_options.it.adoc[tag=logger_options]
[[relay_plugin]]
=== Relay
+163 -162
View File
@@ -248,7 +248,7 @@ CMake に対するオプションを指定するには、以下の書式を使
巨大ファイルのサポート。
| ENABLE_LOGGER | `ON`, `OFF` | ON |
<<logger_plugin,Logger プラグイン>>のコンパイル。
<<buffer_logging,Logger プラグイン>>のコンパイル。
| ENABLE_LUA | `ON`, `OFF` | ON |
<<scripts_plugins,Lua プラグイン>>のコンパイル。
@@ -2326,6 +2326,168 @@ irc サーバ "libera" に含まれる全てのバッファに対して設定す
これを保存するには _buffer_autoset.py_ スクリプトを使ってください: このスクリプトをインストールするには
`+/script install buffer_autoset.py+` コマンドを使い、ヘルプを見るには `+/help buffer_autoset+` コマンドを使ってください。
// TRANSLATION MISSING
[[buffer_logging]]
=== Buffer logging
Logger
プラグインを使うことで、バッファの内容をファイルに保存できます。保存形式とその方法をオプションで設定できます。
[[logger_log_levels]]
==== ログレベル
ログ保存はそれぞれのバッファに対して設定されたログレベルに従って行われます。デフォルトのレベルは
9 (バッファに表示されたメッセージをすべて保存)
です。特定のバッファやバッファグループに対して個別にログレベルを設定できます。
設定可能なレベルは 0 から 9 です。0 は "保存しない"、9
は「すべてのメッセージを保存」を意味します。
それぞれのプラグインでレベルの意味が変わります。IRC
プラグインに対しては以下のレベルが利用されます:
* レベル 1: ユーザからのメッセージ (チャンネルまたはプライベート)
* レベル 2: ニックネームの変更 (自身と他のユーザ)
* レベル 3: 任意のサーバメッセージ (参加/退出/終了メッセージを除く)
* レベル 4: 参加/退出/終了メッセージ
従って、IRC チャンネルに対してレベル 3 を設定した場合、WeeChat
は参加/退出/終了メッセージを除いて全てのメッセージを保存します。
例:
* IRC チャンネル #weechat に対してレベル 3 を設定:
----
/set logger.level.irc.libera.#weechat 3
----
* libera サーババッファに対してレベル 3 を設定:
----
/set logger.level.irc.server.libera 3
----
* libera サーバの全てのチャンネルに対してレベル 3 を設定:
----
/set logger.level.irc.libera 3
----
* 全ての IRC バッファに対してレベル 2 を設定:
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== ファイル名マスク
// TRANSLATION MISSING
It is possible to define a filename mask for each buffer, and use local buffer
variables to build filename. To see available local variables for current buffer:
----
/buffer listvar
----
// TRANSLATION MISSING
Masks will be matched on options in descending order of specificity on
`logger.mask.$plugin.*`, with `logger.file.mask` as fallback option.
例えば "irc.libera.#weechat" バッファの場合、WeeChat
は以下の順番でオプションに設定されたファイル名マスクを検索します:
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
特定の IRC サーバ ("logger.mask.irc.libera") またはプラグイン
("logger.mask.irc") のグループに対して共通のマスクを適用できます。
[[logger_files_by_date]]
===== ログファイルに日付を利用する
ログファイルに日付を使うには、マスクに日時/時間指定子を利用できます
(書式に関しては `man strftime` を参照してください)。例えば:
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
以下のファイルが作成されます:
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== IRC ログファイルにサーバとチャンネル名を利用する
IRC サーバ名を使ったディレクトリに、チャンネル名を使ったファイルを作成する場合:
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
以下のファイルが作成されます:
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #mychan.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #channel1.weechatlog
│ └── #channel2.weechatlog
...
....
[[logger_commands]]
==== コマンド
include::includes/autogen_user_commands.ja.adoc[tag=logger_commands]
[[logger_options]]
==== オプション
_logger.conf_ ファイル内のセクション:
[width="100%",cols="3m,6m,16",options="header"]
|===
| セクション | 操作コマンド | 説明
| look | /set logger.look.* | 外観
| color | /set logger.color.* | 色
| file | /set logger.file.* | ログファイルのオプション
| level | /set logger.level.* | バッファのログレベル (オプションをセクションに追加/削除出来ます)
| mask | /set logger.mask.* | バッファのファイル名マスク (オプションをセクションに追加/削除出来ます)
|===
オプション:
include::includes/autogen_user_options.ja.adoc[tag=logger_options]
[[mouse]]
=== マウスサポート
@@ -3737,167 +3899,6 @@ _fifo.conf_ ファイル内のセクション:
include::includes/autogen_user_options.ja.adoc[tag=fifo_options]
[[logger_plugin]]
=== Logger
Logger
プラグインを使うことで、バッファの内容をファイルに保存できます。保存形式とその方法をオプションで設定できます。
[[logger_log_levels]]
==== ログレベル
ログ保存はそれぞれのバッファに対して設定されたログレベルに従って行われます。デフォルトのレベルは
9 (バッファに表示されたメッセージをすべて保存)
です。特定のバッファやバッファグループに対して個別にログレベルを設定できます。
設定可能なレベルは 0 から 9 です。0 は "保存しない"、9
は「すべてのメッセージを保存」を意味します。
それぞれのプラグインでレベルの意味が変わります。IRC
プラグインに対しては以下のレベルが利用されます:
* レベル 1: ユーザからのメッセージ (チャンネルまたはプライベート)
* レベル 2: ニックネームの変更 (自身と他のユーザ)
* レベル 3: 任意のサーバメッセージ (参加/退出/終了メッセージを除く)
* レベル 4: 参加/退出/終了メッセージ
従って、IRC チャンネルに対してレベル 3 を設定した場合、WeeChat
は参加/退出/終了メッセージを除いて全てのメッセージを保存します。
例:
* IRC チャンネル #weechat に対してレベル 3 を設定:
----
/set logger.level.irc.libera.#weechat 3
----
* libera サーババッファに対してレベル 3 を設定:
----
/set logger.level.irc.server.libera 3
----
* libera サーバの全てのチャンネルに対してレベル 3 を設定:
----
/set logger.level.irc.libera 3
----
* 全ての IRC バッファに対してレベル 2 を設定:
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== ファイル名マスク
// TRANSLATION MISSING
It is possible to define a filename mask for each buffer, and use local buffer
variables to build filename. To see available local variables for current buffer:
----
/buffer listvar
----
// TRANSLATION MISSING
Masks will be matched on options in descending order of specificity on
`logger.mask.$plugin.*`, with `logger.file.mask` as fallback option.
例えば "irc.libera.#weechat" バッファの場合、WeeChat
は以下の順番でオプションに設定されたファイル名マスクを検索します:
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
特定の IRC サーバ ("logger.mask.irc.libera") またはプラグイン
("logger.mask.irc") のグループに対して共通のマスクを適用できます。
[[logger_files_by_date]]
===== ログファイルに日付を利用する
ログファイルに日付を使うには、マスクに日時/時間指定子を利用できます
(書式に関しては `man strftime` を参照してください)。例えば:
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
以下のファイルが作成されます:
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== IRC ログファイルにサーバとチャンネル名を利用する
IRC サーバ名を使ったディレクトリに、チャンネル名を使ったファイルを作成する場合:
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
以下のファイルが作成されます:
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #mychan.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #channel1.weechatlog
│ └── #channel2.weechatlog
...
....
[[logger_commands]]
==== コマンド
include::includes/autogen_user_commands.ja.adoc[tag=logger_commands]
[[logger_options]]
==== オプション
_logger.conf_ ファイル内のセクション:
[width="100%",cols="3m,6m,16",options="header"]
|===
| セクション | 操作コマンド | 説明
| look | /set logger.look.* | 外観
| color | /set logger.color.* | 色
| file | /set logger.file.* | ログファイルのオプション
| level | /set logger.level.* | バッファのログレベル (オプションをセクションに追加/削除出来ます)
| mask | /set logger.mask.* | バッファのファイル名マスク (オプションをセクションに追加/削除出来ます)
|===
オプション:
include::includes/autogen_user_options.ja.adoc[tag=logger_options]
[[relay_plugin]]
=== Relay
+164 -163
View File
@@ -244,7 +244,7 @@ Lista popularnych opcji:
Wsparcie dla dużych plików.
| ENABLE_LOGGER | `ON`, `OFF` | ON |
Kompilacja <<logger_plugin,wtyczki logger>>.
Kompilacja <<buffer_logging,wtyczki logger>>.
| ENABLE_LUA | `ON`, `OFF` | ON |
Kompilacja <<scripts_plugins,wtyczki lua>>.
@@ -2265,6 +2265,169 @@ 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
[[buffer_logging]]
=== Buffer logging
Wtyczka logger pozwala zapisywać zawartość bufora do pliku, oraz wybrać co i jak
ma być zapisywane.
[[logger_log_levels]]
==== Poziomy logowania
Logowanie odbywa się dla odpowiedniego poziomu dla każdego bufora. Domyślny
poziom to 9 (logowane są wszystkie wiadomości wyświetlane w buforze).
Możesz zmienić poziom dla pojedynczego bufora lub grupy buforów.
Dostępne są poziomy od 0 do 9. Zero oznacza "nic nie loguj", a 9 oznacza "loguj
wszystko".
Wtyczki wykorzystują różne poziomy dla wyświetlanych wiadomości.
Wtyczka IRC używa następujących:
* poziom 1: wiadomość od użytkownika (na kanale lub prywatnie)
* poziom 2: zmiana nicka (twojego lub innego)
* poziom 3: dowolna wiadomość serwera (poza wejściem/opuszczeniem/wyjściem z kanału)
* poziom 4: wiadomości serwera o wejściu/opuszczeniu/wyjściu z kanału
Zatem jeśli ustawisz poziom 3 dla kanału IRC, WeeChat będzie logować wszystkie
wiadomości, poza tymi o wejściu/opuszczeniu/wyjściu z kanału.
Kilka przykładów:
* ustawienie poziomu 3 dla kanału IRC #weechat:
----
/set logger.level.irc.libera.#weechat 3
----
* ustawienie poziomu 3 dla buforu serwera libera:
----
/set logger.level.irc.server.libera 3
----
* ustawienie poziomu 3 dla wszystkich kanałów na serwerze libera:
----
/set logger.level.irc.libera 3
----
* ustawienie poziomu 2 dla wszystkich buforów IRC:
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== Maski dla nazw plików
Możliwe jest zdefiniowanie maski dla nazwy pliku z logiem dla każdego bufora i
użycie do tego zmiennych lokalnych bufora. W celu wyświetlenia listy dostępnych
zmiennych dla bufora wykonaj:
----
/buffer listvar
----
Maski zostaną dopasowane do opcji w kolejności malejącej specyficznie dla
`logger.mask.$plugin.*`, z `logger.file.mask` jako opcją zapasową.
Na przykład, w buforze "irc.libera.#weechat", WeeChat będzie szukał maski dla
nazwy w takiej kolejności:
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
Oznacza to, że można mieć maski specyficzne tylko dla niektórych serwerów IRC
("logger.mask.irc.libera") lub dla wtyczek ("logger.mask.irc").
[[logger_files_by_date]]
===== Pliki z logami uporządkowane według daty
Żeby mieć pliki z logami uporządkowane według daty, możesz użyć specyfikatorów
daty/czasu w masce (obsługiwane formaty można znaleźć w `man strftime`),
na przykład:
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
Spowoduje powstanie następującej struktury:
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== Pliki z logami IRC uporządkowane według serwera i daty
Jeśli chcesz mieć oddzielne katalogi dla serwerów IRC z oddzielnym plikiem dla
każdego kanału:
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
Spowoduje powstanie następującej struktury:
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #mychan.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #channel1.weechatlog
│ └── #channel2.weechatlog
...
....
[[logger_commands]]
==== Komendy
include::includes/autogen_user_commands.pl.adoc[tag=logger_commands]
[[logger_options]]
==== Opcje
Sekcje w pliku _logger.conf_:
[width="100%",cols="3m,6m,16",options="header"]
|===
| Sekcja | Komenda | Opis
| look | /set logger.look.* | Wygląd.
| color | /set logger.color.* | Kolory.
| file | /set logger.file.* | Opcje dla plików z logami.
| level | /set logger.level.* | Poziomy logowania dla buforów (opcje w tej sekcji mogą być dodawane/usuwane).
| mask | /set logger.mask.* | Maski dla nazw plików dla buforów (opcje w tej sekcji mogą być dodawane/usuwane).
|===
Opcje:
include::includes/autogen_user_options.pl.adoc[tag=logger_options]
[[mouse]]
=== Wsparcie myszy
@@ -3669,168 +3832,6 @@ Opcje:
include::includes/autogen_user_options.pl.adoc[tag=fifo_options]
[[logger_plugin]]
=== Logger
Wtyczka logger pozwala zapisywać zawartość bufora do pliku, oraz wybrać co i jak
ma być zapisywane.
[[logger_log_levels]]
==== Poziomy logowania
Logowanie odbywa się dla odpowiedniego poziomu dla każdego bufora. Domyślny
poziom to 9 (logowane są wszystkie wiadomości wyświetlane w buforze).
Możesz zmienić poziom dla pojedynczego bufora lub grupy buforów.
Dostępne są poziomy od 0 do 9. Zero oznacza "nic nie loguj", a 9 oznacza "loguj
wszystko".
Wtyczki wykorzystują różne poziomy dla wyświetlanych wiadomości.
Wtyczka IRC używa następujących:
* poziom 1: wiadomość od użytkownika (na kanale lub prywatnie)
* poziom 2: zmiana nicka (twojego lub innego)
* poziom 3: dowolna wiadomość serwera (poza wejściem/opuszczeniem/wyjściem z kanału)
* poziom 4: wiadomości serwera o wejściu/opuszczeniu/wyjściu z kanału
Zatem jeśli ustawisz poziom 3 dla kanału IRC, WeeChat będzie logować wszystkie
wiadomości, poza tymi o wejściu/opuszczeniu/wyjściu z kanału.
Kilka przykładów:
* ustawienie poziomu 3 dla kanału IRC #weechat:
----
/set logger.level.irc.libera.#weechat 3
----
* ustawienie poziomu 3 dla buforu serwera libera:
----
/set logger.level.irc.server.libera 3
----
* ustawienie poziomu 3 dla wszystkich kanałów na serwerze libera:
----
/set logger.level.irc.libera 3
----
* ustawienie poziomu 2 dla wszystkich buforów IRC:
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== Maski dla nazw plików
Możliwe jest zdefiniowanie maski dla nazwy pliku z logiem dla każdego bufora i
użycie do tego zmiennych lokalnych bufora. W celu wyświetlenia listy dostępnych
zmiennych dla bufora wykonaj:
----
/buffer listvar
----
Maski zostaną dopasowane do opcji w kolejności malejącej specyficznie dla
`logger.mask.$plugin.*`, z `logger.file.mask` jako opcją zapasową.
Na przykład, w buforze "irc.libera.#weechat", WeeChat będzie szukał maski dla
nazwy w takiej kolejności:
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
Oznacza to, że można mieć maski specyficzne tylko dla niektórych serwerów IRC
("logger.mask.irc.libera") lub dla wtyczek ("logger.mask.irc").
[[logger_files_by_date]]
===== Pliki z logami uporządkowane według daty
Żeby mieć pliki z logami uporządkowane według daty, możesz użyć specyfikatorów
daty/czasu w masce (obsługiwane formaty można znaleźć w `man strftime`),
na przykład:
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
Spowoduje powstanie następującej struktury:
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== Pliki z logami IRC uporządkowane według serwera i daty
Jeśli chcesz mieć oddzielne katalogi dla serwerów IRC z oddzielnym plikiem dla
każdego kanału:
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
Spowoduje powstanie następującej struktury:
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #mychan.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #channel1.weechatlog
│ └── #channel2.weechatlog
...
....
[[logger_commands]]
==== Komendy
include::includes/autogen_user_commands.pl.adoc[tag=logger_commands]
[[logger_options]]
==== Opcje
Sekcje w pliku _logger.conf_:
[width="100%",cols="3m,6m,16",options="header"]
|===
| Sekcja | Komenda | Opis
| look | /set logger.look.* | Wygląd.
| color | /set logger.color.* | Kolory.
| file | /set logger.file.* | Opcje dla plików z logami.
| level | /set logger.level.* | Poziomy logowania dla buforów (opcje w tej sekcji mogą być dodawane/usuwane).
| mask | /set logger.mask.* | Maski dla nazw plików dla buforów (opcje w tej sekcji mogą być dodawane/usuwane).
|===
Opcje:
include::includes/autogen_user_options.pl.adoc[tag=logger_options]
[[relay_plugin]]
=== Relay
+150 -149
View File
@@ -222,7 +222,7 @@ $ make install
Подршка за велике фајлове.
| ENABLE_LOGGER | `ON`, `OFF` | ON |
Компајлира <<logger_plugin,Logger додатак>>.
Компајлира <<buffer_logging,Logger додатак>>.
| ENABLE_LUA | `ON`, `OFF` | ON |
Компајлира <<scripts_plugins,Lua додатак>>.
@@ -2113,6 +2113,155 @@ include::includes/autogen_user_options.sr.adoc[tag=charset_options]
Особина бафера „highlight_regex” се не чува у конфигурацији. +
Лако можете да је сачувате скриптом _buffer_autoset.py_: инсталирате је командом `+/script install buffer_autoset.py+`, а помоћ добијате са `+/help buffer_autoset+`.
// TRANSLATION MISSING
[[buffer_logging]]
=== Buffer logging
Logger додатак вам омогућава да чувате садржај бафера у фајлове, и нуди опције којима подешавате шта се и како чува.
[[logger_log_levels]]
==== Лог нивои
Логовање се врши са нивоом за сваки бафер. Подразумевани ниво је 9 (логују се све поруке које су приказане у баферу). Ниво можете да промените само за један бафер, или за групу бафера.
Могући нивои су од 0 до 9. Нула значи „ништа се не логује”, а 9 значи „логују се све поруке”.
Додаци користе различите нивое за приказане поруке. IRC додатак користи следеће нивое:
* ниво 1: порука од корисника (на каналу или приватна)
* ниво 2: измена надимка (вашег или неког другог)
* ниво 3: било која серверска порука (осим join/part/quit)
* ниво 4: join/part/quit серверска порука
Тако да ако за IRC канал поставите ниво 3, програм WeeChat ће логовати све поруке осим join/part/quit.
Неки примери:
* Постављање нивоа 3 за IRC канал #weechat:
----
/set logger.level.irc.libera.#weechat 3
----
* Постављање нивоа 3 за libera серверски бафер:
----
/set logger.level.irc.server.libera 3
----
* Постављање нивоа 3 за све канале на серверу libera:
----
/set logger.level.irc.libera 3
----
* Постављање нивоа 2 за све IRC бафере:
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== Маске имена фајлова
За сваки бафер можете да дефинишете маску имена фајла, па да употребите локалне променљиве бафера за изградњу имена фајла. Да бисте видели доступне локалне променљиве текућег бафера:
----
/buffer listvar
----
Masks will be matched on options in descending order of specificity on `logger.mask.$plugin.*`, with `logger.file.mask` as fallback option.
На пример, у баферу „irc.libera.#weechat”, програм WeeChat ће потражити маску са именом опције, по следећем редоследу:
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
Ово значи да можете имати маске које су специфичне за одређене IRC сервере („logger.mask.irc.libera”) или за додатак („logger.mask.irc”).
[[logger_files_by_date]]
===== Лог фајлови по датуму
Ако желите да се лог фајлови креирају по датуму, у маски можете да употребите спецификаторе датума/времена (за формате, погледајте `man strftime`), на пример:
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
Имаћете следеће фајлове:
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== IRC лог фајлови по серверу и каналу
Ако желите један директоријум по IRC серверу и један фајл по каналу у њему:
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
Имаћете следеће фајлове:
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #mychan.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #channel1.weechatlog
│ └── #channel2.weechatlog
...
....
[[logger_commands]]
==== Команде
include::includes/autogen_user_commands.sr.adoc[tag=logger_commands]
[[logger_options]]
==== Опције
Одељци у фајлу _logger.conf_:
[width="100%", cols="3m,6m,16", options="header"]
|===
| Одељак | Команда за контролу | Опис
| look | /set logger.look.* | Изглед и осећај.
| color | /set logger.color.* | Боје.
| file | /set logger.file.* | Опције за лог фајлове.
| level | /set logger.level.* | Лог ниво по баферу (у одељку је могуће додавање/уклањање опција).
| mask | /set logger.mask.* | Маска имена фајла по баферу (у одељку је могуће додавање/уклањање опција).
|===
Опције:
include::includes/autogen_user_options.sr.adoc[tag=logger_options]
[[mouse]]
=== Подршка за миша
@@ -3410,154 +3559,6 @@ include::includes/autogen_user_commands.sr.adoc[tag=fifo_commands]
include::includes/autogen_user_options.sr.adoc[tag=fifo_options]
[[logger_plugin]]
=== Logger
Logger додатак вам омогућава да чувате садржај бафера у фајлове, и нуди опције којима подешавате шта се и како чува.
[[logger_log_levels]]
==== Лог нивои
Логовање се врши са нивоом за сваки бафер. Подразумевани ниво је 9 (логују се све поруке које су приказане у баферу). Ниво можете да промените само за један бафер, или за групу бафера.
Могући нивои су од 0 до 9. Нула значи „ништа се не логује”, а 9 значи „логују се све поруке”.
Додаци користе различите нивое за приказане поруке. IRC додатак користи следеће нивое:
* ниво 1: порука од корисника (на каналу или приватна)
* ниво 2: измена надимка (вашег или неког другог)
* ниво 3: било која серверска порука (осим join/part/quit)
* ниво 4: join/part/quit серверска порука
Тако да ако за IRC канал поставите ниво 3, програм WeeChat ће логовати све поруке осим join/part/quit.
Неки примери:
* Постављање нивоа 3 за IRC канал #weechat:
----
/set logger.level.irc.libera.#weechat 3
----
* Постављање нивоа 3 за libera серверски бафер:
----
/set logger.level.irc.server.libera 3
----
* Постављање нивоа 3 за све канале на серверу libera:
----
/set logger.level.irc.libera 3
----
* Постављање нивоа 2 за све IRC бафере:
----
/set logger.level.irc 2
----
[[logger_filenames_masks]]
==== Маске имена фајлова
За сваки бафер можете да дефинишете маску имена фајла, па да употребите локалне променљиве бафера за изградњу имена фајла. Да бисте видели доступне локалне променљиве текућег бафера:
----
/buffer listvar
----
Masks will be matched on options in descending order of specificity on `logger.mask.$plugin.*`, with `logger.file.mask` as fallback option.
На пример, у баферу „irc.libera.#weechat”, програм WeeChat ће потражити маску са именом опције, по следећем редоследу:
----
logger.mask.irc.libera.#weechat
logger.mask.irc.libera
logger.mask.irc
logger.file.mask
----
Ово значи да можете имати маске које су специфичне за одређене IRC сервере („logger.mask.irc.libera”) или за додатак („logger.mask.irc”).
[[logger_files_by_date]]
===== Лог фајлови по датуму
Ако желите да се лог фајлови креирају по датуму, у маски можете да употребите спецификаторе датума/времена (за формате, погледајте `man strftime`), на пример:
----
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----
Имаћете следеће фајлове:
....
~/.local/share/weechat
└── logs
├── 2010
│ ├── 11
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ └── 12
│ ├── irc.server.libera.weechatlog
│ └── irc.libera.#weechat.weechatlog
├── 2011
│ ├── 01
│ │ ├── irc.server.libera.weechatlog
│ │ └── irc.libera.#weechat.weechatlog
│ ├── 02
...
....
[[logger_irc_files_by_server_channel]]
===== IRC лог фајлови по серверу и каналу
Ако желите један директоријум по IRC серверу и један фајл по каналу у њему:
----
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----
Имаћете следеће фајлове:
....
~/.local/share/weechat
└── logs
└── irc
├── libera
│ ├── libera.weechatlog
│ ├── #weechat.weechatlog
│ └── #mychan.weechatlog
├── oftc
│ ├── oftc.weechatlog
│ ├── #channel1.weechatlog
│ └── #channel2.weechatlog
...
....
[[logger_commands]]
==== Команде
include::includes/autogen_user_commands.sr.adoc[tag=logger_commands]
[[logger_options]]
==== Опције
Одељци у фајлу _logger.conf_:
[width="100%", cols="3m,6m,16", options="header"]
|===
| Одељак | Команда за контролу | Опис
| look | /set logger.look.* | Изглед и осећај.
| color | /set logger.color.* | Боје.
| file | /set logger.file.* | Опције за лог фајлове.
| level | /set logger.level.* | Лог ниво по баферу (у одељку је могуће додавање/уклањање опција).
| mask | /set logger.mask.* | Маска имена фајла по баферу (у одељку је могуће додавање/уклањање опција).
|===
Опције:
include::includes/autogen_user_options.sr.adoc[tag=logger_options]
[[relay_plugin]]
=== Релеј