diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/de/weechat_user.de.adoc | 456 | ||||
| -rw-r--r-- | doc/en/weechat_user.en.adoc | 438 | ||||
| -rw-r--r-- | doc/fr/weechat_user.fr.adoc | 454 | ||||
| -rw-r--r-- | doc/it/weechat_user.it.adoc | 460 | ||||
| -rw-r--r-- | doc/ja/weechat_user.ja.adoc | 438 | ||||
| -rw-r--r-- | doc/pl/weechat_user.pl.adoc | 442 |
6 files changed, 1344 insertions, 1344 deletions
diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc index 0b191898f..ae4c48b9f 100644 --- a/doc/de/weechat_user.de.adoc +++ b/doc/de/weechat_user.de.adoc @@ -629,6 +629,234 @@ andere Items die man nutzen kann (die aber nicht standardmäßig in einer Bar ak | window_number | `2` | Nummer des aktuellen Fensters |=== +[[command_line]] +=== Befehlszeile + +In der WeeChat Befehlszeile (am unteren Rand des Fensters) können Befehle ausgeführt oder +ein Text in den Buffer geschrieben werden. + +[[command_line_syntax]] +==== Syntax + +Ein Befehl wird durch das Zeichen "/" eingeleitet, gefolgt von dem Namen des Befehls. In folgendem +Beispiel werden alle Konfigurationsoptionen angezeigt: + +---- +/set +---- + +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: + +---- +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: + +---- +//set +---- + +[[command_line_colors]] +==== Farbkodierung + +Für einige Erweiterungen wie z.B. der IRC Erweiterung können Farbkodierungen und Attribute für den +Text gesetzt werden. Dazu muss die Tastenkombination kbd:[Ctrl+c], gefolgt von einem der folgenden +Zeichen, genutzt werden: + +[width="60%",cols="3,5",options="header"] +|=== +| Taste | Beschreibung +| kbd:[Ctrl+c], kbd:[b] | Text wird fett dargestellt +| kbd:[Ctrl+c], kbd:[c], + kbd:[xx] | Textfarbe `xx` (siehe Farbtabelle) +| kbd:[Ctrl+c], kbd:[c], + kbd:[xx], kbd:[,], + kbd:[yy] | Textfarbe `xx` und Hintergrundfarbe `yy` (siehe Farbtabelle) +| kbd:[Ctrl+c], kbd:[i] | Text wird kursiv dargestellt +| kbd:[Ctrl+c], kbd:[o] | deaktiviert Farben und Attribute +| kbd:[Ctrl+c], kbd:[v] | Farben umkehren (kehrt Textfarbe und Hintergrundfarbe um) +| kbd:[Ctrl+c], kbd:[_] | Text wird mit Unterstrich dargestellt +|=== + +[NOTE] +Der selbe Befehl (ohne den Wert für kbd:[Ctrl+c], kbd:[c]) sollte genutzt werden +um die Farbkodierungen bzw. Attribute zu deaktivieren. + +Farbtabelle für kbd:[Ctrl+c], kbd:[c]: + +include::autogen/user/irc_colors.adoc[] + +[NOTE] +Um sich alle verfügbaren Farben anzeigen zu lassen, die der Terminal +unterstützt, kann man in WeeChat die Tastenkombination kbd:[Alt+c] +im `/color` Buffer nutzen oder im Terminal den Befehl `weechat --colors` ausführen. + +Beispiel: Im Buffer wird "Hallo an alle!" ausgegeben. Dabei wird "Hallo" in Fettschrift +und hellblau und "an alle" rot und unterstrichen dargestellt. + +---- +^Cc12^CbHallo ^Cb^Cc04^C_an alle^C_^Cc! +---- + +[NOTE] +Die Farben können in der IRC Erweiterung neu belegt werden, +mittels der Option <<option_irc.color.mirc_remap,irc.color.mirc_remap>>. + +[[colors]] +=== Farben + +WeeChat kann bis zu 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 +was die Farbdarstellung in WeeChat betrifft: + +[width="50%",cols="8,>2,>2",options="header"] +|=== +| $TERM | Farben | Paare +| "rxvt-unicode", "xterm", ... | 88 | 256 +| "rxvt-256color", "xterm-256color", ... | 256 | 256 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 256 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 256 +|=== + +Mittels `weechat --colors` oder dem internen WeeChat-Befehl `/color` kann man sich +die Einschränkungen für die jeweilige Umgebungsvariable anzeigen lassen. + +Folgende Werte sind für die _TERM_-Umgebungsvariable zu empfehlen, sofern man 256 Farben +nutzen möchte: + +* falls screen genutzt wird: _screen-256color_ +* für tmux: _screen-256color_ oder _tmux-256color_ +* ausserhalb screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... + +[NOTE] +Es sollte das Paket "ncurses-term" installiert werden um die Werte der _TERM_ +Variable nutzen zu können. + +Sollte screen genutzt werden, fügt man folgende Zeile an das Ende der Datei +_~/.screenrc_: + +---- +term screen-256color +---- + +Sollte die Umgebungsvariable _TERM_ falsch gesetzt worden sein und WeeChat +wird derweil schon ausgeführt, kann die Variable mit folgenden zwei Befehlen +geändert werden: + +---- +/set env TERM screen-256color +/upgrade +---- + +[[colors_basic]] +==== Basisfarben + +Basisfarben in WeeChat sind: + +[width="50%",cols="^3m,8",options="header"] +|=== +| Name | Farbe +| default | Standard Terminalfarbe (transparent für Hintergrund) +| black | Schwarz +| darkgray | Dunkelgrau +| red | Dunkelrot +| lightred | Hellrot +| green | Dunkelgrün +| lightgreen | Hellgrün +| brown | Braun +| yellow | Gelb +| blue | Dunkelblau +| lightblue | Hellblau +| magenta | Dunkel magenta +| lightmagenta | Hell magenta +| cyan | Dunkel türkis +| lightcyan | Hell türkis +| gray | Grau +| white | Weiß +|=== + +[[colors_extended]] +==== erweiterte Farbpalette + +WeeChat belegt die Farbpaare dynamisch, sobald die Farbe genutzt werden sollte. Zum Beispiel +um mit einer Farbe Buffer oder Bars zu nutzen. + +Zu den Basisfarben können zusätzlich Farben zwischen eins und der maximalen Anzahl an Farben +genutzt werden die vom jeweiligen Terminal zur Verfügung gestellt werden. + +Mit dem `/color` Befehl kann man sich sowohl die aktuelle Farbpalette anzeigen lassen als +auch die Anzahl der zu nutzenden Farben. Mit kbd:[Alt+c] kann man vorübergehend zu den +Terminalfarben wechseln um eine Farbe auszuwählen. + +Um zum Beispiel die Uhrzeit in einem Buffer in einem schönen Orange darzustellen: + +---- +/set weechat.color.chat_time 214 +---- + +oder falls man den Hintergrund der Statusbar in einm sehr dunklen Grün haben möchte: + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== Alias + +Man kann einer Farbe einen Alias zuordnen um diesen Alias anstelle einer Zahl in +die Optionen einzutragen. Um einen Alias zu definieren nutzt man den Befehl +`/color alias`. + +Beispiel: + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== Attribute + +Er ist möglich einer Farbe ein Attribut hinzuzufügen. Dazu wird dem +Farbnamen oder der Farbnummer ein- oder mehrere Attribute vorangestellt. + +* `+*+` : fett +* `+!+` : invertierte Darstellung +* `+/+` : kursiven +* `+_+` : unterstrichen +* `+|+` : behält Attribut bei: fett, invertierte Darstellung, Unterstrichen wird beim Farbwechsel nicht zurückgesetzt + +Um zum Beispiel dem eigenen Nick die Farbe weiß und unterstrichen +zuzuordnen: + +---- +/set weechat.color.chat_nick_self _white +---- + +oder um die Zeitanzeige in der Statusbar orange, fett und unterstrichen +darzustellen: + +---- +/set weechat.color.status_time *_214 +---- + +Um einer Standard-Terminalfarbe (-1) ein Attribut hinzuzufügen muss eine Zahl +gewählt werden die größer ist als die letzte genutzte Farbe des Terminals. +Zum Beispiel; maximale Farbwahl in WeeChat: 99999. + +Um der Vordergrundfarbe des Terminals das Attribut "fett" zuzuordnen: + +---- +/set weechat.color.status_time *99999 +---- + [[buffers_and_windows]] === Buffer und Fenster @@ -1546,234 +1774,6 @@ Den Namen eines Mausereignisses kann man mittels des Befehls `/input grab_mouse` Man führt den Befehl in der Eingabezeile aus und startet das Ereignis. Als Ergebnis erhält man in der Eingabezeile den Namen des ausgeführten Mausereignisses. -[[command_line]] -=== Befehlszeile - -In der WeeChat Befehlszeile (am unteren Rand des Fensters) können Befehle ausgeführt oder -ein Text in den Buffer geschrieben werden. - -[[command_line_syntax]] -==== Syntax - -Ein Befehl wird durch das Zeichen "/" eingeleitet, gefolgt von dem Namen des Befehls. In folgendem -Beispiel werden alle Konfigurationsoptionen angezeigt: - ----- -/set ----- - -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: - ----- -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: - ----- -//set ----- - -[[command_line_colors]] -==== Farbkodierung - -Für einige Erweiterungen wie z.B. der IRC Erweiterung können Farbkodierungen und Attribute für den -Text gesetzt werden. Dazu muss die Tastenkombination kbd:[Ctrl+c], gefolgt von einem der folgenden -Zeichen, genutzt werden: - -[width="60%",cols="3,5",options="header"] -|=== -| Taste | Beschreibung -| kbd:[Ctrl+c], kbd:[b] | Text wird fett dargestellt -| kbd:[Ctrl+c], kbd:[c], - kbd:[xx] | Textfarbe `xx` (siehe Farbtabelle) -| kbd:[Ctrl+c], kbd:[c], - kbd:[xx], kbd:[,], - kbd:[yy] | Textfarbe `xx` und Hintergrundfarbe `yy` (siehe Farbtabelle) -| kbd:[Ctrl+c], kbd:[i] | Text wird kursiv dargestellt -| kbd:[Ctrl+c], kbd:[o] | deaktiviert Farben und Attribute -| kbd:[Ctrl+c], kbd:[v] | Farben umkehren (kehrt Textfarbe und Hintergrundfarbe um) -| kbd:[Ctrl+c], kbd:[_] | Text wird mit Unterstrich dargestellt -|=== - -[NOTE] -Der selbe Befehl (ohne den Wert für kbd:[Ctrl+c], kbd:[c]) sollte genutzt werden -um die Farbkodierungen bzw. Attribute zu deaktivieren. - -Farbtabelle für kbd:[Ctrl+c], kbd:[c]: - -include::autogen/user/irc_colors.adoc[] - -[NOTE] -Um sich alle verfügbaren Farben anzeigen zu lassen, die der Terminal -unterstützt, kann man in WeeChat die Tastenkombination kbd:[Alt+c] -im `/color` Buffer nutzen oder im Terminal den Befehl `weechat --colors` ausführen. - -Beispiel: Im Buffer wird "Hallo an alle!" ausgegeben. Dabei wird "Hallo" in Fettschrift -und hellblau und "an alle" rot und unterstrichen dargestellt. - ----- -^Cc12^CbHallo ^Cb^Cc04^C_an alle^C_^Cc! ----- - -[NOTE] -Die Farben können in der IRC Erweiterung neu belegt werden, -mittels der Option <<option_irc.color.mirc_remap,irc.color.mirc_remap>>. - -[[colors]] -=== Farben - -WeeChat kann bis zu 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 -was die Farbdarstellung in WeeChat betrifft: - -[width="50%",cols="8,>2,>2",options="header"] -|=== -| $TERM | Farben | Paare -| "rxvt-unicode", "xterm", ... | 88 | 256 -| "rxvt-256color", "xterm-256color", ... | 256 | 256 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 256 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 256 -|=== - -Mittels `weechat --colors` oder dem internen WeeChat-Befehl `/color` kann man sich -die Einschränkungen für die jeweilige Umgebungsvariable anzeigen lassen. - -Folgende Werte sind für die _TERM_-Umgebungsvariable zu empfehlen, sofern man 256 Farben -nutzen möchte: - -* falls screen genutzt wird: _screen-256color_ -* für tmux: _screen-256color_ oder _tmux-256color_ -* ausserhalb screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... - -[NOTE] -Es sollte das Paket "ncurses-term" installiert werden um die Werte der _TERM_ -Variable nutzen zu können. - -Sollte screen genutzt werden, fügt man folgende Zeile an das Ende der Datei -_~/.screenrc_: - ----- -term screen-256color ----- - -Sollte die Umgebungsvariable _TERM_ falsch gesetzt worden sein und WeeChat -wird derweil schon ausgeführt, kann die Variable mit folgenden zwei Befehlen -geändert werden: - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== Basisfarben - -Basisfarben in WeeChat sind: - -[width="50%",cols="^3m,8",options="header"] -|=== -| Name | Farbe -| default | Standard Terminalfarbe (transparent für Hintergrund) -| black | Schwarz -| darkgray | Dunkelgrau -| red | Dunkelrot -| lightred | Hellrot -| green | Dunkelgrün -| lightgreen | Hellgrün -| brown | Braun -| yellow | Gelb -| blue | Dunkelblau -| lightblue | Hellblau -| magenta | Dunkel magenta -| lightmagenta | Hell magenta -| cyan | Dunkel türkis -| lightcyan | Hell türkis -| gray | Grau -| white | Weiß -|=== - -[[colors_extended]] -==== erweiterte Farbpalette - -WeeChat belegt die Farbpaare dynamisch, sobald die Farbe genutzt werden sollte. Zum Beispiel -um mit einer Farbe Buffer oder Bars zu nutzen. - -Zu den Basisfarben können zusätzlich Farben zwischen eins und der maximalen Anzahl an Farben -genutzt werden die vom jeweiligen Terminal zur Verfügung gestellt werden. - -Mit dem `/color` Befehl kann man sich sowohl die aktuelle Farbpalette anzeigen lassen als -auch die Anzahl der zu nutzenden Farben. Mit kbd:[Alt+c] kann man vorübergehend zu den -Terminalfarben wechseln um eine Farbe auszuwählen. - -Um zum Beispiel die Uhrzeit in einem Buffer in einem schönen Orange darzustellen: - ----- -/set weechat.color.chat_time 214 ----- - -oder falls man den Hintergrund der Statusbar in einm sehr dunklen Grün haben möchte: - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== Alias - -Man kann einer Farbe einen Alias zuordnen um diesen Alias anstelle einer Zahl in -die Optionen einzutragen. Um einen Alias zu definieren nutzt man den Befehl -`/color alias`. - -Beispiel: - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== Attribute - -Er ist möglich einer Farbe ein Attribut hinzuzufügen. Dazu wird dem -Farbnamen oder der Farbnummer ein- oder mehrere Attribute vorangestellt. - -* `+*+` : fett -* `+!+` : invertierte Darstellung -* `+/+` : kursiven -* `+_+` : unterstrichen -* `+|+` : behält Attribut bei: fett, invertierte Darstellung, Unterstrichen wird beim Farbwechsel nicht zurückgesetzt - -Um zum Beispiel dem eigenen Nick die Farbe weiß und unterstrichen -zuzuordnen: - ----- -/set weechat.color.chat_nick_self _white ----- - -oder um die Zeitanzeige in der Statusbar orange, fett und unterstrichen -darzustellen: - ----- -/set weechat.color.status_time *_214 ----- - -Um einer Standard-Terminalfarbe (-1) ein Attribut hinzuzufügen muss eine Zahl -gewählt werden die größer ist als die letzte genutzte Farbe des Terminals. -Zum Beispiel; maximale Farbwahl in WeeChat: 99999. - -Um der Vordergrundfarbe des Terminals das Attribut "fett" zuzuordnen: - ----- -/set weechat.color.status_time *99999 ----- - [[secured_data]] === sensible Daten diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc index 2622f63c8..c5d0d6096 100644 --- a/doc/en/weechat_user.en.adoc +++ b/doc/en/weechat_user.en.adoc @@ -622,6 +622,225 @@ Other items available (not used in bars by default): | window_number | `2` | Current window number |=== +[[command_line]] +=== Command line + +WeeChat command line (at the bottom of window) lets you execute commands or +send text to buffer. + +[[command_line_syntax]] +==== Syntax + +Commands begin with "/" char, followed by name of command. For example, to see +list of all options: + +---- +/set +---- + +Text sent to a buffer is any text that does not begin with "/" char. +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: + +---- +//set +---- + +[[command_line_colors]] +==== Color codes + +For some plugins like IRC, you can use color codes and attributes, as +follow (press kbd:[Ctrl+c] then following letter, with optional value): + +[width="60%",cols="3,5",options="header"] +|=== +| Key | Description +| kbd:[Ctrl+c], kbd:[b] | bold text +| kbd:[Ctrl+c], kbd:[c], + kbd:[xx] | text color `xx` (see list of colors below) +| kbd:[Ctrl+c], kbd:[c], + kbd:[xx], kbd:[,], + kbd:[yy] | text color `xx` and background `yy` (see list of colors below) +| kbd:[Ctrl+c], kbd:[i] | italic text +| kbd:[Ctrl+c], kbd:[o] | disable color and attributes +| kbd:[Ctrl+c], kbd:[v] | reverse video (revert text color with background) +| kbd:[Ctrl+c], kbd:[_] | underlined text +|=== + +[NOTE] +The same code (without number for kbd:[Ctrl+c], kbd:[c]) can be used to stop the +attribute. + +Color codes for kbd:[Ctrl+c], kbd:[c] are: + +include::autogen/user/irc_colors.adoc[] + +[NOTE] +To show all available colors in your terminal, you can do `/color` then +kbd:[Alt+c] in WeeChat or run this command in terminal: `weechat --colors`. + +Example: display of "hello everybody!" with "hello" in light blue bold and +"everybody" in light red underlined: + +---- +^Cc12^Cbhello ^Cb^Cc04^C_everybody^C_^Cc! +---- + +[NOTE] +In irc plugin, you can remap these colors using option +<<option_irc.color.mirc_remap,irc.color.mirc_remap>>. + +[[colors]] +=== Colors + +WeeChat can use up to 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 +for colors in WeeChat: + +[width="50%",cols="8,>2,>2",options="header"] +|=== +| $TERM | Colors | Pairs +| "rxvt-unicode", "xterm", ... | 88 | 256 +| "rxvt-256color", "xterm-256color", ... | 256 | 256 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 256 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 256 +|=== + +You can run `weechat --colors` or use command `/color` in WeeChat to +display limits for your environment. + +Some recommended values for _TERM_ if you want 256 colors: + +* under screen: _screen-256color_ +* under tmux: _screen-256color_ or _tmux-256color_ +* outside screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... + +[NOTE] +You may have to install package "ncurses-term" to use these values in _TERM_ +variable. + +If you are using screen, you can add this line to your _~/.screenrc_: + +---- +term screen-256color +---- + +If your _TERM_ variable has wrong value and that WeeChat is already running, +you can change it with these two commands: + +---- +/set env TERM screen-256color +/upgrade +---- + +[[colors_basic]] +==== Basic colors + +Basic colors in WeeChat are: + +[width="50%",cols="^3m,8",options="header"] +|=== +| Name | Color +| default | Default terminal color (transparent for background) +| black | Black +| darkgray | Dark gray +| red | Dark red +| lightred | Light red +| green | Dark green +| lightgreen | Light green +| brown | Brown +| yellow | Yellow +| blue | Dark blue +| lightblue | Light blue +| magenta | Dark magenta +| lightmagenta | Light magenta +| cyan | Dark cyan +| lightcyan | Light cyan +| gray | Gray +| white | White +|=== + +[[colors_extended]] +==== Extended colors + +WeeChat dynamically allocates color pairs when colors are used on screen (to +display buffers and bars). + +In addition to basic colors, you can use a color number between 1 and the limit +of your terminal. + +Use command `/color` to see current colors and limits. With kbd:[Alt+c] you can +temporarily switch to terminal colors to choose a color. + +For example if you want to display time in orange in buffer, do: + +---- +/set weechat.color.chat_time 214 +---- + +Or if you want a very dark green background for status bar: + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== Aliases + +You can add color aliases with command `/color alias` and then use this alias +in any color option. + +For example: + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== Attributes + +It is possible to use some attributes for colors. One or more attributes can be +added before color name or number: + +* `+*+` : bold text +* `+!+` : reverse video +* `+/+` : italic +* `+_+` : underlined text +* `+|+` : keep attributes: do not reset bold/reverse/italic/underlined when + changing color + +For example if you want self nick as white underlined, do: + +---- +/set weechat.color.chat_nick_self _white +---- + +Or if you want time in status bar as orange underlined with bold: + +---- +/set weechat.color.status_time *_214 +---- + +To use an attribute with default terminal color (-1), you must use a number +greater than last terminal color, for example max color in WeeChat: 99999. + +Example of bold with terminal foreground color: + +---- +/set weechat.color.status_time *99999 +---- + [[buffers_and_windows]] === Buffers and windows @@ -1518,225 +1737,6 @@ any gesture made using left button. You can find an event name with command `/input grab_mouse` then doing event with mouse. This will insert event name on command line. -[[command_line]] -=== Command line - -WeeChat command line (at the bottom of window) lets you execute commands or -send text to buffer. - -[[command_line_syntax]] -==== Syntax - -Commands begin with "/" char, followed by name of command. For example, to see -list of all options: - ----- -/set ----- - -Text sent to a buffer is any text that does not begin with "/" char. -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: - ----- -//set ----- - -[[command_line_colors]] -==== Color codes - -For some plugins like IRC, you can use color codes and attributes, as -follow (press kbd:[Ctrl+c] then following letter, with optional value): - -[width="60%",cols="3,5",options="header"] -|=== -| Key | Description -| kbd:[Ctrl+c], kbd:[b] | bold text -| kbd:[Ctrl+c], kbd:[c], - kbd:[xx] | text color `xx` (see list of colors below) -| kbd:[Ctrl+c], kbd:[c], - kbd:[xx], kbd:[,], - kbd:[yy] | text color `xx` and background `yy` (see list of colors below) -| kbd:[Ctrl+c], kbd:[i] | italic text -| kbd:[Ctrl+c], kbd:[o] | disable color and attributes -| kbd:[Ctrl+c], kbd:[v] | reverse video (revert text color with background) -| kbd:[Ctrl+c], kbd:[_] | underlined text -|=== - -[NOTE] -The same code (without number for kbd:[Ctrl+c], kbd:[c]) can be used to stop the -attribute. - -Color codes for kbd:[Ctrl+c], kbd:[c] are: - -include::autogen/user/irc_colors.adoc[] - -[NOTE] -To show all available colors in your terminal, you can do `/color` then -kbd:[Alt+c] in WeeChat or run this command in terminal: `weechat --colors`. - -Example: display of "hello everybody!" with "hello" in light blue bold and -"everybody" in light red underlined: - ----- -^Cc12^Cbhello ^Cb^Cc04^C_everybody^C_^Cc! ----- - -[NOTE] -In irc plugin, you can remap these colors using option -<<option_irc.color.mirc_remap,irc.color.mirc_remap>>. - -[[colors]] -=== Colors - -WeeChat can use up to 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 -for colors in WeeChat: - -[width="50%",cols="8,>2,>2",options="header"] -|=== -| $TERM | Colors | Pairs -| "rxvt-unicode", "xterm", ... | 88 | 256 -| "rxvt-256color", "xterm-256color", ... | 256 | 256 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 256 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 256 -|=== - -You can run `weechat --colors` or use command `/color` in WeeChat to -display limits for your environment. - -Some recommended values for _TERM_ if you want 256 colors: - -* under screen: _screen-256color_ -* under tmux: _screen-256color_ or _tmux-256color_ -* outside screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... - -[NOTE] -You may have to install package "ncurses-term" to use these values in _TERM_ -variable. - -If you are using screen, you can add this line to your _~/.screenrc_: - ----- -term screen-256color ----- - -If your _TERM_ variable has wrong value and that WeeChat is already running, -you can change it with these two commands: - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== Basic colors - -Basic colors in WeeChat are: - -[width="50%",cols="^3m,8",options="header"] -|=== -| Name | Color -| default | Default terminal color (transparent for background) -| black | Black -| darkgray | Dark gray -| red | Dark red -| lightred | Light red -| green | Dark green -| lightgreen | Light green -| brown | Brown -| yellow | Yellow -| blue | Dark blue -| lightblue | Light blue -| magenta | Dark magenta -| lightmagenta | Light magenta -| cyan | Dark cyan -| lightcyan | Light cyan -| gray | Gray -| white | White -|=== - -[[colors_extended]] -==== Extended colors - -WeeChat dynamically allocates color pairs when colors are used on screen (to -display buffers and bars). - -In addition to basic colors, you can use a color number between 1 and the limit -of your terminal. - -Use command `/color` to see current colors and limits. With kbd:[Alt+c] you can -temporarily switch to terminal colors to choose a color. - -For example if you want to display time in orange in buffer, do: - ----- -/set weechat.color.chat_time 214 ----- - -Or if you want a very dark green background for status bar: - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== Aliases - -You can add color aliases with command `/color alias` and then use this alias -in any color option. - -For example: - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== Attributes - -It is possible to use some attributes for colors. One or more attributes can be -added before color name or number: - -* `+*+` : bold text -* `+!+` : reverse video -* `+/+` : italic -* `+_+` : underlined text -* `+|+` : keep attributes: do not reset bold/reverse/italic/underlined when - changing color - -For example if you want self nick as white underlined, do: - ----- -/set weechat.color.chat_nick_self _white ----- - -Or if you want time in status bar as orange underlined with bold: - ----- -/set weechat.color.status_time *_214 ----- - -To use an attribute with default terminal color (-1), you must use a number -greater than last terminal color, for example max color in WeeChat: 99999. - -Example of bold with terminal foreground color: - ----- -/set weechat.color.status_time *99999 ----- - [[secured_data]] === Secured data diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc index f59b10393..d4158deab 100644 --- a/doc/fr/weechat_user.fr.adoc +++ b/doc/fr/weechat_user.fr.adoc @@ -633,6 +633,233 @@ Autres objets (non utilisés dans des barres par défaut) : | window_number | `2` | Numéro de la fenêtre courante |=== +[[command_line]] +=== Ligne de commande + +La ligne de commande WeeChat (située en bas de la fenêtre) permet d'exécuter +des commandes ou d'envoyer du texte vers le tampon. + +[[command_line_syntax]] +==== Syntaxe + +Les commandes débutent par un caractère "/", suivi du nom de la +commande. Par exemple pour afficher la liste de toutes les options : + +---- +/set +---- + +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 : + +---- +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 : + +---- +//set +---- + +[[command_line_colors]] +==== Codes couleurs + +Pour certaines extensions comme IRC, il est possible d'utiliser des codes +couleur et attributs comme suit (appuyer sur kbd:[Ctrl+c] puis sur la lettre qui +suit et éventuellement une valeur) : + +[width="60%",cols="3,5",options="header"] +|=== +| Touche | Description +| kbd:[Ctrl+c], kbd:[b] | texte gras +| kbd:[Ctrl+c], kbd:[c], + kbd:[xx] | couleur du texte `xx` (voir la liste des couleurs ci-dessous) +| kbd:[Ctrl+c], kbd:[c], + kbd:[xx], kbd:[,], + kbd:[yy] | couleur du texte `xx` et du fond `yy` (voir la liste des couleurs ci-dessous) +| kbd:[Ctrl+c], kbd:[i] | texte en italique +| kbd:[Ctrl+c], kbd:[o] | désactiver la couleur et tous les attributs +| kbd:[Ctrl+c], kbd:[v] | vidéo inverse (inversion de la couleur d'écriture et du fond) +| kbd:[Ctrl+c], kbd:[_] | texte souligné +|=== + +[NOTE] +Le même code (sans le numéro pour kbd:[Ctrl+c], kbd:[c]) peut être utilisé pour +stopper l'attribut défini. + +Les codes couleur pour kbd:[Ctrl+c], kbd:[c] sont : + +include::autogen/user/irc_colors.adoc[] + +[NOTE] +Pour voir toutes les couleurs disponibles dans votre terminal, vous pouvez +taper `/color` puis kbd:[Alt+c] dans WeeChat ou lancez cette commande dans le +terminal : `weechat --colors`. + +Exemple : affichage de "bonjour tout le monde !" avec "bonjour" en bleu clair +gras, et "tout le monde" en rouge clair souligné : + +---- +^Cc12^Cbbonjour ^Cb^Cc04^C_tout le monde^C_^Cc ! +---- + +[NOTE] +Dans l'extension irc, vous pouvez réassigner les couleurs en utilisant l'option +<<option_irc.color.mirc_remap,irc.color.mirc_remap>>. + +[[colors]] +=== Couleurs + +WeeChat peut utiliser jusqu'à 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 +limites suivantes pour les couleurs dans WeeChat : + +[width="50%",cols="8,>2,>2",options="header"] +|=== +| $TERM | Couleurs | Paires +| "rxvt-unicode", "xterm", ... | 88 | 256 +| "rxvt-256color", "xterm-256color", ... | 256 | 256 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 256 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 256 +|=== + +Vous pouvez lancer `weechat --colors` ou utiliser la commande `/color` +dans WeeChat pour afficher les limites de votre environnement. + +Quelques valeurs recommandées pour _TERM_ si vous voulez 256 couleurs : + +* sous screen : _screen-256color_ +* sous tmux : _screen-256color_ ou _tmux-256color_ +* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_, + _putty-256color_, ... + +Si vous utilisez screen, vous pouvez ajouter cette ligne dans votre +_~/.screenrc_ : + +[NOTE] +Vous devrez peut-être installer le paquet "ncurses-term" pour utiliser ces +valeurs dans la variable _TERM_. + +---- +term screen-256color +---- + +Si votre variable _TERM_ a une valeur erronée et que WeeChat est déjà lancé, +vous pouvez la changer avec ces deux commandes : + +---- +/set env TERM screen-256color +/upgrade +---- + +[[colors_basic]] +==== Couleurs de base + +Les couleurs de base dans WeeChat sont : + +[width="50%",cols="^3m,8",options="header"] +|=== +| Nom | Couleur +| default | Couleur par défaut du terminal (transparent pour le fond) +| black | Noir +| darkgray | Gris foncé +| red | Rouge foncé +| lightred | Rouge clair +| green | Vert foncé +| lightgreen | Vert clair +| brown | Marron +| yellow | Jaune +| blue | Bleu foncé +| lightblue | Bleu clair +| magenta | Violet foncé +| lightmagenta | Violet clair +| cyan | Cyan foncé +| lightcyan | Cyan clair +| gray | Gris +| white | Blanc +|=== + +[[colors_extended]] +==== Couleurs étendues + +WeeChat alloue dynamiquement les paires de couleurs quand elles sont utilisées +sur l'écran (pour afficher les tampons et les barres). + +En plus des couleurs de base, vous pouvez utiliser un numéro de couleur entre 1 +et la limite de votre terminal. + +Utilisez la commande `/color` pour voir les couleurs et les limites. Avec la +touche kbd:[Alt+c], vous pouvez basculer temporairement vers les couleurs du +terminal pour choisir une couleur. + +Par exemple si vous souhaitez afficher l'heure en orange dans le tampon, +faites : + +---- +/set weechat.color.chat_time 214 +---- + +Ou si vous voulez un fond vert très foncé pour la barre de statut : + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== Alias + +Vous pouvez ajouter des alias de couleur avec la commande `/color alias` puis +utiliser cet alias dans n'importe quelle option de couleur. + +Par exemple : + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== Attributs + +Il est possible d'utiliser des attributs pour les couleurs. Un ou plusieurs +attributs peuvent être ajoutés avant le nom ou le numéro de la couleur : + +* `+*+` : texte gras +* `+!+` : mode vidéo inverse +* `+/+` : italique +* `+_+` : texte souligné +* `+|+` : garder les attributs : ne pas réinitialiser gras/inverse/souligné lors + du changement de couleur + +Par exemple si vous voulez votre pseudo en blanc souligné, faites : + +---- +/set weechat.color.chat_nick_self _white +---- + +Ou si vous voulez l'heure dans la barre de statut en orange souligné avec gras : + +---- +/set weechat.color.status_time *_214 +---- + +Pour utiliser un attribut avec la couleur par défaut du terminal (-1), vous +devez utiliser un nombre supérieur à la dernière couleur du terminal, par +exemple la couleur maximum de WeeChat : 99999. + +Exemple de gras avec la couleur de texte du terminal : + +---- +/set weechat.color.status_time *99999 +---- + [[buffers_and_windows]] === Tampons et fenêtres @@ -1567,233 +1794,6 @@ Vous pouvez trouver le nom de l'évènement avec la commande `/input grab_mouse` puis en faisant l'action avec la souris. Cela insérera le nom de l'évènement sur la ligne de commande. -[[command_line]] -=== Ligne de commande - -La ligne de commande WeeChat (située en bas de la fenêtre) permet d'exécuter -des commandes ou d'envoyer du texte vers le tampon. - -[[command_line_syntax]] -==== Syntaxe - -Les commandes débutent par un caractère "/", suivi du nom de la -commande. Par exemple pour afficher la liste de toutes les options : - ----- -/set ----- - -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 : - ----- -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 : - ----- -//set ----- - -[[command_line_colors]] -==== Codes couleurs - -Pour certaines extensions comme IRC, il est possible d'utiliser des codes -couleur et attributs comme suit (appuyer sur kbd:[Ctrl+c] puis sur la lettre qui -suit et éventuellement une valeur) : - -[width="60%",cols="3,5",options="header"] -|=== -| Touche | Description -| kbd:[Ctrl+c], kbd:[b] | texte gras -| kbd:[Ctrl+c], kbd:[c], - kbd:[xx] | couleur du texte `xx` (voir la liste des couleurs ci-dessous) -| kbd:[Ctrl+c], kbd:[c], - kbd:[xx], kbd:[,], - kbd:[yy] | couleur du texte `xx` et du fond `yy` (voir la liste des couleurs ci-dessous) -| kbd:[Ctrl+c], kbd:[i] | texte en italique -| kbd:[Ctrl+c], kbd:[o] | désactiver la couleur et tous les attributs -| kbd:[Ctrl+c], kbd:[v] | vidéo inverse (inversion de la couleur d'écriture et du fond) -| kbd:[Ctrl+c], kbd:[_] | texte souligné -|=== - -[NOTE] -Le même code (sans le numéro pour kbd:[Ctrl+c], kbd:[c]) peut être utilisé pour -stopper l'attribut défini. - -Les codes couleur pour kbd:[Ctrl+c], kbd:[c] sont : - -include::autogen/user/irc_colors.adoc[] - -[NOTE] -Pour voir toutes les couleurs disponibles dans votre terminal, vous pouvez -taper `/color` puis kbd:[Alt+c] dans WeeChat ou lancez cette commande dans le -terminal : `weechat --colors`. - -Exemple : affichage de "bonjour tout le monde !" avec "bonjour" en bleu clair -gras, et "tout le monde" en rouge clair souligné : - ----- -^Cc12^Cbbonjour ^Cb^Cc04^C_tout le monde^C_^Cc ! ----- - -[NOTE] -Dans l'extension irc, vous pouvez réassigner les couleurs en utilisant l'option -<<option_irc.color.mirc_remap,irc.color.mirc_remap>>. - -[[colors]] -=== Couleurs - -WeeChat peut utiliser jusqu'à 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 -limites suivantes pour les couleurs dans WeeChat : - -[width="50%",cols="8,>2,>2",options="header"] -|=== -| $TERM | Couleurs | Paires -| "rxvt-unicode", "xterm", ... | 88 | 256 -| "rxvt-256color", "xterm-256color", ... | 256 | 256 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 256 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 256 -|=== - -Vous pouvez lancer `weechat --colors` ou utiliser la commande `/color` -dans WeeChat pour afficher les limites de votre environnement. - -Quelques valeurs recommandées pour _TERM_ si vous voulez 256 couleurs : - -* sous screen : _screen-256color_ -* sous tmux : _screen-256color_ ou _tmux-256color_ -* en dehors de screen/tmux : _xterm-256color_, _rxvt-256color_, - _putty-256color_, ... - -Si vous utilisez screen, vous pouvez ajouter cette ligne dans votre -_~/.screenrc_ : - -[NOTE] -Vous devrez peut-être installer le paquet "ncurses-term" pour utiliser ces -valeurs dans la variable _TERM_. - ----- -term screen-256color ----- - -Si votre variable _TERM_ a une valeur erronée et que WeeChat est déjà lancé, -vous pouvez la changer avec ces deux commandes : - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== Couleurs de base - -Les couleurs de base dans WeeChat sont : - -[width="50%",cols="^3m,8",options="header"] -|=== -| Nom | Couleur -| default | Couleur par défaut du terminal (transparent pour le fond) -| black | Noir -| darkgray | Gris foncé -| red | Rouge foncé -| lightred | Rouge clair -| green | Vert foncé -| lightgreen | Vert clair -| brown | Marron -| yellow | Jaune -| blue | Bleu foncé -| lightblue | Bleu clair -| magenta | Violet foncé -| lightmagenta | Violet clair -| cyan | Cyan foncé -| lightcyan | Cyan clair -| gray | Gris -| white | Blanc -|=== - -[[colors_extended]] -==== Couleurs étendues - -WeeChat alloue dynamiquement les paires de couleurs quand elles sont utilisées -sur l'écran (pour afficher les tampons et les barres). - -En plus des couleurs de base, vous pouvez utiliser un numéro de couleur entre 1 -et la limite de votre terminal. - -Utilisez la commande `/color` pour voir les couleurs et les limites. Avec la -touche kbd:[Alt+c], vous pouvez basculer temporairement vers les couleurs du -terminal pour choisir une couleur. - -Par exemple si vous souhaitez afficher l'heure en orange dans le tampon, -faites : - ----- -/set weechat.color.chat_time 214 ----- - -Ou si vous voulez un fond vert très foncé pour la barre de statut : - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== Alias - -Vous pouvez ajouter des alias de couleur avec la commande `/color alias` puis -utiliser cet alias dans n'importe quelle option de couleur. - -Par exemple : - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== Attributs - -Il est possible d'utiliser des attributs pour les couleurs. Un ou plusieurs -attributs peuvent être ajoutés avant le nom ou le numéro de la couleur : - -* `+*+` : texte gras -* `+!+` : mode vidéo inverse -* `+/+` : italique -* `+_+` : texte souligné -* `+|+` : garder les attributs : ne pas réinitialiser gras/inverse/souligné lors - du changement de couleur - -Par exemple si vous voulez votre pseudo en blanc souligné, faites : - ----- -/set weechat.color.chat_nick_self _white ----- - -Ou si vous voulez l'heure dans la barre de statut en orange souligné avec gras : - ----- -/set weechat.color.status_time *_214 ----- - -Pour utiliser un attribut avec la couleur par défaut du terminal (-1), vous -devez utiliser un nombre supérieur à la dernière couleur du terminal, par -exemple la couleur maximum de WeeChat : 99999. - -Exemple de gras avec la couleur de texte du terminal : - ----- -/set weechat.color.status_time *99999 ----- - [[secured_data]] === Données sécurisées diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc index e362e8747..3f589b92d 100644 --- a/doc/it/weechat_user.it.adoc +++ b/doc/it/weechat_user.it.adoc @@ -666,6 +666,236 @@ Other items available (not used in bars by default): | window_number | `2` | Current window number |=== +[[command_line]] +=== Riga di comando + +La riga di comando di WeeChat (nella parte inferiore della finestra) consente di +inserire i comandi o di inviare del testo sul buffer. + +[[command_line_syntax]] +==== Sintassi + +I comandi iniziano con il carattere "/", seguito dal nome del comando. Ad esempio, +per consultare un elenco di opzioni: + +---- +/set +---- + +Il testo inviato ad un buffer è qualsiasi testo che non comincia con +il carattere "/". Per esempio, per inviare il testo _ciao_ sul buffer +attivo: + +---- +ciao +---- + +Ad ogni modo, è possibile iniziare con il carattere "/", aggiungendone +poi un altro. Ad esempio, per inviare il testo `/set` sul buffer attivo: + +---- +//set +---- + +[[command_line_colors]] +==== Codici colore + +Per alcuni plugin come IRC, è possibile usare codici colori ed attributi, +come segue (digitare kbd:[Ctrl+c] poi la lettera che segue, con il valore +opzionale): + +[width="60%",cols="3,5",options="header"] +|=== +// TRANSLATIION MISSING +| Key | Description +| kbd:[Ctrl+c], kbd:[b] | testo in grassetto +| kbd:[Ctrl+c], kbd:[c], + kbd:[xx] | colore del testo `xx` (consultare la lista di colori che segue) +| kbd:[Ctrl+c], kbd:[c], + kbd:[xx], kbd:[,], + kbd:[yy] | colore del testo `xx` e di sfondo `yy` (consultare la lista di colori che segue) +// TRANSLATION MISSING +| kbd:[Ctrl+c], kbd:[i] | italic text +| kbd:[Ctrl+c], kbd:[o] | disabilita colori ed attributi +| kbd:[Ctrl+c], kbd:[v] | video inverso (inverte il colore del testo con quello di sfondo) +| kbd:[Ctrl+c], kbd:[_] | testo sottolineato +|=== + +[NOTE] +Lo stesso codice (senza numero per kbd:[Ctrl+c], kbd:[c]) può essere usato per +terminare l'attributo. + +I codici colore per kbd:[Ctrl+c], kbd:[c] sono: + +include::autogen/user/irc_colors.adoc[] + +// TRANSLATION MISSING +[NOTE] +To show all available colors in your terminal, you can do `/color` then +kbd:[Alt+c] in WeeChat or run this command in terminal: `weechat --colors`. + +Esempio: visualizza "ciao a tutti!" con "ciao" scritto in blu chiaro grassetto +e "a tutti" in rosso chiaro sottolineato: + +---- +^Cc12^Cbciao ^Cb^Cc04^C_a tutti^C_^Cc ! +---- + +[NOTE] +Nel plugin irc, si possono riorganizzare i colori usando l'opzione +<<option_irc.color.mirc_remap,irc.color.mirc_remap>>. + +[[colors]] +=== Colori + +WeeChat può usare fino a 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 +seguenti limiti per i colori in WeeChat: + +[width="50%",cols="8,>2,>2",options="header"] +|=== +| $TERM | Colori | Coppie +| "rxvt-unicode", "xterm", ... | 88 | 256 +| "rxvt-256color", "xterm-256color", ... | 256 | 256 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 256 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 256 +|=== + +È possibile eseguire `weechat --colors` o utilizzare il comando `/color` in +WeeChat per visualizzare i limiti del proprio ambiente. + +Alcuni valori raccomandati per _TERM_ se si desiderano 256 colori: + +* con screen: _screen-256color_ +// TRANSLATION MISSING +* under tmux: _screen-256color_ or _tmux-256color_ +// TRANSLATION MISSING +* outside screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... + +[NOTE] +Potrebbe essere necessario installare il pacchetto "ncurses-term" per usare +questi valori nella variabile _TERM_. + +Se si sta utilizzando screen, è possibile aggiungere questa riga al +proprio _~/.screenrc_: + +---- +term screen-256color +---- + +// TRANSLATION MISSING +If your _TERM_ variable has wrong value and that WeeChat is already running, +you can change it with these two commands: + +---- +/set env TERM screen-256color +/upgrade +---- + +[[colors_basic]] +==== Colori base + +I colori base in WeeChat sono: + +[width="50%",cols="^3m,8",options="header"] +|=== +| Nome | Colore +| default | Colore predefinito del terminale (trasparente per lo sfondo) +| black | Nero +| darkgray | Grigio scuro +| red | Rosso scuro +| lightred | Rosso chiaro +| green | Verde scuro +| lightgreen | Verde chiaro +| brown | Marrone +| yellow | Giallo +| blue | Blu scuro +| lightblue | Blu chiaro +| magenta | Rosa scuro +| lightmagenta | Rosa chiaro +| cyan | Azzurro scuro +| lightcyan | Azzurro chiaro +| gray | Grigio +| white | Bianco +|=== + +[[colors_extended]] +==== Colori estesi + +WeeChat alloca dinamicamente le coppie colore quando vengono usati i colori +sullo schermo (per mostrare buffer e barre). + +In aggiunta ai colori di base, si può usare un numero per il colore compreso +tra 1 e il limite del proprio terminale. + +Il comando `/color` mostra i colori attivi ed i limiti. Com kbd:[Alt+c] si può +passare temporaneamente ai colori del terminale per sceglierne uno. + +Se ad esempio si desidera visualizzare l'ora in arancione nel buffer: + +---- +/set weechat.color.chat_time 214 +---- + +O se si desidera uno sfondo verde scuro per la barra di stato: + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== Alias + +Si possono aggiungere degli alias ai colori con il comando `/color alias` e +usarli in ogni opzione relativa al colore. + +Ad esempio: + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== Attributi + +Esistono alcuni attributi per i colori. Uno o più attributi vanno aggiunti prima +del nome o del numero del colore: + +* `+*+` : testo in grassetto +* `+!+` : video inverso +* `+/+` : testo in corsivo +* `+_+` : testo sottolineato +* `+|+` : mantiene attributi: non ripristina grassetto/inverso/sottolineato + al cambio di colore + +Ad esempio se si vuole il proprio nick bianco e sottolineato: + +---- +/set weechat.color.chat_nick_self _white +---- + +O se si desidera l'ora nella barra di stato arancione sottolineata +e in grassetto: + +---- +/set weechat.color.status_time *_214 +---- + +Per usare un attributo con il colore predefinito del terminale (-1), bisogna +usare un numero maggiore dell'ultimo colore del terminale, ad esempio il +numero massimo in WeeChat: 99999. + +Esempio di grassetto con il colore di primo piano del terminale: + +---- +/set weechat.color.status_time *99999 +---- + [[buffers_and_windows]] === Buffer e finestre @@ -1598,236 +1828,6 @@ più eventi usando `+*+` all'inizio o alla fine del nome, ad esempio poi eseguire l'evento col mouse. Il comando inserisce il nome dell'evento nella riga di comando. -[[command_line]] -=== Riga di comando - -La riga di comando di WeeChat (nella parte inferiore della finestra) consente di -inserire i comandi o di inviare del testo sul buffer. - -[[command_line_syntax]] -==== Sintassi - -I comandi iniziano con il carattere "/", seguito dal nome del comando. Ad esempio, -per consultare un elenco di opzioni: - ----- -/set ----- - -Il testo inviato ad un buffer è qualsiasi testo che non comincia con -il carattere "/". Per esempio, per inviare il testo _ciao_ sul buffer -attivo: - ----- -ciao ----- - -Ad ogni modo, è possibile iniziare con il carattere "/", aggiungendone -poi un altro. Ad esempio, per inviare il testo `/set` sul buffer attivo: - ----- -//set ----- - -[[command_line_colors]] -==== Codici colore - -Per alcuni plugin come IRC, è possibile usare codici colori ed attributi, -come segue (digitare kbd:[Ctrl+c] poi la lettera che segue, con il valore -opzionale): - -[width="60%",cols="3,5",options="header"] -|=== -// TRANSLATIION MISSING -| Key | Description -| kbd:[Ctrl+c], kbd:[b] | testo in grassetto -| kbd:[Ctrl+c], kbd:[c], - kbd:[xx] | colore del testo `xx` (consultare la lista di colori che segue) -| kbd:[Ctrl+c], kbd:[c], - kbd:[xx], kbd:[,], - kbd:[yy] | colore del testo `xx` e di sfondo `yy` (consultare la lista di colori che segue) -// TRANSLATION MISSING -| kbd:[Ctrl+c], kbd:[i] | italic text -| kbd:[Ctrl+c], kbd:[o] | disabilita colori ed attributi -| kbd:[Ctrl+c], kbd:[v] | video inverso (inverte il colore del testo con quello di sfondo) -| kbd:[Ctrl+c], kbd:[_] | testo sottolineato -|=== - -[NOTE] -Lo stesso codice (senza numero per kbd:[Ctrl+c], kbd:[c]) può essere usato per -terminare l'attributo. - -I codici colore per kbd:[Ctrl+c], kbd:[c] sono: - -include::autogen/user/irc_colors.adoc[] - -// TRANSLATION MISSING -[NOTE] -To show all available colors in your terminal, you can do `/color` then -kbd:[Alt+c] in WeeChat or run this command in terminal: `weechat --colors`. - -Esempio: visualizza "ciao a tutti!" con "ciao" scritto in blu chiaro grassetto -e "a tutti" in rosso chiaro sottolineato: - ----- -^Cc12^Cbciao ^Cb^Cc04^C_a tutti^C_^Cc ! ----- - -[NOTE] -Nel plugin irc, si possono riorganizzare i colori usando l'opzione -<<option_irc.color.mirc_remap,irc.color.mirc_remap>>. - -[[colors]] -=== Colori - -WeeChat può usare fino a 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 -seguenti limiti per i colori in WeeChat: - -[width="50%",cols="8,>2,>2",options="header"] -|=== -| $TERM | Colori | Coppie -| "rxvt-unicode", "xterm", ... | 88 | 256 -| "rxvt-256color", "xterm-256color", ... | 256 | 256 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 256 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 256 -|=== - -È possibile eseguire `weechat --colors` o utilizzare il comando `/color` in -WeeChat per visualizzare i limiti del proprio ambiente. - -Alcuni valori raccomandati per _TERM_ se si desiderano 256 colori: - -* con screen: _screen-256color_ -// TRANSLATION MISSING -* under tmux: _screen-256color_ or _tmux-256color_ -// TRANSLATION MISSING -* outside screen/tmux: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... - -[NOTE] -Potrebbe essere necessario installare il pacchetto "ncurses-term" per usare -questi valori nella variabile _TERM_. - -Se si sta utilizzando screen, è possibile aggiungere questa riga al -proprio _~/.screenrc_: - ----- -term screen-256color ----- - -// TRANSLATION MISSING -If your _TERM_ variable has wrong value and that WeeChat is already running, -you can change it with these two commands: - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== Colori base - -I colori base in WeeChat sono: - -[width="50%",cols="^3m,8",options="header"] -|=== -| Nome | Colore -| default | Colore predefinito del terminale (trasparente per lo sfondo) -| black | Nero -| darkgray | Grigio scuro -| red | Rosso scuro -| lightred | Rosso chiaro -| green | Verde scuro -| lightgreen | Verde chiaro -| brown | Marrone -| yellow | Giallo -| blue | Blu scuro -| lightblue | Blu chiaro -| magenta | Rosa scuro -| lightmagenta | Rosa chiaro -| cyan | Azzurro scuro -| lightcyan | Azzurro chiaro -| gray | Grigio -| white | Bianco -|=== - -[[colors_extended]] -==== Colori estesi - -WeeChat alloca dinamicamente le coppie colore quando vengono usati i colori -sullo schermo (per mostrare buffer e barre). - -In aggiunta ai colori di base, si può usare un numero per il colore compreso -tra 1 e il limite del proprio terminale. - -Il comando `/color` mostra i colori attivi ed i limiti. Com kbd:[Alt+c] si può -passare temporaneamente ai colori del terminale per sceglierne uno. - -Se ad esempio si desidera visualizzare l'ora in arancione nel buffer: - ----- -/set weechat.color.chat_time 214 ----- - -O se si desidera uno sfondo verde scuro per la barra di stato: - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== Alias - -Si possono aggiungere degli alias ai colori con il comando `/color alias` e -usarli in ogni opzione relativa al colore. - -Ad esempio: - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== Attributi - -Esistono alcuni attributi per i colori. Uno o più attributi vanno aggiunti prima -del nome o del numero del colore: - -* `+*+` : testo in grassetto -* `+!+` : video inverso -* `+/+` : testo in corsivo -* `+_+` : testo sottolineato -* `+|+` : mantiene attributi: non ripristina grassetto/inverso/sottolineato - al cambio di colore - -Ad esempio se si vuole il proprio nick bianco e sottolineato: - ----- -/set weechat.color.chat_nick_self _white ----- - -O se si desidera l'ora nella barra di stato arancione sottolineata -e in grassetto: - ----- -/set weechat.color.status_time *_214 ----- - -Per usare un attributo con il colore predefinito del terminale (-1), bisogna -usare un numero maggiore dell'ultimo colore del terminale, ad esempio il -numero massimo in WeeChat: 99999. - -Esempio di grassetto con il colore di primo piano del terminale: - ----- -/set weechat.color.status_time *99999 ----- - // TRANSLATION MISSING [[secured_data]] === Secured data diff --git a/doc/ja/weechat_user.ja.adoc b/doc/ja/weechat_user.ja.adoc index 215875bd8..fe1437f16 100644 --- a/doc/ja/weechat_user.ja.adoc +++ b/doc/ja/weechat_user.ja.adoc @@ -625,6 +625,225 @@ WeeChat を起動した端末の例: | window_number | `2` | 現在のウィンドウ番号 |=== +[[command_line]] +=== コマンドライン + +WeeChat コマンドライン (ウィンドウの一番下にあります) +はコマンドの実行やバッファにテキストを送信するために利用します。 + +[[command_line_syntax]] +==== 文法 + +コマンドは "/" +文字で始まり、コマンドの名前を続けます。例えば、すべてのオプションを表示するには: + +---- +/set +---- + +"/" が最初に無い場合、そのテキストはバッファに送信されます。例えば、_hello_ +というテキストをバッファに送信するには: + +---- +hello +---- + +"/" 文字から始まるテキストを送信したい場合、2 重に "/" をつけます。例えば、`/set` +というテキストを現在のバッファに送信するには: + +---- +//set +---- + +[[command_line_colors]] +==== 色コード + +IRC 等のプラグインでは、以下の色コードと属性を利用できます +(kbd:[Ctrl+c] の後に、オプションとともに以下のキーを押してください): + +[width="60%",cols="3,5",options="header"] +|=== +| キー | 説明 +| kbd:[Ctrl+c], kbd:[b] | テキストを太字に +| kbd:[Ctrl+c], kbd:[c], + kbd:[xx] | テキスト表示色を `xx` に (以下の色リストを参照) +| kbd:[Ctrl+c], kbd:[c], + kbd:[xx], kbd:[,], + kbd:[yy] | テキスト表示色を `xx` に、背景色を `yy` に (以下の色リストを参照) +| kbd:[Ctrl+c], kbd:[i] | テキストをイタリック体に +| kbd:[Ctrl+c], kbd:[o] | テキスト表示色と属性をリセット +| kbd:[Ctrl+c], kbd:[v] | テキストを反転 (テキスト表示色と背景色の入れ替え) +| kbd:[Ctrl+c], kbd:[_] | テキストに下線を引く +|=== + +[NOTE] +同じコードで (色コードを入力せずに kbd:[Ctrl+c], kbd:[c] +を使うことで) 属性をキャンセルすることができます。 + +kbd:[Ctrl+c], kbd:[c] 用の色コード: + +include::autogen/user/irc_colors.adoc[] + +[NOTE] +端末で利用可能なすべての色を表示するには、WeeChat で `/color` を実行した後 +kbd:[Alt+c] を入力するか、端末で以下のコマンドを実行してください: `weechat --colors`。 + +例: +「こんにちは皆さん!」の「こんにちは」を太字の明るい青、「皆さん」を下線付きの明るい赤に表示したい場合: + +---- +^Cc12^Cbこんにちは^Cb^Cc04^C_皆さん^C_^Cc! +---- + +[NOTE] +irc プラグインでは、<<option_irc.color.mirc_remap,irc.color.mirc_remap>> +を使ってこれらの色を別の色に対応付けることができます。 + +[[colors]] +=== 色 + +WeeChat ではバーやチャットエリアにおけるテキスト表示に 256 個の色ペアを利用できます +(この機能を利用するには WeeChat が実行されている端末が 256 色表示に対応している必要があります)。 + +_TERM_ 環境変数の値によって、WeeChat +で利用できる色と色ペアに以下の制限があります: + +[width="50%",cols="8,>2,>2",options="header"] +|=== +| $TERM | 色 | ペア +| "rxvt-unicode", "xterm", ... | 88 | 256 +| "rxvt-256color", "xterm-256color", ... | 256 | 256 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 256 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 256 +|=== + +`weechat --colors` を実行するか、`/color` コマンドを WeeChat +の中で実行することで、色表示の制限を確認できます。 + +256 色を利用したい場合に推奨される _TERM_ 環境変数の値は: + +* screen 内の場合: _screen-256color_ +* tmux 内の場合: _screen-256color_、_tmux-256color_ +* screen および tmux の外の場合: _xterm-256color_、_rxvt-256color_、_putty-256color_、... + +[NOTE] +_TERM_ 環境変数の値に上の値を設定するには、"ncurses-term" +パッケージをインストールする必要があるかもしれません。 + +screen を使っている場合、_~/.screenrc_ に以下の内容を追加してください: + +---- +term screen-256color +---- + +_TERM_ 変数が間違った値に設定された状態で WeeChat が起動完了している場合は、以下の +2 つのコマンドを使って変数の値を変更してください: + +---- +/set env TERM screen-256color +/upgrade +---- + +[[colors_basic]] +==== 基本色 + +WeeChat における基本色とは: + +[width="50%",cols="^3m,8",options="header"] +|=== +| 名前 | 色 +| default | デフォルトの端末色 (背景色を透過色とする) +| black | 黒 +| darkgray | 暗い灰色 +| red | 暗い赤 +| lightred | 明るい赤 +| green | 暗い緑色 +| lightgreen | 明るい緑色 +| brown | 茶色 +| yellow | 黄色 +| blue | 暗い青 +| lightblue | 明るい青 +| magenta | 暗い赤紫色 +| lightmagenta | 明るい赤紫色 +| cyan | 暗い青緑色 +| lightcyan | 明るい青緑色 +| gray | 灰色 +| white | 白 +|=== + +[[colors_extended]] +==== 拡張色 + +WeeChat は画面に色が表示された時点で色ペアを動的に割り当てます +(バッファとバーを表示する時点で)。 + +基本色に加えて、1 番 +から端末の対応状況に依存する番号までの色番号を利用できます。 + +`/color` コマンドで現在の色と色制限を確認できます。kbd:[Alt+c] +をタイプすることで、一時的に端末色を選択された色に変更できます。 + +例えば、バッファ中のに表示される時刻をオレンジ色にしたい場合、以下のようにしてください: + +---- +/set weechat.color.chat_time 214 +---- + +ステータスバーの色を非常に暗い緑色にしたい場合: + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== 別名 + +`/color alias` コマンドを使えば色の別名を追加できます。 +追加後は任意の色関連オプションで別名を使えます。 + +例: + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== 属性 + +色に対していくつかの属性を付加することができます。1 +つ以上の属性を色名または色番号の前に付加できます: + +* `+*+` : テキストを太字に +* `+!+` : テキストを反転 +* `+/+` : テキストをイタリック体に +* `+_+` : テキストに下線を引く +* `+|+` : 属性を保持: + 色を変えた際に太字/反転/下線属性をリセットしない + +例えば、自分自身のニックネームの表示色を白にして、下線を引きたい場合: + +---- +/set weechat.color.chat_nick_self _white +---- + +ステータスバーの時刻の表示色を橙色にして、下線を引いて、太字にしたい場合: + +---- +/set weechat.color.status_time *_214 +---- + +デフォルト端末色 (-1) に対して属性を設定したい場合、端末色番号の最大値よりも大きな値を利用してください。例えば、WeeChat +における色番号の最大値は 99999 です。 + +端末の表示色に太字の属性を付加する例: + +---- +/set weechat.color.status_time *99999 +---- + [[buffers_and_windows]] === バッファとウィンドウ @@ -1523,225 +1742,6 @@ WeeChat はデフォルトマウスイベントの多くを定義しています `/input grab_mouse` コマンドの後にマウスを動かすことでコマンドラインにマウスイベントが入力されます。これにより対応するイベントを確認できます。 -[[command_line]] -=== コマンドライン - -WeeChat コマンドライン (ウィンドウの一番下にあります) -はコマンドの実行やバッファにテキストを送信するために利用します。 - -[[command_line_syntax]] -==== 文法 - -コマンドは "/" -文字で始まり、コマンドの名前を続けます。例えば、すべてのオプションを表示するには: - ----- -/set ----- - -"/" が最初に無い場合、そのテキストはバッファに送信されます。例えば、_hello_ -というテキストをバッファに送信するには: - ----- -hello ----- - -"/" 文字から始まるテキストを送信したい場合、2 重に "/" をつけます。例えば、`/set` -というテキストを現在のバッファに送信するには: - ----- -//set ----- - -[[command_line_colors]] -==== 色コード - -IRC 等のプラグインでは、以下の色コードと属性を利用できます -(kbd:[Ctrl+c] の後に、オプションとともに以下のキーを押してください): - -[width="60%",cols="3,5",options="header"] -|=== -| キー | 説明 -| kbd:[Ctrl+c], kbd:[b] | テキストを太字に -| kbd:[Ctrl+c], kbd:[c], - kbd:[xx] | テキスト表示色を `xx` に (以下の色リストを参照) -| kbd:[Ctrl+c], kbd:[c], - kbd:[xx], kbd:[,], - kbd:[yy] | テキスト表示色を `xx` に、背景色を `yy` に (以下の色リストを参照) -| kbd:[Ctrl+c], kbd:[i] | テキストをイタリック体に -| kbd:[Ctrl+c], kbd:[o] | テキスト表示色と属性をリセット -| kbd:[Ctrl+c], kbd:[v] | テキストを反転 (テキスト表示色と背景色の入れ替え) -| kbd:[Ctrl+c], kbd:[_] | テキストに下線を引く -|=== - -[NOTE] -同じコードで (色コードを入力せずに kbd:[Ctrl+c], kbd:[c] -を使うことで) 属性をキャンセルすることができます。 - -kbd:[Ctrl+c], kbd:[c] 用の色コード: - -include::autogen/user/irc_colors.adoc[] - -[NOTE] -端末で利用可能なすべての色を表示するには、WeeChat で `/color` を実行した後 -kbd:[Alt+c] を入力するか、端末で以下のコマンドを実行してください: `weechat --colors`。 - -例: -「こんにちは皆さん!」の「こんにちは」を太字の明るい青、「皆さん」を下線付きの明るい赤に表示したい場合: - ----- -^Cc12^Cbこんにちは^Cb^Cc04^C_皆さん^C_^Cc! ----- - -[NOTE] -irc プラグインでは、<<option_irc.color.mirc_remap,irc.color.mirc_remap>> -を使ってこれらの色を別の色に対応付けることができます。 - -[[colors]] -=== 色 - -WeeChat ではバーやチャットエリアにおけるテキスト表示に 256 個の色ペアを利用できます -(この機能を利用するには WeeChat が実行されている端末が 256 色表示に対応している必要があります)。 - -_TERM_ 環境変数の値によって、WeeChat -で利用できる色と色ペアに以下の制限があります: - -[width="50%",cols="8,>2,>2",options="header"] -|=== -| $TERM | 色 | ペア -| "rxvt-unicode", "xterm", ... | 88 | 256 -| "rxvt-256color", "xterm-256color", ... | 256 | 256 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 256 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 256 -|=== - -`weechat --colors` を実行するか、`/color` コマンドを WeeChat -の中で実行することで、色表示の制限を確認できます。 - -256 色を利用したい場合に推奨される _TERM_ 環境変数の値は: - -* screen 内の場合: _screen-256color_ -* tmux 内の場合: _screen-256color_、_tmux-256color_ -* screen および tmux の外の場合: _xterm-256color_、_rxvt-256color_、_putty-256color_、... - -[NOTE] -_TERM_ 環境変数の値に上の値を設定するには、"ncurses-term" -パッケージをインストールする必要があるかもしれません。 - -screen を使っている場合、_~/.screenrc_ に以下の内容を追加してください: - ----- -term screen-256color ----- - -_TERM_ 変数が間違った値に設定された状態で WeeChat が起動完了している場合は、以下の -2 つのコマンドを使って変数の値を変更してください: - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== 基本色 - -WeeChat における基本色とは: - -[width="50%",cols="^3m,8",options="header"] -|=== -| 名前 | 色 -| default | デフォルトの端末色 (背景色を透過色とする) -| black | 黒 -| darkgray | 暗い灰色 -| red | 暗い赤 -| lightred | 明るい赤 -| green | 暗い緑色 -| lightgreen | 明るい緑色 -| brown | 茶色 -| yellow | 黄色 -| blue | 暗い青 -| lightblue | 明るい青 -| magenta | 暗い赤紫色 -| lightmagenta | 明るい赤紫色 -| cyan | 暗い青緑色 -| lightcyan | 明るい青緑色 -| gray | 灰色 -| white | 白 -|=== - -[[colors_extended]] -==== 拡張色 - -WeeChat は画面に色が表示された時点で色ペアを動的に割り当てます -(バッファとバーを表示する時点で)。 - -基本色に加えて、1 番 -から端末の対応状況に依存する番号までの色番号を利用できます。 - -`/color` コマンドで現在の色と色制限を確認できます。kbd:[Alt+c] -をタイプすることで、一時的に端末色を選択された色に変更できます。 - -例えば、バッファ中のに表示される時刻をオレンジ色にしたい場合、以下のようにしてください: - ----- -/set weechat.color.chat_time 214 ----- - -ステータスバーの色を非常に暗い緑色にしたい場合: - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== 別名 - -`/color alias` コマンドを使えば色の別名を追加できます。 -追加後は任意の色関連オプションで別名を使えます。 - -例: - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== 属性 - -色に対していくつかの属性を付加することができます。1 -つ以上の属性を色名または色番号の前に付加できます: - -* `+*+` : テキストを太字に -* `+!+` : テキストを反転 -* `+/+` : テキストをイタリック体に -* `+_+` : テキストに下線を引く -* `+|+` : 属性を保持: - 色を変えた際に太字/反転/下線属性をリセットしない - -例えば、自分自身のニックネームの表示色を白にして、下線を引きたい場合: - ----- -/set weechat.color.chat_nick_self _white ----- - -ステータスバーの時刻の表示色を橙色にして、下線を引いて、太字にしたい場合: - ----- -/set weechat.color.status_time *_214 ----- - -デフォルト端末色 (-1) に対して属性を設定したい場合、端末色番号の最大値よりも大きな値を利用してください。例えば、WeeChat -における色番号の最大値は 99999 です。 - -端末の表示色に太字の属性を付加する例: - ----- -/set weechat.color.status_time *99999 ----- - [[secured_data]] === 暗号化データ diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc index 83b3bf256..be6d7cf5b 100644 --- a/doc/pl/weechat_user.pl.adoc +++ b/doc/pl/weechat_user.pl.adoc @@ -630,6 +630,227 @@ Inne dostępne elementy (nie używane domyślnie w paskach): | window_number | `2` | Numer obecnego okna |=== +[[command_line]] +=== Linia poleceń + +Linia poleceń WeeChat (na dole okna) pozwala na wykonywanie komend lub wysłanie +tekstu do bufora. + +[[command_line_syntax]] +==== Składnia + +Komendy zaczynają się od znaku "/", następnie wpisujemy komendę. Na przykład, +aby zobaczyć listę wszystkich opcji: + +---- +/set +---- + +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: + +---- +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: + +---- +//set +---- + +[[command_line_colors]] +==== Kody kolorów + +Dla niektórych wtyczek jak IRC, można użyć kolorów i atrybutów w następujący sposób +(wciśnij kbd:[Ctrl+c] następnie literę z opcjonalną wartością): + +[width="60%",cols="3,5",options="header"] +|=== +| Klawisz | Opis +| kbd:[Ctrl+c], kbd:[b] | pogrubiony tekst +| kbd:[Ctrl+c], kbd:[c], + kbd:[xx] | kolor tekstu `xx` (zgodnie z poniższą listą kolorów) +| kbd:[Ctrl+c], kbd:[c], + kbd:[xx], kbd:[,], + kbd:[yy] | kolor tekstu `xx` i tła `yy` (zgodnie z poniższą listą kolorów) +| kbd:[Ctrl+c], kbd:[i] | pochyły tekst +| kbd:[Ctrl+c], kbd:[o] | wyłącza kolory i atrybuty +| kbd:[Ctrl+c], kbd:[v] | odwróć video (przywraca kolor tekstu i tła) +| kbd:[Ctrl+c], kbd:[_] | podkreślony tekst +|=== + +[NOTE] +Ten sam sktót (bez numeru dla kbd:[Ctrl+c], kbd:[c]) może zostać użyty do zatrzymania +atrybutu. + +Kody kolorów dla kbd:[Ctrl+c], kbd:[c]: + +include::autogen/user/irc_colors.adoc[] + +[NOTE] +W celu wyświetlenia wszystkich dostępnych kolorów dla terminala możesz wykonać +komendę `/color` następnie kbd:[Alt+c] (w WeeChat) lub wywołać w terminalu: +`weechat --colors`. + +Przykład: wyświetlenie "hello everybody!" z pogrubionym jasno niebieskim "hello" +i podkreślonym jasno czerwonym "everybody": + +---- +^Cc12^Cbhello ^Cb^Cc04^C_everybody^C_^Cc! +---- + +[NOTE] +We wtyczce irc, można zmienić przypisania tych kolorów za pomocą opcji +<<option_irc.color.mirc_remap,irc.color.mirc_remap>>. + +[[colors]] +=== Kolory + +WeeChat może użyć do 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 +limity dla kolorów w WeeChat: + +[width="50%",cols="8,>2,>2",options="header"] +|=== +| $TERM | Kolory | Pary +| "rxvt-unicode", "xterm", ... | 88 | 256 +| "rxvt-256color", "xterm-256color", ... | 256 | 256 +| "screen" | 8 | 64 +| "screen-256color" | 256 | 256 +| "tmux" | 8 | 64 +| "tmux-256color" | 256 | 256 +|=== + +Możesz wykonać `weechat --colors` lub użyć komendy `/color` w WeeChat, aby +wyświetlić limity dla twojego środowiska. + +Niektóre z zalecanych wartości dla _TERM_ jeśli chcesz używać 256 kolorów: + +* dla screena: _screen-256color_ +* pod tmux: _screen-256color_ lub _tmux-256color_ +* poza screenem/tmuxem: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... + +[NOTE] +Być może konieczne jest zainstalowanie pakietu "ncurses-term", w celu użycia +tych wartości dla zmiennej _TERM_. + +Jeśli używasz screena, możesz dodać to do swojego _~/.screenrc_: + +---- +term screen-256color +---- + +Jeśli wartość zmiennej _TERM_ ma złą wartość, a WeeChat jest już uruchomiony, +możesz ją zmienić za pomocą tych dwóch komend: + +---- +/set env TERM screen-256color +/upgrade +---- + +[[colors_basic]] +==== Podstawowe kolory + +Podstawowe kolory w WeeChat to: + +[width="50%",cols="^3m,8",options="header"] +|=== +| Nazwa | Kolor +| default | Domyślny kolor terminala (przezroczysty dla tła) +| black | Czarny +| darkgray | Ciemny szary +| red | Ciemny czerwony +| lightred | Jasny czerwony +| green | Ciemny zielony +| lightgreen | Jasny zielony +| brown | Brązowy +| yellow | Żółty +| blue | Ciemny niebieski +| lightblue | Jasny niebieski +| magenta | Ciemny karmazynowy +| lightmagenta | Jasny karmazynowy +| cyan | Ciemny błękitny +| lightcyan | Jasny błękitny +| gray | Szary +| white | Biały +|=== + +[[colors_extended]] +==== Rozszerzone kolory + +Weechat dynamicznie alokuje pary kolorów, kiedy kolory są używane na ekranie (do +wyświetlania buforów i pasków). + +W dodatku do podstawowych kolorów, możesz użyć numer koloru pomiędzy 1 a limitem +twojego terminala. + +Użyj komendy `/color`, aby zobaczyć obecne kolory i limity. Za pomocą kbd:[Alt+c] +możesz tymczasowo przełączyć się na kolory terminala, żeby wybrać kolor. + +Na przykład jeśli chcesz wyświetlać czas na pomarańczowo w buforze: + +---- +/set weechat.color.chat_time 214 +---- + +Lub jeśli chcesz mocno ciemno zielonego tła dla pasku statusu: + +---- +/set weechat.bar.status.color_bg 22 +---- + +[[colors_aliases]] +==== Aliasy + +Możesz dodać aliasy do kolorów za pomocą komendy `/color alias` i używać ich w +dowolnej opcji jako koloru. + +Na przykład: + +---- +/color alias 214 orange +/set weechat.color.chat_delimiters orange +---- + +[[colors_attributes]] +==== Atrybuty + +Możliwe jest użycie niektórych atrybutów dla kolorów. Jeden lub więcej z nich +może zostać użyty przed nazwą lub numerem koloru: + +* `+*+` : pogrubiony tekst +* `+!+` : odwrócenie video +* `+/+` : pochyły +* `+_+` : podkreślony tekst +* `+|+` : zachowaj atrybuty: nie resetuj pogrubienia/odwrócenia/pochylenia/podkreślenia, + podczas zmiany koloru + +Na przykład jeśli chcesz, żeby twój nick był biały i podkreślony: + +---- +/set weechat.color.chat_nick_self _white +---- + +Lub jeśli chcesz, żeby czas w pasku statusu był pomarańczowy, podkreślony i +pogrubiony: + +---- +/set weechat.color.status_time *_214 +---- + +Aby użyć atrybutu z domyślnym kolorem terminala (-1), należy użyć numeru większego +od ostatniego koloru terminala, na przykład maksymalny kolor w WeeChat: 99999. + +Przykład pogrubienia z domyślnym kolorem terminala: + +---- +/set weechat.color.status_time *99999 +---- + [[buffers_and_windows]] === Bufory i okna @@ -1537,227 +1758,6 @@ przycisku myszy. Możesz znaleźć nazwę zdarzenia za pomocą komendy `/input grab_mouse` wykonując następnie zdarzenie za pomocą myszy. Umieści to zdarzenie w linii poleceń. -[[command_line]] -=== Linia poleceń - -Linia poleceń WeeChat (na dole okna) pozwala na wykonywanie komend lub wysłanie -tekstu do bufora. - -[[command_line_syntax]] -==== Składnia - -Komendy zaczynają się od znaku "/", następnie wpisujemy komendę. Na przykład, -aby zobaczyć listę wszystkich opcji: - ----- -/set ----- - -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: - ----- -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: - ----- -//set ----- - -[[command_line_colors]] -==== Kody kolorów - -Dla niektórych wtyczek jak IRC, można użyć kolorów i atrybutów w następujący sposób -(wciśnij kbd:[Ctrl+c] następnie literę z opcjonalną wartością): - -[width="60%",cols="3,5",options="header"] -|=== -| Klawisz | Opis -| kbd:[Ctrl+c], kbd:[b] | pogrubiony tekst -| kbd:[Ctrl+c], kbd:[c], - kbd:[xx] | kolor tekstu `xx` (zgodnie z poniższą listą kolorów) -| kbd:[Ctrl+c], kbd:[c], - kbd:[xx], kbd:[,], - kbd:[yy] | kolor tekstu `xx` i tła `yy` (zgodnie z poniższą listą kolorów) -| kbd:[Ctrl+c], kbd:[i] | pochyły tekst -| kbd:[Ctrl+c], kbd:[o] | wyłącza kolory i atrybuty -| kbd:[Ctrl+c], kbd:[v] | odwróć video (przywraca kolor tekstu i tła) -| kbd:[Ctrl+c], kbd:[_] | podkreślony tekst -|=== - -[NOTE] -Ten sam sktót (bez numeru dla kbd:[Ctrl+c], kbd:[c]) może zostać użyty do zatrzymania -atrybutu. - -Kody kolorów dla kbd:[Ctrl+c], kbd:[c]: - -include::autogen/user/irc_colors.adoc[] - -[NOTE] -W celu wyświetlenia wszystkich dostępnych kolorów dla terminala możesz wykonać -komendę `/color` następnie kbd:[Alt+c] (w WeeChat) lub wywołać w terminalu: -`weechat --colors`. - -Przykład: wyświetlenie "hello everybody!" z pogrubionym jasno niebieskim "hello" -i podkreślonym jasno czerwonym "everybody": - ----- -^Cc12^Cbhello ^Cb^Cc04^C_everybody^C_^Cc! ----- - -[NOTE] -We wtyczce irc, można zmienić przypisania tych kolorów za pomocą opcji -<<option_irc.color.mirc_remap,irc.color.mirc_remap>>. - -[[colors]] -=== Kolory - -WeeChat może użyć do 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 -limity dla kolorów w WeeChat: - -[width="50%",cols="8,>2,>2",options="header"] -|=== -| $TERM | Kolory | Pary -| "rxvt-unicode", "xterm", ... | 88 | 256 -| "rxvt-256color", "xterm-256color", ... | 256 | 256 -| "screen" | 8 | 64 -| "screen-256color" | 256 | 256 -| "tmux" | 8 | 64 -| "tmux-256color" | 256 | 256 -|=== - -Możesz wykonać `weechat --colors` lub użyć komendy `/color` w WeeChat, aby -wyświetlić limity dla twojego środowiska. - -Niektóre z zalecanych wartości dla _TERM_ jeśli chcesz używać 256 kolorów: - -* dla screena: _screen-256color_ -* pod tmux: _screen-256color_ lub _tmux-256color_ -* poza screenem/tmuxem: _xterm-256color_, _rxvt-256color_, _putty-256color_, ... - -[NOTE] -Być może konieczne jest zainstalowanie pakietu "ncurses-term", w celu użycia -tych wartości dla zmiennej _TERM_. - -Jeśli używasz screena, możesz dodać to do swojego _~/.screenrc_: - ----- -term screen-256color ----- - -Jeśli wartość zmiennej _TERM_ ma złą wartość, a WeeChat jest już uruchomiony, -możesz ją zmienić za pomocą tych dwóch komend: - ----- -/set env TERM screen-256color -/upgrade ----- - -[[colors_basic]] -==== Podstawowe kolory - -Podstawowe kolory w WeeChat to: - -[width="50%",cols="^3m,8",options="header"] -|=== -| Nazwa | Kolor -| default | Domyślny kolor terminala (przezroczysty dla tła) -| black | Czarny -| darkgray | Ciemny szary -| red | Ciemny czerwony -| lightred | Jasny czerwony -| green | Ciemny zielony -| lightgreen | Jasny zielony -| brown | Brązowy -| yellow | Żółty -| blue | Ciemny niebieski -| lightblue | Jasny niebieski -| magenta | Ciemny karmazynowy -| lightmagenta | Jasny karmazynowy -| cyan | Ciemny błękitny -| lightcyan | Jasny błękitny -| gray | Szary -| white | Biały -|=== - -[[colors_extended]] -==== Rozszerzone kolory - -Weechat dynamicznie alokuje pary kolorów, kiedy kolory są używane na ekranie (do -wyświetlania buforów i pasków). - -W dodatku do podstawowych kolorów, możesz użyć numer koloru pomiędzy 1 a limitem -twojego terminala. - -Użyj komendy `/color`, aby zobaczyć obecne kolory i limity. Za pomocą kbd:[Alt+c] -możesz tymczasowo przełączyć się na kolory terminala, żeby wybrać kolor. - -Na przykład jeśli chcesz wyświetlać czas na pomarańczowo w buforze: - ----- -/set weechat.color.chat_time 214 ----- - -Lub jeśli chcesz mocno ciemno zielonego tła dla pasku statusu: - ----- -/set weechat.bar.status.color_bg 22 ----- - -[[colors_aliases]] -==== Aliasy - -Możesz dodać aliasy do kolorów za pomocą komendy `/color alias` i używać ich w -dowolnej opcji jako koloru. - -Na przykład: - ----- -/color alias 214 orange -/set weechat.color.chat_delimiters orange ----- - -[[colors_attributes]] -==== Atrybuty - -Możliwe jest użycie niektórych atrybutów dla kolorów. Jeden lub więcej z nich -może zostać użyty przed nazwą lub numerem koloru: - -* `+*+` : pogrubiony tekst -* `+!+` : odwrócenie video -* `+/+` : pochyły -* `+_+` : podkreślony tekst -* `+|+` : zachowaj atrybuty: nie resetuj pogrubienia/odwrócenia/pochylenia/podkreślenia, - podczas zmiany koloru - -Na przykład jeśli chcesz, żeby twój nick był biały i podkreślony: - ----- -/set weechat.color.chat_nick_self _white ----- - -Lub jeśli chcesz, żeby czas w pasku statusu był pomarańczowy, podkreślony i -pogrubiony: - ----- -/set weechat.color.status_time *_214 ----- - -Aby użyć atrybutu z domyślnym kolorem terminala (-1), należy użyć numeru większego -od ostatniego koloru terminala, na przykład maksymalny kolor w WeeChat: 99999. - -Przykład pogrubienia z domyślnym kolorem terminala: - ----- -/set weechat.color.status_time *99999 ----- - [[secured_data]] === Zabezpieczone dane |