doc: fix styles in user's guide (issue #722)

v2.8-utf8proc
Sébastien Helleu 2016-05-07 14:36:50 +02:00
parent c2c3ecb3f7
commit bc98d43c08
6 changed files with 853 additions and 853 deletions

View File

@ -55,7 +55,7 @@ Um WeeChat zu installieren wird folgendes benötigt:
* ein lauffähiges GNU/Linux System (mit Kompilierungswerkzeugen für Quellpakete),
oder ein kompatibles OS
* 'root' Privilegien (um WeeChat in das Systemverzeichnis zu installieren)
* _root_ Privilegien (um WeeChat in das Systemverzeichnis zu installieren)
* einige Bibliotheken (siehe <<dependencies,Abhängigkeiten>>).
[[install]]
@ -138,7 +138,7 @@ aber nicht mit Version ≤ 2.6 oder ≥ 3.0).
[[compile_with_cmake]]
==== Kompilieren mit cmake
* Installation in das Systemverzeichnis (benötigt 'root' Privilegien):
* Installation in das Systemverzeichnis (benötigt _root_ Privilegien):
----
$ mkdir build
@ -291,7 +291,7 @@ sollte nur verwendet werden falls man keine Möglichkeit hat cmake zu nutzen. +
Für die Erstellung mittels autotools werden zusätzliche Pakete benötigt und es ist
zeitintensiver als cmake.
* Installation in das Systemverzeichnis (benötigt 'root' Privilegien):
* Installation in das Systemverzeichnis (benötigt _root_ Privilegien):
----
$ ./autogen.sh
@ -313,7 +313,7 @@ $ make
$ make install
----
Die Optionen können auch für das 'configure' Skript verwendet und mittels
Die Optionen können auch für das _configure_ Skript verwendet und mittels
folgendem Befehl angezeigt werden:
----
@ -340,7 +340,7 @@ Folgen Sie bitte der Anleitung zur Erstellung aus Quellpaketen (siehe <<source_p
Falls WeeChat abgestürzt sein sollte und Sie diesen Fehler melden möchten:
* kompilieren Sie WeeChat mit Debug-Information (oder installieren Sie das Binärpaket mit Debug-Information)
* aktivieren Sie 'core' Dateien auf Ihrem System
* aktivieren Sie _core_ Dateien auf Ihrem System
* installieren Sie gdb
[[debug_info]]
@ -354,22 +354,22 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
Bei der Kompilierung mit autotools ist debug standardmäßig aktiviert (`--with-debug=1`).
Wird ein Binärpaket genutzt dann muss zusätzlich das Paket 'weechat-dbg' installiert werden.
Wird ein Binärpaket genutzt dann muss zusätzlich das Paket _weechat-dbg_ installiert werden.
[[core_files]]
==== Core Dateien
Um 'core' Dateien zu aktivieren kann folgende Option genutzt werden:
Um _core_ Dateien zu aktivieren kann folgende Option genutzt werden:
<<option_weechat.startup.sys_rlimit,weechat.startup.sys_rlimit>>:
----
/set weechat.startup.sys_rlimit "core:-1"
----
Wird eine WeeChat Version ≤ 0.3.8 verwendet oder man möchte die 'core' Dateien
Wird eine WeeChat Version ≤ 0.3.8 verwendet oder man möchte die _core_ Dateien
aktivieren, bevor WeeChat gestaret wird, wird der Befehl `ulimit` benötigt.
Zum Beispiel muss unter Linux in einer 'bash' Shell folgender Befehl in die `~/.bashrc`
Zum Beispiel muss unter Linux in einer _bash_ Shell folgender Befehl in die `~/.bashrc`
Datei eingetragen werden:
----
@ -385,19 +385,19 @@ ulimit -c 200000
[[gdb_backtrace]]
==== Rückverfolgung mit gdb
Falls WeeChat abstürzen sollte, dann wird auf Ihrem System eine 'core' bzw. 'core.12345' Datei
('12345' ist die Prozess-Id) erzeugt.
Falls WeeChat abstürzen sollte, dann wird auf Ihrem System eine _core_ bzw. _core.12345_ Datei
(_12345_ ist die Prozess-Id) erzeugt.
Diese Datei wird in dem Verzeichnis erzeugt aus welchem Sie WeeChat gestartet haben (dies
ist *nicht* das Verzeichnis in welchem sich WeeChat befindet!).
Beispiel: 'weechat' ist installiert in '/usr/bin/' und die 'core' Datei befindet sich
in '/home/xxx/'. Nun wird gdb mit folgendem Befehl aufgerufen:
Beispiel: _weechat_ ist installiert in _/usr/bin/_ und die _core_ Datei befindet sich
in _/home/xxx/_. Nun wird gdb mit folgendem Befehl aufgerufen:
----
gdb /usr/bin/weechat /home/xxx/core
----
Nun startet man 'gdb' und führt den Befehl `bt full` innerhalb der gdb Umgebung aus, um die
Nun startet man _gdb_ und führt den Befehl `bt full` innerhalb der gdb Umgebung aus, um die
Fehlermeldung auszugeben. Eine Fehlermeldung von gdb sieht z.B. wie folgt aus:
----
@ -437,7 +437,7 @@ Danke für Ihre Mithilfe!
==== Eine laufende Session von WeeChat debuggen
Um eine laufende Session von WeeChat zu debuggen (zum Beispiel wenn WeeChat nicht
mehr reagieren sollte) sollte man gdb mit der Prozess-ID starten ('12345' muss durch
mehr reagieren sollte) sollte man gdb mit der Prozess-ID starten (_12345_ muss durch
die PID des laufenden weechat Prozesses ersetzt werden):
----
@ -468,7 +468,7 @@ $ weechat
Wird WeeChat zum ersten mal gestartet wird eine Konfigurationsdatei
mit Standardparametern erstellt. Die Konfigurationsdatei heißt:
'~/.weechat/weechat.conf'.
_~/.weechat/weechat.conf_.
Die Einstellungen für WeeChat können an die eigenen Bedürfnisse angepasst werden. Dazu sollten
Veränderungen an der Konfigurationsdatei mit dem internen Befehl `/set` durchführt werden. (siehe
@ -513,12 +513,12 @@ Der Bildschirm setzt sich aus folgenden Bereichen zusammen:
** Prefix (links von dem "|")
** Nachricht (rechts von dem "|")
* Die Bars können um den Chat-Bereich angeordnet werden. Standard-Bars sind:
** 'title' Bar, über dem Chat-Bereich
** 'status' Bar, unter dem Chat-Bereich
** 'input' Bar, unter der Status-Bar
** 'nicklist' Bar, auf der rechten Seite
** _title_ Bar, über dem Chat-Bereich
** _status_ Bar, unter dem Chat-Bereich
** _input_ Bar, unter der Status-Bar
** _nicklist_ Bar, auf der rechten Seite
Die 'status'-Bar besitzt als Standardeinträge:
Die _status_-Bar besitzt als Standardeinträge:
[width="100%",cols="^3,^4,10",options="header"]
|===
@ -531,14 +531,14 @@ Die 'status'-Bar besitzt als Standardeinträge:
| buffer_modes | `+n` | IRC Channel-Modi
| buffer_nicklist_count | `{4}` | Anzahl der Nicks in Benutzerliste
| buffer_zoom | ! | `!` bedeutet, dass ein zusammengefügter Buffer gezoomed (nur dieser Buffer wird angezeigt) wird.
| buffer_filter | `*` | Filteranzeige: `*` bedeutet das Zeilen gefiltert (unterdrückt) wurden. Ein leerer Eintrag zeigt an dass alle Zeilen dargestellt werden
| buffer_filter | `+*+` | Filteranzeige: `+*+` bedeutet das Zeilen gefiltert (unterdrückt) wurden. Ein leerer Eintrag zeigt an dass alle Zeilen dargestellt werden
| scroll | `-MORE(50)-` | Scroll Indikator, zeigt an wie viele Zeilen unterhalb der zur Zeit dargestellten Zeile vorhanden sind
| lag | `[Lag: 2.5]` | Verzögerungsanzeige, in Sekunden (keine Anzeige falls Verzögerung gering)
| hotlist | `[H: 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)
| hotlist | `[H: 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)
| completion | `abc(2) def(5)` | Liste von Wörtern für Vervollständigung, die Zahl zeigt an wie viele Varianten möglich sind
|===
In der 'input' Bar lautet die Standardeinstellung:
In der _input_ Bar lautet die Standardeinstellung:
[width="100%",cols="^3,^4,10",options="header"]
|===
@ -568,7 +568,7 @@ andere Items die man nutzen kann (die aber nicht standardmäßig in einer Bar ak
[[buffers_and_windows]]
=== Buffer und Fenster
Ein 'Buffer' setzt sich zusammen aus einer Nummer, besitzt einem Namen, hat Zeilen die angezeigt
Ein _Buffer_ setzt sich zusammen aus einer Nummer, besitzt einem Namen, hat Zeilen die angezeigt
werden (und noch anderen Daten).
Beispiele von Buffern:
@ -578,7 +578,7 @@ Beispiele von Buffern:
* IRC Channel
* IRC Privat (wird auch Query-Buffer genannt)
Ein 'Fenster' ist ein Bildschirmbereich der Buffer darstellt. Es ist möglich
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
@ -680,7 +680,7 @@ Beispiele für eine vertikale und horizontale Fensteraufteilung:
[[bars]]
=== Bars
Eine 'Bar' ist ein Bereich der parallel, zum Chatfenster, jedwede Art von Text enthalten kann.
Eine _Bar_ ist ein Bereich der parallel, zum Chatfenster, jedwede Art von Text enthalten kann.
Eine Bar kann mittels `weechat.bar.name.option` konfiguriert werden. Dabei steht `name`,
für den Namen der Bar und `option` für die Option für diese Bar.
@ -694,11 +694,11 @@ Aufzählung von Bar-Optionen:
| type | `root`, `window` |
Eine Bar, vom Typ `root`, kann nur einmal, außerhalb von Fenstern, auf dem Bildschirm
dargestellt werden. Standardmäßig existiert keine `root` Bar. Eine solche Bar, mit Namen
'buffers', wird zum Beispiel durch das Skript 'buffers.pl' eingerichtet in welcher alle
_buffers_, wird zum Beispiel durch das Skript _buffers.pl_ eingerichtet in welcher alle
geöffneten Buffer aufgeführt werden. +
Eine Bar, vom Typ `window`, wird in jedem einzelnen Fenster dargestellt, beispielsweise
wenn man das Fenster teilt (mit `/window splith` oder `/window splitv`). Die vier
standardmäßigen Bars ('title', 'status', 'input', 'nicklist'), sind vom Typ `window`.
standardmäßigen Bars (_title_, _status_, _input_, _nicklist_), sind vom Typ `window`.
| position | `top`, `bottom`, `left`, `right` |
Position der Bar: ober- oder unterhalb des Chatfensters, oder links/rechts davon.
@ -708,7 +708,7 @@ Aufzählung von Bar-Optionen:
wenn mehrere Bars den selben Typ und Position besitzen. +
Die Bars werden vom Rand zur Mitte des Bildschirms gezeichnet. Eine höhere Priorität
bewirkt, dass die Bar näher am Rand gezeichnet wird. +
Beispiel: Die 'input' Bar hat eine Priorität von 1000 und wird somit vor der 'status' Bars
Beispiel: Die _input_ Bar hat eine Priorität von 1000 und wird somit vor der _status_ Bars
gezeichnet, da diese lediglich eine Priorität von 500 besitzt.
| size | integer ≥ 0 |
@ -739,7 +739,7 @@ Aufzählung von Bar-Optionen:
Bars oder dem Chatbereich trennt.
| items | string |
Eine Aufzählung von 'items' (siehe <<bar_items,items>> für weitere Informationen).
Eine Aufzählung von _items_ (siehe <<bar_items,items>> für weitere Informationen).
| filling_left_right | `horizontal`, `vertical`, `columns_horizontal`, `columns_vertical` |
Art, wie der Inhalt der Bar die `links` oder `rechts` gezeichnet wird, dargestellt wird (siehe
@ -757,7 +757,7 @@ Aufzählung von Bar-Optionen:
[[bar_items]]
==== Items
Die Option 'items' ist ein String, mit einer Anzahl von Bar-Items. Diese werden
Die Option _items_ ist ein String, mit einer Anzahl von Bar-Items. Diese werden
durch Kommata voneinander getrennt (auf dem Bildschirm wird das Komma durch ein
Leerzeichen ersetzt). Möchte man die Items ohne Leerzeichen darstellen, nutzt
man ein "+" um die Items zu trennen.
@ -766,7 +766,7 @@ Eine Liste von Bar-Items kann man sich mit dem Befehl `/bar listitems` anzeigen
Vor oder nach dem Item können Zeichen eingefügt werden. Diese dürfen nicht alphanumerisch,
"-" oder "_" sein. Die Zeichen werden mit der entsprechenden Farbe, für Trennzeichen,
dargestellt (Option 'color_delim').
dargestellt (Option _color_delim_).
Beispiel einer Bar mit den Items, "[time],buffer_number+:+buffer_plugin+.+buffer_name":
@ -785,7 +785,7 @@ anzuzeigen, welcher nicht im aktuellen Fenster oder überhaupt nicht sichtbar
ist.
Beispiel: Benutzerliste von bitlbee permanent in einer root-Bar darstellen (die Bar
heißt hierbei 'bitlist' und der Name des bitlbee Servers 'bitlbee'):
heißt hierbei _bitlist_ und der Name des bitlbee Servers _bitlbee_):
----
/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist"
@ -808,10 +808,10 @@ Es gibt folgende vier Möglichkeiten um Text innerhalb einer Bar darzustellen:
ausgerichtet ist. Das erste Item wird in der linken oben Ecke angezeigt und das
zweite Item wird eine Zeile darunter angezeigt.
Die Standard-Bars 'title', 'status' und 'input' nutzen eine 'horizontal'
Darstellung und die Standard-Bar 'nicklist' nutzt eine 'vertical' Darstellung.
Die Standard-Bars _title_, _status_ und _input_ nutzen eine _horizontal_
Darstellung und die Standard-Bar _nicklist_ nutzt eine _vertical_ Darstellung.
Einige Beispiele, wie die Bar 'nicklist' dargestellt werden kann:
Einige Beispiele, wie die Bar _nicklist_ dargestellt werden kann:
....
┌───────────────────────────────────────────────────────────────────────┐
@ -874,14 +874,14 @@ Einige Beispiele, wie die Bar 'nicklist' dargestellt werden kann:
[[bar_conditions]]
==== Bedingungen
Der Inhalt der Option 'conditions' ist evaluiert um festzulegen ob die entsprechende
Der Inhalt der Option _conditions_ ist evaluiert um festzulegen ob die entsprechende
Bar angezeigt werden soll oder nicht.
Folgende Zeichenketten sind möglich:
* 'active' : das Fenster muss das aktive Fenster sein
* 'inactive': das Fenster muss das inaktive Fenster sein
* 'nicklist': der Buffer der in einem Fenster dargestellt wird, muss eine
* _active_ : das Fenster muss das aktive Fenster sein
* _inactive_: das Fenster muss das inaktive Fenster sein
* _nicklist_: der Buffer der in einem Fenster dargestellt wird, muss eine
Benutzerliste anzeigen.
* ein Ausdruck: wird als boolescher Wert ausgewertet (siehe Befehl
<<command_weechat_eval,/eval>>)
@ -904,7 +904,7 @@ darstellt, aber nur wenn das Fenster eine Mindestbreite von > 100 Pixeln aufweis
/set weechat.bar.nicklist.conditions "${nicklist} && ${window.win_width} > 100"
----
Gleiche Bedingungen, aber die Benutzerliste wird im Buffer '&bitlbee' immer angezeigt
Gleiche Bedingungen, aber die Benutzerliste wird im Buffer _&bitlbee_ immer angezeigt
(auch wenn das Fenster kleiner als 100 Pixel ist):
----
@ -992,7 +992,7 @@ Der selbe Bildschirm sieht im vereinfachten Anzeigemodus wie folgt aus:
└───────────────────────────────────────────────────────────────────────────┘
....
Es kann nun die URL von 'joe' ohne Probleme angeklickt werden (dies setzt
Es kann nun die URL von _joe_ ohne Probleme angeklickt werden (dies setzt
natürlich voraus, dass der Terminal das Anwählen von URLs unterstützt).
[[notify_levels]]
@ -1001,10 +1001,10 @@ natürlich voraus, dass der Terminal das Anwählen von URLs unterstützt).
Es gibt vier Benachrichtigungsstufen für Nachrichten, welche in Buffern dargestellt
werden. Nachfolgend eine Liste, sortiert von niedrig nach hoch:
* 'low': Nachricht mit einer geringen Wertigkeit (zum Beispiel: IRC join/part/quit)
* 'message': Nachricht von einem User
* 'private': Nachricht in einem privaten Buffer
* 'highlight': wenn es sich um eine 'highlight' Nachricht handelt
* _low_: Nachricht mit einer geringen Wertigkeit (zum Beispiel: IRC join/part/quit)
* _message_: Nachricht von einem User
* _private_: Nachricht in einem privaten Buffer
* _highlight_: wenn es sich um eine _highlight_ Nachricht handelt
Jeder Buffer besitzt eine Benachrichtigungsstufe, um festzulegen, bei welchen Nachrichten
der entsprechende Buffer in der Hotlist angezeigt werden soll.
@ -1012,15 +1012,15 @@ der entsprechende Buffer in der Hotlist angezeigt werden soll.
Der Wert für die Benachrichtigungsstufe kann mittels folgender Option festgelegt
werden:
<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>,
Der Standardwert ist 'all'.
Der Standardwert ist _all_.
[width="50%",cols="3m,10",options="header"]
|===
| Benachrichtigungsstufe | Welche Nachrichten Berücksichtigung in der Hotlist finden
| none | (keine)
| highlight | 'highlight' + 'private Nachrichten'
| message | 'highlight' + 'private Nachrichten' + 'normale Nachrichten'
| all | 'highlight' + 'private Nachrichten' + 'normal Nachrichten' + 'Nachrichten mit einer niedrigen Priorität'
| highlight | _highlight_ + _private Nachrichten_
| message | _highlight_ + _private Nachrichten_ + _normale Nachrichten_
| all | _highlight_ + _private Nachrichten_ + _normal Nachrichten_ + _Nachrichten mit einer niedrigen Priorität_
|===
Benachrichtigungsstufen können für mehrere Buffer definiert werden. Zum Beispiel
@ -1031,7 +1031,7 @@ für alle Buffer des IRC Servers "freenode":
----
Setzt die Benachrichtigungsstufe ausschließlich für den Channel "#weechat",
auf die Stufe 'highlight':
auf die Stufe _highlight_:
----
/set weechat.notify.irc.freenode.#weechat highlight
@ -1131,8 +1131,8 @@ Befehl festgelegt werden:
kbd:[F6] | zum nächsten Buffer springen | `/buffer +1`
| kbd:[F7] | zum vorherigen Fenster wechseln | `/window -1`
| kbd:[F8] | zum nächsten Fenster wechseln | `/window +1`
| kbd:[F9] | Titel des Buffers nach links verschieben | `/bar scroll title * -30%`
| kbd:[F10] | Titel des Buffers nach rechts verschieben | `/bar scroll title * +30%`
| kbd:[F9] | Titel des Buffers nach links verschieben | `+/bar scroll title * -30%+`
| kbd:[F10] | Titel des Buffers nach rechts verschieben | `+/bar scroll title * +30%+`
| kbd:[F11] | Benutzerliste um eine Seite nach oben blättern | `/bar scroll nicklist * -100%`
| kbd:[F12] | Benutzerliste um eine Seite nach unten blättern | `/bar scroll nicklist * +100%`
| kbd:[Alt+F11] | springt zum Anfang der Benutzerliste | `/bar scroll nicklist * b`
@ -1302,7 +1302,7 @@ einigen Terminals, wie z.B. iTerm, muß die Taste kbd:[Alt] anstelle von
kbd:[Shift] verwendet werden).
[NOTE]
Sollten Probleme bei der Mausunterstützung auftreten, dann sollte Bitte die 'WeeChat FAQ' gelesen werden.
Sollten Probleme bei der Mausunterstützung auftreten, dann sollte Bitte die _WeeChat FAQ_ gelesen werden.
[[mouse_bind_events]]
==== Befehle einem Maus-Ereignis zuweisen
@ -1402,14 +1402,14 @@ Beispiel werden alle Konfigurationsoptionen angezeigt:
----
Jeder Text der nicht mit dem Zeichen "/" beginnt wird in den Buffer geschrieben.
In folgendem Beispiel wird der Text 'Hallo' in den aktuellen Buffer geschrieben:
In folgendem Beispiel wird der Text _Hallo_ in den aktuellen Buffer geschrieben:
----
Hallo
----
Dennoch ist es möglich einen Text in den Buffer zu schreiben der mit dem Zeichen "/" beginnt.
Dazu muss dem ersten "/" ein zweites "/" vorangestellt werden. Um den Befehl'/set' als Text zu senden:
Dazu muss dem ersten "/" ein zweites "/" vorangestellt werden. Um den Befehl `/set` als Text zu senden:
----
//set
@ -1468,7 +1468,7 @@ mittels der Option <<option_irc.color.mirc_remap,irc.color.mirc_remap>>.
WeeChat kann bis zu 256 Farbpaarungen nutzen um einen Text in Bars oder im
Chatbereich darzustellen (der Terminal muss natürlich 256 Farben unterstützten).
Gemäß der Einstellung in der 'TERM'-Umgebungsvariable bestehen folgende Einschränkungen
Gemäß der Einstellung in der _TERM_-Umgebungsvariable bestehen folgende Einschränkungen
was die Farbdarstellung in WeeChat betrifft:
[width="50%",cols="8,>2,>2",options="header"]
@ -1485,25 +1485,25 @@ was die Farbdarstellung in WeeChat betrifft:
Mittels `weechat --colors` oder dem internen WeeChat-Befehl `/color` kann man sich
die Einschränkungen für die jeweilige Umgebungsvariable anzeigen lassen.
Folgende Werte sind für die 'TERM'-Umgebungsvariable zu empfehlen, sofern man 256 Farben
Folgende Werte sind für die _TERM_-Umgebungsvariable zu empfehlen, sofern man 256 Farben
nutzen möchte:
* falls screen genutzt wird: 'screen-256color'
* für tmux: 'screen-256color' oder 'tmux-256color'
* ausserhalb screen/tmux: 'xterm-256color', 'rxvt-256color', 'putty-256color', ...
* falls screen genutzt wird: _screen-256color_
* für tmux: _screen-256color_ oder _tmux-256color_
* ausserhalb screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ...
[NOTE]
Es sollte das Paket "ncurses-term" installiert werden um die Werte der 'TERM'
Es sollte das Paket "ncurses-term" installiert werden um die Werte der _TERM_
Variable nutzen zu können.
Sollte screen genutzt werden, fügt man folgende Zeile an das Ende der Datei
'~/.screenrc':
_~/.screenrc_:
----
term screen-256color
----
Sollte die Umgebungsvariable 'TERM' falsch gesetzt worden sein und WeeChat
Sollte die Umgebungsvariable _TERM_ falsch gesetzt worden sein und WeeChat
wird derweil schon ausgeführt, kann die Variable mit folgenden zwei Befehlen
geändert werden:
@ -1584,11 +1584,11 @@ Beispiel:
Er ist möglich einer Farbe ein Attribut hinzuzufügen. Dazu wird dem
Farbnamen oder der Farbnummer ein- oder mehrere Attribute vorangestellt.
* `*` : fett
* `!` : invertierte Darstellung
* `/` : kursiven
* `_` : unterstrichen
* `|` : behält Attribut bei: fett, invertierte Darstellung, Unterstrichen wird beim Farbwechsel nicht zurückgesetzt
* `+*+` : fett
* `+!+` : invertierte Darstellung
* `+/+` : kursiven
* `+_+` : unterstrichen
* `+|+` : behält Attribut bei: fett, invertierte Darstellung, Unterstrichen wird beim Farbwechsel nicht zurückgesetzt
Um zum Beispiel dem eigenen Nick die Farbe weiß und unterstrichen
zuzuordnen:
@ -1621,13 +1621,13 @@ Um der Vordergrundfarbe des Terminals das Attribut "fett" zuzuordnen:
==== Archivierung
WeeChat kann Passwörter oder sensible Daten verschlüsseln und in der
Datei 'sec.conf' speichern.
Datei _sec.conf_ speichern.
Diese Konfigurationsdatei wird vor allen anderen Dateien geladen und die
gespeicherten Daten können in verschiedenen WeeChat Optionen bzw.
Erweiterungen und Skripten genutzt werden.
Es kann eine Passphrase genutzt werden um die Daten in 'sec.conf' zu
Es kann eine Passphrase genutzt werden um die Daten in _sec.conf_ zu
verschlüsseln. Dies ist nicht obligatorisch wird aber dringend empfohlen,
da ansonsten die Daten in Klartext gesichert werden.
@ -1651,9 +1651,9 @@ Die Daten werden in drei Schritten verschlüsselt:
. verschlüsselt den Hash + Daten (Ausgabe ist: Salt + Hash/Daten verschlüsselt)
[NOTE]
Der Cipher Block Modus ist 'CFB'.
Der Cipher Block Modus ist _CFB_.
Das Ergebnis wird als hexadezimale Zeichenkette in 'sec.conf' gesichert.
Das Ergebnis wird als hexadezimale Zeichenkette in _sec.conf_ gesichert.
Zum Beispiel:
----
@ -1675,7 +1675,7 @@ Die Entschlüsselung findet in drei Schritten statt:
==== Umgang mit sensiblen Daten
Um sensible Daten zu schützen wird der Befehl `/secure set` verwendet. Es folgt
ein Beispiel wie man das Passwort für den IRC Server 'freenode' schützt:
ein Beispiel wie man das Passwort für den IRC Server _freenode_ schützt:
----
/secure set freenode meinPasswort
@ -1697,7 +1697,7 @@ Passwortes, verwendet: "${sec.data.xxx}". "xxx" ist hierbei der Name den man
dem Passwort zugeordnet hat (siehe oben, mittels `/secure set xxx ...`). +
Für eine vollständige Liste aller unterstützten Optionen, siehe `/help secure`.
Um z.B. das oben eingestellte 'freenode' Passwort für eine
Um z.B. das oben eingestellte _freenode_ Passwort für eine
<<irc_sasl_authentication,SASL Authentifizierung>> zu nutzen:
----
@ -1774,9 +1774,9 @@ Erweiterungen die gefunden werden, werden beim Start von WeeChat automatisch gel
Natürlich ist es möglich während einer laufenden Session von WeeChat Erweiterungen
nachträglich zu laden oder zu entfernen.
Es ist wichtig zwischen 'Erweiterung' und 'Skript' zu unterscheiden. Eine Erweiterung
Es ist wichtig zwischen _Erweiterung_ und _Skript_ zu unterscheiden. Eine Erweiterung
ist eine Binärdatei die kompiliert wurde und mit dem Befehl `/plugin` geladen wird.
Dem gegenüber ist ein 'Skript' eine Textdatei die durch eine Erweiterung z.B. 'python'
Dem gegenüber ist ein _Skript_ eine Textdatei die durch eine Erweiterung z.B. _python_
mittels dem Befehl `/python` geladen wird.
Mit dem Befehl `/plugin` kann eine Erweiterung geladen bzw. entfernt werden. Auch können
@ -1818,7 +1818,7 @@ Standarderweiterungen:
|===
Um mehr über Erweiterungen- und Skriptenprogrammierung (mittels API) zu erfahren,
sollten Sie die 'WeeChat Plugin API Reference' oder 'WeeChat Scripting Guide' lesen.
sollten Sie die _WeeChat Plugin API Reference_ oder _WeeChat Scripting Guide_ lesen.
[[alias_plugin]]
=== Alias Erweiterung
@ -1884,11 +1884,11 @@ Um zum Beispiel die Option "ignore-case" einzuschalten:
Eine Rechtschreibkorrektur wird in der Bar-Item "aspell_suggest" angezeigt.
Die Anzahl an Vorschlägen, für die Rechtschreibkorrektur, kann mit der Option
'aspell.check.suggestions' bestimmt werden.
_aspell.check.suggestions_ bestimmt werden.
Um die Rechtschreibkorrektur zu aktivieren, muss für die Option 'aspell.check.suggestions'
Um die Rechtschreibkorrektur zu aktivieren, muss für die Option _aspell.check.suggestions_
ein Wert ≥ 0 eingestellt werden und das Bar-Item "aspell_suggest" zu einer Bar, zum
Beispiel 'status', hinzufügt werden.
Beispiel _status_, hinzufügt werden.
Beispiel der Rechtschreibkorrektur, mit einem deutschen Wörterbuch (`de`):
@ -1983,7 +1983,7 @@ Beispiel:
Wenn der globale Zeichensatz zum dekodieren nicht gesetzt ist (dies tritt beim
ersten Aufruf des Charset Erweiterung auf) dann wird automatisch der Zeichensatz
genutzt der vom Terminal verwendet wird (sofern dieser nicht UTF-8 ist) oder
der Standardzeichensatz 'ISO-8859-1'.
der Standardzeichensatz _ISO-8859-1_.
Der Standardwert zum kodieren ist nicht gesetzt. Deshalb wird der interne Zeichensatz
(UTF-8) genutzt.
@ -2024,7 +2024,7 @@ Um sich alle genutzten Zeichensätze anzeigen zu lassen wird folgender Befehl ge
==== Fehlersuche
sollten Probleme bei der Zeichensatzdarstellung auftreten dann werfen Sie bitte
einen Blick in die 'WeeChat FAQ'.
einen Blick in die _WeeChat FAQ_.
[[exec_plugin]]
=== Exec Erweiterung
@ -2061,8 +2061,8 @@ Sie können WeeChat fern steuern indem Sie Befehle oder einen Text an die FIFO P
schicken (dazu muss die Option "plugins.var.fifo.fifo" aktiviert sein (standardmäßig
ist diese Option aktiviert).
Die FIFO pipe findet man in '~/.weechat/' und heisst 'weechat_fifo_xxxx'
('xxxx' ist dabei die ID (PID) der laufenden WeeChat Session).
Die FIFO pipe findet man in _~/.weechat/_ und heisst _weechat_fifo_xxxx_
(_xxxx_ ist dabei die ID (PID) der laufenden WeeChat Session).
Die Syntax der FIFO Pipe Befehle/Text sieht wie folgt aus:
@ -2079,7 +2079,7 @@ einige Beispiele:
$ echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo_12345
----
* Den Text 'Hallo!' in den Channel #weechat schreiben:
* Den Text _Hallo!_ in den Channel #weechat schreiben:
----
$ echo 'irc.freenode.#weechat *Hallo!' >~/.weechat/weechat_fifo_12345
@ -2139,8 +2139,8 @@ Es ist möglich eine oder mehrere URL von IRC Servern zu übergeben:
irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]]
----
Beispiel: Anmelden beim Server 'chat.freenode.net' mit dem Nick 'nono' und betreten
der Channels '#weechat' und '#toto' (Standardport (6667) wird genutzt):
Beispiel: Anmelden beim Server _chat.freenode.net_ mit dem Nick _nono_ und betreten
der Channels _#weechat_ und _#toto_ (Standardport (6667) wird genutzt):
----
$ weechat irc://nono@chat.freenode.net/#weechat,#toto
@ -2246,12 +2246,12 @@ Für weiterreichende Informationen lesen Sie bitte: http://www.oftc.net/oftc/Nic
WeeChat unterstützt eine SASL Authentifikation, mittels verschiedener Mechanismen:
* 'plain': Passwort liegt in Klarschrift vor (Standard)
* 'ecdsa-nist256p-challenge': Abgleich von öffentlichem/privatem Schlüssel
* 'external': SSL Zertifikat welches auf Client Seite vorliegt
* 'dh-blowfish': Passwort wird mittels blowfish verschlüsselt
* _plain_: Passwort liegt in Klarschrift vor (Standard)
* _ecdsa-nist256p-challenge_: Abgleich von öffentlichem/privatem Schlüssel
* _external_: SSL Zertifikat welches auf Client Seite vorliegt
* _dh-blowfish_: Passwort wird mittels blowfish verschlüsselt
(*unsicher*, wird nicht empfohlen)
* 'dh-aes': Passwort wird mittels AES verschlüsselt
* _dh-aes_: Passwort wird mittels AES verschlüsselt
(*unsicher*, wird nicht empfohlen)
[NOTE]
@ -2260,13 +2260,13 @@ Die "gcrypt" Bibliothek wird beim kompilieren von WeeChat benötigt um
Optionen für Server sind:
* 'sasl_mechanism': Mechanismus welcher genutzt werden soll (siehe oben)
* 'sasl_timeout': Zeitüberschreitung für Authentifizierung (in Sekunden)
* 'sasl_fail': auszuführende Aktion falls die SASL Authentifizierung fehlschlägt
* 'sasl_username': Username (Nickname)
* 'sasl_password': Passwort
* 'sasl_key': Datei mit privatem ECC Schlüssel (für den
'ecdsa-nist256p-challenge' Mechanismus)
* _sasl_mechanism_: Mechanismus welcher genutzt werden soll (siehe oben)
* _sasl_timeout_: Zeitüberschreitung für Authentifizierung (in Sekunden)
* _sasl_fail_: auszuführende Aktion falls die SASL Authentifizierung fehlschlägt
* _sasl_username_: Username (Nickname)
* _sasl_password_: Passwort
* _sasl_key_: Datei mit privatem ECC Schlüssel (für den
_ecdsa-nist256p-challenge_ Mechanismus)
[[irc_sasl_ecdsa_nist256p_challenge]]
===== SASL ECDSA-NIST256P-CHALLENGE
@ -2479,7 +2479,7 @@ Falls CTCP Optionen nicht festgelegt sind, lauten die CTCP Antworten:
==== Zielbuffer für IRC Nachrichten
Sie können einen Zielbuffer einstellen in welchem IRC Nachrichten dargestellt werden sollen.
Dazu dienen die Optionen `irc.msgbuffer.*`.
Dazu dienen die Optionen `+irc.msgbuffer.*+`.
Für einige IRC Nachrichten (siehe unten) können zusätzliche Werte angepasst werden:
@ -2488,7 +2488,7 @@ current::
private::
privaten Buffer, oder im aktuellen/Server Buffer falls nicht vorhanden (gemäß der Einstellung
in der Option 'irc.look.msgbuffer_fallback')
in der Option _irc.look.msgbuffer_fallback_)
server::
Server Buffer
@ -2769,9 +2769,9 @@ Erstellt eine Struktur in folgender Form:
Die Relay-Erweiterung wird genutzt um Daten, mittels unterschiedlicher Protokolle,
über ein Netzwerk zu übermitteln:
* 'irc': IRC Proxy: um mittels einem oder mehreren IRC-Clients eine Verbindung zu
* _irc_: IRC Proxy: um mittels einem oder mehreren IRC-Clients eine Verbindung zu
IRC Servern zu unterhalten.
* 'weechat': Protokoll welches es erlaubt die Daten mit einer externen Oberfläche
* _weechat_: Protokoll welches es erlaubt die Daten mit einer externen Oberfläche
zu teilen (zum Beispiel QWeeChat)
[[relay_options]]
@ -2808,7 +2808,7 @@ Es wird nachdrücklich Empfohlen ein Passwort für die Relay-Verbindung zu nutze
/set relay.network.password "meinPasswort"
----
Dieses Passwort wird sowohl für das 'irc' als auch für das 'weechat' Protokoll
Dieses Passwort wird sowohl für das _irc_ als auch für das _weechat_ Protokoll
verwendet.
[[relay_ssl]]
@ -2818,7 +2818,7 @@ Man kann SSL mittels eines selbst erstellten Zertifikates und eines privaten
Schlüssels nutzen. Um SSL für die Verbindung zu aktivieren stellt man dem
Protokollnamen ein "ssl" voran.
Die Standarddatei für Zertifikate/Schlüssel ist '~/.weechat/ssl/relay.pem'
Die Standarddatei für Zertifikate/Schlüssel ist _~/.weechat/ssl/relay.pem_
(option <<option_relay.network.ssl_cert_key,relay.network.ssl_cert_key>>).
Ein Zertifikat und einen privaten Schlüssel kann man mit folgenden Befehlen
@ -2911,7 +2911,7 @@ websocket = new WebSocket("ws://server.com:9000/weechat");
----
Der Port (im Beispiel: 9000) ist der Port der in der Relay Erweiterung angegeben wurde.
Die URI muss immer auf "/weechat" enden ('irc' und 'weechat' Protokoll).
Die URI muss immer auf "/weechat" enden (_irc_ und _weechat_ Protokoll).
[[scripts_plugins]]
=== Erweiterungen für Skripten
@ -2927,7 +2927,7 @@ Skripten, aus dem Skript-Repository, installiert und deinstalliert werden. Das S
kann unter folgender URL eingesehen werden: https://weechat.org/scripts
Sollten wir Ihr Interesse geweckt haben, selber Skripten für WeeChat zu programmieren, dann lesen Sie
bitte die 'WeeChat Scripting Guide'.
bitte die _WeeChat Scripting Guide_.
[[script_options]]
==== Script Optionen (script.conf)
@ -2997,7 +2997,7 @@ Trigger unter bestimmten Umständen ausgeführt wird.
Um Trigger nutzen zu können ist es erforderlich zu wissen wie signals,
modifiers, ... in WeeChat funktionieren. Dazu sollte man das Kapitel
'Hooks' in der 'Anleitung für API Erweiterung' lesen.
_Hooks_ in der _Anleitung für API Erweiterung_ lesen.
[[trigger_options]]
==== Optionen (trigger.conf)
@ -3039,7 +3039,7 @@ Ein Trigger hat folgende Optionen (Benennung ist
| hook | `signal`, `hsignal`, `modifier`, `print`, `command`, `command_run`,
`timer`, `config`, `focus` |
Der hook welcher durch Trigger genutzt werden soll. Für weitere Informationen siehe
'Anleitung für API Erweiterung', Kapitel 'Hooks'.
_Anleitung für API Erweiterung_, Kapitel _Hooks_.
| arguments | string |
Argumente welche der Hook nutzen soll. Dies ist davon abhängig welcher Hook-Typ genutzt wird.
@ -3062,7 +3062,7 @@ Ein Trigger hat folgende Optionen (Benennung ist
genutzt werden. Die anderen Werte werden höchst selten verwendet).
|===
Ein Beispiel ist der standardmäßig genutzte Trigger 'beep', der
Ein Beispiel ist der standardmäßig genutzte Trigger _beep_, der
folgende Optionen besitzt:
----
@ -3084,7 +3084,7 @@ abgearbeitet:
. Überprüfung von Bedingungen; falls unwahr, beenden
. ersetze Text mittels erweitertem regulärer POSIX Ausdruck (sofern im Trigger definiert)
. ein oder mehrere Befehle werden ausgeführt (sofern im Trigger definiert)
. Beendigung mit einem Rückgabewert (ausgenommen sind die Hooks 'modifier' und 'focus')
. Beendigung mit einem Rückgabewert (ausgenommen sind die Hooks _modifier_ und _focus_)
[[trigger_hook_arguments]]
==== Hook Argumente
@ -3153,7 +3153,7 @@ ein Semikolon getrennt.
1. Name der Option (Priorität erlaubt) (erforderlich) +
2. Name der Option (Priorität erlaubt) +
3. ... |
`weechat.look.*`
`+weechat.look.*+`
| focus |
1. area Name (Priorität erlaubt) (erforderlich) +
@ -3172,7 +3172,7 @@ Diese sind evaluiert und die Daten im Callback können verwendet werden
(siehe <<trigger_callback_data,Daten in Callbacks>> und Befehl
<<command_weechat_eval,/eval>>).
Beispiel: der standardmäßig genutzte Trigger 'beep' nutzt folgende Bedingungen,
Beispiel: der standardmäßig genutzte Trigger _beep_ nutzt folgende Bedingungen,
um ausschließlich bei einer privaten Nachricht oder einem Highlight ausgeführt
zu werden:
@ -3185,9 +3185,9 @@ ${tg_highlight} || ${tg_msg_pv}
Reguläre Ausdrücke werden verwendet um Variablen in einem Callback Hashtable zu ändern.
Das Format ist: "/regex/replace" oder "/regex/replace/var" (wobei 'var' eine
Das Format ist: "/regex/replace" oder "/regex/replace/var" (wobei _var_ eine
Variable eines Hashtable darstellt). +
Sollte 'var' nicht näher spezifiziert sein, wird die Standard-Variable genutzt,
Sollte _var_ nicht näher spezifiziert sein, wird die Standard-Variable genutzt,
welche abhängig von dem genutzten Hook ist:
[width="50%",cols="4,5m",options="header"]
@ -3217,8 +3217,8 @@ Matching groups können in "replace" genutzt werden:
`${re:99}` um Gruppen zu fangen
* `${re:+}`: der letzte match (mit der höchsten Nummer)
* `${hide:c,${re:N}}`: match "N" mit allen Zeichen die durch "c" ersetzt wurden
(Beispiel: `${hide:*,${re:2}}` ist die group #2 mit allen Zeichen die durch
`*` ersetzt wurden).
(Beispiel: `+${hide:*,${re:2}}+` ist die group #2 mit allen Zeichen die durch
`+*+` ersetzt wurden).
Beispiel: nutzte Fettschrift zwischen dem Zeichen "*":
@ -3226,9 +3226,9 @@ Beispiel: nutzte Fettschrift zwischen dem Zeichen "*":
/\*(\S+)\*/*${color:bold}${re:1}${color:-bold}*/
----
Beispiel: der Standard-Trigger 'server_pass' nutzt folgenden regulären Ausdruck
Beispiel: der Standard-Trigger _server_pass_ nutzt folgenden regulären Ausdruck
um ein Passwort in den Befehlen `/server` und `/connect` zu verbergen (die
einzelnen Zeichen des Passwortes werden durch `*` ersetzt):
einzelnen Zeichen des Passwortes werden durch `+*+` ersetzt):
----
==^(/(server|connect) .*-(sasl_)?password=)(\S+)(.*)==${re:1}${hide:*,${re:4}}${re:5}
@ -3249,7 +3249,7 @@ Der Inhalt ist evaluiert (siehe Befehl <<command_weechat_eval,/eval>>) und der
durch einen regulären Ausdruck veränderte Text kann in dem Befehl verwendet
werden.
Beispiel: der standardmäßig genutzte Trigger 'beep' nutzt folgenden
Beispiel: der standardmäßig genutzte Trigger _beep_ nutzt folgenden
Befehl um einen Ton (BEL) zu erzeugen.
----
@ -3262,9 +3262,9 @@ Befehl um einen Ton (BEL) zu erzeugen.
Daten, die dem Callback übergeben werden, werden in einer Hashtable (Pointer
und Strings) gesichert und können durch folgende Optionen genutzt werden:
* 'conditions'
* 'regex'
* 'command'
* _conditions_
* _regex_
* _command_
Der Inhalt eines Hashtable ist abhängig von dem Hook-Typ.
@ -3300,12 +3300,12 @@ und die Daten in einer Hashtable gesichert:
| host | string | Hostname
| command | string | IRC Befehl (Beispiel: "PRIVMSG", "NOTICE", ...)
| channel | string | IRC Channel
| arguments | string | Argumente des Befehls (Beinhaltet Wert von 'channel')
| arguments | string | Argumente des Befehls (Beinhaltet Wert von _channel_)
| text | string | Text (zum Beipiel eine Nachricht eines Users)
| pos_command | string | Index von 'command' innerhalb einer Nachricht ("-1" falls 'command' nicht gefunden wird)
| pos_arguments | string | Index von'arguments' innerhalb einer Nachricht ("-1" falls 'arguments' nicht gefunden wird)
| pos_channel | string | Index von 'channel' innerhalb einer Nachricht ("-1" falls 'channel' nicht gefunden wird)
| pos_text | string | Index von 'text' innerhalb einer Nachricht ("-1" falls 'text' nicht gefunden wird)
| pos_command | string | Index von _command_ innerhalb einer Nachricht ("-1" falls _command_ nicht gefunden wird)
| pos_arguments | string | Index von_arguments_ innerhalb einer Nachricht ("-1" falls _arguments_ nicht gefunden wird)
| pos_channel | string | Index von _channel_ innerhalb einer Nachricht ("-1" falls _channel_ nicht gefunden wird)
| pos_text | string | Index von _text_ innerhalb einer Nachricht ("-1" falls _text_ nicht gefunden wird)
|===
Sofern es sich bei den Daten um einen Pointer handelt, kann die Variable `tg_signal_data`
@ -3343,7 +3343,7 @@ Der Callback von "modifier" legt folgende Variablen in der Hashtable an:
| tg_string_nocolor | string | Zeichenkette ohne Farbcodes
|===
Für den modifier 'weechat_print' gilt, Tags werden hinzugefügt, sofern sie
Für den modifier _weechat_print_ gilt, Tags werden hinzugefügt, sofern sie
vorhanden sind (siehe <<trigger_data_print,hook print>> weiter unten), und nachfolgende Variablen:
[width="100%",cols="3m,2,14",options="header"]
@ -3380,7 +3380,7 @@ Der Callback von "print" legt folgende Variablen in der Hashtable an:
|===
Variablen welche gesetzt werden, aufgrund der Nutzung von Tags in einer Nachricht
('weechat_print' nutzt ebenso diese Tag-Variablen):
(_weechat_print_ nutzt ebenso diese Tag-Variablen):
[width="100%",cols="3m,2,14",options="header"]
|===
@ -3390,8 +3390,8 @@ Variablen welche gesetzt werden, aufgrund der Nutzung von Tags in einer Nachrich
| tg_tag_nick | string | Nick (extrahiert aus Tag "nick_xxx")
| tg_tag_prefix_nick | string | Nickfarbe für Präfix (extrahier aus Tag "prefix_nick_ccc")
| tg_tag_host | string | Username und Host, Format: username@host (extrahiert aus Tag "host_xxx")
| tg_tag_notify | string | Benachrichtigungsstufe ('none', 'message', 'private', 'highlight')
| tg_notify | string | Benachrichtigungsstufe, falls von 'none' abweichend
| tg_tag_notify | string | Benachrichtigungsstufe (_none_, _message_, _private_, _highlight_)
| tg_notify | string | Benachrichtigungsstufe, falls von _none_ abweichend
| tg_msg_pv | string | "1" für eine private Nachricht, andernfalls "0"
|===
@ -3517,9 +3517,9 @@ gespeichert werden:
Argumente für den Hook-Timer sind:
* '3600000': 3600 * 1000 Millisekunden, der Callback wird jede Stunde ausgeführt
* '0': Abgleich der Sekunden (es findet keine Justierung statt)
* '0': maximale Anzahl an aufrufen (0 = unbegrenzt)
* _3600000_: 3600 * 1000 Millisekunden, der Callback wird jede Stunde ausgeführt
* _0_: Abgleich der Sekunden (es findet keine Justierung statt)
* _0_: maximale Anzahl an aufrufen (0 = unbegrenzt)
Der Befehl `/mute /save` sorgt dafür, dass die Konfiguration ohne kommentarlos
gespeichert wird (es findet keine Ausgabe im Core-Buffer statt).
@ -3562,12 +3562,12 @@ include::autogen/user/xfer_commands.asciidoc[]
Bevor man nach Unterstützung fragt sollte man sicherstellen, dass man sowohl die
Dokumentation als auch die FAQ gelesen hat, welche mit WeeChat bereitgestellt wird.
Unterstützung im IRC findet man auf dem Server 'chat.freenode.net':
Unterstützung im IRC findet man auf dem Server _chat.freenode.net_:
* offizielle Channel (Entwickler vertreten):
** '#weechat' (englisch)
** '#weechat-fr' (französisch)
** _#weechat_ (englisch)
** _#weechat-fr_ (französisch)
* kein offizieller Channel:
** '#weechat-de' (deutsch)
** _#weechat-de_ (deutsch)
Weitere Möglichkeiten, um mit den Entwicklern in Kontakt zu treten, siehe: https://weechat.org/dev/support

View File

@ -48,7 +48,7 @@ In order to install WeeChat, you need:
* a running GNU/Linux system (with compiler tools for source
package), or a compatible OS
* 'root' privileges (to install WeeChat in a system directory)
* _root_ privileges (to install WeeChat in a system directory)
* some libraries (see <<dependencies,dependencies>>).
[[install]]
@ -130,7 +130,7 @@ but not with versions ≤ 2.6 or ≥ 3.0).
[[compile_with_cmake]]
==== Compile with cmake
* Installation in system directories (requires 'root' privileges):
* Installation in system directories (requires _root_ privileges):
----
$ mkdir build
@ -282,7 +282,7 @@ Only cmake is officially supported to build WeeChat. You should use autotools
only if you are not able to use cmake. +
Build with autotools requires more dependencies and is slower than with cmake.
* Installation in system directories (requires 'root' privileges):
* Installation in system directories (requires _root_ privileges):
----
$ ./autogen.sh
@ -304,7 +304,7 @@ $ make
$ make install
----
Options can be used for 'configure' script, they can be displayed with this
Options can be used for _configure_ script, they can be displayed with this
command:
----
@ -333,7 +333,7 @@ If you experienced crashes, or if you want to report any future WeeChat crash,
you have to:
* compile it with debug info (or install binary package with debug info)
* enable 'core' files on your system
* enable _core_ files on your system
* install gdb
[[debug_info]]
@ -347,12 +347,12 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
If you're compiling with autotools, debug is default (`--with-debug=1`).
If you installed a binary package, then install package 'weechat-dbg'.
If you installed a binary package, then install package _weechat-dbg_.
[[core_files]]
==== Core files
To enable 'core' files, you can use option
To enable _core_ files, you can use option
<<option_weechat.startup.sys_rlimit,weechat.startup.sys_rlimit>>:
----
@ -362,7 +362,7 @@ To enable 'core' files, you can use option
For WeeChat ≤ 0.3.8 or if you want to enable core files even before WeeChat
starts, you can use `ulimit` command.
For example under Linux with 'bash' shell, add this line to your `~/.bashrc`:
For example under Linux with _bash_ shell, add this line to your `~/.bashrc`:
----
ulimit -c unlimited
@ -377,13 +377,13 @@ ulimit -c 200000
[[gdb_backtrace]]
==== Get backtrace with gdb
When WeeChat crashes, your system will create a file 'core' or 'core.12345'
('12345' is process id).
When WeeChat crashes, your system will create a file _core_ or _core.12345_
(_12345_ is process id).
This file is created in directory where you have run WeeChat (this is *not*
directory where WeeChat is installed!).
For example if 'weechat' is installed in '/usr/bin/' and 'core' file is
in '/home/xxx/', then run gdb with this command:
For example if _weechat_ is installed in _/usr/bin/_ and _core_ file is
in _/home/xxx/_, then run gdb with this command:
----
gdb /usr/bin/weechat /home/xxx/core
@ -430,7 +430,7 @@ Thank you for your help!
==== Debug a running WeeChat
To debug a running WeeChat (for example if WeeChat seems blocked), you can use
gdb with process id (replace '12345' with PID of weechat process):
gdb with process id (replace _12345_ with PID of weechat process):
----
gdb /usr/bin/weechat 12345
@ -460,7 +460,7 @@ $ weechat
When you run WeeChat for the first time, a default configuration file is
created, with default options. The default configuration file is:
'~/.weechat/weechat.conf'.
_~/.weechat/weechat.conf_.
You can edit this file at your convenience to configure WeeChat or you can set
parameters with `/set` command in WeeChat (see
@ -505,12 +505,12 @@ Screen is composed by following areas:
** prefix (before "|")
** message (after "|")
* bars around chat area, default bars are:
** 'title' bar, above chat area
** 'status' bar, below chat area
** 'input' bar, below status bar
** 'nicklist' bar, on the right
** _title_ bar, above chat area
** _status_ bar, below chat area
** _input_ bar, below status bar
** _nicklist_ bar, on the right
Bar 'status' has following default items:
Bar _status_ has following default items:
[width="100%",cols="^3,^4,10",options="header"]
|===
@ -523,14 +523,14 @@ Bar 'status' has following default items:
| buffer_modes | `+n` | IRC channel modes
| buffer_nicklist_count | `{4}` | Number of nicks in nicklist
| buffer_zoom | ! | `!` means the merged buffer is zoomed (only this one is displayed), empty value means all merged buffers are displayed
| buffer_filter | `*` | Filtering indicator: `*` means some lines are filtered (hidden), empty value means all lines are displayed
| buffer_filter | `+*+` | Filtering indicator: `+*+` means some lines are filtered (hidden), empty value means all lines are displayed
| scroll | `-MORE(50)-` | Scroll indicator, with number of lines below last line displayed
| lag | `[Lag: 2.5]` | Lag indicator, in seconds (hidden if lag is low)
| hotlist | `[H: 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)
| hotlist | `[H: 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)
| completion | `abc(2) def(5)` | List of words for completion, with number of possible completions for each word
|===
Bar 'input' has following default items:
Bar _input_ has following default items:
[width="100%",cols="^3,^4,10",options="header"]
|===
@ -560,7 +560,7 @@ Other items available (not used in bars by default):
[[buffers_and_windows]]
=== Buffers and windows
A 'buffer' is composed by a number, a name, lines displayed (and some other
A _buffer_ is composed by a number, a name, lines displayed (and some other
data).
Examples of buffers:
@ -570,7 +570,7 @@ Examples of buffers:
* irc channel
* irc private
A 'window' is a screen area which displays a buffer. It is possible to split
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
@ -671,7 +671,7 @@ Example of vertical + horizontal splits:
[[bars]]
=== Bars
A 'bar' is an area beside the chat that can contain any type of text.
A _bar_ is an area beside the chat that can contain any type of text.
The bar options can be set with options `weechat.bar.name.option` where `name`
is the name of the bar and `option` the option for this bar.
@ -684,12 +684,12 @@ List of bar options:
| type | `root`, `window` |
A bar with type `root` is displayed exactly one time on screen, outside all
windows. There is no root bar by default, but an example is the bar 'buffers'
created by script 'buffers.pl' (sidebar with list of buffers). +
windows. There is no root bar by default, but an example is the bar _buffers_
created by script _buffers.pl_ (sidebar with list of buffers). +
A bar with type `window` is displayed in each window, for example if you
split one time the screen (with `/window splith` or `/window splitv`), you
will have one bar in each window. The four default bars ('title', 'status',
'input', 'nicklist') have type `window`.
will have one bar in each window. The four default bars (_title_, _status_,
_input_, _nicklist_) have type `window`.
| position | `top`, `bottom`, `left`, `right` |
Position of the bar: above/below chat, on the left/right.
@ -699,7 +699,7 @@ List of bar options:
many bars have same type and position. +
The bars are displayed from the edge of the screen to the center. A higher
priority will display bar at the beginning, so closer to the edge. +
Example: 'input' bar has priority 1000, so it is displayed before the 'status'
Example: _input_ bar has priority 1000, so it is displayed before the _status_
bar, which has priority 500.
| size | integer ≥ 0 |
@ -730,7 +730,7 @@ List of bar options:
other bars (or chat).
| items | string |
A list of 'items' (see <<bar_items,items>> for more info).
A list of _items_ (see <<bar_items,items>> for more info).
| filling_left_right | `horizontal`, `vertical`, `columns_horizontal`, `columns_vertical` |
Type of filling for a bar which has position `left` or `right` (see
@ -748,14 +748,14 @@ List of bar options:
[[bar_items]]
==== Items
The option 'items' is a string with a list of bar items, separated by a comma
The option _items_ is a string with a list of bar items, separated by a comma
(space between items on screen) or "+" (glued items).
The list of bar items is displayed with command `/bar listitems`.
Before or after item name, you can use chars (that are not alphanumeric, "-" or
"_"). They will be displayed before/after item with the delimiters color
defined in bar (option 'color_delim').
defined in bar (option _color_delim_).
Example of bar with items "[time],buffer_number+:+buffer_plugin+.+buffer_name":
@ -773,7 +773,7 @@ This is useful in root bars, to display item for a specific buffer which is
not displayed in the current window (or even not displayed at all).
Example: nicklist of bitlbee in a root bar (if the bar is called
'bitlist' and if bitlbee server is called 'bitlbee'):
_bitlist_ and if bitlbee server is called _bitlbee_):
----
/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist"
@ -794,10 +794,10 @@ There are four types of filling:
* `columns_vertical`: items are displayed using columns, where text is aligned
on the left. The first item is on top left, the second is one line below.
Default bars 'title', 'status' and 'input' have 'horizontal' filling, and
default bar 'nicklist' has 'vertical' filling.
Default bars _title_, _status_ and _input_ have _horizontal_ filling, and
default bar _nicklist_ has _vertical_ filling.
Some examples of filling for bar 'nicklist':
Some examples of filling for bar _nicklist_:
....
┌───────────────────────────────────────────────────────────────────────┐
@ -860,14 +860,14 @@ Some examples of filling for bar 'nicklist':
[[bar_conditions]]
==== Conditions
The option 'conditions' is a string which is evaluated to know if the bar
The option _conditions_ is a string which is evaluated to know if the bar
must be displayed or not.
The string can be:
* 'active': the window must be active
* 'inactive': the window must be inactive
* 'nicklist': the buffer displayed in window must have a nicklist
* _active_: the window must be active
* _inactive_: the window must be inactive
* _nicklist_: the buffer displayed in window must have a nicklist
* an expression: it is evaluated as boolean (see command
<<command_weechat_eval,/eval>>)
@ -889,7 +889,7 @@ width of window is > 100 :
/set weechat.bar.nicklist.conditions "${nicklist} && ${window.win_width} > 100"
----
Same condition, but always display nicklist on buffer '&bitlbee' (even if window
Same condition, but always display nicklist on buffer _&bitlbee_ (even if window
is small):
----
@ -974,7 +974,7 @@ The screen will look like that in bare display:
└───────────────────────────────────────────────────────────────────────────┘
....
So you can click the URL from 'joe' without any problem in your terminal (of
So you can click the URL from _joe_ without any problem in your terminal (of
course this supposes that your terminal supports click on URLs).
[[notify_levels]]
@ -982,25 +982,25 @@ course this supposes that your terminal supports click on URLs).
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
* _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'.
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'
| 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
@ -1010,7 +1010,7 @@ irc server "freenode":
/set weechat.notify.irc.freenode message
----
Set notify level 'highlight' on channel "#weechat" only:
Set notify level _highlight_ on channel "#weechat" only:
----
/set weechat.notify.irc.freenode.#weechat highlight
@ -1109,8 +1109,8 @@ The notify level for a buffer can be set with command `/buffer`:
kbd:[F6] | Switch to next buffer | `/buffer +1`
| kbd:[F7] | Switch to previous window | `/window -1`
| kbd:[F8] | Switch to next window | `/window +1`
| kbd:[F9] | Scroll buffer's title on the left | `/bar scroll title * -30%`
| kbd:[F10] | Scroll buffer's title on the right | `/bar scroll title * +30%`
| kbd:[F9] | Scroll buffer's title on the left | `+/bar scroll title * -30%+`
| kbd:[F10] | Scroll buffer's title on the right | `+/bar scroll title * +30%+`
| kbd:[F11] | Scroll up one page in nicklist | `/bar scroll nicklist * -100%`
| kbd:[F12] | Scroll down one page in nicklist | `/bar scroll nicklist * +100%`
| kbd:[Alt+F11] | Go to the beginning of nicklist | `/bar scroll nicklist * b`
@ -1277,7 +1277,7 @@ as if the mouse was disabled (on some terminals like iTerm, you have to use
kbd:[Alt] instead of kbd:[Shift]).
[NOTE]
For any problem with mouse, please look at 'WeeChat FAQ'.
For any problem with mouse, please look at _WeeChat FAQ_.
[[mouse_bind_events]]
==== Bind mouse events to commands
@ -1376,14 +1376,14 @@ list of all options:
----
Text sent to a buffer is any text that does not begin with "/" char.
For example, to send text 'hello' on current buffer:
For example, to send text _hello_ on current buffer:
----
hello
----
However, it is possible to start with "/" char, by adding another.
For example, to send text '/set' on current buffer:
For example, to send text `/set` on current buffer:
----
//set
@ -1439,7 +1439,7 @@ In irc plugin, you can remap these colors using option
WeeChat can use up to 256 color pairs to display text in bars and chat area
(your terminal must support 256 colors to use them in WeeChat).
According to value of 'TERM' environment variable, you may have following limits
According to value of _TERM_ environment variable, you may have following limits
for colors in WeeChat:
[width="50%",cols="8,>2,>2",options="header"]
@ -1456,23 +1456,23 @@ for colors in WeeChat:
You can run `weechat --colors` or use command `/color` in WeeChat to
display limits for your environment.
Some recommended values for 'TERM' if you want 256 colors:
Some recommended values for _TERM_ if you want 256 colors:
* under screen: 'screen-256color'
* under tmux: 'screen-256color' or 'tmux-256color'
* outside screen/tmux: 'xterm-256color', 'rxvt-256color', 'putty-256color', ...
* under screen: _screen-256color_
* under tmux: _screen-256color_ or _tmux-256color_
* outside screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ...
[NOTE]
You may have to install package "ncurses-term" to use these values in 'TERM'
You may have to install package "ncurses-term" to use these values in _TERM_
variable.
If you are using screen, you can add this line to your '~/.screenrc':
If you are using screen, you can add this line to your _~/.screenrc_:
----
term screen-256color
----
If your 'TERM' variable has wrong value and that WeeChat is already running,
If your _TERM_ variable has wrong value and that WeeChat is already running,
you can change it with these two commands:
----
@ -1550,11 +1550,11 @@ For example:
It is possible to use some attributes for colors. One or more attributes can be
added before color name or number:
* `*` : bold text
* `!` : reverse video
* `/` : italic
* `_` : underlined text
* `|` : keep attributes: do not reset bold/reverse/italic/underlined when
* `+*+` : bold text
* `+!+` : reverse video
* `+/+` : italic
* `+_+` : underlined text
* `+|+` : keep attributes: do not reset bold/reverse/italic/underlined when
changing color
For example if you want self nick as white underlined, do:
@ -1585,12 +1585,12 @@ Example of bold with terminal foreground color:
==== Storage
WeeChat can encrypt passwords or private data using secured data, stored in file
'sec.conf'.
_sec.conf_.
This configuration file is read before any other file, and the values stored
inside can be used in various WeeChat or plugins/scripts options.
You can set a passphrase to encrypt data in 'sec.conf'. This is not mandatory
You can set a passphrase to encrypt data in _sec.conf_. This is not mandatory
but highly recommended, otherwise data is stored as plain text in file.
----
@ -1613,9 +1613,9 @@ The encryption of data is made in 3 steps:
. Encrypt the hash + data (output is: salt + encrypted hash/data).
[NOTE]
The cipher block mode is 'CFB'.
The cipher block mode is _CFB_.
The result is put as hexadecimal string in file 'sec.conf', for example:
The result is put as hexadecimal string in file _sec.conf_, for example:
----
[data]
@ -1635,7 +1635,7 @@ The decryption of data is made in 3 steps:
[[secured_data_manage]]
==== Manage secured data
To add secured data, use `/secure set`, for example a password for 'freenode'
To add secured data, use `/secure set`, for example a password for _freenode_
IRC server:
----
@ -1654,7 +1654,7 @@ password, using this format: "${sec.data.xxx}" where "xxx" is the name of
secured data (used with `/secure set xxx ...`). +
For a complete list of supported options, see `/help secure`.
To use the 'freenode' password, for example with
To use the _freenode_ password, for example with
<<irc_sasl_authentication,SASL authentication>>:
----
@ -1730,9 +1730,9 @@ Under GNU/Linux, the file has ".so" extension, ".dll" under Windows.
Plugins found are automatically loaded when WeeChat is starting, and it is
possible to load or unload plugins while WeeChat is running.
It's important to make difference between a 'plugin' and a 'script': a
'plugin' is a binary file compiled and loaded with command `/plugin`, whereas
a 'script' is a text file loaded with a plugin like 'python' with command
It's important to make difference between a _plugin_ and a _script_: a
_plugin_ is a binary file compiled and loaded with command `/plugin`, whereas
a _script_ is a text file loaded with a plugin like _python_ with command
`/python`.
You can use command `/plugin` to load/unload a plugin, or list all loaded
@ -1774,7 +1774,7 @@ Default plugins are:
|===
To learn more about plugin or script development (through API), please read
'WeeChat Plugin API Reference' or 'WeeChat Scripting Guide'.
_WeeChat Plugin API Reference_ or _WeeChat Scripting Guide_.
[[alias_plugin]]
=== Alias plugin
@ -1840,10 +1840,10 @@ For example, to enable option "ignore-case":
==== Suggestions
Suggestions are displayed in a bar item called "aspell_suggest". The number of
suggestions is set in option 'aspell.check.suggestions'.
suggestions is set in option _aspell.check.suggestions_.
To enable suggestions you must set option 'aspell.check.suggestions' to an
integer ≥ 0 and add the bar item "aspell_suggest" to a bar, like 'status'.
To enable suggestions you must set option _aspell.check.suggestions_ to an
integer ≥ 0 and add the bar item "aspell_suggest" to a bar, like _status_.
Example of suggestions with English dictionary (`en`):
@ -1935,7 +1935,7 @@ For example:
If global decode charset is not set (for example during first
load of Charset plugin), it will be automatically set to terminal
charset (if it's different from UTF-8), or by default to 'ISO-8859-1'.
charset (if it's different from UTF-8), or by default to _ISO-8859-1_.
Default encode value is empty, so it sends by default with
internal charset (UTF-8).
@ -1974,7 +1974,7 @@ To see all charsets used, use following command:
[[charset_troubleshooting]]
==== Troubleshooting
For any problem with charsets, please look at 'WeeChat FAQ'.
For any problem with charsets, please look at _WeeChat FAQ_.
[[exec_plugin]]
=== Exec plugin
@ -2009,8 +2009,8 @@ include::autogen/user/exec_commands.asciidoc[]
You can remote control WeeChat, by sending commands or text to a FIFO pipe (if
option "plugins.var.fifo.fifo" is enabled, it is by default).
The FIFO pipe is located in '~/.weechat/' and is called 'weechat_fifo_xxxx'
(where 'xxxx' is the process ID (PID) of running WeeChat).
The FIFO pipe is located in _~/.weechat/_ and is called _weechat_fifo_xxxx_
(where _xxxx_ is the process ID (PID) of running WeeChat).
Syntax for the FIFO pipe commands/text is one of following:
@ -2088,8 +2088,8 @@ It is possible to give URL for one or many IRC servers, as follow:
irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]]
----
Example to join '#weechat' and '#toto' on server 'chat.freenode.net' server,
default port (6667), with nick 'nono':
Example to join _#weechat_ and _#toto_ on server _chat.freenode.net_ server,
default port (6667), with nick _nono_:
----
$ weechat irc://nono@chat.freenode.net/#weechat,#toto
@ -2194,11 +2194,11 @@ For more information, look at http://www.oftc.net/oftc/NickServ/CertFP
WeeChat supports SASL authentication, using different mechanisms:
* 'plain': plain text password (default)
* 'ecdsa-nist256p-challenge': challenge with public/private key
* 'external': client side SSL cert
* 'dh-blowfish': blowfish encrypted password (*insecure*, not recommended)
* 'dh-aes': AES encrypted password (*insecure*, not recommended)
* _plain_: plain text password (default)
* _ecdsa-nist256p-challenge_: challenge with public/private key
* _external_: client side SSL cert
* _dh-blowfish_: blowfish encrypted password (*insecure*, not recommended)
* _dh-aes_: AES encrypted password (*insecure*, not recommended)
[NOTE]
The "gcrypt" library is required when compiling WeeChat in order to use
@ -2206,13 +2206,13 @@ The "gcrypt" library is required when compiling WeeChat in order to use
Options in servers are:
* 'sasl_mechanism': mechanism to use (see above)
* 'sasl_timeout': timeout (in seconds) for authentication
* 'sasl_fail': action to perform if authentication fails
* 'sasl_username': username (nick)
* 'sasl_password': password
* 'sasl_key': file with ECC private key (for mechanism
'ecdsa-nist256p-challenge')
* _sasl_mechanism_: mechanism to use (see above)
* _sasl_timeout_: timeout (in seconds) for authentication
* _sasl_fail_: action to perform if authentication fails
* _sasl_username_: username (nick)
* _sasl_password_: password
* _sasl_key_: file with ECC private key (for mechanism
_ecdsa-nist256p-challenge_)
[[irc_sasl_ecdsa_nist256p_challenge]]
===== SASL ECDSA-NIST256P-CHALLENGE
@ -2419,7 +2419,7 @@ If CTCP options are not defined (by default), CTCP replies are:
==== Target buffer for IRC messages
It is possible to customize target buffer for IRC messages (buffer used to
display message) with options `irc.msgbuffer.*`.
display message) with options `+irc.msgbuffer.*+`.
For some IRC messages (see list below), you can use value:
@ -2428,7 +2428,7 @@ current::
private::
private buffer for nick, or current/server buffer if not found (according
to option 'irc.look.msgbuffer_fallback')
to option _irc.look.msgbuffer_fallback_)
server::
server buffer
@ -2702,9 +2702,9 @@ You'll have following files:
The Relay plugin is used to relay data via network, using different protocols:
* 'irc': IRC proxy: used to share connections to IRC servers with one or many
* _irc_: IRC proxy: used to share connections to IRC servers with one or many
other IRC clients
* 'weechat': protocol used by remote interfaces to display and interact with
* _weechat_: protocol used by remote interfaces to display and interact with
WeeChat (for example QWeeChat or weechat-android)
[[relay_options]]
@ -2741,7 +2741,7 @@ It is highly recommended to set a password for relay, with command:
/set relay.network.password "mypassword"
----
This password is used for 'irc' and 'weechat' protocols.
This password is used for _irc_ and _weechat_ protocols.
[[relay_ssl]]
==== SSL
@ -2749,7 +2749,7 @@ This password is used for 'irc' and 'weechat' protocols.
You can use SSL by creating a certificate and private key, and by using prefix
"ssl." in the name of protocol.
The default file for certificate/key is '~/.weechat/ssl/relay.pem'
The default file for certificate/key is _~/.weechat/ssl/relay.pem_
(option <<option_relay.network.ssl_cert_key,relay.network.ssl_cert_key>>).
You can create a certificate and private key with following commands:
@ -2836,7 +2836,7 @@ websocket = new WebSocket("ws://server.com:9000/weechat");
----
The port (9000 in example) is the port defined in Relay plugin.
The URI must always end with "/weechat" (for 'irc' and 'weechat' protocols).
The URI must always end with "/weechat" (for _irc_ and _weechat_ protocols).
[[scripts_plugins]]
=== Scripts plugins
@ -2850,7 +2850,7 @@ scripts of any language, and install/remove scripts of WeeChat scripts
repository, which are visible at this URL: https://weechat.org/scripts
For more information about how to write scripts, or WeeChat API for
scripts, please read 'WeeChat Scripting Guide'.
scripts, please read _WeeChat Scripting Guide_.
[[script_options]]
==== Script options (script.conf)
@ -2918,8 +2918,8 @@ commands. A condition can be used to prevent the trigger to run in some
circumstances.
Using triggers require you to know how the signals, modifiers, ... are working.
So you might consider reading the 'Hooks' chapter in the
'WeeChat Plugin API Reference'.
So you might consider reading the _Hooks_ chapter in the
_WeeChat Plugin API Reference_.
[[trigger_options]]
==== Options (trigger.conf)
@ -2962,7 +2962,7 @@ A trigger has the following options (names are
| hook | `signal`, `hsignal`, `modifier`, `print`, `command`, `command_run`,
`timer`, `config`, `focus` |
The hook used in trigger. For more information, see
'WeeChat Plugin API Reference', chapter 'Hooks'.
_WeeChat Plugin API Reference_, chapter _Hooks_.
| arguments | string |
The arguments for the hook, it depends on the hook type used.
@ -2985,7 +2985,7 @@ A trigger has the following options (names are
all triggers, the other values are rarely used).
|===
For example, the default 'beep' trigger has following options:
For example, the default _beep_ trigger has following options:
----
trigger.trigger.beep.enabled = on
@ -3006,7 +3006,7 @@ order, if triggers are globally enabled and if the trigger itself is enabled:
. check trigger conditions: if false, exit
. replace text in trigger using regular expression(s)
. execute command(s)
. exit with a return code (except for hooks 'modifier' and 'focus').
. exit with a return code (except for hooks _modifier_ and _focus_).
[[trigger_hook_arguments]]
==== Hook arguments
@ -3074,7 +3074,7 @@ The arguments depend on the hook used. They are separated by semicolons.
1. option name (priority allowed) (required) +
2. option name (priority allowed) +
3. ... |
`weechat.look.*`
`+weechat.look.*+`
| focus |
1. area name (priority allowed) (required) +
@ -3092,7 +3092,7 @@ They are evaluated, and data available in callback can be used
(see <<trigger_callback_data,data in callbacks>> and command
<<command_weechat_eval,/eval>>).
Example: the default 'beep' trigger uses this condition to make a beep only on
Example: the default _beep_ trigger uses this condition to make a beep only on
highlight or private message:
----
@ -3104,9 +3104,9 @@ ${tg_highlight} || ${tg_msg_pv}
The regular expression is used to change variables in callback hashtable.
The format is: "/regex/replace" or "/regex/replace/var" (where 'var' is a
The format is: "/regex/replace" or "/regex/replace/var" (where _var_ is a
variable of the hashtable). +
If 'var' is not specified, the default variable is used, it depends on hook
If _var_ is not specified, the default variable is used, it depends on hook
type:
[width="50%",cols="4,5m",options="header"]
@ -3134,8 +3134,8 @@ Matching groups can be used in "replace":
`${re:99}` are groups captured
* `${re:+}`: the last match (with highest number)
* `${hide:c,${re:N}}`: match "N" with all chars replaced by "c"
(example: `${hide:*,${re:2}}` is the group #2 with all chars replaced by
`*`).
(example: `+${hide:*,${re:2}}+` is the group #2 with all chars replaced by
`+*+`).
Example: use bold for words between "*":
@ -3143,9 +3143,9 @@ Example: use bold for words between "*":
/\*(\S+)\*/*${color:bold}${re:1}${color:-bold}*/
----
Example: default trigger 'server_pass' uses this regular expression to hide
Example: default trigger _server_pass_ uses this regular expression to hide
password in commands `/server` and `/connect` (chars in passwords are replaced
by `*`):
by `+*+`):
----
==^(/(server|connect) .*-(sasl_)?password=)(\S+)(.*)==${re:1}${hide:*,${re:4}}${re:5}
@ -3164,7 +3164,7 @@ Many commands can be separated by semicolons.
It is evaluated (see command <<command_weechat_eval,/eval>>) and text replaced
with a regular expression can be used in the command.
Example: default 'beep' trigger uses this command to make a beep (BEL):
Example: default _beep_ trigger uses this command to make a beep (BEL):
----
/print -beep
@ -3176,9 +3176,9 @@ Example: default 'beep' trigger uses this command to make a beep (BEL):
Data received in callbacks are stored in hashtables (pointers and strings) and
can be used in following options:
* 'conditions'
* 'regex'
* 'command'
* _conditions_
* _regex_
* _command_
The content of hashtables depend on the hook type.
@ -3214,12 +3214,12 @@ is added in hashtable:
| host | string | Hostname
| command | string | IRC command (example: "PRIVMSG", "NOTICE", ...)
| channel | string | IRC channel
| arguments | string | Arguments of command (includes value of 'channel')
| arguments | string | Arguments of command (includes value of _channel_)
| text | string | Text (for example user message)
| pos_command | string | The index of 'command' in message ("-1" if 'command' was not found)
| pos_arguments | string | The index of 'arguments' in message ("-1" if 'arguments' was not found)
| pos_channel | string | The index of 'channel' in message ("-1" if 'channel' was not found)
| pos_text | string | The index of 'text' in message ("-1" if 'text' was not found)
| pos_command | string | The index of _command_ in message ("-1" if _command_ was not found)
| pos_arguments | string | The index of _arguments_ in message ("-1" if _arguments_ was not found)
| pos_channel | string | The index of _channel_ in message ("-1" if _channel_ was not found)
| pos_text | string | The index of _text_ in message ("-1" if _text_ was not found)
|===
When the data is a pointer, the variable `tg_signal_data` can be used like this
@ -3257,7 +3257,7 @@ The "modifier" callback sets following variables in hashtable:
| tg_string_nocolor | string | The string without color codes
|===
For the 'weechat_print' modifier, variables using message tags are added (see
For the _weechat_print_ modifier, variables using message tags are added (see
<<trigger_data_print,hook print>> below), and following variables:
[width="100%",cols="3m,2,14",options="header"]
@ -3293,7 +3293,7 @@ The "print" callback sets following variables in hashtable:
| tg_message_nocolor | string | Message without color codes
|===
Variables set using tags in message (they are set in modifier 'weechat_print'
Variables set using tags in message (they are set in modifier _weechat_print_
too):
[width="100%",cols="3m,2,14",options="header"]
@ -3304,8 +3304,8 @@ too):
| tg_tag_nick | string | Nick (from tag "nick_xxx")
| tg_tag_prefix_nick | string | Color of nick in prefix (from tag "prefix_nick_ccc")
| tg_tag_host | string | User name and host, format: username@host (from tag "host_xxx")
| tg_tag_notify | string | Notify level ('none', 'message', 'private', 'highlight')
| tg_notify | string | Notify level, if different from 'none'
| tg_tag_notify | string | Notify level (_none_, _message_, _private_, _highlight_)
| tg_notify | string | Notify level, if different from _none_
| tg_msg_pv | string | "1" for a private message, otherwise "0"
|===
@ -3431,9 +3431,9 @@ hour:
Arguments for the timer hook are:
* '3600000': 3600 * 1000 milliseconds, the callback is called each hour
* '0': alignment on second (not aligned here)
* '0': max number of calls (0 = no end for the timer)
* _3600000_: 3600 * 1000 milliseconds, the callback is called each hour
* _0_: alignment on second (not aligned here)
* _0_: max number of calls (0 = no end for the timer)
The command `/mute /save` will silently save configuration files (nothing
displayed on core buffer).
@ -3476,12 +3476,12 @@ include::autogen/user/xfer_commands.asciidoc[]
Before asking for support, be sure you've read documentation and FAQ provided
with WeeChat.
For support with IRC, on server 'chat.freenode.net':
For support with IRC, on server _chat.freenode.net_:
* official channels (with developers):
** '#weechat' (English)
** '#weechat-fr' (French)
** _#weechat_ (English)
** _#weechat-fr_ (French)
* non-official channels:
** '#weechat-de' (German)
** _#weechat-de_ (German)
For other ways of support, see: https://weechat.org/dev/support

View File

@ -133,7 +133,7 @@ avec la version 2.7, mais pas avec les versions ≤ 2.6 ou ≥ 3.0).
[[compile_with_cmake]]
==== Compilation avec cmake
* Installation dans les répertoires systèmes (nécessite les droits 'root') :
* Installation dans les répertoires systèmes (nécessite les droits _root_) :
----
$ mkdir build
@ -287,7 +287,7 @@ cmake. +
La compilation avec les autotools requiert plus de dépendances et est plus lente
qu'avec cmake.
* Installation dans les répertoires systèmes (nécessite les droits 'root') :
* Installation dans les répertoires systèmes (nécessite les droits _root_) :
----
$ ./autogen.sh
@ -309,7 +309,7 @@ $ make
$ make install
----
Des options peuvent être utilisées pour le script 'configure', elles peuvent
Des options peuvent être utilisées pour le script _configure_, elles peuvent
être affichées avec cette commande :
----
@ -339,7 +339,7 @@ futur de WeeChat, vous devez :
* compiler avec les infos de debug (ou installer un paquet binaire avec les
infos de debug)
* activer les fichiers 'core' sur votre système
* activer les fichiers _core_ sur votre système
* installer gdb
[[debug_info]]
@ -354,12 +354,12 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
Si vous compilez avec les autotools, le debug est par défaut (`--with-debug=1`).
Si vous avez installé un paquet binaire, alors installez le paquet
'weechat-dbg'.
_weechat-dbg_.
[[core_files]]
==== Fichiers core
Pour activer les fichiers 'core', vous pouvez utiliser l'option
Pour activer les fichiers _core_, vous pouvez utiliser l'option
<<option_weechat.startup.sys_rlimit,weechat.startup.sys_rlimit>> :
----
@ -369,7 +369,7 @@ Pour activer les fichiers 'core', vous pouvez utiliser l'option
Pour WeeChat ≤ 0.3.8 ou si vous voulez activer les fichiers core avant que
WeeChat ne démarre, vous pouvez utiliser la commande `ulimit`.
Par exemple sous Linux avec le shell 'bash', ajoutez cette ligne dans votre
Par exemple sous Linux avec le shell _bash_, ajoutez cette ligne dans votre
`~/.bashrc` :
----
@ -385,13 +385,13 @@ ulimit -c 200000
[[gdb_backtrace]]
==== Obtenir la trace avec gdb
Lorsque WeeChat se plante, votre système génère un fichier 'core' ou
'core.12345' ('12345' est l'identifiant du processus).
Lorsque WeeChat se plante, votre système génère un fichier _core_ ou
_core.12345_ (_12345_ est l'identifiant du processus).
Ce fichier est créé dans le répertoire où vous avez lancé WeeChat (ce n'est
*pas* le répertoire où WeeChat est installé !).
Par exemple si 'weechat' est installé dans '/usr/bin/' et que le fichier
'core' est dans '/home/xxx/', alors lancez gdb avec cette commande :
Par exemple si _weechat_ est installé dans _/usr/bin/_ et que le fichier
_core_ est dans _/home/xxx/_, alors lancez gdb avec cette commande :
----
gdb /usr/bin/weechat /home/xxx/core
@ -438,7 +438,7 @@ Merci pour votre aide !
==== Debug de WeeChat qui tourne
Pour déboguer WeeChat qui tourne (par exemple si WeeChat semble bloqué), vous
pouvez utiliser gdb avec l'identifiant du processus (remplacez '12345' par le
pouvez utiliser gdb avec l'identifiant du processus (remplacez _12345_ par le
PID du processus weechat) :
----
@ -469,7 +469,7 @@ $ weechat
Lorsque vous lancez WeeChat pour la première fois, un fichier de configuration
par défaut est créé, avec les options par défaut.
Le fichier de configuration par défaut est : '~/.weechat/weechat.conf'.
Le fichier de configuration par défaut est : _~/.weechat/weechat.conf_.
Vous pouvez éditer ce fichier pour configurer WeeChat à votre convenance ou
vous pouvez modifier les paramètres dans WeeChat avec la commande `/set`
@ -515,12 +515,12 @@ L'écran est composé des zones suivantes :
** préfixe (avant "|")
** message (après "|")
* barres autour de la zone de discussion, les barres par défaut sont :
** barre 'title', au dessus de la zone de discussion
** barre 'status', sous la zone de discussion
** barre 'input', sous la barre de statut
** barre 'nicklist', sur la droite
** barre _title_, au dessus de la zone de discussion
** barre _status_, sous la zone de discussion
** barre _input_, sous la barre de statut
** barre _nicklist_, sur la droite
La barre 'status' contient les objets (items) suivants par défaut :
La barre _status_ contient les objets (items) suivants par défaut :
[width="100%",cols="^3,^4,10",options="header"]
|===
@ -533,14 +533,14 @@ La barre 'status' contient les objets (items) suivants par défaut :
| buffer_modes | `+n` | Modes du canal IRC
| buffer_nicklist_count | `{4}` | Nombre de pseudos dans la liste des pseudos
| buffer_zoom | ! | `!` signifie que le tampon mélangé est zoomé, une valeur vide signifie que tous les tampons mélangés sont affichés
| 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
| 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
| scroll | `-PLUS(50)-` | Indicateur de scroll, avec le nombre de lignes sous la dernière ligne affichée
| lag | `[Lag: 2.5]` | Indicateur de "lag" (ralentissements réseau), en secondes (caché si le lag est faible)
| hotlist | `[H: 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 tampon numéro 6)
| hotlist | `[H: 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 tampon numéro 6)
| completion | `abc(2) def(5)` | Liste des mots pour la complétion, avec le nombre de complétions possibles pour chaque mot
|===
La barre 'input' contient les objets (items) suivants par défaut :
La barre _input_ contient les objets (items) suivants par défaut :
[width="100%",cols="^3,^4,10",options="header"]
|===
@ -570,7 +570,7 @@ Autres objets (non utilisés dans des barres par défaut) :
[[buffers_and_windows]]
=== Tampons et fenêtres
Un tampon ('buffer') est composé d'un numéro, un nom, des lignes affichées
Un tampon (_buffer_) est composé d'un numéro, un nom, des lignes affichées
(ainsi que d'autres données).
Exemples de tampons :
@ -580,7 +580,7 @@ Exemples de tampons :
* canal irc
* privé irc
Une fenêtre ('window') est une zone de l'écran affichant un tampon. Il est
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.
@ -682,7 +682,7 @@ Exemple de découpage vertical + horizontal :
[[bars]]
=== Barres
Une 'barre' est une zone à côté de la discussion qui peut contenir tout type de
Une _barre_ est une zone à côté de la discussion qui peut contenir tout type de
texte.
Les options de barre sont définies avec les options `weechat.bar.nom.option` où
@ -697,12 +697,12 @@ Liste des options de barre :
| type | `root`, `window` |
Une barre avec le type `root` est affichée exactement une fois à l'écran, en
dehors de toutes les fenêtres. Il n'y a pas de barre root par défaut, mais un
exemple est la barre 'buffers' créée par le script 'buffers.pl' (barre
exemple est la barre _buffers_ créée par le script _buffers.pl_ (barre
latérale avec la liste des tampons). +
Une barre avec le type `window` est affichée dans chaque fenêtre, par exemple
si vous découpez l'écran (avec `/window splith` ou `/window splitv`), vous
aurez une barre dans chaque fenêtre. Les quatre barres par défaut ('title',
'status', 'input', 'nicklist') sont de type `window`.
aurez une barre dans chaque fenêtre. Les quatre barres par défaut (_title_,
_status_, _input_, _nicklist_) sont de type `window`.
| position | `top`, `bottom`, `left`, `right` |
Position de la barre : au dessus/en dessous de la discussion, sur la
@ -713,8 +713,8 @@ Liste des options de barre :
quand plusieurs barres utilisent le même type et position. +
Les barres sont affichées depuis le bord de l'écran vers le centre. Une
priorité plus haute affichera la barre au début, donc près du bord. +
Exemple : la barre 'input' a une priorité de 1000, donc elle est affichée
avant la barre 'status', qui a une priorité de 500.
Exemple : la barre _input_ a une priorité de 1000, donc elle est affichée
avant la barre _status_, qui a une priorité de 500.
| size | entier ≥ 0 |
La taille de la barre : nombre de colonnes pour une position left/right,
@ -764,7 +764,7 @@ Liste des options de barre :
[[bar_items]]
==== Objets
L'option 'items' est une chaîne avec une liste d'objets de barre, séparés par
L'option _items_ est une chaîne avec une liste d'objets de barre, séparés par
une virgule (espace entre les objets à l'écran) ou un "+" (objets collés).
La liste des objets de barre est affichée avec la commande `/bar listitems`.
@ -772,7 +772,7 @@ La liste des objets de barre est affichée avec la commande `/bar listitems`.
Avant ou après l'objet de barre, vous pouvez utiliser des caractères (qui ne
sont pas alphanumériques, "-" ou "_"). Ils seront affichés avant/après l'objet
de barre avec la couleur des délimiteurs définie dans la barre (option
'color_delim').
_color_delim_).
Exemple de barre avec les objets
"[time],buffer_number+:+buffer_plugin+.+buffer_name" :
@ -792,7 +792,7 @@ pour un tampon qui n'est pas affiché dans la fenêtre courante (ou même pas
affiché du tout).
Exemple : liste de pseudos de bitlbee dans une barre "root" (si la barre
s'appelle 'bitlist' et si le serveur bitlbee s'appelle 'bitlbee') :
s'appelle _bitlist_ et si le serveur bitlbee s'appelle _bitlbee_) :
----
/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist"
@ -816,10 +816,10 @@ Il y a quatre types de remplissage :
le texte est aligné à gauche. Le premier objet est en haut à gauche, le second
est sur la ligne en dessous.
Les barres par défaut 'title', 'status' et 'input' ont un remplissage
'horizontal', et la barre par défaut 'nicklist' a un remplissage 'vertical'.
Les barres par défaut _title_, _status_ et _input_ ont un remplissage
_horizontal_, et la barre par défaut _nicklist_ a un remplissage _vertical_.
Quelques exemples de remplissage pour la barre 'nicklist' :
Quelques exemples de remplissage pour la barre _nicklist_ :
....
┌───────────────────────────────────────────────────────────────────────┐
@ -882,14 +882,14 @@ Quelques exemples de remplissage pour la barre 'nicklist' :
[[bar_conditions]]
==== Conditions
L'option 'conditions' est une chaîne qui est évaluée pour savoir si la barre
L'option _conditions_ est une chaîne qui est évaluée pour savoir si la barre
doit être affichée ou non.
La chaîne peut être :
* 'active' : la fenêtre doit être active
* 'inactive' : la fenêtre doit être inactive
* 'nicklist' : le tampon affiché dans la fenêtre doit avoir une liste de pseudos
* _active_ : la fenêtre doit être active
* _inactive_ : la fenêtre doit être inactive
* _nicklist_ : le tampon affiché dans la fenêtre doit avoir une liste de pseudos
* une expression : elle est évaluée comme booléen (voir la commande
<<command_weechat_eval,/eval>>)
@ -913,7 +913,7 @@ liste de pseudos, et seulement si la largeur de fenêtre est supérieurs à 100
----
Même condition, mais afficher toujours la liste de pseudos sur le tampon
'&bitlbee' (même si la fenêtre est petite) :
_&bitlbee_ (même si la fenêtre est petite) :
----
/set weechat.bar.nicklist.conditions "${nicklist} && (${window.win_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)"
@ -922,7 +922,7 @@ Même condition, mais afficher toujours la liste de pseudos sur le tampon
[[bare_display]]
=== Affichage dépouillé
Un affichage spécial, appelé "dépouillé" ('bare display') peut être utilisé pour
Un affichage spécial, appelé "dépouillé" (_bare display_) peut être utilisé pour
un clic facile sur les URLs longs et la sélection de texte (avec la souris).
L'affichage dépouillé a les caractéristiques suivantes :
@ -1000,7 +1000,7 @@ L'écran ressemblera à ça en mode dépouillé :
└───────────────────────────────────────────────────────────────────────────┘
....
Donc vous pouvez cliquer l'URL de 'joe' sans problème dans votre terminal (bien
Donc vous pouvez cliquer l'URL de _joe_ sans problème dans votre terminal (bien
entendu cela suppose que votre terminal permet le clic sur les URLs).
[[notify_levels]]
@ -1009,25 +1009,25 @@ entendu cela suppose que votre terminal permet le clic sur les URLs).
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
* _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'.
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'
| 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
@ -1037,7 +1037,7 @@ 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 :
Définir le niveau de notification _highlight_ sur le canal "#weechat" seulement :
----
/set weechat.notify.irc.freenode.#weechat highlight
@ -1137,8 +1137,8 @@ commande `/buffer` :
kbd:[F6] | Aller au tampon suivant | `/buffer +1`
| kbd:[F7] | Aller à la fenêtre précédente | `/window -1`
| kbd:[F8] | Aller à la fenêtre suivante | `/window +1`
| kbd:[F9] | Faire défiler le titre du tampon vers la gauche | `/bar scroll title * -30%`
| kbd:[F10] | Faire défiler le titre du tampon vers la droite | `/bar scroll title * +30%`
| kbd:[F9] | Faire défiler le titre du tampon vers la gauche | `+/bar scroll title * -30%+`
| kbd:[F10] | Faire défiler le titre du tampon vers la droite | `+/bar scroll title * +30%+`
| kbd:[F11] | Monter d'une page dans la liste des pseudos | `/bar scroll nicklist * -100%`
| kbd:[F12] | Descendre d'une page dans la liste des pseudos | `/bar scroll nicklist * +100%`
| kbd:[Alt+F11] | Aller au début de la liste des pseudos | `/bar scroll nicklist * b`
@ -1310,7 +1310,7 @@ terminal, comme si la souris était désactivée (sous certains terminaux comme
iTerm, vous devez utiliser kbd:[Alt] au lieu de kbd:[Shift]).
[NOTE]
Pour tout problème avec la souris, merci de consulter la 'FAQ WeeChat'.
Pour tout problème avec la souris, merci de consulter la _FAQ WeeChat_.
[[mouse_bind_events]]
==== Associer des évènements souris à des commandes
@ -1413,14 +1413,14 @@ commande. Par exemple pour afficher la liste de toutes les options :
----
Le texte envoyé à un tampon est tout texte ne commençant pas par le
caractère "/", par exemple pour envoyer 'bonjour' sur le tampon courant :
caractère "/", par exemple pour envoyer _bonjour_ sur le tampon courant :
----
bonjour
----
Il est cependant possible de faire débuter un texte par "/" en le
doublant. Par exemple pour envoyer le texte '/set' sur le tampon courant :
doublant. Par exemple pour envoyer le texte `/set` sur le tampon courant :
----
//set
@ -1479,7 +1479,7 @@ WeeChat peut utiliser jusqu'à 256 paires de couleur pour afficher le texte dans
les barres et la zone de discussion (votre terminal doit supporter 256 couleurs
pour pouvoir les utiliser dans WeeChat).
Selon la valeur de la variable d'environnement 'TERM', vous pouvez avoir les
Selon la valeur de la variable d'environnement _TERM_, vous pouvez avoir les
limites suivantes pour les couleurs dans WeeChat :
[width="50%",cols="8,>2,>2",options="header"]
@ -1496,25 +1496,25 @@ limites suivantes pour les couleurs dans WeeChat :
Vous pouvez lancer `weechat --colors` ou utiliser la commande `/color`
dans WeeChat pour afficher les limites de votre environnement.
Quelques valeurs recommandées pour 'TERM' si vous voulez 256 couleurs :
Quelques valeurs recommandées pour _TERM_ si vous voulez 256 couleurs :
* sous screen : 'screen-256color'
* sous tmux : 'screen-256color' ou 'tmux-256color'
* en dehors de screen/tmux : 'xterm-256color', 'rxvt-256color',
'putty-256color', ...
* sous screen : _screen-256color_
* sous tmux : _screen-256color_ ou _tmux-256color_
* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_,
_putty-256color_, ...
Si vous utilisez screen, vous pouvez ajouter cette ligne dans votre
'~/.screenrc' :
_~/.screenrc_ :
[NOTE]
Vous devrez peut-être installer le paquet "ncurses-term" pour utiliser ces
valeurs dans la variable 'TERM'.
valeurs dans la variable _TERM_.
----
term screen-256color
----
Si votre variable 'TERM' a une valeur erronée et que WeeChat est déjà lancé,
Si votre variable _TERM_ a une valeur erronée et que WeeChat est déjà lancé,
vous pouvez la changer avec ces deux commandes :
----
@ -1594,11 +1594,11 @@ Par exemple :
Il est possible d'utiliser des attributs pour les couleurs. Un ou plusieurs
attributs peuvent être ajoutés avant le nom ou le numéro de la couleur :
* `*` : texte gras
* `!` : mode vidéo inverse
* `/` : italique
* `_` : texte souligné
* `|` : garder les attributs : ne pas réinitialiser gras/inverse/souligné lors
* `+*+` : texte gras
* `+!+` : mode vidéo inverse
* `+/+` : italique
* `+_+` : texte souligné
* `+|+` : garder les attributs : ne pas réinitialiser gras/inverse/souligné lors
du changement de couleur
Par exemple si vous voulez votre pseudo en blanc souligné, faites :
@ -1630,14 +1630,14 @@ Exemple de gras avec la couleur de texte du terminal :
==== Stockage
WeeChat peut chiffrer les mots de passe ou les données sensibles en utilisant
des données sécurisées, stockées dans le fichier 'sec.conf'.
des données sécurisées, stockées dans le fichier _sec.conf_.
Ce fichier de configuration est lu avant tout autre fichier, et les valeurs
ici stockées peuvent être utilisées dans diverses options de WeeChat ou des
extensions/scripts.
Vous pouvez définir une phrase secrète pour chiffrer les données dans le fichier
'sec.conf'. Ce n'est pas obligatoire, mais fortement recommandé, sinon les
_sec.conf_. Ce n'est pas obligatoire, mais fortement recommandé, sinon les
données sont stockées sous forme de texte en clair dans le fichier.
----
@ -1662,10 +1662,10 @@ Le chiffrement des données se fait en 3 étapes :
contrôle et données chiffrées).
[NOTE]
Le mode de chiffrement par bloc est 'CFB'.
Le mode de chiffrement par bloc est _CFB_.
Le résultat est stocké sous forme d'une chaîne hexadécimale dans le fichier
'sec.conf', par exemple :
_sec.conf_, par exemple :
----
[data]
@ -1687,7 +1687,7 @@ Le déchiffrement des données se fait en 3 étapes :
==== Gérer les données sécurisées
Pour ajouter une donnée sécurisée, utilisez la commande `/secure set`, par
exemple un mot de passe pour le serveur IRC 'freenode' :
exemple un mot de passe pour le serveur IRC _freenode_ :
----
/secure set freenode motdepasse
@ -1707,7 +1707,7 @@ contenir des données sensibles comme un mot de passe, en utilisant ce format :
commande `/secure set xxx ...`). +
Pour une liste complète des options supportées, voir `/help secure`.
Pour utiliser le mot de passe 'freenode', par exemple avec
Pour utiliser le mot de passe _freenode_, par exemple avec
<<irc_sasl_authentication,l'authentification SASL>> :
----
@ -1784,10 +1784,10 @@ Les extensions trouvées sont automatiquement chargées par WeeChat lorsqu'il
démarre, et il est possible de charger et décharger des extensions pendant que
WeeChat tourne.
Il est important de bien faire la différence entre une 'extension' et un
'script' : une 'extension' est un fichier binaire compilé et chargé avec la
commande `/plugin`, tandis qu'un 'script' est un fichier texte chargé par une
extension comme 'python' par la commande `/python`.
Il est important de bien faire la différence entre une _extension_ et un
_script_ : une _extension_ est un fichier binaire compilé et chargé avec la
commande `/plugin`, tandis qu'un _script_ est un fichier texte chargé par une
extension comme _python_ par la commande `/python`.
Vous pouvez utiliser la commande `/plugin` pour charger/décharger une
extension, ou afficher les extensions chargées.
@ -1828,8 +1828,8 @@ Les extensions par défaut sont :
|===
Pour en apprendre plus sur le développement d'extension ou de script (via
l'API), merci de consulter la 'Référence API Extension WeeChat' ou le 'Guide
pour Scripts WeeChat'.
l'API), merci de consulter la _Référence API Extension WeeChat_ ou le
_Guide pour Scripts WeeChat_.
[[alias_plugin]]
=== Extension Alias
@ -1895,11 +1895,11 @@ Par exemple, pour activer l'option "ignore-case" :
==== Suggestions
Les suggestions sont affichées dans un objet de barre appelé "aspell_suggest".
Le nombre de suggestions est défini dans l'option 'aspell.check.suggestions'.
Le nombre de suggestions est défini dans l'option _aspell.check.suggestions_.
Pour activer les suggestions, vous devez modifier l'option
'aspell.check.suggestions' avec un entier ≥ 0 et ajouter l'objet de barre
"aspell_suggest" à une barre, par exemple 'status'.
_aspell.check.suggestions_ avec un entier ≥ 0 et ajouter l'objet de barre
"aspell_suggest" à une barre, par exemple _status_.
Exemple de suggestions avec un dictionnaire anglais (`en`) :
@ -1996,7 +1996,7 @@ Par exemple :
Si le jeu de caractères de décodage global n'est pas renseigné (par exemple
pendant le premier chargement de Charset), il sera renseigné automatiquement
avec le jeu de caractères du terminal (s'il est différent de UTF-8) ou par
défaut à 'ISO-8859-1'.
défaut à _ISO-8859-1_.
La valeur d'encodage par défaut est vide, donc WeeChat envoie par défaut avec
le jeu de caractères interne (UTF-8).
@ -2039,7 +2039,7 @@ Pour voir tous les jeux de caractères utilisés, utilisez la commande suivante
==== En cas de problème
Pour tout problème avec les jeux de caractères, merci de consulter la
'FAQ WeeChat'.
_FAQ WeeChat_.
[[exec_plugin]]
=== Extension Exec
@ -2072,11 +2072,11 @@ include::autogen/user/exec_commands.asciidoc[]
=== Extension Fifo
Vous pouvez contrôler WeeChat à distance, en envoyant des commandes ou du
texte dans un tube FIFO (si l'option 'plugins.var.fifo.fifo' est activée,
texte dans un tube FIFO (si l'option _plugins.var.fifo.fifo_ est activée,
elle l'est par défaut).
Le tube FIFO est dans le répertoire '~/.weechat/' et s'appelle
'weechat_fifo_xxxx' (où 'xxxx' est l'ID du processus (PID) du WeeChat qui
Le tube FIFO est dans le répertoire _~/.weechat/_ et s'appelle
_weechat_fifo_xxxx_ (où _xxxx_ est l'ID du processus (PID) du WeeChat qui
tourne).
La syntaxe pour envoyer des commandes ou du texte dans le tube FIFO est une
@ -2158,8 +2158,8 @@ Il est possible de passer une URL pour un ou plusieurs serveurs, comme suit :
irc[6][s]://[pseudo[:mot_passe]@]irc.example.org[:port][/canal][,canal[...]]
----
Exemple pour rejoindre '#weechat' et '#toto' sur le serveur 'chat.freenode.net',
port par défaut (6667), avec le pseudo 'nono' :
Exemple pour rejoindre _#weechat_ et _#toto_ sur le serveur _chat.freenode.net_,
port par défaut (6667), avec le pseudo _nono_ :
----
$ weechat irc://nono@chat.freenode.net/#weechat,#toto
@ -2268,11 +2268,11 @@ Pour plus d'informations, consulter http://www.oftc.net/oftc/NickServ/CertFP
WeeChat supporte l'authentification avec SASL, en utilisant différents
mécanismes :
* 'plain' : mot de passe en clair (par défaut)
* 'ecdsa-nist256p-challenge' : challenge avec clé publique/privée
* 'external' : certificat SSL côté client
* 'dh-blowfish' : mot de passe chiffré avec blowfish (*non sûr*, non recommandé)
* 'dh-aes' : mot de passe chiffré avec AES (*non sûr*, non recommandé)
* _plain_ : mot de passe en clair (par défaut)
* _ecdsa-nist256p-challenge_ : challenge avec clé publique/privée
* _external_ : certificat SSL côté client
* _dh-blowfish_ : mot de passe chiffré avec blowfish (*non sûr*, non recommandé)
* _dh-aes_ : mot de passe chiffré avec AES (*non sûr*, non recommandé)
[NOTE]
La librairie "gcrypt" est requise lors de la compilation de WeeChat pour
@ -2280,13 +2280,13 @@ utiliser le mécanisme "dh-blowfish" (voir <<dependencies,les dépendances>>).
Les options dans le serveur sont :
* 'sasl_mechanism' : mécanisme à utiliser (voir ci-dessus)
* 'sasl_timeout' : délai d'attente maximum (en secondes) pour l'authentification
* 'sasl_fail' : action à effectuer si l'authentification échoue
* 'sasl_username' : nom d'utilisateur (pseudo)
* 'sasl_password' : mot de passe
* 'sasl_key' : fichier avec la clé privée ECC (pour le mécanisme
'ecdsa-nist256p-challenge')
* _sasl_mechanism_ : mécanisme à utiliser (voir ci-dessus)
* _sasl_timeout_ : délai d'attente maximum (en secondes) pour l'authentification
* _sasl_fail_ : action à effectuer si l'authentification échoue
* _sasl_username_ : nom d'utilisateur (pseudo)
* _sasl_password_ : mot de passe
* _sasl_key_ : fichier avec la clé privée ECC (pour le mécanisme
_ecdsa-nist256p-challenge_)
[[irc_sasl_ecdsa_nist256p_challenge]]
===== SASL ECDSA-NIST256P-CHALLENGE
@ -2497,7 +2497,7 @@ Si les options CTCP ne sont pas définies (par défaut), les réponses CTCP sont
==== Tampon cible pour les messages IRC
Il est possible de personnaliser le tampon cible pour les messages IRC (le
tampon utilisé pour afficher le message) avec les options `irc.msgbuffer.*`.
tampon utilisé pour afficher le message) avec les options `+irc.msgbuffer.*+`.
Pour certains messages IRC (voir la liste ci-dessous), vous pouvez utiliser
la valeur :
@ -2507,7 +2507,7 @@ current::
private::
tampon privé pour le pseudo, ou le tampon courant s'il n'est pas trouvé
(selon l'option 'irc.look.msgbuffer_fallback')
(selon l'option _irc.look.msgbuffer_fallback_)
server::
tampon du serveur
@ -2785,9 +2785,9 @@ Vous obtiendrez les fichiers suivants :
L'extension Relay est utilisée pour relayer des données via le réseau, en
utilisant divers protocoles :
* 'irc' : proxy IRC : utilisé pour partager la connexions aux serveurs IRC avec
* _irc_ : proxy IRC : utilisé pour partager la connexions aux serveurs IRC avec
un ou plusieurs autres clients IRC
* 'weechat' : protocole utilisé par les interfaces distantes (par exemple
* _weechat_ : protocole utilisé par les interfaces distantes (par exemple
QWeeChat ou weechat-android).
[[relay_options]]
@ -2825,7 +2825,7 @@ commande :
/set relay.network.password "motdepasse"
----
Ce mot de passe sera utilisé pour les protocoles 'irc' et 'weechat'.
Ce mot de passe sera utilisé pour les protocoles _irc_ et _weechat_.
[[relay_ssl]]
==== SSL
@ -2833,7 +2833,7 @@ Ce mot de passe sera utilisé pour les protocoles 'irc' et 'weechat'.
Vous pouvez utiliser SSL en créant un certificat et clé privée et en utilisant
le préfixe "ssl." dans le nom du protocole.
Le fichier par défaut pour le certificat/clé est '~/.weechat/ssl/relay.pem'
Le fichier par défaut pour le certificat/clé est _~/.weechat/ssl/relay.pem_
(option <<option_relay.network.ssl_cert_key,relay.network.ssl_cert_key>>).
Vous pouvez créer le certificat et la clé privée avec les commandes suivantes :
@ -2926,8 +2926,8 @@ websocket = new WebSocket("ws://server.com:9000/weechat");
----
Le port (9000 dans l'exemple) est le port défini dans l'extension Relay.
L'URI doit toujours se terminer par "/weechat" (pour les protocoles 'irc' et
'weechat').
L'URI doit toujours se terminer par "/weechat" (pour les protocoles _irc_ et
_weechat_).
[[scripts_plugins]]
=== Extensions Scripts
@ -2943,7 +2943,7 @@ installer/supprimer des scripts du dépôt WeeChat, qui sont visibles à cette
URL : https://weechat.org/scripts
Pour plus d'informations sur comment écrire des scripts, ou sur l'API
WeeChat pour les scripts, merci de lire le 'Le Guide pour Scripts WeeChat'.
WeeChat pour les scripts, merci de lire le _Le Guide pour Scripts WeeChat_.
[[script_options]]
==== Options Script (script.conf)
@ -3011,8 +3011,8 @@ une ou plusieurs commandes. Une condition peut être utilisée pour empêcher le
trigger de s'exécuter dans certaines circonstances.
Utiliser les triggers nécessite de connaître le fonctionnement des signaux,
modificateurs, etc... Il peut être utile de lire le chapitre sur les 'Hooks'
dans la 'Référence API Extension WeeChat'.
modificateurs, etc... Il peut être utile de lire le chapitre sur les _Hooks_
dans la _Référence API Extension WeeChat_.
[[trigger_options]]
==== Options (trigger.conf)
@ -3055,7 +3055,7 @@ Un trigger a les options suivantes (les noms sont
| hook | `signal`, `hsignal`, `modifier`, `print`, `command`, `command_run`,
`timer`, `config`, `focus` |
Le "hook" utilisé dans le trigger. Pour plus d'information, voir le chapitre
'Hooks' dans la 'Référence API Extension WeeChat'.
_Hooks_ dans la _Référence API Extension WeeChat_.
| arguments | chaîne |
Les paramètres pour le "hook", ils dépendent du type de hook utilisé.
@ -3079,7 +3079,7 @@ Un trigger a les options suivantes (les noms sont
quasiment tous les triggers, les autres valeurs sont rarement utilisées).
|===
Par exemple, le trigger 'beep' par défaut a les options suivantes :
Par exemple, le trigger _beep_ par défaut a les options suivantes :
----
trigger.trigger.beep.enabled = on
@ -3101,7 +3101,7 @@ trigger lui-même est activé :
. vérifier les conditions du trigger : si faux, sortir
. remplacer du texte dans le trigger en utilisant des expressions régulières
. exécuter la/les commande(s)
. sortir avec un code retour (sauf pour les "hooks" 'modifier' et 'focus').
. sortir avec un code retour (sauf pour les "hooks" _modifier_ et _focus_).
[[trigger_hook_arguments]]
==== Paramètres du hook
@ -3170,7 +3170,7 @@ points-virgules.
1. nom d'option (priorité autorisée) (obligatoire) +
2. nom d'option (priorité autorisée) +
3. ... |
`weechat.look.*`
`+weechat.look.*+`
| focus |
1. nom d'aire (priorité autorisée) (obligatoire) +
@ -3189,7 +3189,7 @@ Elles sont évaluées, et les données disponibles dans le callback peuvent êtr
utilisées (voir <<trigger_callback_data,données dans les callbacks>> et la
commande <<command_weechat_eval,/eval>>).
Exemple : le trigger 'beep' par défaut utilise cette condition pour faire un
Exemple : le trigger _beep_ par défaut utilise cette condition pour faire un
beep seulement sur un highlight ou un message privé :
----
@ -3202,9 +3202,9 @@ ${tg_highlight} || ${tg_msg_pv}
L'expression régulière est utilisée pour modifier des variables dans la table de
hachage du callback.
Le format est : "/regex/remplacement" ou "/regex/remplacement/var" (où 'var' est
Le format est : "/regex/remplacement" ou "/regex/remplacement/var" (où _var_ est
une variable de la table de hachage). +
Si 'var' n'est pas spécifiée, la variable par défaut est utilisée, elle dépend
Si _var_ n'est pas spécifiée, la variable par défaut est utilisée, elle dépend
du type de hook :
[width="50%",cols="4,5m",options="header"]
@ -3233,8 +3233,8 @@ Les groupes de correspondance peuvent être utilisés dans le "remplacement" :
à `${re:99}` sont les groupes capturés
* `${re:+}` : la dernière correspondance (avec le numéro le plus élevé)
* `${hide:c,${re:N}}` : la correspondance "N" avec tous les caractères
remplacés par "c" (exemple : `${hide:*,${re:2}}` est le groupe n°2 avec tous
les caractères remplacés par `*`).
remplacés par "c" (exemple : `+${hide:*,${re:2}}+` est le groupe n°2 avec tous
les caractères remplacés par `+*+`).
Exemple : utiliser du gras pour les mots entre "*" :
@ -3242,9 +3242,9 @@ Exemple : utiliser du gras pour les mots entre "*" :
/\*(\S+)\*/*${color:bold}${re:1}${color:-bold}*/
----
Exemple : le trigger par défaut 'server_pass' utilise cette expression régulière
Exemple : le trigger par défaut _server_pass_ utilise cette expression régulière
pour cacher le mot de passe dans les commandes `/server` et `/connect` (les
caractères des mots de passe sont remplacés par `*`) :
caractères des mots de passe sont remplacés par `+*+`) :
----
==^(/(server|connect) .*-(sasl_)?password=)(\S+)(.*)==${re:1}${hide:*,${re:4}}${re:5}
@ -3264,7 +3264,7 @@ Plusieurs commandes peuvent être séparées par des points-virgules.
Elle est évaluée (voir la commande <<command_weechat_eval,/eval>>) et le texte
remplacé avec l'expression régulière peut être utilisé dans la commande.
Exemple : le trigger par défaut 'beep' utilise cette commande pour produire un
Exemple : le trigger par défaut _beep_ utilise cette commande pour produire un
beep (BEL) :
----
@ -3277,9 +3277,9 @@ beep (BEL) :
Les données reçues dans les callbacks sont stockées dans des tables de hachage
(pointeurs et chaînes) et peuvent être utilisées dans les options suivantes :
* 'conditions'
* 'regex'
* 'command'
* _conditions_
* _regex_
* _command_
Le contenu des tables de hachage dépend du type de hook.
@ -3315,12 +3315,12 @@ suivantes sont ajoutées dans la table de hachage :
| host | chaîne | Nom d'hôte
| command | chaîne | Commande IRC (exemple : "PRIVMSG", "NOTICE", ...)
| channel | chaîne | Canal IRC
| arguments | chaîne | Paramètres de la commande (inclut la valeur de 'channel')
| arguments | chaîne | Paramètres de la commande (inclut la valeur de _channel_)
| text | chaîne | Texte (par exemple message utilisateur)
| pos_command | chaîne | L'index de 'command' dans le message ("-1" si 'command' n'a pas été trouvé)
| pos_arguments | chaîne | L'index de 'arguments' dans le message ("-1" si 'arguments' n'a pas été trouvé)
| pos_channel | chaîne | L'index de 'channel' dans le message ("-1" si 'channel' n'a pas été trouvé)
| pos_text | chaîne | L'index de 'text' dans le message ("-1" si 'text' n'a pas été trouvé)
| pos_command | chaîne | L'index de _command_ dans le message ("-1" si _command_ n'a pas été trouvé)
| pos_arguments | chaîne | L'index de _arguments_ dans le message ("-1" si _arguments_ n'a pas été trouvé)
| pos_channel | chaîne | L'index de _channel_ dans le message ("-1" si _channel_ n'a pas été trouvé)
| pos_text | chaîne | L'index de _text_ dans le message ("-1" si _text_ n'a pas été trouvé)
|===
Lorsque la donnée est un pointeur, la variable `tg_signal_data` peut être
@ -3359,7 +3359,7 @@ Le callback "modifier" définit les variables suivantes dans la table de hachage
| tg_string_nocolor | chaîne | La chaîne sans les codes couleur
|===
Pour le modificateur 'weechat_print', les variables en utilisant les étiquettes
Pour le modificateur _weechat_print_, les variables en utilisant les étiquettes
du message sont ajoutées (voir le <<trigger_data_print,hook print>> ci-dessous),
ainsi que les variables suivantes :
@ -3398,7 +3398,7 @@ Le callback "print" définit les variables suivantes dans la table de hachage :
|===
Variables définies avec les étiquettes du message (elles sont définies aussi
pour le modificateur 'weechat_print') :
pour le modificateur _weechat_print_) :
[width="100%",cols="3m,2,14",options="header"]
|===
@ -3408,8 +3408,8 @@ pour le modificateur 'weechat_print') :
| tg_tag_nick | chaîne | Pseudo (depuis l'étiquette "nick_xxx")
| tg_tag_prefix_nick | chaîne | Couleur du pseudo dans le préfixe (depuis l'étiquette "prefix_nick_ccc")
| tg_tag_host | chaîne | Nom d'utilisateur et hôte, format : utilisateur@hôte (depuis l'étiquette "host_xxx")
| tg_tag_notify | chaîne | Niveau de notification ('none', 'message', 'private', 'highlight')
| tg_notify | chaîne | Niveau de notification, si différent de 'none'
| tg_tag_notify | chaîne | Niveau de notification (_none_, _message_, _private_, _highlight_)
| tg_notify | chaîne | Niveau de notification, si différent de _none_
| tg_msg_pv | chaîne | "1" pour un message privé, sinon "0"
|===
@ -3538,10 +3538,10 @@ Vous pouvez sauvegarder automatiquement les fichiers de configuration
Les paramètres pour le minuteur sont :
* '3600000' : 3600 * 1000 millisecondes, le callback est appelé toutes les
* _3600000_ : 3600 * 1000 millisecondes, le callback est appelé toutes les
heures
* '0' : alignement sur la seconde (pas d'alignement ici)
* '0' : nombre maximum d'appels (0 = pas de fin pour le minuteur)
* _0_ : alignement sur la seconde (pas d'alignement ici)
* _0_ : nombre maximum d'appels (0 = pas de fin pour le minuteur)
La commande `/mute /save` sauvegarde silencieusement les fichiers de
configuration (rien n'est affiché sur le tampon "core").
@ -3584,12 +3584,12 @@ include::autogen/user/xfer_commands.asciidoc[]
Avant de faire appel au support, merci de lire la documentation et la FAQ de
WeeChat.
Pour le support via IRC, sur le serveur 'chat.freenode.net' :
Pour le support via IRC, sur le serveur _chat.freenode.net_ :
* canaux officiels (avec les développeurs) :
** '#weechat' (Anglais)
** '#weechat-fr' (Français)
** _#weechat_ (Anglais)
** _#weechat-fr_ (Français)
* canaux non officiels :
** '#weechat-de' (Allemand)
** _#weechat-de_ (Allemand)
Pour les autres formes de support, voir : https://weechat.org/dev/support

View File

@ -58,7 +58,7 @@ Per poter installare WeeChat, è necessario:
* un sistema GNU/Linux in esecuzione (con gli strumenti di
compilazione per i sorgenti), oppure OS compatibile
* privilegi di 'root' (per installare WeeChat in una directory di
* privilegi di _root_ (per installare WeeChat in una directory di
sistema)
// TRANSLATION MISSING
* some libraries (see <<dependencies,dependencies>>).
@ -154,7 +154,7 @@ correttamente con la versione 2.7, ma non con le versioni ≤ 2.6 o ≥ 3.0).
[[compile_with_cmake]]
==== Compilazione con cmake
* Installazione nelle directory di sistema (richiede privilegi di 'root'):
* Installazione nelle directory di sistema (richiede privilegi di _root_):
----
$ mkdir build
@ -311,7 +311,7 @@ Only cmake is officially supported to build WeeChat. You should use autotools
only if you are not able to use cmake. +
Build with autotools requires more dependencies and is slower than with cmake.
* Installazione nelle directory di sistema (richiede privilegi di 'root'):
* Installazione nelle directory di sistema (richiede privilegi di _root_):
----
$ ./autogen.sh
@ -334,7 +334,7 @@ $ make install
----
// TRANSLATION MISSING
Options can be used for 'configure' script, they can be displayed with this
Options can be used for _configure_ script, they can be displayed with this
command:
----
@ -364,7 +364,7 @@ futuro di WeeChat, è necessario:
* compilarlo con informazioni di debug (o installare il pacchetto binario con
le informazioni di debug)
* abilitare i file 'core' sul proprio sistema
* abilitare i file _core_ sul proprio sistema
* installare gdb
[[debug_info]]
@ -378,13 +378,13 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
Se compilato con gli autotools, il debug è attivato automaticamente (`--with-debug=1`).
Se è stato installato il pacchetto binario, installare il pacchetto 'weechat-gdb'.
Se è stato installato il pacchetto binario, installare il pacchetto _weechat-gdb_.
[[core_files]]
==== File core
// TRANSLATION MISSING
To enable 'core' files, you can use option
To enable _core_ files, you can use option
<<option_weechat.startup.sys_rlimit,weechat.startup.sys_rlimit>>:
----
@ -395,7 +395,7 @@ To enable 'core' files, you can use option
For WeeChat ≤ 0.3.8 or if you want to enable core files even before WeeChat
starts, you can use `ulimit` command.
Ad esempio su Linux con la shell 'bash', aggiungere questa riga al proprio
Ad esempio su Linux con la shell _bash_, aggiungere questa riga al proprio
`~/.bashrc`:
----
@ -411,13 +411,13 @@ ulimit -c 200000
[[gdb_backtrace]]
==== Ottenere un backtrace con gdb
In caso di errore di WeeChat, il sistema creerà un file 'core' oppure 'core.12345'
('12345' è l'id del processo).
In caso di errore di WeeChat, il sistema creerà un file _core_ oppure _core.12345_
(_12345_ è l'id del processo).
Questo file viene creato nella directory in cui è in esecuzione WeeChat (e
*non* la directory dove WeeChat è installato!).
Ad esempio, se 'weechat' è installato in '/usr/bin/' ed il file 'core'
si trova in '/home/xxx/', allora eseguire gdb con questo comando:
Ad esempio, se _weechat_ è installato in _/usr/bin/_ ed il file _core_
si trova in _/home/xxx/_, allora eseguire gdb con questo comando:
----
gdb /usr/bin/weechat /home/xxx/core
@ -465,7 +465,7 @@ Grazie per il vostro aiuto!
Per eseguire il debug di un'istanza di WeeChat in esecuzione (ad esempio se
WeeChat sembra sia bloccato), è possibile usare gdb con l'id del processo
(sostituire '12345' con il PID del processo weechat):
(sostituire _12345_ con il PID del processo weechat):
----
gdb /usr/bin/weechat 12345
@ -495,7 +495,7 @@ $ weechat
Alla prima esecuzione di WeeChat, viene creato un file di configurazione
predefinito. Il file di configurazione viene creato nella directory:
'~/.weechat/weechat.conf'.
_~/.weechat/weechat.conf_.
È possibile modificare questo file per configurare WeeChat a seconda delle
proprie esigenze, oppure impostando i parametri con il comando `/set`
@ -541,12 +541,12 @@ Lo schermo è composto dalle seguenti aree:
** prefisso (prima di "|")
** messaggio (dopo di "|")
* barre che circondano l'area di chat, quelle predefinite sono:
** barra 'titolo', in alto rispetto all'area di chat
** barra 'stato', in basso rispetto all'area di chat
** barra 'input', in basso rispetto alla barra di stato
** barra 'nicklist', sulla destra
** barra _titolo_, in alto rispetto all'area di chat
** barra _stato_, in basso rispetto all'area di chat
** barra _input_, in basso rispetto alla barra di stato
** barra _nicklist_, sulla destra
La barra 'stato' ha i seguenti elementi predefiniti:
La barra _stato_ ha i seguenti elementi predefiniti:
[width="100%",cols="^3,^4,10",options="header"]
|===
@ -561,14 +561,14 @@ La barra 'stato' ha i seguenti elementi predefiniti:
| buffer_nicklist_count | `{4}` | Numero di nick nella lista nick
// TRANSLATION MISSING
| buffer_zoom | ! | `!` means the merged buffer is zoomed (only this one is displayed), empty value means all merged buffers are displayed
| buffer_filter | `*` | Indicatore filtraggio: `*` significa che alcune righe sono filtrate (nascoste), valori vuoti indicano che tutte le righe sono visualizzate
| buffer_filter | `+*+` | Indicatore filtraggio: `+*+` significa che alcune righe sono filtrate (nascoste), valori vuoti indicano che tutte le righe sono visualizzate
| scroll | `-ANCORA(50)-` | Indicatore di scorrimento, con il numero di righe sotto l'ultima riga visualizzata
| lag | `[Ritardo: 2.5]` | Indicatore ritardo, in secondi (nascosto se il ritardo è basso)
| hotlist | `[H: 4:#abc(2,5), 6]` | Elenco dei buffer con attività (messaggi non letti) (nell'esempio, 2 notifiche e 5 messaggi non letti su #abc, un messaggio non letto sul buffer #6)
| completion | `abc(2) def(5)` | Elenco di parole per il completamento, con il numero di completamenti possibili per ogni parola
|===
La barra 'input' ha i seguenti elementi predefiniti:
La barra _input_ ha i seguenti elementi predefiniti:
[width="100%",cols="^3,^4,10",options="header"]
|===
@ -602,7 +602,7 @@ Other items available (not used in bars by default):
[[buffers_and_windows]]
=== Buffer e finestre
Un 'buffer' è composto da un numero, un nome, delle righe visualizzate (e
Un _buffer_ è composto da un numero, un nome, delle righe visualizzate (e
altri dati).
Esempi di buffer:
@ -612,7 +612,7 @@ Esempi di buffer:
* canale irc
* query irc
Una 'finestra' (o window) è un'area dello schermo in cui viene visualizzato
Una _finestra_ (o window) è un'area 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
@ -717,7 +717,7 @@ Esempio di split orizzontale + verticale:
[[bars]]
=== Bars
A 'bar' is an area beside the chat that can contain any type of text.
A _bar_ is an area beside the chat that can contain any type of text.
The bar options can be set with options `weechat.bar.name.option` where `name`
is the name of the bar and `option` the option for this bar.
@ -730,12 +730,12 @@ List of bar options:
| type | `root`, `window` |
A bar with type `root` is displayed exactly one time on screen, outside all
windows. There is no root bar by default, but an example is the bar 'buffers'
created by script 'buffers.pl' (sidebar with list of buffers). +
windows. There is no root bar by default, but an example is the bar _buffers_
created by script _buffers.pl_ (sidebar with list of buffers). +
A bar with type `window` is displayed in each window, for example if you
split one time the screen (with `/window splith` or `/window splitv`), you
will have one bar in each window. The four default bars ('title', 'status',
'input', 'nicklist') have type `window`.
will have one bar in each window. The four default bars (_title_, _status_,
_input_, _nicklist_) have type `window`.
| position | `top`, `bottom`, `left`, `right` |
Position of the bar: above/below chat, on the left/right.
@ -745,7 +745,7 @@ List of bar options:
many bars have same type and position. +
The bars are displayed from the edge of the screen to the center. A higher
priority will display bar at the beginning, so closer to the edge. +
Example: 'input' bar has priority 1000, so it is displayed before the 'status'
Example: _input_ bar has priority 1000, so it is displayed before the _status_
bar, which has priority 500.
| size | integer ≥ 0 |
@ -776,7 +776,7 @@ List of bar options:
other bars (or chat).
| items | string |
A list of 'items' (see <<bar_items,items>> for more info).
A list of _items_ (see <<bar_items,items>> for more info).
| filling_left_right | `horizontal`, `vertical`, `columns_horizontal`, `columns_vertical` |
Type of filling for a bar which has position `left` or `right` (see
@ -794,7 +794,7 @@ List of bar options:
[[bar_items]]
==== Items
The option 'items' is a string with a list of bar items, separated by a comma
The option _items_ is a string with a list of bar items, separated by a comma
(space between items on screen) or "+" (glued items).
The list of bar items is displayed with command `/bar listitems`.
@ -802,7 +802,7 @@ The list of bar items is displayed with command `/bar listitems`.
// TRANSLATION MISSING
Before or after item name, you can use chars (that are not alphanumeric, "-" or
"_"). They will be displayed before/after item with the delimiters color
defined in bar (option 'color_delim').
defined in bar (option _color_delim_).
Example of bar with items "[time],buffer_number+:+buffer_plugin+.+buffer_name":
@ -823,7 +823,7 @@ not displayed in the current window (or even not displayed at all).
// TRANSLATION MISSING
Example: nicklist of bitlbee in a root bar (if the bar is called
'bitlist' and if bitlbee server is called 'bitlbee'):
_bitlist_ and if bitlbee server is called _bitlbee_):
----
/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist"
@ -844,10 +844,10 @@ There are four types of filling:
* `columns_vertical`: items are displayed using columns, where text is aligned
on the left. The first item is on top left, the second is one line below.
Default bars 'title', 'status' and 'input' have 'horizontal' filling, and
default bar 'nicklist' has 'vertical' filling.
Default bars _title_, _status_ and _input_ have _horizontal_ filling, and
default bar _nicklist_ has _vertical_ filling.
Some examples of filling for bar 'nicklist':
Some examples of filling for bar _nicklist_:
....
┌───────────────────────────────────────────────────────────────────────┐
@ -911,14 +911,14 @@ Some examples of filling for bar 'nicklist':
==== Conditions
// TRANSLATION MISSING
The option 'conditions' is a string which is evaluated to know if the bar
The option _conditions_ is a string which is evaluated to know if the bar
must be displayed or not.
The string can be:
* 'active': the window must be active
* 'inactive': the window must be inactive
* 'nicklist': the buffer displayed in window must have a nicklist
* _active_: the window must be active
* _inactive_: the window must be inactive
* _nicklist_: the buffer displayed in window must have a nicklist
* an expression: it is evaluated as boolean (see command
<<command_weechat_eval,/eval>>)
@ -940,7 +940,7 @@ width of window is > 100 :
/set weechat.bar.nicklist.conditions "${nicklist} && ${window.win_width} > 100"
----
Same condition, but always display nicklist on buffer '&bitlbee' (even if window
Same condition, but always display nicklist on buffer _&bitlbee_ (even if window
is small):
----
@ -1026,7 +1026,7 @@ The screen will look like that in bare display:
└───────────────────────────────────────────────────────────────────────────┘
....
So you can click the URL from 'joe' without any problem in your terminal (of
So you can click the URL from _joe_ without any problem in your terminal (of
course this supposes that your terminal supports click on URLs).
[[notify_levels]]
@ -1035,26 +1035,26 @@ course this supposes that your terminal supports click on URLs).
Sono possibili quattro livelli per i messaggi mostrati nei buffer, dal più basso
al più alto:
* 'low': messaggio di bassa importanza (ad esempio entrata/uscita/disconnessione
* _low_: messaggio di bassa importanza (ad esempio entrata/uscita/disconnessione
di irc)
* 'message': messaggio da un utente
* 'private': messaggio in un buffer privato
* 'highlight': messaggio con notifica
* _message_: messaggio da un utente
* _private_: messaggio in un buffer privato
* _highlight_: messaggio con notifica
Ogni buffer ha un livello di notifica, che viene usato per decidere quale
messaggio il buffer andrà ad aggiungere nella hotlist.
Il livello predefinito di notifica può essere impostato usando l'opzione
<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>,
il valore predefinito è 'all'.
il valore predefinito è _all_.
[width="50%",cols="3m,10",options="header"]
|===
| Livello di notifica | Livello del messaggio aggiunto alla hotlist
| none | (nessuno)
| highlight | 'highlight' + 'private'
| message | 'highlight' + 'private' + 'message'
| all | 'highlight' + 'private' + 'message' + 'low'
| highlight | _highlight_ + _private_
| message | _highlight_ + _private_ + _message_
| all | _highlight_ + _private_ + _message_ + _low_
|===
Il livello di notifica può essere definito per un set di buffer, ad esempio
@ -1064,7 +1064,7 @@ tutti i buffer per il server irc "freenode":
/set weechat.notify.irc.freenode message
----
Imposta il livello di notifica 'highlight' solo sul canale '#weechat':
Imposta il livello di notifica _highlight_ solo sul canale _#weechat_:
----
/set weechat.notify.irc.freenode.#weechat highlight
@ -1164,8 +1164,8 @@ Il livello di notifica per un buffer può essere impostato con il comando `/buff
kbd:[F6] | Passa al buffer successivo | `/buffer +1`
| kbd:[F7] | Passa alla finestra precedente | `/window -1`
| kbd:[F8] | Passa alla finestra successiva | `/window +1`
| kbd:[F9] | Scorre il titolo del buffer sulla sinistra | `/bar scroll title * -30%`
| kbd:[F10] | Scorre il titolo del buffer sulla destra | `/bar scroll title * +30%`
| kbd:[F9] | Scorre il titolo del buffer sulla sinistra | `+/bar scroll title * -30%+`
| kbd:[F10] | Scorre il titolo del buffer sulla destra | `+/bar scroll title * +30%+`
| kbd:[F11] | Scorre di una pagina in alto nella lista nick | `/bar scroll nicklist * -100%`
| kbd:[F12] | Scorre di una pagina in basso nella lista nick | `/bar scroll nicklist * +100%`
| kbd:[Alt+F11] | Sposta all'inizio della lista nick | `/bar scroll nicklist * b`
@ -1344,7 +1344,7 @@ as if the mouse was disabled (on some terminals like iTerm, you have to use
kbd:[Alt] instead of kbd:[Shift]).
[NOTE]
Per qualunque problema con il mouse, consultare 'FAQ di WeeChat'.
Per qualunque problema con il mouse, consultare _FAQ di WeeChat_.
[[mouse_bind_events]]
==== Associare gli eventi del mouse a comandi
@ -1446,7 +1446,7 @@ per consultare un elenco di opzioni:
----
Il testo inviato ad un buffer è qualsiasi testo che non comincia con
il carattere "/". Per esempio, per inviare il testo 'ciao' sul buffer
il carattere "/". Per esempio, per inviare il testo _ciao_ sul buffer
attivo:
----
@ -1454,7 +1454,7 @@ ciao
----
Ad ogni modo, è possibile iniziare con il carattere "/", aggiungendone
poi un altro. Ad esempio, per inviare il testo '/set' sul buffer attivo:
poi un altro. Ad esempio, per inviare il testo `/set` sul buffer attivo:
----
//set
@ -1514,7 +1514,7 @@ Nel plugin irc, si possono riorganizzare i colori usando l'opzione
WeeChat può usare fino a 256 coppie di colore per visualizzare il testo nelle barre e
nell'area di chat(il terminale deve supportare 256 colori per essere utilizzati in WeeChat).
In base al valore della variabile di ambiente 'TERM', potrebbero verificarsi i
In base al valore della variabile di ambiente _TERM_, potrebbero verificarsi i
seguenti limiti per i colori in WeeChat:
[width="50%",cols="8,>2,>2",options="header"]
@ -1531,27 +1531,27 @@ seguenti limiti per i colori in WeeChat:
È possibile eseguire `weechat --colors` o utilizzare il comando `/color` in
WeeChat per visualizzare i limiti del proprio ambiente.
Alcuni valori raccomandati per 'TERM' se si desiderano 256 colori:
Alcuni valori raccomandati per _TERM_ se si desiderano 256 colori:
* con screen: 'screen-256color'
* con screen: _screen-256color_
// TRANSLATION MISSING
* under tmux: 'screen-256color' or 'tmux-256color'
* under tmux: _screen-256color_ or _tmux-256color_
// TRANSLATION MISSING
* outside screen/tmux: 'xterm-256color', 'rxvt-256color', 'putty-256color', ...
* outside screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ...
[NOTE]
Potrebbe essere necessario installare il pacchetto "ncurses-term" per usare
questi valori nella variabile 'TERM'.
questi valori nella variabile _TERM_.
Se si sta utilizzando screen, è possibile aggiungere questa riga al
proprio '~/.screenrc':
proprio _~/.screenrc_:
----
term screen-256color
----
// TRANSLATION MISSING
If your 'TERM' variable has wrong value and that WeeChat is already running,
If your _TERM_ variable has wrong value and that WeeChat is already running,
you can change it with these two commands:
----
@ -1595,7 +1595,7 @@ sullo schermo (per mostrare buffer e barre).
In aggiunta ai colori di base, si può usare un numero per il colore compreso
tra 1 e il limite del proprio terminale.
Il comando '/color' mostra i colori attivi ed i limiti. Com kbd:[Alt+c] si può
Il comando `/color` mostra i colori attivi ed i limiti. Com kbd:[Alt+c] si può
passare temporaneamente ai colori del terminale per sceglierne uno.
Se ad esempio si desidera visualizzare l'ora in arancione nel buffer:
@ -1613,7 +1613,7 @@ O se si desidera uno sfondo verde scuro per la barra di stato:
[[colors_aliases]]
==== Alias
Si possono aggiungere degli alias ai colori con il comando '/color alias' e
Si possono aggiungere degli alias ai colori con il comando `/color alias` e
usarli in ogni opzione relativa al colore.
Ad esempio:
@ -1629,11 +1629,11 @@ Ad esempio:
Esistono alcuni attributi per i colori. Uno o più attributi vanno aggiunti prima
del nome o del numero del colore:
* `*` : testo in grassetto
* `!` : video inverso
* `/` : testo in corsivo
* `_` : testo sottolineato
* `|` : mantiene attributi: non ripristina grassetto/inverso/sottolineato
* `+*+` : testo in grassetto
* `+!+` : video inverso
* `+/+` : testo in corsivo
* `+_+` : testo sottolineato
* `+|+` : mantiene attributi: non ripristina grassetto/inverso/sottolineato
al cambio di colore
Ad esempio se si vuole il proprio nick bianco e sottolineato:
@ -1667,12 +1667,12 @@ Esempio di grassetto con il colore di primo piano del terminale:
==== Storage
WeeChat can encrypt passwords or private data using secured data, stored in file
'sec.conf'.
_sec.conf_.
This configuration file is read before any other file, and the values stored
inside can be used in various WeeChat or plugins/scripts options.
You can set a passphrase to encrypt data in 'sec.conf'. This is not mandatory
You can set a passphrase to encrypt data in _sec.conf_. This is not mandatory
but highly recommended, otherwise data is stored as plain text in file.
----
@ -1695,9 +1695,9 @@ The encryption of data is made in 3 steps:
. Encrypt the hash + data (output is: salt + encrypted hash/data).
[NOTE]
The cipher block mode is 'CFB'.
The cipher block mode is _CFB_.
The result is put as hexadecimal string in file 'sec.conf', for example:
The result is put as hexadecimal string in file _sec.conf_, for example:
----
[data]
@ -1717,7 +1717,7 @@ The decryption of data is made in 3 steps:
[[secured_data_manage]]
==== Manage secured data
To add secured data, use `/secure set`, for example a password for 'freenode'
To add secured data, use `/secure set`, for example a password for _freenode_
IRC server:
----
@ -1736,7 +1736,7 @@ password, using this format: "${sec.data.xxx}" where "xxx" is the name of
secured data (used with `/secure set xxx ...`). +
For a complete list of supported options, see `/help secure`.
To use the 'freenode' password, for example with
To use the _freenode_ password, for example with
<<irc_sasl_authentication,SASL authentication>>:
----
@ -1820,9 +1820,9 @@ In GNU/Linux, il file ha estensione ".so", ".dll" in Windows.
I plugin trovati vengono caricati automaticamente all'avvio di WeeChat, ed
è possibile caricare o scaricare i plugin durante l'esecuzione del programma.
È importante evidenziare la differenza tra un 'plugin' ed uno 'script': un
'plugin' è un file binario compilato e caricato con il comando `/plugin`,
mentre uno 'script' è un file di testo caricato con un plugin come 'python'
È importante evidenziare la differenza tra un _plugin_ ed uno _script_: un
_plugin_ è un file binario compilato e caricato con il comando `/plugin`,
mentre uno _script_ è un file di testo caricato con un plugin come _python_
con il comando `/python`.
È possibile utilizzare il comando `/plugin` per caricare/scaricare un plugin,
@ -1866,8 +1866,8 @@ I plugin predefiniti sono:
|===
Per saperne di più riguardo lo sviluppo di plugin o script (tramite le API), per
favore consultare 'Riferimento API dei Plugin per WeeChat' oppure
'Guida allo Scripting di WeeChat'.
favore consultare _Riferimento API dei Plugin per WeeChat_ oppure
_Guida allo Scripting di WeeChat_.
[[alias_plugin]]
=== Plugin Alias
@ -1937,10 +1937,10 @@ Ad esempio, per abilitare l'opzione "ignore-case":
==== Suggestions
Suggestions are displayed in a bar item called "aspell_suggest". The number of
suggestions is set in option 'aspell.check.suggestions'.
suggestions is set in option _aspell.check.suggestions_.
To enable suggestions you must set option 'aspell.check.suggestions' to an
integer ≥ 0 and add the bar item "aspell_suggest" to a bar, like 'status'.
To enable suggestions you must set option _aspell.check.suggestions_ to an
integer ≥ 0 and add the bar item "aspell_suggest" to a bar, like _status_.
Example of suggestions with English dictionary (`en`):
@ -2039,7 +2039,7 @@ Per esempio:
Se il set caratteri globale per la decodifica non è impostato (ad
esempio durante il primo caricamento del plugin Charset), verrà
impostato automaticamente sul set caratteri del terminale (se
diverso da UTF-8), oppure su 'ISO-8859-1'.
diverso da UTF-8), oppure su _ISO-8859-1_.
Il valore di codifica predefinito è vuoto, perciò il testo viene
inviato per default con il set caratteri interno (UTF-8).
@ -2081,7 +2081,7 @@ Per visualizzare tutti i set caratteri utilizzati, utilizzare il comando seguent
==== Risoluzione problemi
Per qualunque problema con i set caratteri, per favore consultare
le 'Domande Frequenti di WeeChat'.
le _Domande Frequenti di WeeChat_.
// TRANSLATION MISSING
[[exec_plugin]]
@ -2117,8 +2117,8 @@ include::autogen/user/exec_commands.asciidoc[]
È possibile controllare da remoto WeeChat, inviando comandi o del testo ad una
pipe FIFO (se l'opzione "plugins.var.fifo.fifo" è abilitata, e lo è per default).
La pipe FIFO si trova in '~/.weechat/' ed è chiamata 'weechat_fifo_xxxx'
(dove 'xxxx' è l'ID del processo (PID) dell'istanza di WeeChat in esecuzione).
La pipe FIFO si trova in _~/.weechat/_ ed è chiamata _weechat_fifo_xxxx_
(dove _xxxx_ è l'ID del processo (PID) dell'istanza di WeeChat in esecuzione).
La sintassi per i comandi/testo della pipe FIFO è una delle seguenti:
@ -2197,8 +2197,8 @@ trasferimento file (tramite plugin xfer, consultare <<xfer_plugin,plugin Xfer>>)
irc[6][s]://[nick[:password]@]irc.esempio.org[:porta][/#canale][,#canale[...]]
----
Esempio per entrare in '#weechat' e '#tizio' sul server 'chat.freenode.net',
porta predefinita (6667), con il nick 'caio':
Esempio per entrare in _#weechat_ e _#tizio_ sul server _chat.freenode.net_,
porta predefinita (6667), con il nick _caio_:
----
$ weechat irc://caio@chat.freenode.net/#weechat,#tizio
@ -2313,14 +2313,14 @@ Per maggiori informazioni consultare http://www.oftc.net/oftc/NickServ/CertFP
WeeChat supports SASL authentication, using different mechanisms:
// TRANSLATION MISSING
* 'plain': password in chiaro (default)
* _plain_: password in chiaro (default)
// TRANSLATION MISSING
* 'ecdsa-nist256p-challenge': challenge with public/private key
* 'external': certificato SSL da lato client
* _ecdsa-nist256p-challenge_: challenge with public/private key
* _external_: certificato SSL da lato client
// TRANSLATION MISSING
* 'dh-blowfish': blowfish encrypted password (*insecure*, not recommended)
* _dh-blowfish_: blowfish encrypted password (*insecure*, not recommended)
// TRANSLATION MISSING
* 'dh-aes': AES encrypted password (*insecure*, not recommended)
* _dh-aes_: AES encrypted password (*insecure*, not recommended)
[NOTE]
La libreria "gcrypt" è richiesta per compilare WeeChat al fine di usare il
@ -2329,15 +2329,15 @@ meccanismo "dh-blowfish" (consultare <<dependencies,dipendenze>>).
Le opzioni nel server sono:
// TRANSLATION MISSING
* 'sasl_mechanism': meccanismo da usare (see above)
* 'sasl_timeout': timeout (in secondi) per l'autenticazione
* _sasl_mechanism_: meccanismo da usare (see above)
* _sasl_timeout_: timeout (in secondi) per l'autenticazione
// TRANSLATION MISSING
* 'sasl_fail': action to perform if authentication fails
* 'sasl_username': nome utente (nick)
* 'sasl_password': password
* _sasl_fail_: action to perform if authentication fails
* _sasl_username_: nome utente (nick)
* _sasl_password_: password
// TRANSLATION MISSING
* 'sasl_key': file with ECc private key (for mechanism
'ecdsa-nist256p-challenge')
* _sasl_key_: file with ECc private key (for mechanism
_ecdsa-nist256p-challenge_)
// TRANSLATION MISSING
[[irc_sasl_ecdsa_nist256p_challenge]]
@ -2555,7 +2555,7 @@ le risposte CTCP sono:
==== Buffer di destinazione per i messaggi IRC
È possibile personalizzare il buffer di destinazione per i messaggi IRC
(buffer usato per visualizzare messaggi) con l'opzione `irc.msgbuffer.*`.
(buffer usato per visualizzare messaggi) con l'opzione `+irc.msgbuffer.*+`.
Per alcuni messaggi IRC (elenco in basso), si possono usare i seguenti
valori:
@ -2566,7 +2566,7 @@ current::
private::
buffer privato per il nick, o il buffer corrente se non trovato
(in base all'opzione 'irc.look.msgbuffer_fallback')
(in base all'opzione _irc.look.msgbuffer_fallback_)
server::
buffer del server
@ -2853,9 +2853,9 @@ Si avranno i seguenti file:
Il plugin Relay viene utilizzato per inoltrare i dati via rete, facendo uso di
protocolli differenti:
* 'irc': proxy IRC: usato per condividere le connessioni ai server IRC con uno
* _irc_: proxy IRC: usato per condividere le connessioni ai server IRC con uno
o più client IRC
* 'weechat': protocollo usato dalle interfacce remote per mostrare ed interagire
* _weechat_: protocollo usato dalle interfacce remote per mostrare ed interagire
con WeeChat (ad esempio QWeeChat)
[[relay_options]]
@ -2896,7 +2896,7 @@ It is highly recommended to set a password for relay, with command:
/set relay.network.password "miapass"
----
This password is used for 'irc' and 'weechat' protocols.
This password is used for _irc_ and _weechat_ protocols.
[[relay_ssl]]
==== SSL
@ -2904,7 +2904,7 @@ This password is used for 'irc' and 'weechat' protocols.
È possibile usare SSL creando un certificato e una chiave privata, e usando il
prefisso "ssl." nel nome del protocollo.
Il file predefinito per il certificato/chiave è '~/.weechat/ssl/relay.pem'
Il file predefinito per il certificato/chiave è _~/.weechat/ssl/relay.pem_
(opzione <<option_relay.network.ssl_cert_key,relay.network.ssl_cert_key>>).
È possibile creare un certificato e una chiave privata con i seguenti comandi:
@ -2996,7 +2996,7 @@ websocket = new WebSocket("ws://server.com:9000/weechat");
----
The port (9000 in example) is the port defined in Relay plugin.
The URI must always end with "/weechat" (for 'irc' and 'weechat' protocols).
The URI must always end with "/weechat" (for _irc_ and _weechat_ protocols).
[[scripts_plugins]]
=== Plugin per gli script
@ -3012,7 +3012,7 @@ scripts of any language, and install/remove scripts of WeeChat scripts
repository, which are visible at this URL: https://weechat.org/scripts
Per maggiori informazioni su come scrivere gli script, o le API WeeChat
per gli script, consultare la 'Guida allo Scripting di WeeChat'.
per gli script, consultare la _Guida allo Scripting di WeeChat_.
// TRANSLATION MISSING
[[script_options]]
@ -3085,8 +3085,8 @@ commands. A condition can be used to prevent the trigger to run in some
circumstances.
Using triggers require you to know how the signals, modifiers, ... are working.
So you might consider reading the 'Hooks' chapter in the
'WeeChat Plugin API Reference'.
So you might consider reading the _Hooks_ chapter in the
_WeeChat Plugin API Reference_.
[[trigger_options]]
==== Options (trigger.conf)
@ -3129,7 +3129,7 @@ A trigger has the following options (names are
| hook | `signal`, `hsignal`, `modifier`, `print`, `command`, `command_run`,
`timer`, `config`, `focus` |
The hook used in trigger. For more information, see
'WeeChat Plugin API Reference', chapter 'Hooks'.
_WeeChat Plugin API Reference_, chapter _Hooks_.
| arguments | string |
The arguments for the hook, it depends on the hook type used.
@ -3152,7 +3152,7 @@ A trigger has the following options (names are
all triggers, the other values are rarely used).
|===
For example, the default 'beep' trigger has following options:
For example, the default _beep_ trigger has following options:
----
trigger.trigger.beep.enabled = on
@ -3173,7 +3173,7 @@ order, if triggers are globally enabled and if the trigger itself is enabled:
. check trigger conditions: if false, exit
. replace text in trigger using regular expression(s)
. execute command(s)
. exit with a return code (except for hooks 'modifier' and 'focus').
. exit with a return code (except for hooks _modifier_ and _focus_).
[[trigger_hook_arguments]]
==== Hook arguments
@ -3241,7 +3241,7 @@ The arguments depend on the hook used. They are separated by semicolons.
1. option name (priority allowed) (required) +
2. option name (priority allowed) +
3. ... |
`weechat.look.*`
`+weechat.look.*+`
| focus |
1. area name (priority allowed) (required) +
@ -3259,7 +3259,7 @@ They are evaluated, and data available in callback can be used
(see <<trigger_callback_data,data in callbacks>> and command
<<command_weechat_eval,/eval>>).
Example: the default 'beep' trigger uses this condition to make a beep only on
Example: the default _beep_ trigger uses this condition to make a beep only on
highlight or private message:
----
@ -3271,9 +3271,9 @@ ${tg_highlight} || ${tg_msg_pv}
The regular expression is used to change variables in callback hashtable.
The format is: "/regex/replace" or "/regex/replace/var" (where 'var' is a
The format is: "/regex/replace" or "/regex/replace/var" (where _var_ is a
variable of the hashtable). +
If 'var' is not specified, the default variable is used, it depends on hook
If _var_ is not specified, the default variable is used, it depends on hook
type:
[width="50%",cols="4,5m",options="header"]
@ -3301,8 +3301,8 @@ Matching groups can be used in "replace":
`${re:99}` are groups captured
* `${re:+}`: the last match (with highest number)
* `${hide:c,${re:N}}`: match "N" with all chars replaced by "c"
(example: `${hide:*,${re:2}}` is the group #2 with all chars replaced by
`*`).
(example: `+${hide:*,${re:2}}+` is the group #2 with all chars replaced by
`+*+`).
Example: use bold for words between "*":
@ -3310,9 +3310,9 @@ Example: use bold for words between "*":
/\*(\S+)\*/*${color:bold}${re:1}${color:-bold}*/
----
Example: default trigger 'server_pass' uses this regular expression to hide
Example: default trigger _server_pass_ uses this regular expression to hide
password in commands `/server` and `/connect` (chars in passwords are replaced
by `*`):
by `+*+`):
----
==^(/(server|connect) .*-(sasl_)?password=)(\S+)(.*)==${re:1}${hide:*,${re:4}}${re:5}
@ -3331,7 +3331,7 @@ Many commands can be separated by semicolons.
It is evaluated (see command <<command_weechat_eval,/eval>>) and text replaced
with a regular expression can be used in the command.
Example: default 'beep' trigger uses this command to make a beep (BEL):
Example: default _beep_ trigger uses this command to make a beep (BEL):
----
/print -beep
@ -3343,9 +3343,9 @@ Example: default 'beep' trigger uses this command to make a beep (BEL):
Data received in callbacks are stored in hashtables (pointers and strings) and
can be used in following options:
* 'conditions'
* 'regex'
* 'command'
* _conditions_
* _regex_
* _command_
The content of hashtables depend on the hook type.
@ -3381,16 +3381,16 @@ is added in hashtable:
| host | string | Hostname
| command | string | IRC command (example: "PRIVMSG", "NOTICE", ...)
| channel | string | IRC channel
| arguments | string | Arguments of command (includes value of 'channel')
| arguments | string | Arguments of command (includes value of _channel_)
| text | string | Text (for example user message)
// TRANSLATION MISSING
| pos_command | string | The index of 'command' in message ("-1" if 'command' was not found)
| pos_command | string | The index of _command_ in message ("-1" if _command_ was not found)
// TRANSLATION MISSING
| pos_arguments | string | The index of 'arguments' in message ("-1" if 'arguments' was not found)
| pos_arguments | string | The index of _arguments_ in message ("-1" if _arguments_ was not found)
// TRANSLATION MISSING
| pos_channel | string | The index of 'channel' in message ("-1" if 'channel' was not found)
| pos_channel | string | The index of _channel_ in message ("-1" if _channel_ was not found)
// TRANSLATION MISSING
| pos_text | string | The index of 'text' in message ("-1" if 'text' was not found)
| pos_text | string | The index of _text_ in message ("-1" if _text_ was not found)
|===
When the data is a pointer, the variable `tg_signal_data` can be used like this
@ -3428,7 +3428,7 @@ The "modifier" callback sets following variables in hashtable:
| tg_string_nocolor | string | The string without color codes
|===
For the 'weechat_print' modifier, variables using message tags are added (see
For the _weechat_print_ modifier, variables using message tags are added (see
<<trigger_data_print,hook print>> below), and following variables:
[width="100%",cols="3m,2,14",options="header"]
@ -3464,7 +3464,7 @@ The "print" callback sets following variables in hashtable:
| tg_message_nocolor | string | Message without color codes
|===
Variables set using tags in message (they are set in modifier 'weechat_print'
Variables set using tags in message (they are set in modifier _weechat_print_
too):
[width="100%",cols="3m,2,14",options="header"]
@ -3476,8 +3476,8 @@ too):
| tg_tag_prefix_nick | string | Color of nick in prefix (from tag "prefix_nick_ccc")
// TRANSLATION MISSING
| tg_tag_host | string | User name and host, format: username@host (from tag "host_xxx")
| tg_tag_notify | string | Notify level ('none', 'message', 'private', 'highlight')
| tg_notify | string | Notify level, if different from 'none'
| tg_tag_notify | string | Notify level (_none_, _message_, _private_, _highlight_)
| tg_notify | string | Notify level, if different from _none_
| tg_msg_pv | string | "1" for a private message, otherwise "0"
|===
@ -3603,9 +3603,9 @@ hour:
Arguments for the timer hook are:
* '3600000': 3600 * 1000 milliseconds, the callback is called each hour
* '0': alignment on second (not aligned here)
* '0': max number of calls (0 = no end for the timer)
* _3600000_: 3600 * 1000 milliseconds, the callback is called each hour
* _0_: alignment on second (not aligned here)
* _0_: max number of calls (0 = no end for the timer)
The command `/mute /save` will silently save configuration files (nothing
displayed on core buffer).
@ -3653,13 +3653,13 @@ Before asking for support, be sure you've read documentation and FAQ provided
with WeeChat.
// TRANSLATION MISSING
For support with IRC, on server 'chat.freenode.net':
For support with IRC, on server _chat.freenode.net_:
* official channels (with developers):
** '#weechat' (English)
** '#weechat-fr' (French)
** _#weechat_ (English)
** _#weechat-fr_ (French)
* non-official channels:
** '#weechat-de' (German)
** _#weechat-de_ (German)
// TRANSLATION MISSING
For other ways of support, see: https://weechat.org/dev/support

View File

@ -54,7 +54,7 @@ WeeChat をインストールするには、以下のものが必要です:
* GNU/Linux が稼動しているシステム
(ソースパッケージを使う場合は、コンパイラツールも必要)、又は互換 OS
* 'root' 特権 (WeeChat をシステムディレクトリにインストールする場合)
* _root_ 特権 (WeeChat をシステムディレクトリにインストールする場合)
* 一部のライブラリ (<<dependencies,依存関係>>を参照)。
[[install]]
@ -135,7 +135,7 @@ OS X では、http://brew.sh/[Homebrew] を使ってください:
[[compile_with_cmake]]
==== cmake によるコンパイル
* システムディレクトリにインストールする場合 ('root' 特権が必要です):
* システムディレクトリにインストールする場合 (_root_ 特権が必要です):
----
$ mkdir build
@ -286,7 +286,7 @@ cmake 以外を用いた WeeChat のビルドは公式にサポートされま
を利用できない場合のみ autotools を使ってください。 +
autotools を用いてビルドする場合、cmake よりも多くの依存パッケージとより長い時間が必要です。
* システムディレクトリにインストールする場合 ('root' 特権が必要です):
* システムディレクトリにインストールする場合 (_root_ 特権が必要です):
----
$ ./autogen.sh
@ -308,7 +308,7 @@ $ make
$ make install
----
'configure'
_configure_
スクリプトに対してオプションを指定することができます、オプションを表示するには以下のコマンドを使ってください:
----
@ -337,7 +337,7 @@ WeeChat がクラッシュした場合、または WeeChat
をクラッシュさせる操作を報告する場合、以下の手順に従ってください:
* デバッグを有効化してコンパイル (またはデバック情報を含んだバイナリパッケージをインストール)
* システムの 'core' ファイルを有効化
* システムの _core_ ファイルを有効化
* gdb のインストール
[[debug_info]]
@ -351,12 +351,12 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
autotools でコンパイルする場合は、デバックはデフォルトで有効化されています (`--with-debug=1`)。
バイナリパッケージをインストールする場合は、'weechat-dbg' パッケージをインストールしてください。
バイナリパッケージをインストールする場合は、_weechat-dbg_ パッケージをインストールしてください。
[[core_files]]
==== Core ファイル
'core' ファイルを有効化するには、<<option_weechat.startup.sys_rlimit,weechat.startup.sys_rlimit>>
_core_ ファイルを有効化するには、<<option_weechat.startup.sys_rlimit,weechat.startup.sys_rlimit>>
オプションを使ってください:
----
@ -366,7 +366,7 @@ autotools でコンパイルする場合は、デバックはデフォルトで
WeeChat バージョン 0.3.8 以下または WeeChat の実行前に core
ファイルを有効化したい場合には、`ulimit` コマンドを使ってください。
Linux で 'bash' シェルを使っている場合、以下の内容を `~/.bashrc` に追加してください:
Linux で _bash_ シェルを使っている場合、以下の内容を `~/.bashrc` に追加してください:
----
ulimit -c unlimited
@ -381,13 +381,13 @@ ulimit -c 200000
[[gdb_backtrace]]
==== gdb でバックトレースを得る
WeeChat がクラッシュすると、'core' または 'core.12345' ファイルが作られます
('12345' はプロセス番号です)。
WeeChat がクラッシュすると、_core_ または _core.12345_ ファイルが作られます
(_12345_ はプロセス番号です)。
このファイルは WeeChat を起動したディレクトリに作られます (これは
WeeChat がインストールされているディレクトリでは*ありません*!)。
例えば、'weechat' が '/usr/bin/' にインストールされ、'core' ファイルが
'/home/xxx/' にある場合、以下のコマンドで gdb を起動してください:
例えば、_weechat_ が _/usr/bin/_ にインストールされ、_core_ ファイルが
_/home/xxx/_ にある場合、以下のコマンドで gdb を起動してください:
----
gdb /usr/bin/weechat /home/xxx/core
@ -433,7 +433,7 @@ Copying output to /tmp/crash.txt.
==== 起動中の WeeChat のデバッグ
起動している WeeChat をデバッグするには (例えば WeeChat がフリーズしているような場合)、gdb
の引数にプロセス番号を与えて起動します ('12345' は weechat プロセスの PID に変更してください):
の引数にプロセス番号を与えて起動します (_12345_ は weechat プロセスの PID に変更してください):
----
gdb /usr/bin/weechat 12345
@ -463,7 +463,7 @@ $ weechat
初めて WeeChat
を起動する場合、デフォルトのオプションで設定ファイルが作成されます。このデフォルト設定ファイルは
'~/.weechat/weechat.conf' です。
_~/.weechat/weechat.conf_ です。
WeeChat を設定するにはこのファイルを編集するか、WeeChat
内で `/set` コマンドにパラメータを付けて設定します
@ -508,12 +508,12 @@ WeeChat を起動した端末の例:
** プレフィックス ("|" の前)
** メッセージ ("|" の後)
* チャットエリアの周りにあるバー、デフォルトバーは:
** タイトル ('title') バー、チャットエリアの上
** 状態 ('status') バー、チャットエリアの下
** 入力 ('input') バー、状態バーの下
** ニックネームリスト ('nicklist') バー、右端
** タイトル (_title_) バー、チャットエリアの上
** 状態 (_status_) バー、チャットエリアの下
** 入力 (_input_) バー、状態バーの下
** ニックネームリスト (_nicklist_) バー、右端
状態 ('status') バーは以下の初期要素を持っています:
状態 (_status_) バーは以下の初期要素を持っています:
[width="100%",cols="^3,^4,10",options="header"]
|===
@ -526,14 +526,14 @@ WeeChat を起動した端末の例:
| buffer_modes | `+n` | IRC チャンネルモード
| buffer_nicklist_count | `{4}` | ニックネームリスト中のニックネームの数
| buffer_zoom | ! | `!` はマージされたバッファがズームされている状態 (ズームされたものだけを表示する状態) を示します、空の場合はすべてのマージされたバッファが表示されていることを示します
| buffer_filter | `*` | フィルタ表示: `*` の場合いくつかの行がフィルタされ (隠され) ます、空の場合すべての行が表示されます。
| buffer_filter | `+*+` | フィルタ表示: `+*+` の場合いくつかの行がフィルタされ (隠され) ます、空の場合すべての行が表示されます。
| scroll | `-MORE(50)-` | スクロール表示、最後の行が表示されてから追加された行数を含む。
| lag | `[Lag: 2.5]` | 遅延秒表示 (遅延が短い場合は非表示)
| hotlist | `[H: 4:#abc(2,5), 6]` | 変化のあったバッファのリスト (未読メッセージ) (例では、'#abc' に 2 個のハイライトと 5 個の未読メッセージ、6 番目のバッファに 1 個の未読メッセージがあることを意味します。)
| hotlist | `[H: 4:#abc(2,5), 6]` | 変化のあったバッファのリスト (未読メッセージ) (例では、_#abc_ に 2 個のハイライトと 5 個の未読メッセージ、6 番目のバッファに 1 個の未読メッセージがあることを意味します。)
| completion | `abc(2) def(5)` | 補完候補の単語リスト、各単語に対して適応される補完候補の数を含む。
|===
入力 ('input') バーは以下の初期要素を持っています:
入力 (_input_) バーは以下の初期要素を持っています:
[width="100%",cols="^3,^4,10",options="header"]
|===
@ -563,7 +563,7 @@ WeeChat を起動した端末の例:
[[buffers_and_windows]]
=== バッファとウィンドウ
'バッファ' は番号、名前、表示された行
_バッファ_ は番号、名前、表示された行
(とその他の情報) で構成されています。
バッファの例:
@ -573,7 +573,7 @@ WeeChat を起動した端末の例:
* irc チャンネル
* irc プライベート
'window'
_window_
はバッファを表示する画面エリアのことです。画面を複数のウィンドウに分割することができます。
それぞれのウィンドウは 1 つのバッファを表示します。バッファは隠したり
@ -674,7 +674,7 @@ WeeChat を起動した端末の例:
[[bars]]
=== バー
'バー' とは任意のテキストを含めることができるチャットエリア以外の場所です。
_バー_ とは任意のテキストを含めることができるチャットエリア以外の場所です。
バーオプションは `weechat.bar.name.option` オプションで設定します。ここで
`name` はバーの名前、`option` はこのバーのオプション名です。
@ -687,11 +687,11 @@ WeeChat を起動した端末の例:
| type | `root` 、`window` |
`root` 型のバーは画面に (全てのウィンドウの外に) 1 回だけ表示されます。デフォルトでは
root バーはありませんが、'buffers.pl' スクリプトが作成する 'buffers' バー
root バーはありませんが、_buffers.pl_ スクリプトが作成する _buffers_ バー
(バッファのリストを含むサイドバー) が例の 1 つです。 +
`window` 型のバーは各ウィンドウに対して表示されます。例えば (`/window splith`
や `/window splitv` で) 画面を 1 回分割する場合、それぞれのウィンドウにバーが
1 つ表示されます。4 つのデフォルトバー ('title' 、'status' 、'input' 、'nicklist')
1 つ表示されます。4 つのデフォルトバー (_title_ 、_status_ 、_input_ 、_nicklist_)
は `window` 型のバーです。
| position | `top` 、`bottom` 、`left` 、`right` |
@ -702,7 +702,7 @@ WeeChat を起動した端末の例:
型と位置が同じ複数のバーを画面に表示する順番に利用される。 +
バーは画面の端から中心に向かって表示される。高い優先度を持つバーが先に
(画面の端に近い側に) 表示される。 +
例: 優先度 1000 の 'input' バーは優先度 500 の 'status'
例: 優先度 1000 の _input_ バーは優先度 500 の _status_
バーよりも先に表示される。
| size | 0 以上の整数 |
@ -733,7 +733,7 @@ WeeChat を起動した端末の例:
がバー同士またはバーとチャットエリアの間に表示されます。
| items | 文字列 |
'items' のリスト (詳細は<<bar_items,バー要素>>を参照)。
_items_ のリスト (詳細は<<bar_items,バー要素>>を参照)。
| filling_left_right | `horizontal` 、`vertical` 、`columns_horizontal` 、`columns_vertical` |
位置が `left` または `right` のバーに対するフィリングタイプ
@ -751,13 +751,13 @@ WeeChat を起動した端末の例:
[[bar_items]]
==== バー要素
'items' オプションはバー要素をコンマ (画面上の要素同士に間隔を空ける)
_items_ オプションはバー要素をコンマ (画面上の要素同士に間隔を空ける)
または "+" (間隔を空けない) で区切った文字列です。
バー要素のリストは `/bar listitems` コマンドで表示されます。
要素名の前または後に文字を表示させることができます (英数字以外の文字、"-"
または "_")。この文字はバー ('color_delim' オプション)
または "_")。この文字はバー (_color_delim_ オプション)
で定義された区切り文字の色をつけて要素の前または後に表示されます。
バー要素を含むバーの例 "[time],buffer_number+:+buffer_plugin+.+buffer_name":
@ -776,7 +776,7 @@ WeeChat を起動した端末の例:
特定のバッファの要素を表示させる際に便利です。
例: bitlbee のニックネームリストをルートバーに表示させる
(バーが 'bitlist' で bitlbee サーバが 'bitlbee' の場合):
(バーが _bitlist_ で bitlbee サーバが _bitlbee_ の場合):
----
/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist"
@ -797,10 +797,10 @@ WeeChat を起動した端末の例:
* `columns_vertical`: テキストを左寄せして、列形式で要素を表示。最初の要素は左上、2
番目は同じ列の 1 行下側。
デフォルトバーである 'title' 、'status' 、'input'
'horizontal' フィリング、'nicklist' は 'vertical' フィリング。
デフォルトバーである _title_ 、_status_ 、_input_
_horizontal_ フィリング、_nicklist_ は _vertical_ フィリング。
'nicklist' バーに対するフィリングの例:
_nicklist_ バーに対するフィリングの例:
....
┌───────────────────────────────────────────────────────────────────────┐
@ -863,14 +863,14 @@ WeeChat を起動した端末の例:
[[bar_conditions]]
==== バー状態
'conditions'
_conditions_
オプションはバーを表示するか否かを評価する文字列です。
文字列は以下のいずれか:
* 'active': 非アクティブ状態のウィンドウ
* 'inactive': 非アクティブ状態のウィンドウ
* 'nicklist': ニックネームリストが含まれるバッファのウィンドウ
* _active_: 非アクティブ状態のウィンドウ
* _inactive_: 非アクティブ状態のウィンドウ
* _nicklist_: ニックネームリストが含まれるバッファのウィンドウ
* 式: ブール値として評価
(<<command_weechat_eval,/eval>> コマンドを参照)
@ -892,7 +892,7 @@ WeeChat を起動した端末の例:
/set weechat.bar.nicklist.conditions "${nicklist} && ${window.win_width} > 100"
----
上と同じだが、'&bitlbee' バッファでは常にニックネームリストを表示
上と同じだが、_&bitlbee_ バッファでは常にニックネームリストを表示
(ウィンドウ幅が狭くても):
----
@ -977,7 +977,7 @@ WeeChat が以下のような表示状態の場合:
└───────────────────────────────────────────────────────────────────────────┘
....
このため、端末で問題なく 'joe' さんからの URL をクリックできます
このため、端末で問題なく _joe_ さんからの URL をクリックできます
(もちろん、使用中の端末で URL をクリックできるように設定されていなければいけませんが)。
[[notify_levels]]
@ -985,24 +985,24 @@ WeeChat が以下のような表示状態の場合:
バッファに表示された各メッセージには 4 つのレベルが設定されています。レベルの低いものから順に:
* 'low': 重要性の低いメッセージ (例えば irc の参加/退出/終了メッセージ)
* 'message': ユーザからのメッセージ
* 'private': プライベートバッファのメッセージ
* 'highlight': ハイライトされたメッセージ
* _low_: 重要性の低いメッセージ (例えば irc の参加/退出/終了メッセージ)
* _message_: ユーザからのメッセージ
* _private_: プライベートバッファのメッセージ
* _highlight_: ハイライトされたメッセージ
それぞれのバッファには通知レベルが設定されており、通知レベルに対応するメッセージの数がホットリストに表示されます。
デフォルトの通知レベルは
<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>
オプションで指定し、デフォルトは 'all' です。
オプションで指定し、デフォルトは _all_ です。
[width="50%",cols="3m,10",options="header"]
|===
| 通知レベル | ホットリストに追加されるメッセージのレベル
| none | (無効)
| highlight | 'highlight' + 'private'
| message | 'highlight' + 'private' + 'message'
| all | 'highlight' + 'private' + 'message' + 'low'
| highlight | _highlight_ + _private_
| message | _highlight_ + _private_ + _message_
| all | _highlight_ + _private_ + _message_ + _low_
|===
通知レベルはバッファグループに対して設定することも可能で、例えば
@ -1012,7 +1012,7 @@ irc サーバ "freenode" に含まれる全てのバッファに対して設定
/set weechat.notify.irc.freenode message
----
"#weechat" チャンネルだけに対して、通知レベルを 'highlight' に設定する場合:
"#weechat" チャンネルだけに対して、通知レベルを _highlight_ に設定する場合:
----
/set weechat.notify.irc.freenode.#weechat highlight
@ -1111,8 +1111,8 @@ irc サーバ "freenode" に含まれる全てのバッファに対して設定
kbd:[F6] | 後のバッファに移動 | `/buffer +1`
| kbd:[F7] | ウィンドウを前に移動 | `/window -1`
| kbd:[F8] | ウィンドウを後に移動 | `/window +1`
| kbd:[F9] | バッファタイトルを左方向にスクロール | `/bar scroll title * -30%`
| kbd:[F10] | バッファタイトルを右方向にスクロール | `/bar scroll title * +30%`
| kbd:[F9] | バッファタイトルを左方向にスクロール | `+/bar scroll title * -30%+`
| kbd:[F10] | バッファタイトルを右方向にスクロール | `+/bar scroll title * +30%+`
| kbd:[F11] | ニックネームリストを上方向にスクロール | `/bar scroll nicklist * -100%`
| kbd:[F12] | ニックネームリストを下方向にスクロール | `/bar scroll nicklist * +100%`
| kbd:[Alt+F11] | ニックネームリストを一番上にスクロール | `/bar scroll nicklist * b`
@ -1279,7 +1279,7 @@ WeeChat でマウスを有効化した場合、すべてのマウスイベント
(一部の端末、例えば iTerm などでは kbd:[Shift] の代わりに kbd:[Alt] を使ってください)。
[NOTE]
マウスに関するトラブルがあれば 'WeeChat FAQ' を参照してください。
マウスに関するトラブルがあれば _WeeChat FAQ_ を参照してください。
[[mouse_bind_events]]
==== コマンドに対してマウスイベントを割り当てる
@ -1377,14 +1377,14 @@ WeeChat コマンドライン (ウィンドウの一番下にあります)
/set
----
"/" が最初に無い場合、そのテキストはバッファに送信されます。例えば、'hello'
"/" が最初に無い場合、そのテキストはバッファに送信されます。例えば、_hello_
というテキストをバッファに送信するには:
----
hello
----
"/" 文字から始まるテキストを送信したい場合、2 重に "/" をつけます。例えば、'/set'
"/" 文字から始まるテキストを送信したい場合、2 重に "/" をつけます。例えば、`/set`
というテキストを現在のバッファに送信するには:
----
@ -1442,7 +1442,7 @@ irc プラグインでは、<<option_irc.color.mirc_remap,irc.color.mirc_remap>>
WeeChat ではバーやチャットエリアにおけるテキスト表示に 256 個の色ペアを利用できます
(この機能を利用するには WeeChat が実行されている端末が 256 色表示に対応している必要があります)。
'TERM' 環境変数の値によって、WeeChat
_TERM_ 環境変数の値によって、WeeChat
で利用できる色と色ペアに以下の制限があります:
[width="50%",cols="8,>2,>2",options="header"]
@ -1459,23 +1459,23 @@ WeeChat ではバーやチャットエリアにおけるテキスト表示に 25
`weechat --colors` を実行するか、`/color` コマンドを WeeChat
の中で実行することで、色表示の制限を確認できます。
256 色を利用したい場合に推奨される 'TERM' 環境変数の値は:
256 色を利用したい場合に推奨される _TERM_ 環境変数の値は:
* screen 内の場合: 'screen-256color'
* tmux 内の場合: 'screen-256color' 、'tmux-256color'
* screen および tmux の外の場合: 'xterm-256color' 、'rxvt-256color' 、'putty-256color' 、...
* screen 内の場合: _screen-256color_
* tmux 内の場合: _screen-256color_ 、_tmux-256color_
* screen および tmux の外の場合: _xterm-256color_ 、_rxvt-256color_ 、_putty-256color_ 、...
[NOTE]
'TERM' 環境変数の値に上の値を設定するには、"ncurses-term"
_TERM_ 環境変数の値に上の値を設定するには、"ncurses-term"
パッケージをインストールする必要があるかもしれません。
screen を使っている場合、'~/.screenrc' に以下の内容を追加してください:
screen を使っている場合、_~/.screenrc_ に以下の内容を追加してください:
----
term screen-256color
----
'TERM' 変数が間違った値に設定された状態で WeeChat が起動完了している場合は、以下の
_TERM_ 変数が間違った値に設定された状態で WeeChat が起動完了している場合は、以下の
2 つのコマンドを使って変数の値を変更してください:
----
@ -1553,11 +1553,11 @@ WeeChat は画面に色が表示された時点で色ペアを動的に割り当
色に対していくつかの属性を付加することができます。1
つ以上の属性を色名又は色番号の前に付加できます:
* `*` : テキストを太字に
* `!` : テキストを反転
* `/` : テキストをイタリック体に
* `_` : テキストに下線を引く
* `|` : 属性を保持:
* `+*+` : テキストを太字に
* `+!+` : テキストを反転
* `+/+` : テキストをイタリック体に
* `+_+` : テキストに下線を引く
* `+|+` : 属性を保持:
色を変えた際に太字/反転/下線属性をリセットしない
例えば、自分自身のニックネームの表示色を白にして、下線を引きたい場合:
@ -1587,13 +1587,13 @@ WeeChat は画面に色が表示された時点で色ペアを動的に割り当
[[secured_data_storage]]
==== データの保存
WeeChat はパスワード及び 'sec.conf'
WeeChat はパスワード及び _sec.conf_
ファイルに保存されている個人データを暗号化することができます。
この設定ファイルは他のどのファイルよりも先に読まれ、ファイルに保存されている値を
WeeChat 及びプラグイン/スクリプトのオプションで使うことができます。
'sec.conf'
_sec.conf_
に含まれるデータを暗号化するパスフレーズを設定することが可能です。これは必須ではありませんが、パスフレーズを設定することを強く勧めます。パスフレーズを設定しない場合、データは平文でファイルに保存されます。
----
@ -1616,9 +1616,9 @@ WeeChat 及びプラグイン/スクリプトのオプションで使うこと
. ハッシュとデータを暗号化 (出力: salt + 暗号化済みのハッシュ/データ)。
[NOTE]
ブロック暗号モードは 'CFB' です。
ブロック暗号モードは _CFB_ です。
結果は 16 進数文字列として 'sec.conf' ファイルに保存されます、例:
結果は 16 進数文字列として _sec.conf_ ファイルに保存されます、例:
----
[data]
@ -1638,7 +1638,7 @@ freenode = "53B1C86FCDA28FC122A95B0456ABD79B5AB74654F21C3D099A6CCA8173239EEA5953
[[secured_data_manage]]
==== 暗号化データの管理
暗号化データを追加するには、`/secure set` を使ってください、'freenode'
暗号化データを追加するには、`/secure set` を使ってください、_freenode_
IRC サーバのパスワードを設定する例:
----
@ -1657,7 +1657,7 @@ IRC サーバのパスワードを設定する例:
(`/secure set xxx ...` のように使います)。 +
利用できるオプションの完全なリストはを見るには、`/help secure` を使ってください。
例えば上の 'freenode' パスワードを
例えば上の _freenode_ パスワードを
<<irc_sasl_authentication,SASL 認証>>で使うには:
----
@ -1733,9 +1733,9 @@ include::autogen/user/weechat_commands.asciidoc[]
見つかったプラグインは WeeChat の起動時に自動的に読み込まれます。WeeChat
の起動時にプラグインを読み込むか否かは選択可能です。
'プラグイン' と 'スクリプト' の違いを明らかにすることは重要です:
'プラグイン' とは `/plugin` コマンドで読み込まれるコンパイル済みバイナリファイルです。これに対して、
'スクリプト' とは `/python` 等のコマンドで 'python'
_プラグイン_ と _スクリプト_ の違いを明らかにすることは重要です:
_プラグイン_ とは `/plugin` コマンドで読み込まれるコンパイル済みバイナリファイルです。これに対して、
_スクリプト_ とは `/python` 等のコマンドで _python_
等のプラグインとともに読み込まれるテキストファイルです。
`/plugin`
@ -1774,8 +1774,8 @@ include::autogen/user/weechat_commands.asciidoc[]
| xfer | ファイル転送とダイレクトチャット
|===
API を使ったプラグインやスクリプトの開発についてより詳しく学ぶには、'WeeChat
プラグイン API リファレンス' 又は 'WeeChat スクリプト製作ガイド' を参照してください。
API を使ったプラグインやスクリプトの開発についてより詳しく学ぶには、_WeeChat
プラグイン API リファレンス_ 又は _WeeChat スクリプト製作ガイド_ を参照してください。
[[alias_plugin]]
=== Alias プラグイン
@ -1841,9 +1841,9 @@ $ aspell config
==== 修正候補
"aspell_suggest" バー要素内に修正候補が表示されます。修正候補の数は
'aspell.check.suggestions' オプションで設定します。
_aspell.check.suggestions_ オプションで設定します。
修正候補を利用するには、'aspell.check.suggestions' オプションをゼロ以上の整数に設定し、'status'
修正候補を利用するには、_aspell.check.suggestions_ オプションをゼロ以上の整数に設定し、_status_
バーなどに "aspell_suggest" バー要素を追加してください。
英語辞書 (`en`) を用いた修正候補の例:
@ -1936,7 +1936,7 @@ include::autogen/user/charset_commands.asciidoc[]
グローバルデコード文字コードが設定されていない場合 (例えば Charset
プラグインを始めてロードした場合)、これは自動的に端末の文字コードか
(UTF-8 でなければ)、デフォルトの 'ISO-8859-1' に設定されます。
(UTF-8 でなければ)、デフォルトの _ISO-8859-1_ に設定されます。
デフォルトのエンコード文字コードはありません。従って、内部文字コード
(UTF-8) が使われます。
@ -1975,7 +1975,7 @@ IRC サーバの全てのチャンネルおよびプライベートバッファ
[[charset_troubleshooting]]
==== トラブルシューティング
文字コードに関する問題があれば、'WeeChat FAQ' を参照してください。
文字コードに関する問題があれば、_WeeChat FAQ_ を参照してください。
[[exec_plugin]]
=== exec プラグイン
@ -2010,8 +2010,8 @@ include::autogen/user/exec_commands.asciidoc[]
外部から WeeChat を操作するには、FIFO パイプにコマンドやテキストを書き込んでください ("plugins.var.fifo.fifo"
オプションが有効化されている必要がありますが、デフォルトで有効化されているはずです)。
FIFO パイプは '~/.weechat/' の下にあり、'weechat_fifo_xxxx'
のような名前になっています ('xxxx' は実行中の WeeChat のプロセス ID (PID) です)。
FIFO パイプは _~/.weechat/_ の下にあり、_weechat_fifo_xxxx_
のような名前になっています (_xxxx_ は実行中の WeeChat のプロセス ID (PID) です)。
FIFO パイプに書き込むコマンド/テキストの文法は以下の例の一つです:
@ -2089,8 +2089,8 @@ IRC プラグインは IRC プロトコルに従って他の人と会話を行
irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]]
----
'nono' というニックネームを使って 'chat.freenode.net' ホストのデフォルトポート (6667)
で稼働中の IRC サーバ上の '#weechat' と '#toto' チャンネルに参加する例:
_nono_ というニックネームを使って _chat.freenode.net_ ホストのデフォルトポート (6667)
で稼働中の IRC サーバ上の _#weechat_ と _#toto_ チャンネルに参加する例:
----
$ weechat irc://nono@chat.freenode.net/#weechat,#toto
@ -2195,11 +2195,11 @@ $ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick
WeeChat は SASL 認証をサポートします、以下の認証メカニズムを利用できます:
* 'plain': 平文パスワード (デフォルト)
* 'ecdsa-nist256p-challenge': 公開鍵/秘密鍵を使うチャレンジ認証
* 'external': クライアント側 SSL 証明書
* 'dh-blowfish': blowfish 暗号パスワード (*危険* 、非推奨)
* 'dh-aes': AES 暗号パスワード (*危険* 、非推奨)
* _plain_: 平文パスワード (デフォルト)
* _ecdsa-nist256p-challenge_: 公開鍵/秘密鍵を使うチャレンジ認証
* _external_: クライアント側 SSL 証明書
* _dh-blowfish_: blowfish 暗号パスワード (*危険* 、非推奨)
* _dh-aes_: AES 暗号パスワード (*危険* 、非推奨)
[NOTE]
"dh-blowfish" メカニズムを利用する場合、"gcrypt" ライブラリが
@ -2207,13 +2207,13 @@ WeeChat のコンパイル時に必要です (<<dependencies,依存関係>>を
サーバオプション:
* 'sasl_mechanism': 利用する認証メカニズム (上記参照)
* 'sasl_timeout': 認証時のタイムアウト (秒単位)
* 'sasl_fail': 認証に失敗した場合の挙動
* 'sasl_username': ユーザ名 (ニックネーム)
* 'sasl_password': パスワード
* 'sasl_key': ECC 秘密鍵を含むファイル
('ecdsa-nist256p-challenge' 用)
* _sasl_mechanism_: 利用する認証メカニズム (上記参照)
* _sasl_timeout_: 認証時のタイムアウト (秒単位)
* _sasl_fail_: 認証に失敗した場合の挙動
* _sasl_username_: ユーザ名 (ニックネーム)
* _sasl_password_: パスワード
* _sasl_key_: ECC 秘密鍵を含むファイル
(_ecdsa-nist256p-challenge_ 用)
[[irc_sasl_ecdsa_nist256p_challenge]]
===== SASL ECDSA-NIST256P-CHALLENGE 認証
@ -2418,7 +2418,7 @@ CTCP オプションが設定されていない (デフォルトの) 場合、CT
[[irc_target_buffer]]
==== IRC メッセージのターゲットバッファ
`irc.msgbuffer.*` オプションを使えば、IRC メッセージに対するターゲットバッファ
`+irc.msgbuffer.*+` オプションを使えば、IRC メッセージに対するターゲットバッファ
(メッセージを表示するバッファ) をカスタマイズすることができます。
一部の IRC メッセージ (以下のリストを参照) に対して、以下の値を設定できます:
@ -2428,7 +2428,7 @@ current::
private::
ニックネームに対するプライベートバッファ、見つからない場合は現在のバッファまたはサーババッファ
('irc.look.msgbuffer_fallback' オプションに依存)
(_irc.look.msgbuffer_fallback_ オプションに依存)
server::
サーババッファ
@ -2701,9 +2701,9 @@ IRC サーバ名を使ったディレクトリに、チャンネル名を使っ
Relay プラグインはネットワークを介して異なるプロトコルを用いてデータを中継するために利用します:
* 'irc': IRC プロキシ: IRC サーバに対する接続を、単一または複数の IRC
* _irc_: IRC プロキシ: IRC サーバに対する接続を、単一または複数の IRC
クライアントで共有するために用います。
* 'weechat': WeeChat の表示にリモートインターフェイス
* _weechat_: WeeChat の表示にリモートインターフェイス
(例えば QWeeChat) を使う場合に利用されるプロトコル
[[relay_options]]
@ -2740,7 +2740,7 @@ include::autogen/user/relay_commands.asciidoc[]
/set relay.network.password "mypass"
----
このパスワードは 'irc' と 'weechat' プロトコルで利用されます。
このパスワードは _irc_ と _weechat_ プロトコルで利用されます。
[[relay_ssl]]
==== SSL
@ -2748,7 +2748,7 @@ include::autogen/user/relay_commands.asciidoc[]
証明書と秘密鍵を作り、プロトコル名の最初に "ssl." を付けることで
SSL 経由でリレーを利用することができます。
証明書/秘密鍵ファイルへのデフォルトパスは '~/.weechat/ssl/relay.pem' です
証明書/秘密鍵ファイルへのデフォルトパスは _~/.weechat/ssl/relay.pem_ です
(option <<option_relay.network.ssl_cert_key,relay.network.ssl_cert_key>>)。
以下のコマンドを使って証明書と秘密鍵ファイルを作成します:
@ -2835,7 +2835,7 @@ websocket = new WebSocket("ws://server.com:9000/weechat");
----
ポート番号 (例では 9000 番) は Relay プラグインで定義したものです。URI
の最後には必ず "/weechat" をつけます ('irc' と 'weechat' プロトコルの場合)。
の最後には必ず "/weechat" をつけます (_irc_ と _weechat_ プロトコルの場合)。
[[scripts_plugins]]
=== スクリプトプラグイン
@ -2849,7 +2849,7 @@ Python、Perl、Ruby、Lua、Tcl、Guile
のスクリプトをインストール/削除したりする事が可能です。
スクリプトの書き方やスクリプト用の WeeChat API
についての詳しい情報は、'WeeChat スクリプト製作ガイド' を参照してください。
についての詳しい情報は、_WeeChat スクリプト製作ガイド_ を参照してください。
[[script_options]]
==== スクリプトオプション (script.conf)
@ -2917,8 +2917,8 @@ include::autogen/user/javascript_commands.asciidoc[]
をフックして、データの内容を書き換えたり、複数のコマンドを実行することができます。条件をつけることで一部の場合だけトリガを実行するように設定することもできます。
トリガを使うにはシグナル、修飾子、...
がどのように動いているかを知らなければいけません。これを知るには 'WeeChat
プラグイン API リファレンス' の 'フック' の章を読むことをお勧めします。
がどのように動いているかを知らなければいけません。これを知るには _WeeChat
プラグイン API リファレンス_ の _フック_ の章を読むことをお勧めします。
[[trigger_options]]
==== オプション (trigger.conf)
@ -2960,8 +2960,8 @@ include::autogen/user/trigger_commands.asciidoc[]
| hook | `signal` 、`hsignal` 、`modifier` 、`print` 、`command` 、`command_run` 、`timer` 、`config` 、`focus`
|
トリガの中で使われるフック。より詳しい情報は、'WeeChat
プラグイン API リファレンス' の 'フック' の章を参照してください。
トリガの中で使われるフック。より詳しい情報は、_WeeChat
プラグイン API リファレンス_ の _フック_ の章を参照してください。
| arguments | 文字列 |
フックに対する引数、指定したフックの型に依存します。
@ -2984,7 +2984,7 @@ include::autogen/user/trigger_commands.asciidoc[]
`ok` 、ほとんどすべてのトリガで戻り値はこれを使うべきで、ほかの値を使うことは極めてまれです)。
|===
例えば、デフォルトの 'beep' トリガは以下のオプションをとります:
例えば、デフォルトの _beep_ トリガは以下のオプションをとります:
----
trigger.trigger.beep.enabled = on
@ -3004,7 +3004,7 @@ trigger.trigger.beep.return_code = ok
. トリガ条件の確認: 偽の場合、終了
. 正規表現を使ってトリガ内でテキスト置換
. コマンドを実行
. リターンコードを付けて終了 ('modifier' と 'focus' フックの場合を除く)。
. リターンコードを付けて終了 (_modifier_ と _focus_ フックの場合を除く)。
[[trigger_hook_arguments]]
==== フック引数
@ -3072,7 +3072,7 @@ trigger.trigger.beep.return_code = ok
1. オプション名 (優先度の指定も可) (必須) +
2. オプション名 (優先度の指定も可) +
3. ... |
`weechat.look.*`
`+weechat.look.*+`
| focus |
1. エリア名 (優先度の指定も可) (必須) +
@ -3090,7 +3090,7 @@ trigger.trigger.beep.return_code = ok
(<<trigger_callback_data,コールバック内のデータ>>とコマンド
<<command_weechat_eval,/eval>> を参照)。
例: デフォルトの 'beep'
例: デフォルトの _beep_
トリガは以下の条件を使い、ハイライトまたはプライベートメッセージの場合だけビープを鳴らすようにしています:
----
@ -3103,8 +3103,8 @@ ${tg_highlight} || ${tg_msg_pv}
正規表現はコールバックハッシュテーブル内の変数を変更するために使われます。
書式: "/regex/replace" または "/regex/replace/var" (ここで
'var' はハッシュテーブルの変数)。 +
'var'
_var_ はハッシュテーブルの変数)。 +
_var_
が指定されなかった場合、デフォルト変数を使います、これはフックの種類に依存します:
[width="50%",cols="4,5m",options="header"]
@ -3132,7 +3132,7 @@ ${tg_highlight} || ${tg_msg_pv}
`${re:99}` はグループ化されたマッチ部分
* `${re:+}`: 最後のマッチ部分 (最大のグループ番号を持つ)
* `${hide:c,${re:N}}`: マッチグループ "N" のすべての文字を "c" で置換した文字列
(例: `${hide:*,${re:2}}` はグループ #2 のすべての文字を `*`
(例: `+${hide:*,${re:2}}+` はグループ #2 のすべての文字を `*`
で置換した文字列)。
例: "*" で囲まれた文字を太字にする:
@ -3141,7 +3141,7 @@ ${tg_highlight} || ${tg_msg_pv}
/\*(\S+)\*/*${color:bold}${re:1}${color:-bold}*/
----
例: デフォルトトリガ 'server_pass' はこの正規表現を使って、`/server`
例: デフォルトトリガ _server_pass_ はこの正規表現を使って、`/server`
と `/connect` コマンドのパスワードを隠しています (パスワード部分の文字を
`*` で置換しています):
@ -3161,7 +3161,7 @@ ${tg_highlight} || ${tg_msg_pv}
コマンドは評価され (コマンド <<command_weechat_eval,/eval>> を参照)
コマンド内では正規表現を使って置換したテキストを使うことができます。
例: デフォルトの 'beep' トリガは以下のコマンドを実行してビープ (BEL) を鳴らしています:
例: デフォルトの _beep_ トリガは以下のコマンドを実行してビープ (BEL) を鳴らしています:
----
/print -beep
@ -3173,9 +3173,9 @@ ${tg_highlight} || ${tg_msg_pv}
コールバック内で受け取ったデータはハッシュテーブル (ポインタと文字列)
の中に保存され、以下のオプションで使うことができます:
* 'conditions'
* 'regex'
* 'command'
* _conditions_
* _regex_
* _command_
ハッシュテーブルの内容はフックの種類に依存します。
@ -3210,12 +3210,12 @@ ${tg_highlight} || ${tg_msg_pv}
| host | string | ホスト名
| command | string | IRC コマンド (例: "PRIVMSG"、"NOTICE"、...)
| channel | string | IRC チャンネル
| arguments | string | コマンドの引数 ('channel' の値を含みます)
| arguments | string | コマンドの引数 (_channel_ の値を含みます)
| text | string | テキスト (例えばユーザメッセージ)
| pos_command | string | メッセージ内における 'command' のインデックス ('command' が見つからない場合 "-1")
| pos_arguments | string | メッセージ内における 'arguments' のインデックス ('arguments' が見つからない場合 "-1")
| pos_channel | string | メッセージ内における 'channel' のインデックス ('channel' が見つからない場合 "-1")
| pos_text | string | メッセージ内における 'text' のインデックス ('text' が見つからない場合 "-1")
| pos_command | string | メッセージ内における _command_ のインデックス (_command_ が見つからない場合 "-1")
| pos_arguments | string | メッセージ内における _arguments_ のインデックス (_arguments_ が見つからない場合 "-1")
| pos_channel | string | メッセージ内における _channel_ のインデックス (_channel_ が見つからない場合 "-1")
| pos_text | string | メッセージ内における _text_ のインデックス (_text_ が見つからない場合 "-1")
|===
データがポインタの場合、hdata の属性を読むために変数 `tg_signal_data`
@ -3253,7 +3253,7 @@ string/string) が含まれています。
| tg_string_nocolor | string | 色コードを含まない文字列
|===
'weechat_print' 修飾子では、メッセージタグを使う変数 (下の
_weechat_print_ 修飾子では、メッセージタグを使う変数 (下の
<<trigger_data_print,Print>> を参照) と以下の変数が追加されます:
[width="100%",cols="3m,2,14",options="header"]
@ -3290,7 +3290,7 @@ string/string) が含まれています。
|===
メッセージのタグをもとにして変数が格納されます
(変数は 'weechat_print' 修飾子でも格納されます):
(変数は _weechat_print_ 修飾子でも格納されます):
[width="100%",cols="3m,2,14",options="header"]
|===
@ -3300,8 +3300,8 @@ string/string) が含まれています。
| tg_tag_nick | string | ニックネーム ("nick_xxx" タグから)
| tg_tag_prefix_nick | string | プレフィックスで使うニックネームの色 ("prefix_nick_ccc" タグから)
| tg_tag_host | string | ユーザ名とホスト名、書式: username@host ("host_xxx" タグから)
| tg_tag_notify | string | 通知レベル ('none' 、'message' 、'private' 、'highlight')
| tg_notify | string | 通知レベルが 'none' 以外の場合、その通知レベル
| tg_tag_notify | string | 通知レベル (_none_ 、_message_ 、_private_ 、_highlight_)
| tg_notify | string | 通知レベルが _none_ 以外の場合、その通知レベル
| tg_msg_pv | string | プライベートメッセージの場合 "1"、それ以外は "0"
|===
@ -3426,9 +3426,9 @@ WeeChat は SIGWINCH を受けとたった際 (端末のサイズが変更され
timer フックに対する引数は:
* '3600000': 3600 * 1000 ミリ秒、コールバックは毎時間呼び出される
* '0': 秒の調整 (この場合調整しない)
* '0': 呼び出し回数の最大値 (0 = タイマーを無限に繰り返す)
* _3600000_: 3600 * 1000 ミリ秒、コールバックは毎時間呼び出される
* _0_: 秒の調整 (この場合調整しない)
* _0_: 呼び出し回数の最大値 (0 = タイマーを無限に繰り返す)
コマンド `/mute /save` は無言で設定ファイルを保存します
(core バッファに対して何も表示しません)。
@ -3471,12 +3471,12 @@ include::autogen/user/xfer_commands.asciidoc[]
サポートを依頼する前に、必ず WeeChat
に付属するドキュメントと FAQ を読んでください。
IRC を使ったサポート窓口は 'chat.freenode.net' サーバにあります:
IRC を使ったサポート窓口は _chat.freenode.net_ サーバにあります:
* 公式チャンネル (開発者もいます):
** '#weechat' (英語)
** '#weechat-fr' (フランス語)
** _#weechat_ (英語)
** _#weechat-fr_ (フランス語)
* 非公式チャンネル:
** '#weechat-de' (ドイツ語)
** _#weechat-de_ (ドイツ語)
他の方法でサポートを受けるには、以下のページをご覧ください: https://weechat.org/dev/support

View File

@ -54,7 +54,7 @@ Strona domowa WeeChat: https://weechat.org/
* działający system GNU/Linux (z narzędziami kompilatora dla kompilacji ze
źródeł), lub kompatybilny system
* przywileje 'roota' (do instalacji w katalogu systemowym)
* przywileje _roota_ (do instalacji w katalogu systemowym)
* niektóre biblioteki (zobacz <<dependencies,zależności>>).
[[install]]
@ -135,7 +135,7 @@ ale nie w wersjami ≤ 2.6 lub ≥ 3.0).
[[compile_with_cmake]]
==== Kompilacja z użyciem cmake
* Instalacja w katalogach systemowych (wymaga uprawnień użytkownika 'root'):
* Instalacja w katalogach systemowych (wymaga uprawnień użytkownika _root_):
----
$ mkdir build
@ -288,7 +288,7 @@ autotools tylko jeśli nie możesz użyć cmake. +
Budowanie z użyciem autotools wymaga więcej zależności i jest wolniejsze niż
z cmake.
* Instalacja w katalogach systemowych (wymaga uprawnień użytkownika 'root'):
* Instalacja w katalogach systemowych (wymaga uprawnień użytkownika _root_):
----
$ ./autogen.sh
@ -310,7 +310,7 @@ $ make
$ make install
----
Opcje mogą zostać przekazane to skryptu 'configure', można je wyświetlić
Opcje mogą zostać przekazane to skryptu _configure_, można je wyświetlić
za pomocą tej komendy:
----
@ -339,7 +339,7 @@ Jeśli doświadczyłeś awarii, lub chcesz zgłosić przyszłą awarię WeeChat,
* skompilować WeeChat z informacjami diagnostycznymi (lub zainstalować
odpowiedni pakiet)
* włączyć obsługę plików 'core' w systemie
* włączyć obsługę plików _core_ w systemie
* zainstalować gdb
[[debug_info]]
@ -354,12 +354,12 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
Jeśli kompilujesz z użyciem autotools, debugowanie jest domyślnie włączone
(`--with-debug=1`).
Jeśli zainstalowałeś pakiet binarny, doinstaluj paczkę 'weechat-dbg'.
Jeśli zainstalowałeś pakiet binarny, doinstaluj paczkę _weechat-dbg_.
[[core_files]]
==== CPliki core
W celu włączenia plików 'core' możesz użyć opcji
W celu włączenia plików _core_ możesz użyć opcji
<<option_weechat.startup.sys_rlimit,weechat.startup.sys_rlimit>>:
----
@ -369,7 +369,7 @@ W celu włączenia plików 'core' możesz użyć opcji
Dla WeeChat w wersji ≤ 0.3.8 albo jeśli chcesz włączyć obsługę plików core przed
startem WeeChat, możesz użyć komendy `ulimit`.
Na przykład pod Linuksem używając powłoki 'bash', dodaj to do pliku `~/.bashrc`:
Na przykład pod Linuksem używając powłoki _bash_, dodaj to do pliku `~/.bashrc`:
----
ulimit -c unlimited
@ -384,13 +384,13 @@ ulimit -c 200000
[[gdb_backtrace]]
==== Pozyskiwanie logów za pomocą gdb
Kiedy WeeChat ulegnie awarii, system stworzy plik 'core' lub 'core.12345'
('12345' to id procesu).
Kiedy WeeChat ulegnie awarii, system stworzy plik _core_ lub _core.12345_
(_12345_ to id procesu).
Plik ten zostanie utworzony w katalogu, z którego uruchomiono WeeChat (*nie*
jest to katalog, gdzie zainstalowano WeeChat!).
Na przykład jeśli 'weechat' jest zainstalowany w '/usr/bin/' i plik 'core'
znajduje się w '/home/xxx/', uruchom gdb za pomocą tej komendy:
Na przykład jeśli _weechat_ jest zainstalowany w _/usr/bin/_ i plik _core_
znajduje się w _/home/xxx/_, uruchom gdb za pomocą tej komendy:
----
gdb /usr/bin/weechat /home/xxx/core
@ -436,7 +436,7 @@ Dziękujemy za pomoc!
==== Debugowanie działającego WeeChat
W celu debugowania działającego WeeChat (na przykład kiedy WeeChat wydaje się
zawieszony), można użyć gdb podając in procesu (zastąp '12345' numerem PID
zawieszony), można użyć gdb podając in procesu (zastąp _12345_ numerem PID
procesu weechat):
----
@ -467,7 +467,7 @@ $ weechat
Podczas pierwszego uruchomienia WeeChat tworzona jest domyślna konfiguracja,
wraz z domyślnymi opcjami. Plik konfiguracyjny to:
'~/.weechat/weechat.conf'.
_~/.weechat/weechat.conf_.
Możesz edytować ten plik wedle upodobań, żeby skonfigurować WeeChat, lub możesz
ustawić parametry za pomocą komendy `/set` z poziomu WeeChat (zobacz
@ -512,12 +512,12 @@ Ekran składa się z następujących obszarów:
** prefiks (przed "|")
** wiadomość (za "|")
* paski dookoła obszaru rozmowy, domyślne paski to:
** pasek 'title', nad obszarem rozmowy
** pasek 'status', pod obszarem rozmowy
** pasek 'input', pod paskiem statusu
** pasek 'nicklist', po prawej
** pasek _title_, nad obszarem rozmowy
** pasek _status_, pod obszarem rozmowy
** pasek _input_, pod paskiem statusu
** pasek _nicklist_, po prawej
Pasek 'status' posiada następujące domyślne elementy:
Pasek _status_ posiada następujące domyślne elementy:
[width="100%",cols="^3,^4,10",options="header"]
|===
@ -530,14 +530,14 @@ Pasek 'status' posiada następujące domyślne elementy:
| buffer_modes | `+n` | Tryby kanału IRC
| buffer_nicklist_count | `{4}` | Ilość nicków na liście nicków
| buffer_zoom | ! | `!` oznacza, że połączony bufor jest przybliżony (tylko ten jest wyświetlany), pusta wartość oznacza, że wszystkie połączone bufory są wyświetlane
| buffer_filter | `*` | Wskaźnik filtrowania: `*` oznacza, że niektóre linie zostały odfiltrowywane (ukryte), pusta wartość oznacza, że wszystkie linie są wyświetlane
| buffer_filter | `+*+` | Wskaźnik filtrowania: `+*+` oznacza, że niektóre linie zostały odfiltrowywane (ukryte), pusta wartość oznacza, że wszystkie linie są wyświetlane
| scroll | `-Więcej(50)-` | Wskaźnik przewijania, z numerem linii poniżej ostatniej wyświetlanej
| lag | `[Lag: 2.5]` | Wskaźnik opóźnienia, w sekundach (ukryty dla niskich opóźnień)
| hotlist | `[H: 4:#abc(2,5), 6]` | Lista buforów z aktywnością (nieprzeczytane wiadomości) (w przykładzie, 2 podświetlenia i 5 nieprzeczytanych wiadomości w '#abc', jedna wiadomość w buforze #6)
| hotlist | `[H: 4:#abc(2,5), 6]` | Lista buforów z aktywnością (nieprzeczytane wiadomości) (w przykładzie, 2 podświetlenia i 5 nieprzeczytanych wiadomości w _#abc_, jedna wiadomość w buforze #6)
| completion | `abc(2) def(5)` | Lista słów do dopełnienia, z ilością możliwych dopełnień dla każdego słowa
|===
Pasek 'input' posiada następujące domyślne elementy:
Pasek _input_ posiada następujące domyślne elementy:
[width="100%",cols="^3,^4,10",options="header"]
|===
@ -567,7 +567,7 @@ Inne dostępne elementy (nie używane domyślnie w paskach):
[[buffers_and_windows]]
=== Bufory i okna
'Bufor' posiada numer, nazwę, wyświetlane linie (i trochę innych danych).
_Bufor_ posiada numer, nazwę, wyświetlane linie (i trochę innych danych).
Przykłady buforów:
@ -576,7 +576,7 @@ Przykłady buforów:
* kanał irc
* prywatna rozmowa irc
'Okno' to obszar ekranu, w którym wyświetlane są bufory. Nie jest możliwe
_Okno_ to obszar ekranu, w którym wyświetlane są bufory. Nie jest możliwe
podzielenie ekranu na kilka okien.
Każde okno wyświetla jeden bufor. Bufor może zostać ukryty (nie wyświetlany w
@ -677,7 +677,7 @@ Przykład podziałów pionowego i poziomego:
[[bars]]
=== Paski
'Pasek' to obszar poza rozmową, mogący zawierać dowolny rodzaj tekstu.
_Pasek_ to obszar poza rozmową, mogący zawierać dowolny rodzaj tekstu.
Opcje paska mogą być ustawiane za pomocą opcji `weechat.bar.nazwa.opcja`,
gdzie `nazwa` to nazwa paska i `opcja` to opcja dla tego paska.
@ -691,12 +691,12 @@ Lista opcji dla pasków:
| type | `root`, `window` |
Pasek o typie `root` wyświetlany jest dokładnie raz na ekranie, poza wszystkimi
oknami. Domyślnie nie ma paska tego typu, jednak przykładowym paskiem tego typu
jest pasek 'buffers' tworzony przez skrypt 'buffers.pl' (boczny pasek z listą
jest pasek _buffers_ tworzony przez skrypt _buffers.pl_ (boczny pasek z listą
buforów). +
Pasek o typie `window` wyświetlany jest w każdym oknie, na przykład jeśli
podzielisz raz okno ekran (za pomocą `/window splith` lub `/window splitv`),
uzyskasz po jednym pasku w każdym oknie. Cztery domyślne paski ('title',
'status', 'input', 'nicklist') posiadają typ `window`.
uzyskasz po jednym pasku w każdym oknie. Cztery domyślne paski (_title_,
_status_, _input_, _nicklist_) posiadają typ `window`.
| position | `top`, `bottom`, `left`, `right` |
Pozycja paska: powyżej/poniżej ekranu rozmowy, po jego lewej/prawej stronie.
@ -706,8 +706,8 @@ Lista opcji dla pasków:
ekranie, kiedy więcej niż jeden pasek posiada ten sam typ i położenie. +
Paski są wyświetlane od brzegu do środka ekranu. Paski z wyższym priorytetem
zostaną wyświetlone na początku, czyli bliżej krawędzi. +
Przykład: pasek 'input' ma priorytet 1000, dlatego jest wyświetlany przed
paskiem 'status', który ma priorytet 500.
Przykład: pasek _input_ ma priorytet 1000, dlatego jest wyświetlany przed
paskiem _status_, który ma priorytet 500.
| size | integer ≥ 0 |
Rozmiar paska: ilość kolumn dla pozycji lewo/prawo, numer linii dla pozycji
@ -738,7 +738,7 @@ Lista opcji dla pasków:
pomiędzy tym paskiem a pozostałymi (lub oknem rozmowy).
| items | string |
Lista 'elementów' (zobacz <<bar_items,elementy>> po więcej informacji).
Lista _elementów_ (zobacz <<bar_items,elementy>> po więcej informacji).
| filling_left_right | `horizontal`, `vertical`, `columns_horizontal`, `columns_vertical` |
Typ wypełnienia paska dla pozycji o pozycji `left` lub `right` (zobacz
@ -756,14 +756,14 @@ Lista opcji dla pasków:
[[bar_items]]
==== Elementy
Opcja 'items' jest ciągiem z listą elementów paska oddzielonych przecinkiem
Opcja _items_ jest ciągiem z listą elementów paska oddzielonych przecinkiem
(spacja pomiędzy elementami na ekranie) lub "+" (elementy sklejone).
Lista wszystkich elementów paska jest wyświetlana za pomocą komendy `/bar listitems`.
Przed i za nazwą elementu można używać znaków (nie będących alfanumerycznymi,
"-" lub "_"). Będą one wyświetlane przed/za elementem z kolorem separatorów
zdefiniowanych dla paska (opcja 'color_delim').
zdefiniowanych dla paska (opcja _color_delim_).
Przykład paska z elementami "[time],buffer_number+:+buffer_plugin+.+buffer_name":
@ -781,8 +781,8 @@ Jest to przydatne w paskach typu `root` do wyświetlania elementów dla konkretn
buforów, które nie są wyświetlane w obecnym oknie (lub nawet nie wyświetlanych
w ogóle).
Przykład: lista nicków dla bitlbee w pasku `root` (jeśli pasek nazywa się 'bitlist'
i serwer bitlbee nazywa sie 'bitlbee'):
Przykład: lista nicków dla bitlbee w pasku `root` (jeśli pasek nazywa się _bitlist_
i serwer bitlbee nazywa sie _bitlbee_):
----
/set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist"
@ -804,10 +804,10 @@ Są cztery typy wypełnień:
tekst jest wyrównany do lewej. Pierwszy element znajduje się na górze z lewej,
kolejny jest linię niżej.
Domyślne paski 'title', 'status' i 'input' mają wypełnienie 'horizontal',
domyślny pasek 'nicklist' ma wypełnienie 'vertical'.
Domyślne paski _title_, _status_ i _input_ mają wypełnienie _horizontal_,
domyślny pasek _nicklist_ ma wypełnienie _vertical_.
Przykłady wypełnień paska 'nicklist':
Przykłady wypełnień paska _nicklist_:
....
┌───────────────────────────────────────────────────────────────────────┐
@ -870,14 +870,14 @@ Przykłady wypełnień paska 'nicklist':
[[bar_conditions]]
==== Warunki
Opcja 'conditions' jest jest przetwarzana w celu sprawdzenia czy pasek ma być
Opcja _conditions_ jest jest przetwarzana w celu sprawdzenia czy pasek ma być
wyświetlony czy nie.
Dostępne opcje:
* 'active': okno musi być aktywne
* 'inactive': okno musi być nieaktywne
* 'nicklist': bufor wyświetlany w oknie musi mieć listę nicków
* _active_: okno musi być aktywne
* _inactive_: okno musi być nieaktywne
* _nicklist_: bufor wyświetlany w oknie musi mieć listę nicków
* wyrażenie: jest wykonywane jako wyrażenie logiczne (zobacz komendę
<<command_weechat_eval,/eval>>)
@ -899,7 +899,7 @@ jeśli szerokość okna > 100:
/set weechat.bar.nicklist.conditions "${nicklist} && ${window.win_width} > 100"
----
Taki sam warunek ale lista nicków będzie wyświetlana zawsze w buforze '&bitlbee'
Taki sam warunek ale lista nicków będzie wyświetlana zawsze w buforze _&bitlbee_
(nawet jeśli okno jest małe):
----
@ -985,7 +985,7 @@ Ekran w trybie niesformatowanego wyświetlania będzie wyglądać tak:
└───────────────────────────────────────────────────────────────────────────┘
....
Możesz więc kliknąć w URL od 'joe' bez żadnych problemów w swoim terminalu (jeśli
Możesz więc kliknąć w URL od _joe_ bez żadnych problemów w swoim terminalu (jeśli
twój terminal wspiera klikanie w URLe).
[[notify_levels]]
@ -994,25 +994,25 @@ twój terminal wspiera klikanie w URLe).
Dostępne są cztery poziomy dla wiadomości wyświetlanych w buforach, od najniższego
do najwyższego:
* 'low': wiadomości mało istotne (na przykład dla irc join/part/quit)
* 'message': wiadomość od użytkownika
* 'private': wiadomość w buforze prywatnym
* 'highlight': wiadomość z powiadomieniem
* _low_: wiadomości mało istotne (na przykład dla irc join/part/quit)
* _message_: wiadomość od użytkownika
* _private_: wiadomość w buforze prywatnym
* _highlight_: wiadomość z powiadomieniem
Każdy bufor posiada poziom powiadomień, który decyduje o tym, jakie wiadomości
zostaną dodane do bufora w hotliście.
Domyślny poziom powiadomień można ustawić za pomocą opcji
<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>>,
domyślna wartość to 'all'.
domyślna wartość to _all_.
[width="50%",cols="3m,10",options="header"]
|===
| Poziom powiadomień | Poziom wiadomości dodawanej do hotlisty
| none | (brak)
| highlight | 'highlight' + 'private'
| message | 'highlight' + 'private' + 'message'
| all | 'highlight' + 'private' + 'message' + 'low'
| highlight | _highlight_ + _private_
| message | _highlight_ + _private_ + _message_
| all | _highlight_ + _private_ + _message_ + _low_
|===
Poziom powiadomień może być definiowany dla zestawu buforów, na przykład dla
@ -1022,7 +1022,7 @@ wszystkich buforów serwera irc "freenode":
/set weechat.notify.irc.freenode message
----
Ustawienie poziomu powiadomień na 'highlight' tylko dla kanału "#weechat":
Ustawienie poziomu powiadomień na _highlight_ tylko dla kanału "#weechat":
----
/set weechat.notify.irc.freenode.#weechat highlight
@ -1121,8 +1121,8 @@ Poziom powiadomień dla bufora może zostać ustawiony za pomocą komendy `/buff
kbd:[F6] | Przełącz na następny bufor | `/buffer +1`
| kbd:[F7] | Przełącz na poprzednie okno | `/window -1`
| kbd:[F8] | Przełącz na następne okno | `/window +1`
| kbd:[F9] | Przewiń tytuł bufora w lewo | `/bar scroll title * -30%`
| kbd:[F10] | Przewiń tytuł bufora w prawo | `/bar scroll title * +30%`
| kbd:[F9] | Przewiń tytuł bufora w lewo | `+/bar scroll title * -30%+`
| kbd:[F10] | Przewiń tytuł bufora w prawo | `+/bar scroll title * +30%+`
| kbd:[F11] | Przewiń w górę jedna stronę listy nicków | `/bar scroll nicklist * -100%`
| kbd:[F12] | Przewiń w dół jedna stronę listy nicków | `/bar scroll nicklist * +100%`
| kbd:[Alt+F11] | Idź na początek listy nicków | `/bar scroll nicklist * b`
@ -1291,7 +1291,7 @@ do terminala, tak jakby obsługa myszy była wyłączona (w niektórych terminal
jak iTerm, należy użyc klawisza kbd:[Alt] zamiast kbd:[Shift]).
[NOTE]
W razie jakichkolwiek problemów z obsługą myszy, zajrzyj do 'WeeChat FAQ'.
W razie jakichkolwiek problemów z obsługą myszy, zajrzyj do _WeeChat FAQ_.
[[mouse_bind_events]]
==== Przypisanie zdarzeń myszy do komend
@ -1391,14 +1391,14 @@ aby zobaczyć listę wszystkich opcji:
----
Tekst wysłany do buforu to dowolny tekst, który nie zaczyna się od znaku "/".
Na przykład, żeby wysłać tekst 'hello' do obecnego buforu wystarczy:
Na przykład, żeby wysłać tekst _hello_ do obecnego buforu wystarczy:
----
hello
----
Jednak możliwe jest rozpoczęcie tekstu znakiem "/", wpisując go podwójnie.
Na przykład, żeby wysłać tekst '/set' do obecnego buforu:
Na przykład, żeby wysłać tekst `/set` do obecnego buforu:
----
//set
@ -1456,7 +1456,7 @@ We wtyczce irc, można zmienić przypisania tych kolorów za pomocą opcji
WeeChat może użyć do 256 par kolorów do wyświetlania tekstu w paskach i obszarze
rozmów (twój terminal musi wspierać do 256 par kolorów, aby użyć ich w WeeChat).
Zgodnie z wartością zmiennej środowiskowej 'TERM', możesz posiadać następujące
Zgodnie z wartością zmiennej środowiskowej _TERM_, możesz posiadać następujące
limity dla kolorów w WeeChat:
[width="50%",cols="8,>2,>2",options="header"]
@ -1473,23 +1473,23 @@ limity dla kolorów w WeeChat:
Możesz wykonać `weechat --colors` lub użyć komendy `/color` w WeeChat, aby
wyświetlić limity dla twojego środowiska.
Niektóre z zalecanych wartości dla 'TERM' jeśli chcesz używać 256 kolorów:
Niektóre z zalecanych wartości dla _TERM_ jeśli chcesz używać 256 kolorów:
* dla screena: 'screen-256color'
* pod tmux: 'screen-256color' lub 'tmux-256color'
* poza screenem/tmuxem: 'xterm-256color', 'rxvt-256color', 'putty-256color', ...
* dla screena: _screen-256color_
* pod tmux: _screen-256color_ lub _tmux-256color_
* poza screenem/tmuxem: _xterm-256color_, _rxvt-256color_, _putty-256color_, ...
[NOTE]
Być może konieczne jest zainstalowanie pakietu "ncurses-term", w celu użycia
tych wartości dla zmiennej 'TERM'.
tych wartości dla zmiennej _TERM_.
Jeśli używasz screena, możesz dodać to do swojego '~/.screenrc':
Jeśli używasz screena, możesz dodać to do swojego _~/.screenrc_:
----
term screen-256color
----
Jeśli wartość zmiennej 'TERM' ma złą wartość, a WeeChat jest już uruchomiony,
Jeśli wartość zmiennej _TERM_ ma złą wartość, a WeeChat jest już uruchomiony,
możesz ją zmienić za pomocą tych dwóch komend:
----
@ -1567,11 +1567,11 @@ Na przykład:
Możliwe jest użycie niektórych atrybutów dla kolorów. Jeden lub więcej z nich
może zostać użyty przed nazwą lub numerem koloru:
* `*` : pogrubiony tekst
* `!` : odwrócenie video
* `/` : pochyły
* `_` : podkreślony tekst
* `|` : zachowaj atrybuty: nie resetuj pogrubienia/odwrócenia/pochylenia/podkreślenia,
* `+*+` : pogrubiony tekst
* `+!+` : odwrócenie video
* `+/+` : pochyły
* `+_+` : podkreślony tekst
* `+|+` : zachowaj atrybuty: nie resetuj pogrubienia/odwrócenia/pochylenia/podkreślenia,
podczas zmiany koloru
Na przykład jeśli chcesz, żeby twój nick był biały i podkreślony:
@ -1602,12 +1602,12 @@ Przykład pogrubienia z domyślnym kolorem terminala:
[[secured_data_storage]]
==== Przechowywanie
WeeChat umie szyfrować hasła lub prywatne dane i przechowuje je w pliku 'sec.conf'.
WeeChat umie szyfrować hasła lub prywatne dane i przechowuje je w pliku _sec.conf_.
Plik ten jest odczytywany przed wszystkimi innymi plikami i wartości przechowywane
w nim mogą być użyte w różnych opcjach WeeChat jak i wtyczek/skryptów.
Możesz ustawić hasło dla danych zaszyfrowanych w pliku 'sec.conf'. Nie jest to
Możesz ustawić hasło dla danych zaszyfrowanych w pliku _sec.conf_. Nie jest to
obowiązkowe ale wysoce zalecane, w przeciwnym wypadku dane są zapisywane jako
zwykły tekst.
@ -1631,9 +1631,9 @@ Szyfrowanie danych odbywa się w 3 krokach:
. Szyfrowanie hash + dane (wynik to: sól + zaszyfrowany hash/dane).
[NOTE]
Tryb blokowy szyfru to 'CFB'.
Tryb blokowy szyfru to _CFB_.
Wynik jest zapisywany jako ciąg heksadecymalny w pliku 'sec.conf', na przykład:
Wynik jest zapisywany jako ciąg heksadecymalny w pliku _sec.conf_, na przykład:
----
[data]
@ -1654,7 +1654,7 @@ Deszyfrowanie danych odbywa się w 3 krokach:
==== Zarządzanie zabezpieczonymi danymi
W celu dodania bezpiecznych danych użyj `/secure set`, na przykład hasło dla
serwera IRC 'freenode':
serwera IRC _freenode_:
----
/secure set freenode mojehasło
@ -1672,7 +1672,7 @@ hasła, za pomocą formatu: "${sec.data.xxx}", gdzie "xxx" to nazwa zabezpieczon
danych (utworzone za pomocą `/secure set xxx ...`). +
Pełną listę dostępnych opcji można uzyskać wykonując `/help secure`.
W celu użycia hasła 'freenode', na przykład z
W celu użycia hasła _freenode_, na przykład z
<<irc_sasl_authentication,SASL authentication>>:
----
@ -1748,9 +1748,9 @@ W systemach GNU/Linux plik ma rozszerzenie ".so", w Windowsie ".dll".
Znalezione wtyczki są automatycznie ładowane podczas uruchamiania WeeChat,
możliwe jest również ładowanie lub wyładowywanie wtyczek podczas pracy WeeChat.
Ważne jest, aby odróżniać 'wtyczkę' od 'skryptu': 'wtyczka' jest to plik binarny
skompilowany i ładowany za pomocą polecenia `/plugin`, natomiast 'skrypt' to
plik tekstowy, ładowany za pomocą wtyczki jak na przykład 'python' za pomocą
Ważne jest, aby odróżniać _wtyczkę_ od _skryptu_: _wtyczka_ jest to plik binarny
skompilowany i ładowany za pomocą polecenia `/plugin`, natomiast _skrypt_ to
plik tekstowy, ładowany za pomocą wtyczki jak na przykład _python_ za pomocą
polecenia `/python`.
Możesz użyć komendy `/plugin` żeby załadować/wyładować wtyczkę, lub wyświetlić
@ -1792,7 +1792,7 @@ Domyślne wtyczki:
|===
Więcej informacji o wtyczkach i tworzeniu skryptów (przez API), można znaleźć w
'Opisie API wtyczek' i 'Poradniku pisania skryptów'.
_Opisie API wtyczek_ i _Poradniku pisania skryptów_.
[[alias_plugin]]
=== Wtyczka alias
@ -1857,10 +1857,10 @@ Na przykład, aby włączyć opcję "ignore-case":
==== Sugestie
Sugestie są wyświetlane w elemencie paska "aspell_suggest". Ilość wyświetlanych
sugestii można ustawić za pomocą opcji 'aspell.check.suggestions'.
sugestii można ustawić za pomocą opcji _aspell.check.suggestions_.
Aby włączyć sugestie trzeba ustawić opcję 'aspell.check.suggestions' na liczbę
≥ 0 i dodać element "aspell_suggest" do jakiegoś paska, jak 'status'.
Aby włączyć sugestie trzeba ustawić opcję _aspell.check.suggestions_ na liczbę
≥ 0 i dodać element "aspell_suggest" do jakiegoś paska, jak _status_.
Przykład sugestii z angielskim słownikiem (`en`):
@ -1954,7 +1954,7 @@ Na przykład:
Jeżeli globalna wartość dla kodowania nie jest ustawiona (na przykład podczas
pierwszego zaladowania wtyczki), zostanie automatycznie ustawione na kodowanie
terminala (jeśli jest inne niż UTF-8), lub domyślnie na 'ISO-8859-1'.
terminala (jeśli jest inne niż UTF-8), lub domyślnie na _ISO-8859-1_.
Domyślnie kodowanie dla wysyłanych danych nie jest ustawione, dane domyślnie
wysyłane są w kodowaniu wewnętrznym (UTF-8).
@ -1994,7 +1994,7 @@ W celu wyświetlenia wszystkich ustawionych kodowań, wykonaj:
[[charset_troubleshooting]]
==== Rozwiązywanie problemów
W razie jakichś problemów z kodowaniem, zajrzyj do 'WeeChat FAQ'.
W razie jakichś problemów z kodowaniem, zajrzyj do _WeeChat FAQ_.
[[exec_plugin]]
=== Wtyczka exec
@ -2030,8 +2030,8 @@ Możesz zdalnie kontrolować WeeChat, poprzez wysyłanie komend lub tekstu do
kolejki FIFO (jeśli opcja "plugins.var.fifo.fifo" jest włączona, domyślnie
jest włączona).
Kolejka FIFO jest zlokalizowana w '~/.weechat/' i nazywa się 'weechat_fifo_xxxx'
(gdzie 'xxxx' to ID procesu (PID) uruchomionego WeeChat).
Kolejka FIFO jest zlokalizowana w _~/.weechat/_ i nazywa się _weechat_fifo_xxxx_
(gdzie _xxxx_ to ID procesu (PID) uruchomionego WeeChat).
Składnia dla komend/tekstu przekazywanego do kolejki FIFO wygląda następująco:
@ -2111,8 +2111,8 @@ Możliwe jest podanie adresu URL do jednego lub wielu serwerów IRC:
irc[6][s]://[nick[:hasło]@]adres.serwera.irc[:port][/kanał][,kanał[...]]
----
Przykład wejścia na kanały '#weechat' i '#toto' na serwerze 'chat.freenode.net',
na domyślnym porcie (6667), z nickiem 'nono':
Przykład wejścia na kanały _#weechat_ i _#toto_ na serwerze _chat.freenode.net_,
na domyślnym porcie (6667), z nickiem _nono_:
----
$ weechat irc://nono@chat.freenode.net/#weechat,#toto
@ -2216,12 +2216,12 @@ Więcej informacji można znaleźć pod adresem: http://www.oftc.net/oftc/NickSe
WeeChat wspiera uwierzytelnianie SASL, używając różnych mechanizmów:
* 'plain': hasło w czystym tekście (domyślne)
* 'ecdsa-nist256p-challenge': klucz prywatny/publiczny
* 'external': certyfikat SSL po stronie klienta
* 'dh-blowfish': hasło zaszyfrowane algorytmem blowfish
* _plain_: hasło w czystym tekście (domyślne)
* _ecdsa-nist256p-challenge_: klucz prywatny/publiczny
* _external_: certyfikat SSL po stronie klienta
* _dh-blowfish_: hasło zaszyfrowane algorytmem blowfish
(*niebezpieczne*, nie zalecane)
* 'dh-aes': hasło zaszyfrowane algorytmem AES
* _dh-aes_: hasło zaszyfrowane algorytmem AES
(*niebezpieczne*, nie zalecane)
[NOTE]
@ -2230,13 +2230,13 @@ wsparcia dla mechanizmów "dh-blowfish" i "dh-aes" (zobacz <<dependencies,zależ
Opcje dla serwerów to:
* 'sasl_mechanism': mechanizm do użycia (zobacz wyżej)
* 'sasl_timeout': limit czasu (w sekundach) na uwierzytelnienie
* 'sasl_fail': akcja wykonywana jeśli uwierzytelnienie się nie powiedzie
* 'sasl_username': nazwa użytkownika (nick)
* 'sasl_password': hasło
* 'sasl_key': plik z kluczem prywatnym ECc (dla mechanizmu
'ecdsa-nist256p-challenge')
* _sasl_mechanism_: mechanizm do użycia (zobacz wyżej)
* _sasl_timeout_: limit czasu (w sekundach) na uwierzytelnienie
* _sasl_fail_: akcja wykonywana jeśli uwierzytelnienie się nie powiedzie
* _sasl_username_: nazwa użytkownika (nick)
* _sasl_password_: hasło
* _sasl_key_: plik z kluczem prywatnym ECc (dla mechanizmu
_ecdsa-nist256p-challenge_)
[[irc_sasl_ecdsa_nist256p_challenge]]
===== SASL ECDSA-NIST256P-CHALLENGE
@ -2444,7 +2444,7 @@ Jeśli opcje CTCP nie są zdefiniowane (domyślne), odpowiedzi CTCP to:
==== Bufor dla wiadomości IRC
Jest możliwe dostosowanie buforu docelowego dla wiadomości IRC (bufor użyty do
wyświetlania wiadomości) za pomocą opcji `irc.msgbuffer.*`.
wyświetlania wiadomości) za pomocą opcji `+irc.msgbuffer.*+`.
Dla niektórych wiadomości IRC (Zobacz poniższa listę), można ustawić wartość:
@ -2453,7 +2453,7 @@ current::
private::
prywatny bufor dla osoby, lub bufor obecny/serwera jeśli nie zostanie
znaleziony (zgodnie z opcją 'irc.look.msgbuffer_fallback')
znaleziony (zgodnie z opcją _irc.look.msgbuffer_fallback_)
server::
bufor serwera
@ -2731,9 +2731,9 @@ Spowoduje powstanie następującej struktury:
Wtyczka relay jest używana do przekazywania danych przez sieć, z użyciem różnych
protokołów:
* 'irc': pośrednik IRC: używany do dzielenia połączeń z serwerami IRC z jednym
* _irc_: pośrednik IRC: używany do dzielenia połączeń z serwerami IRC z jednym
lub wieloma klientami IRC
* 'weechat': protokół używany przez zdalne interfejsy do wyświetlania i
* _weechat_: protokół używany przez zdalne interfejsy do wyświetlania i
interakcji z WeeChat (na przykład QWeeChat lub weechat-android)
[[relay_options]]
@ -2770,7 +2770,7 @@ Zalecane jest ustawienie hasła dla pośrednika, za pomocą komendy:
/set relay.network.password "moje_hasło"
----
Hasło to używane jest przez protokoły 'irc' i 'weechat'.
Hasło to używane jest przez protokoły _irc_ i _weechat_.
[[relay_ssl]]
==== SSL
@ -2778,7 +2778,7 @@ Hasło to używane jest przez protokoły 'irc' i 'weechat'.
Możesz używać SSL poprzez utworzenie certyfikatu i klucza prywatnego, oraz
użycie prefiksu "ssl." w nazwie protokołu.
Domyślna lokalizacja pliku z certyfikatem/kluczem to '~/.weechat/ssl/relay.pem'
Domyślna lokalizacja pliku z certyfikatem/kluczem to _~/.weechat/ssl/relay.pem_
(opcja <<option_relay.network.ssl_cert_key,relay.network.ssl_cert_key>>).
Możesz utworzyć certyfikat i klucz prywatny wykonując poniższe komendy:
@ -2867,7 +2867,7 @@ websocket = new WebSocket("ws://server.com:9000/weechat");
----
Port (9000 w przykładzie) to port zdefiniowany we wtyczce relay.
Adres URL musi się zawsze kończyć "/weechat" (dla protokołów 'irc' i 'weechat').
Adres URL musi się zawsze kończyć "/weechat" (dla protokołów _irc_ i _weechat_).
[[scripts_plugins]]
=== Wtyczki skryptowe
@ -2882,7 +2882,7 @@ skryptów z repozytorium skryptów WeeChat, dostępnego pod adresem:
https://weechat.org/scripts
Więcej informacji o tym jak pisać skrypty lub o API WeeChat dla skryptów można
znaleźć w 'Poradniku pisania skryptów'.
znaleźć w _Poradniku pisania skryptów_.
[[script_options]]
==== Opcje wtyczki script (script.conf)
@ -2950,7 +2950,7 @@ jedną lub więcej komend. Można użyć warunków w celu ograniczenia działani
w określonych przypadkach.
Używanie triggerów wymaga wiedzy na temat działania sygnałów, modyfikatorów, ...
Dlatego warto rozważyć przeczytanie rozdziału 'Hooks' w 'WeeChat Plugin API Reference'.
Dlatego warto rozważyć przeczytanie rozdziału _Hooks_ w _WeeChat Plugin API Reference_.
[[trigger_options]]
==== Opcje (trigger.conf)
@ -2992,7 +2992,7 @@ Trigger posiada następujące opcje (nazwy to `trigger.trigger.<nazwa>.<opcja>`)
| hook | `signal`, `hsignal`, `modifier`, `print`, `command`, `command_run`,
`timer`, `config`, `focus` |
Zdarzenia używane przez trigger. Więcej informacji można znaleźć w
'WeeChat Plugin API Reference', rozdział 'Hooks'.
_WeeChat Plugin API Reference_, rozdział _Hooks_.
| arguments | string |
Argumenty dla zdarzenia, zależą od jego typu.
@ -3015,7 +3015,7 @@ Trigger posiada następujące opcje (nazwy to `trigger.trigger.<nazwa>.<opcja>`)
większości triggerów, pozostałe wartości są sporadycznie używane).
|===
Na przykład, domyślny trigger 'beep' ma następujące opcje:
Na przykład, domyślny trigger _beep_ ma następujące opcje:
----
trigger.trigger.beep.enabled = on
@ -3036,7 +3036,7 @@ kolejności, jeśli triggery są globalnie włączone i jeśli sam trigger jest
. sprawdzenie warunków triggera: jeśli nie jest spełniony następuje wyjście
. zastępowanie tekstu w triggerze za pomocą wyrażenia
. wykonanie komend(-y)
. wyjście ze zwróceniem kodu (za wyjątkiem uchwytów 'modifier' i 'focus').
. wyjście ze zwróceniem kodu (za wyjątkiem uchwytów _modifier_ i _focus_).
[[trigger_hook_arguments]]
==== Argumenty uchwytów
@ -3104,7 +3104,7 @@ Argumenty zależą od rodzaju uchwytu. Są oddzielane średnikami.
1. nazwa opcji (dozwolony priorytet) (wymagane) +
2. nazwa opcji (dozwolony priorytet) +
3. ... |
`weechat.look.*`
`+weechat.look.*+`
| focus |
1. nazwa obszaru (dozwolony priorytet) (wymagane) +
@ -3123,7 +3123,7 @@ Są one przetwarzane i dane dostępne w callbackach mogą zostać użyte
(zobacz <<trigger_callback_data,dane w callbackach>> oraz komendę
<<command_weechat_eval,/eval>>).
Przykład: domyślny trigger 'beep' używa tego warunku do wywołania dźwięku tylko
Przykład: domyślny trigger _beep_ używa tego warunku do wywołania dźwięku tylko
w przypadku podświetlenia lub otrzymania prywatnej wiadomości:
----
@ -3135,9 +3135,9 @@ ${tg_highlight} || ${tg_msg_pv}
Wyrażenia regularne są używane do zmiany zmiennych w tablicy hashy callbacka.
Format: "/wyrażenie/zamień" lub "/wyrażenie/zamień/zmienna" (gdzie 'zmienna' to
Format: "/wyrażenie/zamień" lub "/wyrażenie/zamień/zmienna" (gdzie _zmienna_ to
zmienna tablicy hashy). +
Jeśli 'zmienna' nie zostanie podana, użyta zostanie domyślna zmienna, zależy ona
Jeśli _zmienna_ nie zostanie podana, użyta zostanie domyślna zmienna, zależy ona
od typu uchwytu:
[width="50%",cols="4,5m",options="header"]
@ -3166,7 +3166,7 @@ Dopasowane grupy, które mogą zostać użyte w "zamień":
`${re:99}` to przechwycone grupy
* `${re:+}`: ostatnie dopasowanie (z najwyższym numerem)
* `${hide:c,${re:N}}`: dopasowanie "N" z wszystkimi znakami zastąpionymi "c"
(przykład: `${hide:*,${re:2}}` to grupa #2 ze znakami zastąpionymi `*`).
(przykład: `+${hide:*,${re:2}}+` to grupa #2 ze znakami zastąpionymi `+*+`).
Przykład: użyj pogrubienia dla słów pomiędzy "*":
@ -3174,8 +3174,8 @@ Przykład: użyj pogrubienia dla słów pomiędzy "*":
/\*(\S+)\*/*${color:bold}${re:1}${color:-bold}*/
----
Przykład: domyślny trigger 'server_pass' używa tego wyrażenia do ukrycia hasła
w komendach `/server` i `/connect` (znaki haseł są zastępowane przez `*`):
Przykład: domyślny trigger _server_pass_ używa tego wyrażenia do ukrycia hasła
w komendach `/server` i `/connect` (znaki haseł są zastępowane przez `+*+`):
----
==^(/(server|connect) .*-(sasl_)?password=)(\S+)(.*)==${re:1}${hide:*,${re:4}}${re:5}
@ -3193,7 +3193,7 @@ Wiele komend może być oddzielonych średnikiem.
Komendy są przetwarzane (zobacz komendę <<command_weechat_eval,/eval>>) i tekst
zastępowany wyrażeniem może zostać użyty w komendzie.
Przykład: domyślny trigger 'beep' używa tej komendy do wydania dźwięku (BEL):
Przykład: domyślny trigger _beep_ używa tej komendy do wydania dźwięku (BEL):
----
/print -beep
@ -3205,9 +3205,9 @@ Przykład: domyślny trigger 'beep' używa tej komendy do wydania dźwięku (BEL
Dane otrzymane w callbackach są przechowywane w tablicach hashy (wskaźniki i
ciągi) i mogą zostać użyte w następujących opcjach:
* 'warunki'
* 'wyrażenia'
* 'komendy'
* _warunki_
* _wyrażenia_
* _komendy_
Zawartość tablicy hashy zależy od typu uchwytu.
@ -3243,12 +3243,12 @@ są dodawane do tablicy hashy:
| host | ciąg | Nazwa hosta
| command | ciąg | Komendy IRC (na przykład: "PRIVMSG", "NOTICE", ...)
| channel | ciąg | Kanał IRC
| arguments | ciąg | Argumenty komendy (razem z wartością 'channel')
| arguments | ciąg | Argumenty komendy (razem z wartością _channel_)
| text | ciąg | Tekst (na przykład wiadomość użytkownika)
| pos_command | ciąg | Indeks 'command' w wiadomości ("-1" jeśli 'command' nie zostanie znalezione)
| pos_arguments | ciąg | Indeks 'arguments' w wiadomości ("-1" jeśli 'arguments' nie zostaną znalezione)
| pos_channel | ciąg | Indeks 'channel' w wiadomości ("-1" jeśli 'channel' nie został znaleziony)
| pos_text | ciąg | Indeks 'text' w wiadomości ("-1" jeśli 'text' nie został znaleziony)
| pos_command | ciąg | Indeks _command_ w wiadomości ("-1" jeśli _command_ nie zostanie znalezione)
| pos_arguments | ciąg | Indeks _arguments_ w wiadomości ("-1" jeśli _arguments_ nie zostaną znalezione)
| pos_channel | ciąg | Indeks _channel_ w wiadomości ("-1" jeśli _channel_ nie został znaleziony)
| pos_text | ciąg | Indeks _text_ w wiadomości ("-1" jeśli _text_ nie został znaleziony)
|===
Kiedy dane są wskaźnikiem, zmienna `tg_signal_data` może zostać użyta do
@ -3286,7 +3286,7 @@ Callback "modifier" ustawia następujące zmienne w tablicy hashy:
| tg_string_nocolor | ciąg | Ciąg bez kodów kolorów
|===
Dla modyfikatora 'weechat_print', są dodawane zmienne używające tagi wiadomości
Dla modyfikatora _weechat_print_, są dodawane zmienne używające tagi wiadomości
zobacz <<trigger_data_print,hook print>> poniżej), oraz następujące zmienne:
[width="100%",cols="3m,2,14",options="header"]
@ -3323,7 +3323,7 @@ Callback "print" ustawia następujące zmienne w tablicy hashy:
|===
Zmienne ustawiane przez tagi w wiadomości (są ustawiane też przez modyfikator
'weechat_print'):
_weechat_print_):
[width="100%",cols="3m,2,14",options="header"]
|===
@ -3333,8 +3333,8 @@ Zmienne ustawiane przez tagi w wiadomości (są ustawiane też przez modyfikator
| tg_tag_nick | ciąg | Nick (z tagu "nick_xxx")
| tg_tag_prefix_nick | ciąg | Kolor nicka w prefiksie (z tagu "prefix_nick_ccc")
| tg_tag_host | ciąg | Nazwa użytkownika i host, format: username@host (z tagu "host_xxx")
| tg_tag_notify | ciąg | Poziom powiadomień ('none', 'message', 'private', 'highlight')
| tg_notify | ciąg | Poziom powiadomień, jeśli różny od 'none'
| tg_tag_notify | ciąg | Poziom powiadomień (_none_, _message_, _private_, _highlight_)
| tg_notify | ciąg | Poziom powiadomień, jeśli różny od _none_
| tg_msg_pv | ciąg | "1" dla prywatnej wiadomości, inaczej "0"
|===
@ -3460,9 +3460,9 @@ godzinę:
Argumenty dla uchwytu timera to:
* '3600000': 3600 * 1000 milisekund, callback wywoływany jest co godzinę
* '0': wyrównanie sekund (nie ustawione)
* '0': maksymalna ilość wywołań (0 = brak ograniczenia ilości wywołań)
* _3600000_: 3600 * 1000 milisekund, callback wywoływany jest co godzinę
* _0_: wyrównanie sekund (nie ustawione)
* _0_: maksymalna ilość wywołań (0 = brak ograniczenia ilości wywołań)
Komenda `/mute /save` zapisze po cichu pliki konfiguracyjne (nic się nie
wyświetli w buforze rdzenia).
@ -3505,13 +3505,13 @@ include::autogen/user/xfer_commands.asciidoc[]
Przed pytaniem o pomoc upewnij się, że przeczytałeś dokumentację i FAQ
dostarczone z WeeChat.
Wsparcie w sieci IRC na serwerze 'chat.freenode.net':
Wsparcie w sieci IRC na serwerze _chat.freenode.net_:
* oficjalne kanały (z developerami):
** '#weechat' (Angielski)
** '#weechat-fr' (Francuski)
** _#weechat_ (Angielski)
** _#weechat-fr_ (Francuski)
* nieoficjalne kanały:
** '#weechat-de' (Niemiecki)
** _#weechat-de_ (Niemiecki)
Inne sposoby na uzyskanie pomocy można znaleźć pod adresem:
https://weechat.org/dev/support