1
0
mirror of https://github.com/weechat/weechat.git synced 2026-06-12 22:24:47 +02:00

Compare commits

..

9 Commits

Author SHA1 Message Date
Sébastien Helleu 8b5da3c6cb core: add CVE id in ChangeLog 2021-09-07 20:33:44 +02:00
Sébastien Helleu e852cef92a core: force version 18.04 of Ubuntu in CI 2021-09-04 23:14:48 +02:00
Sébastien Helleu 84e44632e5 relay: fix crash when decoding a malformed websocket frame 2021-09-04 23:09:19 +02:00
Sébastien Helleu 77bbd5f875 Version 3.0.2-dev 2021-09-04 23:06:58 +02:00
Sébastien Helleu 93f5371cf8 Version 3.0.1 2021-01-31 10:07:53 +01:00
Sébastien Helleu 9db6255a84 Revert "exec: return NULL immediately if the task id is invalid"
This reverts commit dff1bf6f0f.

(cherry picked from commit 08ebc99dea)
2020-12-06 13:42:30 +01:00
Sébastien Helleu 03d36f13af spell: fix refresh of bar item "spell_suggest" when the input becomes empty (issue #1586)
When the input is empty, length of string is zero: when sending zero to
function weechat_string_dyn_alloc, the function returns NULL and therefore we
return immediately instead of handling the empty input, which is a valid value.

The regression was introduced by the use of dynamic strings, commit:
299f74bfef

(cherry picked from commit eb90a73fe8)
2020-11-20 22:21:59 +01:00
Sébastien Helleu b1fe88d5d4 spell: fix crash with IRC color codes in command line (issue #1589)
(cherry picked from commit ee24fac586)
2020-11-20 22:14:22 +01:00
Sébastien Helleu dcccfa2255 Version 3.0.1-dev 2020-11-20 22:14:12 +01:00
701 changed files with 16736 additions and 28580 deletions
-1
View File
@@ -1 +0,0 @@
blank_issues_enabled: false
+8 -13
View File
@@ -1,21 +1,18 @@
name: CI
on:
- push
- pull_request
on: [push, pull_request]
jobs:
build:
name: ${{ matrix.config.name }}
runs-on: ubuntu-20.04
runs-on: ubuntu-18.04
strategy:
fail-fast: false
matrix:
config:
- { name: "cmake_gcc", cc: "gcc", cxx: "g++", tool: "cmake", args: "" }
- { name: "cmake_gcc_no_nls", cc: "gcc", cxx: "g++", tool: "cmake", args: "-DENABLE_NLS=OFF" }
- { name: "cmake_gcc_py2", cc: "gcc", cxx: "g++", tool: "cmake", args: "-DENABLE_PYTHON2=ON" }
- { name: "cmake_gcc_coverage", cc: "gcc", cxx: "g++", tool: "cmake", args: "-DENABLE_CODE_COVERAGE=ON" }
- { name: "cmake_clang", cc: "clang", cxx: "clang++", tool: "cmake", args: "" }
@@ -28,10 +25,9 @@ jobs:
- name: Install dependencies
run: |
sudo apt-add-repository --yes ppa:ondrej/php
sudo apt-get update -qq
sudo apt-get --yes --no-install-recommends install devscripts equivs python3-pip libenchant-dev autopoint cmake lcov pkg-config libncursesw5-dev gem2deb libperl-dev python2-dev python3-dev libaspell-dev liblua5.3-dev tcl8.6-dev guile-2.0-dev libv8-dev libcurl4-gnutls-dev libgcrypt20-dev libgnutls28-dev zlib1g-dev curl libcpputest-dev php7.4-dev libphp7.4-embed libargon2-0-dev libsodium-dev pylint asciidoctor
sudo -H pip3 install --ignore-installed msgcheck
sudo apt-get --yes --no-install-recommends install devscripts equivs python-pip libenchant-dev autopoint cmake lcov pkg-config libncursesw5-dev gem2deb libperl-dev python-dev python3-dev libaspell-dev liblua5.3-dev tcl8.6-dev guile-2.0-dev libv8-dev libcurl4-gnutls-dev libgcrypt20-dev libgnutls28-dev zlib1g-dev curl libcpputest-dev php7.4-dev libphp7.4-embed libargon2-0-dev libsodium-dev pylint3 asciidoctor
sudo -H pip install --ignore-installed msgcheck
- name: Test patches
run: ./tools/build-debian.sh test-patches
@@ -41,11 +37,10 @@ jobs:
- name: Check Python scripts
run: |
pylint --additional-builtins=_ doc/docgen.py
pylint doc/python_stub.py
pylint tests/scripts/python/testapigen.py
pylint tests/scripts/python/testapi.py
pylint tests/scripts/python/unparse.py
pylint3 --additional-builtins=_ doc/docgen.py
pylint3 tests/scripts/python/testapigen.py
pylint3 tests/scripts/python/testapi.py
pylint3 tests/scripts/python/unparse.py
- name: Build and run tests
env:
-5
View File
@@ -37,15 +37,12 @@ Alphabetically:
* Dmitry Kobylin
* Dominik Honnef
* Dominique Martinet
* dotflac
* Eduardo Elias
* Eli Schwartz
* Elizabeth Myers (Elizacat)
* Elián Hanisch (m4v)
* Emanuele Giaquinta
* Emir Sarı
* emk
* Érico Nogueira
* Esteban I. Ruiz Moreno (Exio)
* Evgeny Shmarnev
* Felix Eckhofer
@@ -58,7 +55,6 @@ Alphabetically:
* Hasan Kiran (turgay)
* Ivan Sichmann Freitas
* Jakub Jirutka
* Jan Palus
* Jason A. Donenfeld (zx2c4)
* JD Horelick (jdhore)
* jesopo
@@ -87,7 +83,6 @@ Alphabetically:
* Matt Robinson
* Matthew Horan
* Matthew Martin
* Matti Virkkunen
* Max Anton Teufel
* Maxim Baz
* Michael Siegel
+14 -3
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2007-2008 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2008-2009 Emmanuel Bouthenot <kolter@openics.org>
#
@@ -134,11 +134,23 @@ if(ENABLE_TESTS AND NOT ENABLE_HEADLESS)
endif()
# option WEECHAT_HOME
if(NOT DEFINED WEECHAT_HOME OR "${WEECHAT_HOME}" STREQUAL "")
set(WEECHAT_HOME "~/.weechat")
endif()
set(WEECHAT_HOME "${WEECHAT_HOME}" CACHE
STRING "Force a single WeeChat home directory for config, logs, scripts, etc."
STRING "WeeChat home directory for config, logs, scripts.. (default is \"~/.weechat\")"
FORCE)
mark_as_advanced(CLEAR WEECHAT_HOME)
# option CA_FILE
if(NOT DEFINED CA_FILE OR "${CA_FILE}" STREQUAL "")
set(CA_FILE "/etc/ssl/certs/ca-certificates.crt")
endif()
set(CA_FILE "${CA_FILE}" CACHE
STRING "File containing the certificate authorities (default is \"/etc/ssl/certs/ca-certificates.crt\"). This is the default value of option \"weechat.network.gnutls_ca_file\"."
FORCE)
mark_as_advanced(CLEAR CA_FILE)
if(COMMAND cmake_policy)
if(POLICY CMP0003)
cmake_policy(SET CMP0003 NEW)
@@ -158,7 +170,6 @@ check_include_files("langinfo.h" HAVE_LANGINFO_CODESET)
check_include_files("sys/resource.h" HAVE_SYS_RESOURCE_H)
check_function_exists(mallinfo HAVE_MALLINFO)
check_function_exists(mallinfo2 HAVE_MALLINFO2)
check_symbol_exists("eat_newline_glitch" "term.h" HAVE_EAT_NEWLINE_GLITCH)
+7 -88
View File
@@ -15,93 +15,12 @@ https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes]
(file _ReleaseNotes.adoc_ in sources).
[[v3.2]]
== Version 3.2 (2021-06-13)
New features::
* core: use XDG directories by default (config, data, cache, runtime) (issue #1285)
* core: add option weechat.network.gnutls_ca_system, rename option weechat.network.gnutls_ca_file to weechat.network.gnutls_ca_user (now evaluated), delete and reload certificates when options are changed (issue #972)
* core: evaluate option weechat.plugin.path, change default value to "${weechat_data_dir}/plugins"
* core: add options to customize commands executed on system signals received (SIGHUP, SIGQUIT, SIGTERM, SIGUSR1, SIGUSR2) (issue #1595)
* core: quit WeeChat by default when signal SIGHUP is received in normal run, reload configuration in weechat-headless (issue #1595)
* core: add signals "cursor_start" and "cursor_end"
* api: add function crypto_hmac (issue #1628)
* api: add translated string in evaluation of expressions with "translate:xxx"
* api: add evaluation of WeeChat directories with "${weechat_xxx_dir}" in evaluated strings
* api: add optional key "directory" in hashtable options of function/modifier string_eval_path_home
* api: add supported prefixes "${weechat_xxx_dir}" in function mkdir_home
* api: add infos "weechat_config_dir", "weechat_data_dir", "weechat_cache_dir" and "weechat_runtime_dir"
* api: add support of pointer names in function string_eval_expression (direct and in hdata)
* api: add info "weechat_daemon"
* buflist: add option buflist.format.tls_version
* fifo: change default value of option fifo.file.path to "${weechat_runtime_dir}/weechat_fifo_${info:pid}"
* irc: add support of SASL mechanisms SCRAM-SHA-1, SCRAM-SHA-256 and SCRAM-SHA-512 (issue #1628)
* irc: add variable "${target}" (target nick) in commands /kick and /kickban
* irc: add bar item "tls_version", add options irc.color.item_tls_version_ok, irc.color.item_tls_version_deprecated and irc.color.item_tls_version_insecure (issue #1622)
* irc: evaluate server options "sasl_key" and "ssl_cert"
* logger: change default value of option logger.file.path to "${weechat_data_dir}/logs"
* python: add stub for WeeChat API (issue #1377)
* relay: evaluate option relay.network.ssl_cert_key, change default value to "${weechat_config_dir}/ssl/relay.pem"
* script: change default value of option script.scripts.path to "${weechat_cache_dir}/script"
* trigger: add variables "${tg_shell_argc}" and "${tg_shell_argvN}" in command trigger evaluated strings (issue #1624)
* xfer: change default value of option xfer.file.download_path to "${weechat_data_dir}/xfer"
[[v3.0.2]]
== Version 3.0.2 (under dev)
Bug fixes::
* core: split startup commands before evaluating them (issue #1643)
* core: set server name when connecting to server with TLS (SNI extension) only if it's not an IPV4/IPv6 (issue #1635)
* core: use function mallinfo2 instead of mallinfo when available (issue #1636)
* core: display a warning when the file with certificate authorities is not found (option weechat.network.gnutls_ca_file)
* core: evaluate left/right part of comparison after split on the comparison operator in ${if:xxx} (issue #1627)
* core: prevent switching to start of visited buffers when jumping to next (issue #1591, issue #1592)
* core: recreate buflist and fset bars on /reload when WeeChat is started without configuration files (issue #1618)
* buflist: fix comparison of hotlists in option buflist.look.sort (issue #1621)
* irc: split server command before evaluating it (issue #1643)
* xfer: make file transfer fail when option xfer.file.auto_rename is off and file already exists (issue #1633)
Tests::
* core: switch from Ubuntu 18.04 to 20.04 in CI
* trigger: add tests on main trigger functions
Build::
* core: remove build option CA_FILE
* core: set WeeChat home to empty string by default in CMake and autotools
[[v3.1]]
== Version 3.1 (2021-03-07)
New features::
* core: add options weechat.look.hotlist_update_on_buffer_switch and weechat.look.read_marker_update_on_buffer_switch (issue #992, issue #993)
* core: add option sec.crypt.passphrase_command to read passphrase from an external program on startup, remove option sec.crypt.passphrase_file (issue #141)
* core: improve debug in command /eval: display more verbose debug with two "-d", add indentation and colors
* core: add options "setvar" and "delvar" in command /buffer, rename option "localvar" to "listvar"
* core: add buffer local variable "completion_default_template" (evaluated) to override the value of option "weechat.completion.default_template" (issue #1600)
* core: add option "recreate" in command /filter
* core: add raw string in evaluation of expressions with "raw:xxx" (issue #1611)
* core: add evaluation of conditions in evaluation of expressions with "eval_cond:xxx" (issue #1582)
* api: add info_hashtable "secured_data"
* irc: add info "irc_is_message_ignored"
* irc: add server option "default_chantypes", used when the server does not send them in message 005 (issue #1610)
* trigger: add variable "${tg_trigger_name}" in command trigger evaluated strings (issue #1580)
Bug fixes::
* core: fix quoted line in cursor mode (issue #1602)
* core: fix wrong size of the new window after vertical split (issue #1612)
* core: do not remove quotes in arguments of command /eval as they can be part of the evaluated expression/condition (issue #1601)
* core: display an error when the buffer is not found with command /command -buffer
* buflist: add option buflist.look.use_items to speed up display of buflist (issue #1613)
* irc: add bar item "irc_nick_prefix"
* irc: fix separator between nick and host in bar item "irc_nick_host"
* irc: fix completion of commands /halfop and /dehalfop
Documentation::
* do not build weechat-headless man page if headless binary is disabled (issue #1607)
* relay: fix crash when decoding a malformed websocket frame (CVE-2021-40516)
[[v3.0.1]]
== Version 3.0.1 (2021-01-31)
@@ -248,7 +167,7 @@ New features::
* buflist: add pointer "window" in bar item evaluation
* irc: add support of fake servers (no I/O, for testing purposes)
* relay: accept hash of password in init command of weechat protocol with option "password_hash" (PBKDF2, SHA256, SHA512)
* relay: reject client with weechat protocol if password or TOTP is received in init command but not set in WeeChat (issue #1435)
* relay: reject client with weechat protocol if password or totp is received in init command but not set in WeeChat (issue #1435)
Bug fixes::
@@ -299,7 +218,7 @@ New features::
* core: add option weechat.look.nick_color_hash_salt to shuffle nick colors (issue #635)
* core: add different icons sizes (16x16 to 512x512) (issue #1347)
* core: add file weechat.desktop
* core: add reverse of string for screen in evaluation of expressions with "revscr:xxx"
* core: add reverse of string for screen in evaluation of expressions with "revscr:"
* core: add length of string (number of chars and on screen) in evaluation of expressions with "length:xxx" and "lengthscr:xxx"
* core: add calculation of expression in evaluation of expressions with "calc:xxx" (issue #997)
* core: add optional default path (evaluated) in completion "filename"
@@ -534,7 +453,7 @@ Build::
New features::
* core: change default value of option weechat.look.hotlist_add_conditions to check connected relay clients via weechat protocol (issue #1206)
* core: add reverse of string in evaluation of expressions with "rev:xxx" (issue #1200)
* core: add reverse of string in evaluation of expressions with "rev:" (issue #1200)
* core: send buffer pointer (when possible) in signal "hotlist_changed" (issue #1133)
* core: add support of list options in curl (issue #826, issue #219)
* core: allow merge of buffers by name in command /buffer (issue #1108, issue #1159)
@@ -729,7 +648,7 @@ New features::
* core: add option weechat.completion.nick_case_sensitive (issue #981)
* core: add wildcard matching operator (`+=*+` and `+!*+`) in evaluation of expressions (issue #611)
* core: add cut of string in evaluation of expressions with "cut:xxx" (number of chars) and "cutscr:xxx" (number of chars displayed on screen)
* core: add cut of string in evaluation of expressions with "cut:" (number of chars) and "cutscr:" (number of chars displayed on screen)
* core: add ternary operator (condition) in evaluation of expressions (`${if:condition?value_if_true:value_if_false}`)
* core: add resize of window parents with /window resize [h/v]size (task #11461, issue #893)
* core: add hotlist pointer in buffer structure
+1 -1
View File
@@ -82,7 +82,7 @@ https://github.com/weechat/weechat/milestones[milestones] on GitHub.
Pull requests on GitHub are welcome for minor new features.
For major new features, it's better to discuss about it in IRC
(server: _irc.libera.chat_, channel _#weechat_).
(server: _chat.freenode.net_, channel _#weechat_).
Before submitting any pull request, be sure you have read the
https://weechat.org/files/doc/devel/weechat_dev.en.html#coding_rules[coding rules]
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2005 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2006-2009 Emmanuel Bouthenot <kolter@openics.org>
#
+1 -1
View File
@@ -114,7 +114,7 @@ $ ctest -V
== Copyright
Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
This file is part of WeeChat, the extensible chat client.
+7 -231
View File
@@ -17,230 +17,6 @@ https://weechat.org/files/changelog/ChangeLog-devel.html[ChangeLog]
(file _ChangeLog.adoc_ in sources).
[[v3.2]]
== Version 3.2 (2021-06-13)
[[v3.2_xdg_directories]]
=== XDG directories
Support of XDG directories has been added. For compatibility, if the directory
_~/.weechat_ exists, WeeChat will still use it for all files.
If you want to switch to XDG directories, you must create and move manually
all files in the appropriate directories. +
See https://specs.weechat.org/specs/001285-follow-xdg-base-dir-spec.html#weechat-home[WeeChat XDG specification]
for more information.
Some options have new default value: `%h` is replaced by `${weechat_xxx_dir}`. +
If you didn't change the value, it is recommended to set the new default value,
by doing `/unset <option>` on each option:
[width="100%",cols="2m,2m,5m",options="header"]
|===
| Option | Old default value | New default value
| fifo.file.path | %h/weechat_fifo | ${weechat_runtime_dir}/weechat_fifo_${info:pid}
| logger.file.path | %h/logs/ | ${weechat_data_dir}/logs
| relay.network.ssl_cert_key | %h/ssl/relay.pem | ${weechat_config_dir}/ssl/relay.pem
| script.scripts.path | %h/script | ${weechat_cache_dir}/script
| weechat.plugin.path | %h/plugins | ${weechat_data_dir}/plugins
| xfer.file.download_path | %h/xfer | ${weechat_data_dir}/xfer
|===
The following scripts are updated to take care of XDG directories, be sure
they are all up-to-date, otherwise files may be saved in wrong directories or
the script may not find some files:
* https://weechat.org/scripts/source/autoconf.py/[autoconf.py] 0.4
* https://weechat.org/scripts/source/axolotl.py/[axolotl.py] 0.1.1
* https://weechat.org/scripts/source/beinc.py/[beinc.py] 4.2
* https://weechat.org/scripts/source/buddylist.pl/[buddylist.pl] 2.1
* https://weechat.org/scripts/source/bufsave.py/[bufsave.py] 0.5
* https://weechat.org/scripts/source/chanop.py/[chanop.py] 0.3.4
* https://weechat.org/scripts/source/chanstat.py/[chanstat.py] 0.2
* https://weechat.org/scripts/source/colorize_lines.pl/[colorize_lines.pl] 4.0
* https://weechat.org/scripts/source/confversion.py/[confversion.py] 0.4
* https://weechat.org/scripts/source/country.py/[country.py] 0.6.2
* https://weechat.org/scripts/source/cron.py/[cron.py] 0.5
* https://weechat.org/scripts/source/crypt.py/[crypt.py] 1.4.5
* https://weechat.org/scripts/source/grep.py/[grep.py] 0.8.5
* https://weechat.org/scripts/source/growl.py/[growl.py] 1.0.7
* https://weechat.org/scripts/source/histman.py/[histman.py] 0.8.2
* https://weechat.org/scripts/source/hl2file.py/[hl2file.py] 0.3
* https://weechat.org/scripts/source/hotlist2extern.pl/[hotlist2extern.pl] 1.0
* https://weechat.org/scripts/source/jnotify.pl/[jnotify.pl] 1.2
* https://weechat.org/scripts/source/latex_unicode.py/[latex_unicode.py] 1.2
* https://weechat.org/scripts/source/luanma.pl/[luanma.pl] 0.3
* https://weechat.org/scripts/source/otr.py/[otr.py] 1.9.3
* https://weechat.org/scripts/source/pop3_mail.pl/[pop3_mail.pl] 0.4
* https://weechat.org/scripts/source/purgelogs.py/[purgelogs.py] 0.5
* https://weechat.org/scripts/source/query_blocker.pl/[query_blocker.pl] 1.3
* https://weechat.org/scripts/source/queryman.py/[queryman.py] 0.6
* https://weechat.org/scripts/source/queue.py/[queue.py] 0.4.3
* https://weechat.org/scripts/source/rslap.pl/[rslap.pl] 1.4
* https://weechat.org/scripts/source/rssagg.pl/[rssagg.pl] 1.3
* https://weechat.org/scripts/source/slack.py/[slack.py] 2.8.0
* https://weechat.org/scripts/source/stalker.pl/[stalker.pl] 1.6.2
* https://weechat.org/scripts/source/substitution.rb/[substitution.rb] 0.0.2
* https://weechat.org/scripts/source/triggerreply.py/[triggerreply.py] 0.4.3
* https://weechat.org/scripts/source/update_notifier.py/[update_notifier.py] 0.6
* https://weechat.org/scripts/source/url_olde.py/[url_olde.py] 0.8
* https://weechat.org/scripts/source/urlserver.py/[urlserver.py] 2.6
* https://weechat.org/scripts/source/weetext.py/[weetext.py] 0.1.3
* https://weechat.org/scripts/source/zncplayback.py/[zncplayback.py] 0.2.1
To check if XDG directories are used, you can run command `/debug dirs`, which
should show different directories for config/data/cache/runtime, like this:
----
Directories:
home:
config: /home/user/.config/weechat
data: /home/user/.local/share/weechat
cache: /home/user/.cache/weechat
runtime: /run/user/1000/weechat
lib: /usr/lib/x86_64-linux-gnu/weechat
lib (extra): -
share: /usr/share/weechat
locale: /usr/share/locale
----
With the legacy _~/.weechat_ directory, the output would be:
----
Directories:
home:
config: /home/user/.weechat
data: /home/user/.weechat
cache: /home/user/.weechat
runtime: /home/user/.weechat
lib: /usr/lib/x86_64-linux-gnu/weechat
lib (extra): -
share: /usr/share/weechat
locale: /usr/share/locale
----
[[v3.2_gnutls_ca]]
=== GnuTLS certificate authorities
A new option has been added to load system's default trusted certificate
authorities on startup: _weechat.network.gnutls_ca_system_ (boolean, enabled
by default).
The option _weechat.network.gnutls_ca_file_ has been renamed to
_weechat.network.gnutls_ca_user_ and is now used for extra certificates
(not the system ones). +
This option now supports multiple files, separated by colons.
If you have set a user CA file in option _weechat.network.gnutls_ca_file_,
then you must set this same value in the new option
_weechat.network.gnutls_ca_user_.
When one of these options are changed, all certificates are purged and reloaded
from files.
[[v3.2_split_commands_before_eval]]
=== Split of commands before evaluation
The split of commands is now performed before the evaluation of string, in the
following cases:
* IRC server option _irc.server_default.command_ or _irc.server.xxx.command_
* startup option with command line parameter `-r` / `--run-command`
* options _weechat.startup.command_before_plugins_ and _weechat.startup.command_after_plugins_.
If ever you used here multiple commands that are found by evaluation, then
you must use multiple commands directly.
For example if you did this:
----
/secure set commands "/command1 secret1;/command2 secret2"
/set irc.server.libera.command "${sec.data.commands}"
----
This will now execute a single command: `/command1` with two parameters:
`secret1;/command2` and `secret2`, which is not what you expect.
So you must now do this instead:
----
/secure set command1 "/command1 secret1"
/secure set command2 "/command2 secret2"
/set irc.server.libera.command "${sec.data.command1};${sec.data.command2}"
----
You could also do this, but be careful, there are two evaluations of strings
(the secured data itself is evaluated as well):
----
/secure set commands "/command1 secret1;/command2 secret2"
/set irc.server.libera.command "/eval -s ${sec.data.commands}"
----
[[v3.1]]
== Version 3.1 (2021-03-07)
[[v3.1_secure_data_passphrase_command]]
=== External program to read secured data passphrase
A new option `sec.crypt.passphrase_command` has been added to read the passphrase
from the output of an external program (like a password manager).
The option `sec.crypt.passphrase_file` has been removed, because the command
can now read a file as well. If you used a file to read the passphrase, you
must now setup the command like this:
----
/set sec.crypt.passphrase_command "cat ~/.weechat-passphrase"
----
For security reasons, it is of course highly recommended to use a password manager
or a program to decrypt a file with your passphrase rather than using a file with
the clear password. +
For example with password-store (command `pass`):
----
/set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"
----
[[v3.1_window_splitv]]
=== Vertical split of windows
The vertical split of windows has been fixed (see issue #1612): now the new
window has the asked size, instead of the original window.
For example with this command the new window (on the right) has size 80% instead
of 20% in previous releases:
----
/window splitv 80
----
[[v3.1_command_buffer_listvar]]
=== List of buffer local variables
The command `/buffer localvar` has been renamed to `/buffer listvar`.
The option `localvar` is still supported to stay compatible with scripts
calling it or referencing it in the documentation. +
It is deprecated and will be removed in a future release.
New options `setvar` and `delvar` were also added in command `/buffer`,
see `/help buffer`.
[[v3.1_buflist_option_use_items]]
=== Buflist option buflist.look.use_items
A new buflist option `buflist.look.use_items` has been added to speed up
display of buflist, in case you use a single buflist item (the most common use case).
If ever you use more than one item (item "buflist2" or even "buflist3"), you
must adjust the value of the new option, which defaults to 1:
----
/set buflist.look.use_items 2
----
[[v3.0.1]]
== Version 3.0.1 (2021-01-31)
@@ -362,7 +138,7 @@ using this modifier and the "modifier_data" argument must be updated.
The old format contained plugin name + ";" + buffer name + ";" + tags:
----
irc;libera.#weechat;tag1,tag2,tag3
irc;freenode.#weechat;tag1,tag2,tag3
----
The new format contains buffer pointer + ";" + tags:
@@ -374,7 +150,7 @@ The new format contains buffer pointer + ";" + tags:
The following scripts are updated consequently to be compatible with all
WeeChat versions:
* https://weechat.org/scripts/source/colorize_lines.pl/[colorize_lines.pl] 3.9
* https://weechat.org/scripts/source/colorize_lines.pl.html/[colorize_lines.pl] 3.9
* https://weechat.org/scripts/source/colorize_nicks.py/[colorize_nicks.py] 27
* https://weechat.org/scripts/source/colorizer.rb/[colorizer.rb] 0.2
* https://weechat.org/scripts/source/curiousignore.pl/[curiousignore.pl] 0.4
@@ -438,8 +214,8 @@ For example you can do that:
----
/secure passphrase my_secret_passphrase
/secure set libera my_password
/set irc.server.libera.sasl_password "${sec.data.libera}"
/secure set freenode my_password
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
----
This will be displayed like that in WeeChat, using the new regex value of
@@ -447,8 +223,8 @@ _cmd_pass_ trigger:
----
/secure passphrase ********************
/secure set libera ***********
/set irc.server.libera.sasl_password "${sec.data.libera}"
/secure set freenode ***********
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
----
If you want to use the new trigger regex after upgrade, you can do:
@@ -1260,7 +1036,7 @@ Globally (default value for all servers):
For a specific server:
----
/set irc.server.libera.nicks_alternate off
/set irc.server.freenode.nicks_alternate off
----
[[v1.3]]
+1 -1
View File
@@ -1,6 +1,6 @@
#!/bin/sh
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2005 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2005-2006 Emmanuel Bouthenot <kolter@openics.org>
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2014-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2014-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2007 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
#
# This file is part of WeeChat, the extensible chat client.
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2011-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2011-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,6 +1,6 @@
#
# Copyright (C) 2017 Adam Saponara <as@php.net>
# Copyright (C) 2017-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2017-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2009 Julien Louis <ptitlouis@sysif.net>
#
# This file is part of WeeChat, the extensible chat client.
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2015-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2015-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -5,7 +5,6 @@
#cmakedefine HAVE_BACKTRACE
#cmakedefine ICONV_2ARG_IS_CONST 1
#cmakedefine HAVE_MALLINFO
#cmakedefine HAVE_MALLINFO2
#cmakedefine HAVE_EAT_NEWLINE_GLITCH
#cmakedefine HAVE_ASPELL_VERSION_STRING
#cmakedefine HAVE_ENCHANT_GET_VERSION
@@ -18,4 +17,5 @@
#define WEECHAT_SHAREDIR "@WEECHAT_SHAREDIR@"
#define LOCALEDIR "@LOCALEDIR@"
#define WEECHAT_HOME "@WEECHAT_HOME@"
#define CA_FILE "@CA_FILE@"
#define _GNU_SOURCE 1
+16 -8
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2005 Benoit Papillault <benoit.papillault@free.fr>
# Copyright (C) 2005-2006 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2005-2009 Emmanuel Bouthenot <kolter@openics.org>
@@ -98,7 +98,6 @@ AC_MSG_RESULT($ac_cv_type_socklen_t)
AC_FUNC_SELECT_ARGTYPES
AC_TYPE_SIGNAL
AC_CHECK_FUNCS([mallinfo])
AC_CHECK_FUNCS([mallinfo2])
# Variables in config.h
@@ -134,7 +133,8 @@ AH_VERBATIM([PLUGIN_XFER], [#undef PLUGIN_XFER])
AH_VERBATIM([TESTS], [#undef TESTS])
AH_VERBATIM([MAN], [#undef MAN])
AH_VERBATIM([DOC], [#undef DOC])
AH_VERBATIM([WEECHAT_HOME], [#define WEECHAT_HOME ""])
AH_VERBATIM([WEECHAT_HOME], [#define WEECHAT_HOME "~/.weechat"])
AH_VERBATIM([CA_FILE], [#define CA_FILE "/etc/ssl/certs/ca-certificates.crt"])
# Arguments for ./configure
@@ -171,10 +171,19 @@ AC_ARG_ENABLE(tests, [ --enable-tests turn on build of tests (d
AC_ARG_ENABLE(man, [ --enable-man turn on build of man page (default=not built)],enable_man=$enableval,enable_man=no)
AC_ARG_ENABLE(doc, [ --enable-doc turn on build of documentation (default=not built)],enable_doc=$enableval,enable_doc=no)
AC_ARG_VAR(WEECHAT_HOME, [Force a single WeeChat home directory for config, logs, scripts, etc.])
AC_ARG_VAR(WEECHAT_HOME, [WeeChat home directory for config, logs, scripts.. (default is "~/.weechat")])
AC_ARG_VAR(CA_FILE, [File containing the certificate authorities (default is "/etc/ssl/certs/ca-certificates.crt"). This is the default value of option "weechat.network.gnutls_ca_file".])
if test "x$WEECHAT_HOME" = "x" ; then
WEECHAT_HOME="~/.weechat"
fi
AC_DEFINE_UNQUOTED(WEECHAT_HOME, "$WEECHAT_HOME")
if test "x$CA_FILE" = "x" ; then
CA_FILE="/etc/ssl/certs/ca-certificates.crt"
fi
AC_DEFINE_UNQUOTED(CA_FILE, "$CA_FILE")
not_asked=""
not_found=""
@@ -1538,6 +1547,7 @@ echo " Compile with debug..... : $msg_debug"
echo " Compile tests.......... : $msg_tests"
echo " Man page............... : $msg_man"
echo " Documentation.......... : $msg_doc"
echo " Certificate authorities : ${CA_FILE}"
if test "x$not_asked" != "x" || test "x$not_found" != "x"; then
echo ""
@@ -1551,10 +1561,8 @@ if test "x$not_asked" != "x" || test "x$not_found" != "x"; then
fi
echo ""
if test "x$WEECHAT_HOME" != "x" ; then
echo "WeeChat home directory is forced by default to: ${WEECHAT_HOME}"
echo ""
fi
echo "WeeChat home directory is ${WEECHAT_HOME}"
echo ""
eval echo "WeeChat will be installed in $bindir"
echo ""
echo "configure complete, now type 'make' to build WeeChat $VERSION"
+1 -1
View File
@@ -20,7 +20,7 @@ Build-Depends:
libgcrypt20-dev,
libgnutls28-dev,
zlib1g-dev
Standards-Version: 4.5.1
Standards-Version: 4.4.0
Homepage: https://weechat.org/
Vcs-Git: https://salsa.debian.org/kolter/weechat.git
Vcs-Browser: https://salsa.debian.org/kolter/weechat
-14
View File
@@ -1,17 +1,3 @@
weechat (3.0.1-1) unstable; urgency=medium
* New upstream release
* Bump Standards-Version to 4.5.1
-- Emmanuel Bouthenot <kolter@debian.org> Wed, 03 Mar 2021 05:30:44 +0000
weechat (3.0-1) unstable; urgency=medium
* New upstream release
* Build against Guile 3.0 (instead of 2.2) (Closes: #969680)
-- Emmanuel Bouthenot <kolter@debian.org> Sat, 21 Nov 2020 07:34:12 +0000
weechat (2.9-1) unstable; urgency=medium
* New upstream release
+1 -1
View File
@@ -20,7 +20,7 @@ Build-Depends:
libgcrypt20-dev,
libgnutls28-dev,
zlib1g-dev
Standards-Version: 4.5.1
Standards-Version: 4.4.0
Homepage: https://weechat.org/
Vcs-Git: https://salsa.debian.org/kolter/weechat.git
Vcs-Browser: https://salsa.debian.org/kolter/weechat
+1 -1
View File
@@ -4,7 +4,7 @@ Upstream-Contact: Sébastien Helleu <flashcode@flashtux.org>
Source: https://weechat.org/
Files: *
Copyright: 2003-2021, Sébastien Helleu <flashcode@flashtux.org>
Copyright: 2003-2020, Sébastien Helleu <flashcode@flashtux.org>
License: GPL-3+
Files: src/core/wee-command.c
+2 -2
View File
@@ -1,2 +1,2 @@
version=4
opts=pgpsigurlmangle=s/$/.asc/ https://weechat.org/download/ /files/src/weechat-(\d.*)\.tar\.xz
version=3
opts=pgpsigurlmangle=s/$/.asc/ https://weechat.org/files/src/weechat-(\d.*)\.tar\.bz2
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
#
# This file is part of WeeChat, the extensible chat client.
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2006 Julien Louis <ptitlouis@sysif.net>
#
# This file is part of WeeChat, the extensible chat client.
+14 -16
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
@@ -32,21 +32,19 @@ if(ENABLE_MAN)
add_custom_target(doc-man-weechat-cs ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/cs/man1)
if(ENABLE_HEADLESS)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.cs.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.cs.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.cs.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.cs.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (cs)"
)
add_custom_target(doc-man-weechat-headless-cs ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/cs/man1)
endif()
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.cs.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.cs.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.cs.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.cs.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (cs)"
)
add_custom_target(doc-man-weechat-headless-cs ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/cs/man1)
endif()
if(ENABLE_DOC)
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+4 -4
View File
@@ -16,11 +16,11 @@
(works only with the command *weechat-headless*, not compatible with option
"--daemon").
// TRANSLATION MISSING
*-d*, *--dir* _<path>_::
Force a single directory for all WeeChat files (directory is created if not found).
Four directories can be given, separated by colons (in this order: config,
data, cache, runtime).
Nastav cestu jako dovmský adresář pro WeeChat (použitou pro konfigurační
soubory, logy, uživatelské pluginy a skripty), výchozí hodnota je
"~/.weechat" (poznámka: složka bude vytvořena pokud nebude nalezena
Weechatem)
Pokud tato volba není zadána, použije se promněná prostředí WEECHAT_HOME
(pokud není prázdná)
+27 -27
View File
@@ -8,7 +8,7 @@ S irc pluginem se můžete doččasně připojit na server s URL jako:
K připojení na IRC kanál Weechatu pro podporu s přezdívkou "mynick":
irc://mynick@irc.libera.chat/#weechat
irc://mynick@chat.freenode.net/#weechat
IPv6 adresa může být uzavřena do hranatých závorek k přidání portu, například:
@@ -16,79 +16,79 @@ IPv6 adresa může být uzavřena do hranatých závorek k přidání portu, nap
// end::plugin_options[]
// tag::files[]
$HOME/.config/weechat/weechat.conf::
$HOME/.weechat/weechat.conf::
hlavní konfigurační soubor WeeChatu
$HOME/.config/weechat/plugins.conf::
$HOME/.weechat/plugins.conf::
soubor konfigurace pluginů
$HOME/.config/weechat/sec.conf::
$HOME/.weechat/sec.conf::
konfigurační soubor s chráněnými daty
$HOME/.config/weechat/alias.conf::
$HOME/.weechat/alias.conf::
configurační soubor pro _alias_ plugin
$HOME/.config/weechat/buflist.conf::
$HOME/.weechat/buflist.conf::
konfigurační soubor pro _buflist_ plugin
$HOME/.config/weechat/charset.conf::
$HOME/.weechat/charset.conf::
konfigurační soubor pro _charset_ plugin
$HOME/.config/weechat/exec.conf::
$HOME/.weechat/exec.conf::
konfigurační soubor pro _exec_ plugin
$HOME/.config/weechat/fifo.conf::
$HOME/.weechat/fifo.conf::
konfigurační soubor pro _fifo_ plugin
$HOME/.config/weechat/fset.conf::
$HOME/.weechat/fset.conf::
konfigurační soubor pro _fset_ plugin
$HOME/.config/weechat/guile.conf::
$HOME/.weechat/guile.conf::
konfigurační soubor pro _guile_ plugin
$HOME/.config/weechat/irc.conf::
$HOME/.weechat/irc.conf::
konfigurační soubor pro _irc_ plugin
$HOME/.config/weechat/javascript.conf::
$HOME/.weechat/javascript.conf::
konfigurační soubor pro _javascript_ plugin
$HOME/.config/weechat/logger.conf::
$HOME/.weechat/logger.conf::
konfigurační soubor pro _logger_ plugin
$HOME/.config/weechat/lua.conf::
$HOME/.weechat/lua.conf::
konfigurační soubor pro _lua_ plugin
$HOME/.config/weechat/perl.conf::
$HOME/.weechat/perl.conf::
konfigurační soubor pro _perl_ plugin
$HOME/.config/weechat/php.conf::
$HOME/.weechat/php.conf::
konfigurační soubor pro _php_ plugin
$HOME/.config/weechat/python.conf::
$HOME/.weechat/python.conf::
konfigurační soubor pro _python_ plugin
$HOME/.config/weechat/relay.conf::
$HOME/.weechat/relay.conf::
konfigurační soubor pro _relay_ plugin
$HOME/.config/weechat/ruby.conf::
$HOME/.weechat/ruby.conf::
konfigurační soubor pro _ruby_ plugin
$HOME/.config/weechat/script.conf::
$HOME/.weechat/script.conf::
konfigurační soubor pro _script_ plugin
$HOME/.config/weechat/spell.conf::
$HOME/.weechat/spell.conf::
konfigurační soubor pro _spell_ plugin
$HOME/.config/weechat/tcl.conf::
$HOME/.weechat/tcl.conf::
konfigurační soubor pro _tcl_ plugin
$HOME/.config/weechat/trigger.conf::
$HOME/.weechat/trigger.conf::
konfigurační soubor pro _trigger_ plugin
$HOME/.config/weechat/xfer.conf::
$HOME/.weechat/xfer.conf::
konfigurační soubor pro _xfer_ plugin
$HOME/.local/share/weechat/weechat.log::
$HOME/.weechat/weechat.log::
soubor záznamů WeeChatu
// end::files[]
@@ -96,7 +96,7 @@ $HOME/.local/share/weechat/weechat.log::
WeeChat je napsán Sébastienem Helleu a přispěvovateli (kompletní seznam je v
souboru AUTHORS.adoc).
Copyright (C) 2003-2021 {author}
Copyright (C) 2003-2020 {author}
WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
+28 -21
View File
@@ -113,13 +113,13 @@ Použijte příkaz `/plugin` k zobrazení nahraných pluginů, pravděpodobně u
Můžete přidat irc server příkazem `/server`, například:
----
/server add libera irc.libera.chat/6697 -ssl
/server add freenode chat.freenode.net
----
// TRANSLATION MISSING
In this command, `libera` is the internal server name used by WeeChat:
you'll be able to connect with `/connect libera` and the server options
are _irc.server.libera.xxx_.
In this command, `freenode` is the internal server name used by WeeChat:
you'll be able to connect with `/connect freenode` and the server options
are _irc.server.freenode.xxx_.
Jako obvykle je poskytována nápověda pokud se ztratíte:
@@ -138,38 +138,45 @@ Pro každou serverovou volbu WeeChat použije její hodnotu pokud je definována
(není "prázdná"). Jinak WeeChat použije výchozí hodnotu ("irc.server_default.xxx).
Například, je zde výchozí přezdívka (založena na vašem un*x loginu), můžete
ji přepsat pro libera s následujícím příkazem:
ji přepsat pro freenode s následujícím příkazem:
----
/set irc.server.libera.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
/set irc.server.freenode.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
----
Nastavení username a realname:
----
/set irc.server.libera.username "Mé uživatelské jméno"
/set irc.server.libera.realname "Mé skutečné jméno"
/set irc.server.freenode.username "Mé uživatelské jméno"
/set irc.server.freenode.realname "Mé skutečné jméno"
----
K zapnutí automatického připojení při spuštění:
----
/set irc.server.libera.autoconnect on
/set irc.server.freenode.autoconnect on
----
K připojení s SSL:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
----
Pokud je na serveru podporován SASL, můžete jej použít pro autentizaci (mužete
být identifikován před připojením kanálů):
----
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
----
K spuštění příkazů po připojení k serveru, například k autentizaci s nickserv
(pouze pokud nepoužíváte autentizaci přes SASL):
----
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -187,24 +194,24 @@ First setup a passphrase:
----
// TRANSLATION MISSING
Then add a secured data with your libera password:
Then add a secured data with your freenode password:
----
/secure set libera_password xxxxxxx
/secure set freenode_password xxxxxxx
----
// TRANSLATION MISSING
Then you can use `+${sec.data.libera_password}+` instead of your password in
Then you can use `+${sec.data.freenode_password}+` instead of your password in
IRC options mentioned above, for example:
----
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
----
K automatickému připojení některých kanálů při připojování k serveru:
----
/set irc.server.libera.autojoin "#channel1,#channel2"
/set irc.server.freenode.autojoin "#channel1,#channel2"
----
// TRANSLATION MISSING
@@ -217,25 +224,25 @@ K smazání hodnoty serverové volby a k použití výchozí hodnoty místo ní,
například k požití výchozích přezdívek (irc.server_default.nicks):
----
/unset irc.server.libera.nicks
/unset irc.server.freenode.nicks
----
Ostatní volby: můžete nastavit ostatní volby s následujícím příkazem ("xxx" je
název volby):
----
/set irc.server.libera.xxx value
/set irc.server.freenode.xxx value
----
[[connect_to_irc_server]]
== Připojení k IRC serveru
----
/connect libera
/connect freenode
----
// TRANSLATION MISSING
With this command, WeeChat connects to the libera server and auto-joins the
With this command, WeeChat connects to the freenode server and auto-joins the
channels configured in the "autojoin" server option.
// TRANSLATION MISSING
+14 -16
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
@@ -32,21 +32,19 @@ if(ENABLE_MAN)
add_custom_target(doc-man-weechat-de ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/de/man1)
if(ENABLE_HEADLESS)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.de.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.de.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.de.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.de.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (de)"
)
add_custom_target(doc-man-weechat-headless-de ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/de/man1)
endif()
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.de.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.de.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.de.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.de.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (de)"
)
add_custom_target(doc-man-weechat-headless-de ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/de/man1)
endif()
if(ENABLE_DOC)
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2006 Julien Louis <ptitlouis@sysif.net>
#
# This file is part of WeeChat, the extensible chat client.
+11 -15
View File
@@ -18,23 +18,23 @@
| guile | guile_script | Liste der Skripten
| irc | irc_channel | aktueller IRC-Kanal
| irc | irc_channel | aktueller IRC-Channel
| irc | irc_channel_nicks_hosts | Liste der Nicks und Hostnamen des aktuellen Kanals
| irc | irc_channel_nicks_hosts | Liste der Nicks und Hostnamen des aktuellen Channels
| irc | irc_channel_topic | Thema des aktuellen IRC-Kanals
| irc | irc_channel_topic | Thema des aktuellen IRC-Channels
| irc | irc_channels | Kanäle auf allen IRC Servern
| irc | irc_channels | Channels auf allen IRC Servern
| irc | irc_ignores_numbers | Anzahl für festgelegte Ignorierungen
| irc | irc_modelist_masks | Modelist Maske für aktuellen IRC Kanal; benötigtes Argument: modelist mode
| irc | irc_modelist_masks | Modelist Maske für aktuellen IRC Channel; benötigtes Argument: modelist mode
| irc | irc_modelist_numbers | Modelist Nummern für aktuellen IRC Kanal; benötigtes Argument: modelist mode
| irc | irc_modelist_numbers | Modelist Nummern für aktuellen IRC Channel; benötigtes Argument: modelist mode
| irc | irc_msg_kick | Standardmitteilung wenn man jemanden aus einem Kanal wirftchannel
| irc | irc_msg_kick | Standardmitteilung wenn man jemanden aus einem Channel wirft
| irc | irc_msg_part | Standardmitteilung beim Verlassen (/part) eines IRC-Kanals
| irc | irc_msg_part | Standardmitteilung beim Verlassen (/part) eines IRC-Channels
| irc | irc_notify_nicks | Nicks für die eine Benachrichtigung existiert
@@ -44,17 +44,17 @@
| irc | irc_server | aktueller IRC-Server
| irc | irc_server_channels | Kanäle des derzeitigen IRC-Server
| irc | irc_server_channels | Channels des derzeitigen IRC-Server
| irc | irc_server_nick | Nick beim derzeitigen IRC-Server
| irc | irc_server_nicks | Nicks für alle Kanäle auf dem aktuellen IRC-Server
| irc | irc_server_nicks | Nicks für alle Channels auf dem aktuellen IRC-Server
| irc | irc_server_privates | Privat auf aktuellem IRC Server
| irc | irc_servers | IRC-Server (interne Namen)
| irc | nick | Liste der Nicks im aktuellen Kanal
| irc | nick | Liste der Nicks im aktuellen Channel
| javascript | javascript_script | Liste der Skripten
@@ -120,10 +120,6 @@
| weechat | bars_options | Einstellungen für Infobars
| weechat | buffer_local_variable_value | Wert einer lokalen Buffervariablen
| weechat | buffer_local_variables | lokale Buffervariablen
| weechat | buffer_properties_get | Eigenschaften die für den Buffer gelesen werden können
| weechat | buffer_properties_set | Eigenschaften die für den Buffer gesetzt werden können
+2 -6
View File
@@ -53,7 +53,7 @@ _next_script_   (pointer, hdata: "guile_script") +
| irc
| [[hdata_irc_channel]]<<hdata_irc_channel,irc_channel>>
| IRC-Kanal
| IRC-Channel
| -
| _type_   (integer) +
_name_   (string) +
@@ -87,7 +87,7 @@ _next_channel_   (pointer, hdata: "irc_channel") +
| irc
| [[hdata_irc_channel_speaking]]<<hdata_irc_channel_speaking,irc_channel_speaking>>
| irc channel_speaking
| IRC channel_speaking
| -
| _nick_   (string) +
_time_last_message_   (time) +
@@ -233,10 +233,6 @@ _hook_connect_   (pointer, hdata: "hook") +
_hook_fd_   (pointer, hdata: "hook") +
_hook_timer_connection_   (pointer, hdata: "hook") +
_hook_timer_sasl_   (pointer, hdata: "hook") +
_sasl_scram_client_first_   (string) +
_sasl_scram_salted_pwd_   (other) +
_sasl_scram_salted_pwd_size_   (integer) +
_sasl_scram_auth_message_   (string) +
_is_connected_   (integer) +
_ssl_connected_   (integer) +
_disconnected_   (integer) +
@@ -18,17 +18,17 @@
| guile | guile_script | Liste der Skripten | Skript Pointer (optional) | Name des Skriptes (Platzhalter "*" kann verwendet werden) (optional)
| irc | irc_channel | Liste der Kanäle eines IRC-Servers | Pointer vom Kanal (optional) | Server,Kanal (Kanal ist optional)
| irc | irc_channel | Liste der Channels eines IRC-Servers | Channel Pointer (optional) | Server,Channel (Channel ist optional)
| irc | irc_color_weechat | Zuordnung der IRC Farbkodierung und der WeeChat Farbnamen | - | -
| irc | irc_ignore | Liste von ignorierten IRCs | Ignore Pointer (optional) | -
| irc | irc_modelist | Liste der Kanalmoduslisten für einen IRC-Kanal | Modelist Pointer (optional) | Server,Channel,Type (Type ist optional)
| irc | irc_modelist | Liste der Channel-Mode-Liste für einen IRC-Channel | Modelist Pointer (optional) | Server,Channel,Type (Type ist optional)
| irc | irc_modelist_item | Liste der Items in der Kanal-Modeliste | Modelist Item Pointer (optional) | Server,Channel,Type,Nummer (Nummer ist optional)
| irc | irc_modelist_item | Liste der Items in der Channel-Modeliste | Modelist Item Pointer (optional) | Server,Channel,Type,Nummer (Nummer ist optional)
| irc | irc_nick | Liste der Nicks im IRC-Kanal | Nick Pointer (optional) | server,channel,nick (nick ist optional)
| irc | irc_nick | Liste der Nicks im IRC-Channel | Nick Pointer (optional) | server,channel,nick (nick ist optional)
| irc | irc_notify | Liste mit Benachrichtigungen | Benachrichtigungspointer (optional) | Servername (Platzhalter "*" kann verwendet werden) (optional)
+5 -17
View File
@@ -16,11 +16,9 @@
| guile | guile_version | Version des verwendeten Interpreters | -
| irc | irc_buffer | holt Buffer Pointer für einen IRC Server/Kanal/Nick | server,channel,nick (Kanal und Nicks sind optional)
| irc | irc_buffer | holt Buffer Pointer für einen IRC Server/Channel/Nick | server,channel,nick (Channel und Nicks sind optional)
| irc | irc_is_channel | 1, falls die Zeichenkette ein gültiger IRC-Kanalname für den Server ist | Server,Kanal (Server ist optional)
| irc | irc_is_message_ignored | 1, wenn der Nick ignoriert wird (Meldung wird nicht angezeigt) | Server,Nachricht (Nachricht ist die unverarbeitete IRC Nachricht)
| irc | irc_is_channel | 1, falls die Zeichenkette ein gültiger IRC-Channelname für den Server ist | Server,Channel (Server ist optional)
| irc | irc_is_nick | 1, falls die Zeichenkette ein gültiger IRC Nickname ist | Server,Nickname (Server ist optional)
@@ -60,7 +58,7 @@
| php | php_version | Version des verwendeten Interpreters | -
| python | python2_bin | Pfad zum Python 2.x Interpreter (*veraltet*, seit WeeChat Version 2.6 müssen Skripten Python3 verwenden) | -
| python | python2_bin | Pfad für Python 2.x Interpreter | -
| python | python_eval | Evaluierung des Quelltextes | Quelltext welcher ausgeführt werden soll
@@ -76,7 +74,7 @@
| ruby | ruby_version | Version des verwendeten Interpreters | -
| spell | spell_dict | durch Kommata getrennte Liste von Wörterbüchern, die in diesem Buffer genutzt werden sollen | Buffer-Pointer ("0x12345678") oder der vollständige Buffername ("irc.libera.#weechat")
| spell | spell_dict | durch Kommata getrennte Liste von Wörterbüchern, die in diesem Buffer genutzt werden sollen | Buffer-Pointer ("0x12345678") oder der vollständige Buffername ("irc.freenode.#weechat")
| tcl | tcl_eval | Evaluierung des Quelltextes | Quelltext welcher ausgeführt werden soll
@@ -134,15 +132,7 @@
| weechat | version_number | WeeChat-Version (als Zahl) | -
| weechat | weechat_cache_dir | WeeChat Cache-Verzeichnis | -
| weechat | weechat_config_dir | WeeChat Konfigurationsverzeichnis | -
| weechat | weechat_daemon | 1, falls WeeChat im Daemon-Modus ausgeführt wird (ohne Oberfläche, im Hintergrund) | -
| weechat | weechat_data_dir | WeeChat-Datenverzeichnis | -
| weechat | weechat_dir | WeeChat-Verzeichnis (*veraltet* seit Version 3.2, ersetzt durch "weechat_config_dir", "weechat_data_dir", "weechat_cache_dir" und "weechat_runtime_dir") | -
| weechat | weechat_dir | WeeChat Verzeichnis | -
| weechat | weechat_headless | 1, falls WeeChat im Hintergrundmodus ausgeführt wird | -
@@ -150,8 +140,6 @@
| weechat | weechat_localedir | "lokales" Verzeichnis von WeeChat | -
| weechat | weechat_runtime_dir | WeeChat-Laufzeitverzeichnis | -
| weechat | weechat_sharedir | WeeChat "share" Verzeichnis | -
| weechat | weechat_site | WeeChat Seite | -
@@ -8,13 +8,11 @@
|===
| Erweiterung | Name | Beschreibung | Hashtable (Eingabe) | Hashtable (Ausgabe)
| irc | irc_message_parse | Parse eine IRC Nachricht | "message": IRC Nachricht, "server": Servername (optional) | "tags": Tags, "message_without_tags": Nachrichten ohne Tags, "nick": Nick, "user": Benutzername, "host": Host, "command": Befehl, "channel": Kanal, "arguments": Argumente (schließt Kanal ein), "text": Text (zum Beispiel eine Nachricht von einem User), "pos_command": Index der "command" Nachricht ("-1" falls "command" nicht gefunden wird), "pos_arguments": Index der "arguments" Nachricht ("-1" falls "arguments" nicht gefunden wird), "pos_channel": Index der "channel" Nachricht ("-1" falls "channel" nicht gefunden wird),"pos_text": Index für "text" Nachricht ("-1" falls "text" nicht gefunden wird)
| irc | irc_message_parse | Parse eine IRC Nachricht | "message": IRC Nachricht, "server": Servername (optional) | "tags": Tags, "message_without_tags": Nachrichten ohne Tags, "nick": Nick, "user": Benutzername, "host": Host, "command": Befehl, "channel": Channel, "arguments": Argumente (schließt Channel ein), "text": Text (zum Beispiel eine Nachricht von einem User), "pos_command": Index der "command" Nachricht ("-1" falls "command" nicht gefunden wird), "pos_arguments": Index der "arguments" Nachricht ("-1" falls "arguments" nicht gefunden wird), "pos_channel": Index der "channel" Nachricht ("-1" falls "channel" nicht gefunden wird),"pos_text": Index für "text" Nachricht ("-1" falls "text" nicht gefunden wird)
| irc | irc_message_split | trennt eine IRC Nachricht (standardmäßig in 512 Bytes große Nachrichten) | "message": IRC Nachricht, "server": Servername (optional) | "msg1" ... "msgN": Nachrichten die versendet werden sollen (ohne abschließendes "\r\n"), "args1" ... "argsN": Argumente für Nachrichten, "count": Anzahl der Nachrichten
| weechat | focus_info | Fokusinformationen abrufen | "x": x-Koordinate (Zeichenfolge mit Ganzzahl >= 0), "y": y-Koordinate (Zeichenfolge mit Ganzzahl >= 0) | siehe Funktion "hook_focus" in API Dokumentation
| weechat | secured_data | schutzwürdige Daten | - | schutzwürdige Daten: Namen und Werte (Vorsicht: Dies sind vertrauliche Daten: drucken oder protokollieren Sie diese NICHT)
|===
// end::infos_hashtable[]
+157 -185
View File
@@ -14,32 +14,32 @@ target: Servername
----
[[command_irc_allchan]]
* `+allchan+`: führt einen Befehl aus der an alle Kanäle gesendet wird, die mit einem Server verbunden sind
* `+allchan+`: führt einen Befehl aus der an alle Channels gesendet wird, die mit einem Server verbunden sind
----
/allchan [-current] [-exclude=<channel>[,<channel>...]] <command>
[-current] -include=<channel>[,<channel>...] <command>
-current: führt einen Befehl aus der an alle Kanäle des aktuellen Servers gesendet wird
-exclude: dient zum Ausschluss ausgewählter Kanäle (Platzhalter "*" kann verwendet werden)
-include: findet Anwendung für ausgewählte Kanäle (Platzhalter "*" kann verwendet werden)\n
-current: führt einen Befehl aus der an alle Channels des aktuellen Servers gesendet wird
-exclude: dient zum Ausschluss ausgewählter Channels (Platzhalter "*" kann verwendet werden)
-include: findet Anwendung für ausgewählte Channels (Platzhalter "*" kann verwendet werden)\n
command: Befehl der ausgeführt werden soll
Argumente und Befehl werden evaluiert (siehe /help eval), folgende Variablen können genutzt werden:
$server Name des Servers
$channel Name des Kanals
$channel Name des Channel
$nick Nickname der auf dem Server genutzt wird
${irc_server.xxx} Variable xxx von Server
${irc_channel.xxx} Variable xxx von Kanal
${irc_channel.xxx} Variable xxx von Channel
Beispiele:
führe den Befehl '/me Ich teste gerade etwas...' für alle Kanäle aus:
führe den Befehl '/me Ich teste gerade etwas...' für alle Channels aus:
/allchan /me Ich teste gerade etwas...
schicke 'Hallo Welt' an jeden Kanal, ausgenommen an den #weechat Kanal:
schicke 'Hallo Welt' an jeden Channel, ausgenommen an den #weechat Channel:
/allchan -exclude=#weechat Hallo Welt
schicke 'Hallo Welt' an jeden Kanal, ausgenommen an den #weechat Kanal und Kanäle die mit #linux beginnen:
schicke 'Hallo Welt' an jeden Channel, ausgenommen an den #weechat Channel und Channels die mit #linux beginnen:
/allchan -exclude=#weechat,#linux* Hallo Welt
schickt den Text 'Hallo' an alle Kanäle die mit #linux beginnen:
schickt den Text 'Hallo' an alle Channels die mit #linux beginnen:
/allchan -include=#linux* Hallo
----
@@ -57,10 +57,10 @@ Beispiele:
Argumente und Befehl werden evaluiert (siehe /help eval), folgende Variablen können genutzt werden:
$server Name des Servers
$channel Name des Kanals
$channel Name des Channel
$nick Nickname der auf dem Server genutzt wird
${irc_server.xxx} Variable xxx von Server
${irc_channel.xxx} Variable xxx von Kanal
${irc_channel.xxx} Variable xxx von Channel
Beispiele:
führe den Befehl '/me Ich teste gerade etwas...' für alle privaten Buffer aus:
@@ -106,10 +106,10 @@ Beispiele:
----
/ban [<channel>] [<nick> [<nick>...]]
channel: Name des Kanals
channel: Name des Channel
nick: Nick oder Host
Ohne Angabe von Argumenten wird die Ban-Liste für den aktuellen Kanal angezeigt.
Ohne Angabe von Argumenten wird die Ban-Liste für den aktuellen Channel angezeigt.
----
[[command_irc_cap]]
@@ -161,7 +161,7 @@ Beispiele:
Um eine Verbindung zum Server, oder Verbindungsversuche, zu beenden wird der Befehl /disconnect verwendet.
Beispiele:
/connect libera
/connect freenode
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
@@ -177,7 +177,7 @@ Beispiele:
/ctcp [-server <server>] <target>[,<target>...] <type> [<arguments>]
server: an diesen Server senden (interner Servername)
target: Nick- oder Kanalname an welchen eine CTCP-Nachricht geschickt werden soll ('*' = aktueller Kanal)
target: Nick- oder Channelname an welchen eine CTCP-Nachricht geschickt werden soll ('*' = aktuellen Channel)
type: CTCP-Nachricht (Beispiele: "version", "ping", usw.)
arguments: Argumente für CTCP
@@ -188,12 +188,12 @@ Beispiele:
----
[[command_irc_cycle]]
* `+cycle+`: Einen Kanal verlassen und wieder betreten
* `+cycle+`: Einen Channel verlassen und wieder betreten
----
/cycle [<channel>[,<channel>...]] [<message>]
channel: Name des Kanals
channel: Name des Channels
message: Abschiedsnachricht (wird anderen Usern angezeigt)
----
@@ -219,10 +219,9 @@ Beispiel:
----
/dehalfop <nick> [<nick>...]
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: entzieht allen Nicks im Kanal den half-operator-Status, ausgenommen sich selber
*: entzieht allen Nicks im Channel den half-operator-Status, ausgenommen sich selber
----
[[command_irc_deop]]
@@ -233,7 +232,7 @@ nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: entzieht allen Nicks im Kanal den Operator-Status, ausgenommen sich selber
*: entzieht allen Nicks im Channel den Operator-Status, ausgenommen sich selber
----
[[command_irc_devoice]]
@@ -244,7 +243,7 @@ nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: entzieht allen Nicks im Kanal den voice-Status
*: entzieht allen Nicks im Channel den voice-Status
----
[[command_irc_die]]
@@ -276,11 +275,11 @@ target: Servername
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: vergibt an alle Nicks im Kanal den half-operator-Status
*: vergibt an alle Nicks im Channel den half-operator-Status
----
[[command_irc_ignore]]
* `+ignore+`: Ignoriert Nicks/Hosts von Kanälen oder Servern
* `+ignore+`: Ignoriert Nicks/Hosts von Channels oder Servern
----
/ignore list
@@ -294,17 +293,17 @@ nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
number: Nummer der Ignorierung die entfernt werden soll (nutze "list" um den entsprechenden Eintrag zu finden)
-all: entfernt alle Einträge
server: interner Name des Server auf welchem die Ignorierung statt finden soll
channel: Name des Kanals, in dem die Ignorierung statt finden soll
channel: Name des Channel, in dem die Ignorierung statt finden soll
Hinweis: Um zwischen Groß-und Kleinschreibung zu unterscheiden muss am Wortanfang "(?-i)" genutzt werden.
Beispiele:
ignoriert den Nick "toto" global:
/ignore add toto
ignoriert den Host "toto@domain.com" auf dem libera Server:
/ignore add toto@domain.com libera
ignoriert den Host "toto*@*.domain.com" im Chat libera/#weechat:
/ignore add toto*@*.domain.com libera #weechat
ignoriert den Host "toto@domain.com" auf dem freenode Server:
/ignore add toto@domain.com freenode
ignoriert den Host "toto*@*.domain.com" im Chat freenode/#weechat:
/ignore add toto*@*.domain.com freenode #weechat
----
[[command_irc_info]]
@@ -317,13 +316,13 @@ target: Servername
----
[[command_irc_invite]]
* `+invite+`: Eine Person in einen Kanal einladen
* `+invite+`: Eine Person in einen Channel einladen
----
/invite <nick> [<nick>...] [<channel>]
nick: Nickname
channel: Name des Kanals
channel: Name des Channels
----
[[command_irc_ison]]
@@ -336,43 +335,43 @@ nick: Nickname
----
[[command_irc_join]]
* `+join+`: einen Kanal betreten
* `+join+`: einen Channel betreten
----
/join [-noswitch] [-server <server>] [<channel1>[,<channel2>...]] [<key1>[,<key2>...]]
-noswitch: es wird nicht zu dem angegebenen Kanal gewechselt
-noswitch: es wird nicht zu dem angegebenen Channel gewechselt
server: an angegebenen Server (interner Name) senden
channel: Name des Kanals, der betreten werden soll
key: Zugriffsschlüssel für einen Kanal (Kanäle, die einen Zugriffsschlüssel benötigen, müssen zuerst aufgeführt werden)
channel: Name des Channels, der betreten werden soll
key: Zugriffsschlüssel für einen Channel (Channel, die einen Zugriffsschlüssel benötigen, müssen zuerst aufgeführt werden)
Beispiele:
/join #weechat
/join #geschützter_Kanal,#weechat Zugriffsschlüssel
/join -server libera #weechat
/join #geschützter_Channel,#weechat Zugriffsschlüssel
/join -server freenode #weechat
/join -noswitch #weechat
----
[[command_irc_kick]]
* `+kick+`: wirft einen User aus einem Kanal
* `+kick+`: wirft einen User aus einem Channel
----
/kick [<channel>] <nick> [<reason>]
channel: Kanalname
channel: Channelname
nick: Nick der rausgeworfen werden soll
reason: Begründung für den Rauswurf (evaluiert, siehe /help eval; besondere Variablen ${nick} (eigener Nick), ${target} (betroffener Nick), ${channel} und ${server}, werden durch den entsprechenden Wert ersetzt)
reason: Begründung für den Rauswurf (Variablen die genutzt werden können: $nick, $channel und $server)
----
[[command_irc_kickban]]
* `+kickban+`: wirft einen User aus einem Kanal und sein Host kommt auf die Bannliste
* `+kickban+`: wirft einen User aus einem Channel und sein Host kommt auf die Bannliste
----
/kickban [<channel>] <nick> [<reason>]
channel: Kanalname
channel: Channelname
nick: Nickname der rausgeworfen und gebannt werden soll
reason: Begründung für den Rauswurf (evaluiert, siehe /help eval; besondere Variablen ${nick} (eigener Nick), ${target} (betroffener Nick), ${channel} und ${server}, werden durch den entsprechenden Wert ersetzt)
reason: Begründung weshalb der User rausgeworfen wurde (Variablen die genutzt werden können: $nick, $channel und $server)
Es ist möglich kick/ban mittels einer Maske auszuführen. Der Nick wird aus der Maske heraus gefiltert und durch "*" ersetzt.
@@ -402,22 +401,22 @@ server_mask: die aufzulistenden Server sollen diesem Muster entsprechen
----
[[command_irc_list]]
* `+list+`: Kanäle und deren Themen auflisten
* `+list+`: Channels mit ihrem Thema auflisten
----
/list [-server <server>] [-re <regex>] [<channel>[,<channel>...]] [<target>]
server: an diesen Server senden (interner Name)
regexp: erweiterter regulärer POSIX Ausdruck, der auf die Ausgabe angewendet werden soll (zwischen Groß- und Kleinschreibung wird nicht unterschieden. Um zwischen Groß- und Kleinschreibung zu unterscheiden muss zu Beginn "(?-i)" genutzt werden)
channel: aufzulistender Kanal
channel: aufzulistender Channel
target: Servername
Beispiele:
listet alle Kanäle des Servers auf (dies kann bei großen Netzwerken sehr lange dauern):
listet alle Channels des Servers auf (dies kann bei großen Netzwerken sehr lange dauern):
/list
listet den Kanal #weechat auf:
listet den Channel #weechat auf:
/list #weechat
listet alle Kanäle auf die mit "#weechat" beginnen (dies kann bei großen Netzwerken sehr lange dauern):
listet alle Channels auf die mit "#weechat" beginnen (dies kann bei großen Netzwerken sehr lange dauern):
/list -re #weechat.*
----
@@ -438,7 +437,7 @@ target: Server, der die Anfrage weiterleiten soll
----
[[command_irc_me]]
* `+me+`: eine CTCP ACTION an den aktuellen Kanal senden
* `+me+`: eine CTCP ACTION an den aktuellen Channel senden
----
/me <message>
@@ -447,26 +446,26 @@ message: zu sendende Nachricht
----
[[command_irc_mode]]
* `+mode+`: Eigenschaften eines Kanals oder von einem User ändern
* `+mode+`: Eigenschaften eines Channel oder von einem User ändern
----
/mode [<channel>] [+|-]o|p|s|i|t|n|m|l|b|e|v|k [<arguments>]
<nick> [+|-]i|s|w|o
Kanal-Eigenschaften:
channel: zu ändernder Kanal (standardmäßig der erste Kanal)
Channel-Eigenschaften:
channel: zu ändernder Channel (standardmäßig der erste Channel)
o: vergibt/entzieht Operator Privilegien
p: privater Kanal
s: geheimer Kanal
i: geschlossener Kanal (Zutritt nur mit Einladung)
p: privater Channel
s: geheimer Channel
i: geschlossener Channel (Zutritt nur mit Einladung)
t: nur Operatoren dürfen das Thema setzen
n: keine Nachrichten von außerhalb des Kanals zulassen
m: moderierter Kanal (schreiben nur mit Voice)
l: maximale Anzahl an Usern im Kanal festlegen
n: keine Nachrichten von außerhalb des Channels zulassen
m: moderierter Channel (schreiben nur mit Voice)
l: maximale Anzahl an Usern im Channel festlegen
b: Bannmaske für zu sperrende User (in nick!ident@host-Form)
e: legt Ausnahmemaske fest
v: vergibt/entzieht Schreibrechte (voice) in moderierten Kanälen
k: legt ein Passwort für den Kanal fest
v: vergibt/entzieht Schreibrechte (voice) in moderierten Channels
k: legt ein Passwort für den Channel fest
User-Eigenschaften:
nick: zu ändernder Nickname
i: User als unsichtbar kennzeichnen
@@ -493,23 +492,23 @@ target: Servername
----
[[command_irc_msg]]
* `+msg+`: Nachricht an Nick/Kanal verschicken
* `+msg+`: Nachricht an Nick/Channel verschicken
----
/msg [-server <server>] <target>[,<target>...] <text>
server: schicke an diesen Server (interner Servername)
target: Nick oder Kanal (darf eine Maske sein, '*' = aktueller c)
target: Nick oder Channel (darf eine Maske sein, '*' = aktueller Channel)
text: zu sendender Text
----
[[command_irc_names]]
* `+names+`: Nicknamen des Kanals auflisten
* `+names+`: Nicknamen in Channels auflisten
----
/names [<channel>[,<channel>...]]
channel: Name des Kanals
channel: Name des Channels
----
[[command_irc_nick]]
@@ -529,7 +528,7 @@ nick: neuer Nickname
/notice [-server <server>] <target> <text>
server: an diesen Server senden (interner Name)
target: Nick- oder Kanalname
target: Nick- oder Channelname
text: zu sendender Text
----
@@ -552,21 +551,21 @@ Ohne Angabe von Argumenten werden alle Benachrichtigungen für den aktuellen Ser
Beispiele:
Benachrichtigung falls sich "toto" am aktuellen Server an- oder abmeldet:
/notify add toto
Benachrichtigung falls sich "toto" am libera Server an- oder abmeldet:
/notify add toto libera
Benachrichtigung falls "toto" den Befehl away am libera Server nutzt:
/notify add toto libera -away
Benachrichtigung falls sich "toto" am freenode Server an- oder abmeldet:
/notify add toto freenode
Benachrichtigung falls "toto" den Befehl away am freenode Server nutzt:
/notify add toto freenode -away
----
[[command_irc_op]]
* `+op+`: Status des Kanal-Operator an Nicknamen vergeben
* `+op+`: Channel-Operator Status an Nicknamen vergeben
----
/op <nick> [<nick>...]
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: vergibt an alle Nicks im Kanal den Operator-Status
*: vergibt an alle Nicks im Channel den Operator-Status
----
[[command_irc_oper]]
@@ -580,12 +579,12 @@ password: Passwort
----
[[command_irc_part]]
* `+part+`: Einen Kanal verlassen
* `+part+`: Einen Channel verlassen
----
/part [<channel>[,<channel>...]] [<message>]
channel: Name des Kanals welcher verlassen werden soll
channel: Name des Channels welcher verlassen werden soll
message: Abschiedsnachricht (wird anderen Usern angezeigt)
----
@@ -622,15 +621,15 @@ target: Nickname
----
[[command_irc_quiet]]
* `+quiet+`: Nicks oder Hosts das Wort entziehen (User können im Kanal erst schreiben, wenn sie "+v" oder höher besitzen)
* `+quiet+`: Nicks oder Hosts das Wort entziehen (User können im Channel erst schreiben, wenn sie "+v" oder höher besitzen)
----
/quiet [<channel>] [<nick> [<nick>...]]
channel: Name des Kanals
channel: Name des Channel
nick: Nick oder Host
Ohne Angabe von Argumenten wird die Quiet-Liste für den aktuellen Kanal angezeigt.
Ohne Angabe von Argumenten wird die Quiet-Liste für den aktuellen Channel angezeigt.
----
[[command_irc_quote]]
@@ -652,7 +651,7 @@ data: unbearbeitete (RAW) Daten die gesendet werden sollen
server: Servername zu welchem neu verbunden werden soll (interner Name)
-all: mit allen Servern neu verbinden
-nojoin: Kanäle werden nicht betreten (auch falls autojoin für diesen Server aktiviert ist)
-nojoin: Channels werden nicht betreten (auch falls autojoin für diesen Server aktiviert ist)
-switch: wechselt zur nächsten Server-Adresse
----
@@ -666,12 +665,12 @@ option: zusätzliche Einstellung, die von manchen Servern berücksichtigt wird
----
[[command_irc_remove]]
* `+remove+`: zwingt einen User einen Kanal zu verlassen
* `+remove+`: zwingt einen User einen Channel zu verlassen
----
/remove [<channel>] <nick> [<reason>]
channel: Kanalname
channel: Channelname
nick: Nick der rausgeworfen werden soll
reason: Begründung für den Rauswurf (Variablen die genutzt werden können: $nick, $channel und $server)
----
@@ -686,23 +685,23 @@ target: Servername
----
[[command_irc_sajoin]]
* `+sajoin+`: fordert einen User auf einen oder mehrere Kanäle zu betreten
* `+sajoin+`: fordert einen User auf einen oder mehrere Channel zu betreten
----
/sajoin <nick> <channel>[,<channel>...]
nick: Nickname
channel: Name des Kanals
channel: Name des Channels
----
[[command_irc_samode]]
* `+samode+`: ändert den Modus des Kanals ohne das Operator-Privilegien vorliegen
* `+samode+`: ändert den Modus des Channels ohne das Operator-Privilegien vorliegen
----
/samode [<channel>] <mode>
Channel: Name des Kanals
Mode: neuer Modus für Kanal
Channel: Name des Channel
Mode: neuer Modus für Channel
----
[[command_irc_sanick]]
@@ -716,13 +715,13 @@ new_nick: neuer Nickname
----
[[command_irc_sapart]]
* `+sapart+`: zwingt einen User den oder die Kanäle zu verlassen
* `+sapart+`: zwingt einen User den oder die Channel(s) zu verlassen
----
/sapart <nick> <channel>[,<channel>...]
nick: Nickname
channel: Name des Kanals
channel: Name des Channels
----
[[command_irc_saquit]]
@@ -775,16 +774,16 @@ nooption: stellt die Boolean Einstellung auf 'off' (Beispiel: -nossl)
Beispiele:
/server listfull
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add freenode chat.freenode.net
/server add freenode chat.freenode.net/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server copy freenode freenode-test
/server rename freenode-test freenode2
/server reorder freenode2 freenode
/server del freenode
/server deloutq
/server raw
/server raw s:libera
/server raw s:freenode
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
@@ -846,7 +845,7 @@ target: Name des Servers
user: Benutzername
target: Servername
channel: Kanalname
channel: Channelname
----
[[command_irc_time]]
@@ -859,14 +858,14 @@ target: Zeit des angegebenen Servers abfragen
----
[[command_irc_topic]]
* `+topic+`: Thema des Kanals abfragen/setzen
* `+topic+`: Thema des Channels abfragen/setzen
----
/topic [<channel>] [<topic>|-delete]
channel: Name des Kanals
topic: neues Thema für den Kanal
-delete: entfernt das Thema des Kanals
channel: Name des Channels
topic: neues Thema für den Channel
-delete: entfernt das Thema des Channels
----
[[command_irc_trace]]
@@ -884,7 +883,7 @@ target: Servername
----
/unban [<channel>] <nick>|<number> [<nick>|<number>...]
channel: Name des Kanals
channel: Name des Channel
nick: Nick oder Host
number: ban Nummer (wird beim Befehl /ban angezeigt)
----
@@ -895,7 +894,7 @@ channel: Name des Kanals
----
/unquiet [<channel>] <nick>|<number> [<nick>|<number>...]
channel: Name des Kanals
channel: Name des Channel
nick: Nick oder Host
number: Quiet-Nummer (wird beim Befehl /quiet angezeigt)
----
@@ -933,19 +932,18 @@ target: Servername
----
/voice <nick> [<nick>...]
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: vergibt an alle Nicks im Kanal den voice-Status
*: vergibt an alle Nicks im Channel den voice-Status
----
[[command_irc_wallchops]]
* `+wallchops+`: Nachricht an Kanal-Operator verschicken
* `+wallchops+`: Nachricht an Channel-Operator verschicken
----
/wallchops [<channel>] <text>
channel: Name des Kanals
channel: Name des Channel
text: Text der versendet werden soll
----
@@ -978,7 +976,7 @@ target: Name des Servers (interner Servername)
nick: Nick, welcher abgefragt werden soll (es kann auch eine Maske genutzt werden)
Ohne Angabe von Argumenten, nutzt /whois folgende Regel:
- den eigenen Nick, falls es sich um einen Server/Kanal-Buffer handelt
- den eigenen Nick, falls es sich um einen Server/Channel Buffer handelt
- den Nick des Gesprächspartners, falls es sich um einen privaten Buffer handelt.
Sollte die Einstellung irc.network.whois_double_nick aktiviert sein dann wird ein Nick zweimal verwendet (sofern der Nick nur einmal angegeben wurde), um die Idle-Zeit zu erhalten.
@@ -1022,7 +1020,7 @@ Anmerkung: Im Befehl können Variablen genutzt werden, die dann durch den entspr
$n-m: Argumente von 'n' bis 'm'
$*: alle Argumente
$~: letztes Argument
$var: "var" ist eine lokale Variable für den jeweiligen Buffer (siehe /buffer listvar)
$var: "var" ist eine lokale Variable für den jeweiligen Buffer (siehe /buffer localvar)
Beispiel: $nick, $channel, $server, $plugin, $name
Beispiele:
@@ -1115,9 +1113,7 @@ Beispiele:
renumber [<number1> [<number2> [<start>]]]
close [<n1>[-<n2>]|<name>...]
notify [<level>]
listvar [<number>|<name>]
setvar <name> [<value>]
delvar <name>
localvar [<number>|<name>]
set <property> [<value>]
get <property>
<number>|-|+|<name>
@@ -1141,9 +1137,7 @@ renumber: Buffer werden umnummeriert (Einstellung weechat.look.buffer_auto_renum
message: Benachrichtigung bei Nachrichten von Usern + Highlights
all: Benachrichtigung bei allen Nachrichten
reset: Benachrichtigung auf Standardwert zurück setzen (all)
listvar: zeigt die lokalen Variablen für den aktuellen Buffer an
setvar: legt eine lokale Variable für den aktuellen Buffer an
delvar: löscht eine lokale Variable des aktuellen Buffers
localvar: zeigt die lokalen Variablen für den aktuellen Buffer an
set: setzt eine Eigenschaft für den aktuellen Buffer
get: zeigt eine Eigenschaft für den aktuellen Buffer an
number: wechselt von einem Buffer zu einem anderen, mögliche Optionen:
@@ -1302,11 +1296,11 @@ infolists: zeigt Information über die Infolists an
----
/eval [-n|-s] [-d] <expression>
[-n] [-d [-d]] -c <expression1> <operator> <expression2>
[-n] [-d] -c <expression1> <operator> <expression2>
-n: gibt das Ergebnis aus, ohne dass dieses in den Buffer gesendet wird (debug Modus)
-s: teilt Ausdrücke, bevor sie evaluiert werden (mehrere Befehle können durch Semikolon getrennt werden)
-d: eine Debug-Ausgabe nach Auswertung anzeigen (Nutzung von zwei -d: ausführliche Debug-Ausgabe)
-d: eine Debug-Ausgabe nach Auswertung anzeigen
-c: Auswertung als Bedingung: nutzt Operatoren und runde Klammern, Rückgabewert als Boolean-Wert ("0" oder "1")
expression: Ausdruck welcher verarbeitet werden soll. Variablen im Format ${variable} werden ersetzt (siehe unten); mehrere Befehle werden durch ein Semikolon voneinander getrennt
operator: ein logischer oder vergleichender Operand:
@@ -1341,28 +1335,25 @@ Um einen Vergleich zwischen zwei Zeichenketten zu erzwingen, müssen die Ausdrü
"50" > "100" ==> 1
Einige Variablen werden im Ausdruck mittels der Formatierung ${variable} ersetzt. Mögliche Variablen sind, nach Reihenfolge ihrer Priorität:
1. die Zeichenfolge selbst ohne Auswertung (Format: "raw:xxx")\n
2. eine evaluierte Teilzeichenkette (Format: "eval:xxx")
3. eine evaluierte Bedingung (Format: "eval_cond:xxx")
4. eine Zeichenkette mit Escapesequenzen (Format: "esc:xxx" oder "\xxx")
5. Zeichen, die in einer Zeichenkette nicht dargestellt werden sollen (Format: "hide:Zeichen,Zeichenkette")
6. eine Zeichenkette mit einer maximalen Anzahl an Zeichen (Format: "cut:max,suffix,string" oder "cut:+max,suffix,string")
1. eine evaluierte Teilzeichenkette (Format: "eval:xxx")
2. eine Zeichenkette mit Escapesequenzen (Format: "esc:xxx" oder "\xxx")
3. Zeichen, die in einer Zeichenkette nicht dargestellt werden sollen (Format: "hide:Zeichen,Zeichenkette")
4. eine Zeichenkette mit einer maximalen Anzahl an Zeichen (Format: "cut:+Max,Suffix,Zeichenkette")
oder maximale Anzahl an Zeichen die auf dem Bildschirm angezeigt werden sollen (Format: "cutscr:Max,Suffix,Zeichenkette oder "cutscr:+Max,Suffix,Zeichenkette")
7. eine Zeichenkette umkehren (Format: "rev:xxx" oder "revscr:xxx")
8. eine Zeichenkette wiederholen (Format: "repeat:Anzahl,Zeichenkette")
9. Länge einer Zeichenkette (Format: "length:xxx" oder "lengthscr:xxx")
10. eine Farbe (Format: "color:xxx", siehe "Anleitung für API Erweiterung", Funktion "color")
11. zum modifizieren (Format: "modifier:name,data,string")
12. eine Info (Format: "Info:Name,Argumente", Argumente sind optional)
13. eine Basis 16/32/64 kodierte / dekodierte Zeichenfolge (Format: "base_encode:base,xxx" oder "base_decode:base,xxx")
14. aktuelles Datum/Uhrzeit (Format: "date" oder "date:format")
15. eine Umgebungsvariable (Format: "env:XXX")
16. ein Dreifachoperand (Format: "if:Bedingung?Wert_falls_wahr:Wert_falls_unwahr")
17. Ergebnis eines Ausdrucks mit Klammern und Operatoren + - * / // % ** (Format: "calc:xxx")
18. eine übersetzte Zeichenkette (Format: "translate:xxx")
19. eine Option (Format: "file.section.option")
20. eine lokale Variable eines Buffers
21. ein(e) hdata - Name/Variable (der Wert wird automatisch in eine Zeichenkette konvertiert), standardmäßig wird für "window" und "buffer" das aktuelle Fenster/Buffer verwendet.
5. eine Zeichenkette umkehren (Format: "rev:xxx" oder "revscr:xxx")
6. eine Zeichenkette wiederholen (Format: "repeat:Anzahl,Zeichenkette")
7. Länge einer Zeichenkette (Format: "length:xxx" oder "lengthscr:xxx")
8. eine Farbe (Format: "color:xxx", siehe "Anleitung für API Erweiterung", Funktion "color")
9. ein Modifizierer (Format: "info:Name,Argumente", Argumente sind optional)
10. eine Info (Format: "Info:Name,Argumente", Argumente sind optional)
11. eine Basis 16/32/64 kodierte / dekodierte Zeichenfolge (Format: "base_encode:base,xxx" oder "base_decode:base,xxx")
12. aktuelles Datum/Uhrzeit (Format: "date" oder "date:format")
13. eine Umgebungsvariable (Format: "env:XXX")
14. ein Dreifachoperand (Format: "if:Bedingung?Wert_falls_wahr:Wert_falls_unwahr")
15. Ergebnis eines Ausdrucks mit Klammern und Operatoren + - * / // % ** (Format: "calc:xxx")
16. eine Option (Format: "file.section.option")
17. eine lokale Variable eines Buffers
18. ein(e) hdata - Name/Variable (der Wert wird automatisch in eine Zeichenkette konvertiert), standardmäßig wird für "window" und "buffer" das aktuelle Fenster/Buffer verwendet.
Das Format für hdata kann wie folgt aufgebaut sein:
hdata.var1.var2...: startet mit hdata (der Pointer muss bekannt sein) und fragt eine Variable nach der anderen ab (weitere hdata können folgen)
hdata[list].var1.var2...: startet hdata mittels einer Liste, zum Beispiel:
@@ -1370,16 +1361,13 @@ Das Format für hdata kann wie folgt aufgebaut sein:
${plugin[weechat_plugins].name}: Name der ersten Erweiterung, in der verknüpften Liste aller Erweiterungen
hdata[pointer].var1.var2...: startet hdata mittels einem Pointer, zum Beispiel:
${buffer[0x1234abcd].full_name}: vollständiger Name eines Buffers und des dazugehörigen Pointers (kann in triggern benutzt werden)
${buffer[my_pointer].full_name}: vollständiger Name des Buffers mit dem entsprechenden Pointernamen (kann in Triggern verwendet werden)
Die vorhandenen Namen für hdata und Variablen sind in der "Anleitung für API Erweiterung", Bereich "weechat_hdata_get". beschrieben
Beispiele (einfache Zeichenketten):
/eval -n ${raw:${info:version}} ==> ${info:version}
/eval -n ${eval_cond:${window.win_width}>100} ==> 1
/eval -n ${info:version} ==> 0.4.3
/eval -n ${env:HOME} ==> /home/user
/eval -n ${weechat.look.scroll_amount} ==> 3
/eval -n ${sec.data.password} ==> geheim
/eval -n ${sec.data.freenode_password} ==> geheim
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
@@ -1396,7 +1384,6 @@ Beispiele (einfache Zeichenketten):
/eval -n ${calc:(5+2)*3} ==> 21
/eval -n ${base_encode:64,test} ==> dGVzdA==
/eval -n ${base_decode:64,dGVzdA==} ==> test
/eval -n ${translate:Plugin} ==> Erweiterung
Beispiele (Bedingungen):
/eval -n -c ${window.buffer.number} > 2 ==> 0
@@ -1419,7 +1406,6 @@ Beispiele (Bedingungen):
enable|disable|toggle [<name>|@]
add|addreplace <name> <buffer>[,<buffer>...] <tags> <regex>
rename <name> <new_name>
recreate <name>
del <name>|-all
list: alle Filter auflisten
@@ -1430,11 +1416,10 @@ Beispiele (Bedingungen):
add: Filter hinzufügen
addreplace: erzeugt neuen Filter oder ersetzt einen schon existierenden Filter
rename: benennt einen Filter um
recreate: in die Eingabezeile wird die entsprechende Filtereinstellung übernommen, um diese dann editieren zu können
del: Filter entfernen
-all: entfernt alle Filter
buffer: durch Kommata getrennte Liste von Buffer in denen der Filter aktiv sein soll:
- ist der vollständige Name eines Buffer inklusive seiner Erweiterung (Beispiel: "irc.libera.#weechat" oder "irc.server.libera")
- ist der vollständige Name eines Buffer inklusive seiner Erweiterung (Beispiel: "irc.freenode.#weechat" oder "irc.server.freenode")
- "*" bedeutet, alle Buffer
- beginnt ein Name mit '!' wird für diesen Buffer kein Filter genutzt
- Platzhalter "*" kann verwendet werden
@@ -1469,11 +1454,11 @@ Beispiele:
filtert Nicks wenn diese den Channel betreten oder durch den Befehl "/names" angezeigt werden:
/filter add nicks * irc_366 *
filtert Nick "toto" im IRC Channel #weechat:
/filter add toto irc.libera.#weechat nick_toto *
/filter add toto irc.freenode.#weechat nick_toto *
filtert IRC join/action Nachrichten von Nick "toto":
/filter add toto * nick_toto+irc_join,nick_toto+irc_action *
filtert Zeilen die "weechat sucks" im IRC Channel #weechat enthalten:
/filter add sucks irc.libera.#weechat * weechat sucks
/filter add sucks irc.freenode.#weechat * weechat sucks
filter Zeilen die exakt "WeeChat sucks" lauten und das in allen Buffern:
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -1675,7 +1660,7 @@ Beispiele:
-core: keine Ausgabe im WeeChat Core Buffer
-current: Ausgabe im aktuellen Buffer wird unterdrückt
-buffer: Ausgabe im ausgewählten Buffer wird unterdrückt
name: vollständiger Buffername (Beispiel: "irc.server.libera", "irc.libera.#weechat")
name: vollständiger Buffername (Beispiel: "irc.server.freenode", "irc.freenode.#weechat")
command: Befehl der ohne Textausgabe ausgeführt werden soll (das Präfix, '/', wird automatisch hinzugefügt, falls es dem Befehl nicht vorangestellt wurde)
Wird kein Buffer ausgewählt (-core, -current oder -buffer), dann wird die Textausgabe generell unterdrückt.
@@ -1683,10 +1668,10 @@ Wird kein Buffer ausgewählt (-core, -current oder -buffer), dann wird die Texta
Beispiele:
Speichern der Konfiguration:
/mute save
Nachricht in den aktuellen Kanal senden:
Nachricht in den aktuellen Channel senden:
/mute -current msg * hi!
Nachricht an den #weechat Kanal senden:
/mute -buffer irc.libera.#weechat msg #weechat hi!
Nachricht an den #weechat Channel senden:
/mute -buffer irc.freenode.#weechat msg #weechat hi!
----
[[command_weechat_plugin]]
@@ -1754,7 +1739,7 @@ Beispiele:
zeigt eine Nachricht im Core-Buffer mit dem Präfix "abc" an:
/print -core abc\tmeine Nachricht
es wird eine Nachricht im Channel #weechat ausgegeben:
/print -buffer irc.libera.#weechat Nachricht an #weechat
/print -buffer irc.freenode.#weechat Nachricht an #weechat
gibt einen Schneemann aus (U+2603):
/print -escape \u2603
verschickt Alarm (BEL):
@@ -1876,7 +1861,7 @@ Tastenbefehle für den secure-Buffer:
alt+v Werte werden in Klartext angezeigt bzw. verborgen
Wird eine Passphrase verwendet (Daten liegen verschlüsselt vor), fragt WeeChat beim Start die Passphrase ab.
Setzt man die Umgebungsvariable "WEECHAT_PASSPHRASE", kann die Eingabeaufforderung der Passphrase beim Programmstart vermieden werden (diese Variable wird von WeeChat auch beim /upgrade verwendet). Es ist auch möglich mittels der Option sec.crypt.passphrase_command die Passphrase aus der Ausgabe eines externen Befehls, wie eines Passwort-Managers zu lesen (siehe /help sec.crypt.passphrase_command )
Setzt man die Umgebungsvariable "WEECHAT_PASSPHRASE", kann die Eingabeaufforderung der Passphrase beim Programmstart vermieden werden (diese Variable wird von WeeChat auch beim /upgrade verwendet). Es ist auch möglich in der Option sec.crypt.passphrase_file eine Datei anzugeben die die Passphrase beinhaltet (siehe /help sec.crypt.passphrase_file)
schutzwürdige Daten mit dem Format ${sec.data.xxx} können wie folgt genutzt werden:
- Befehl /eval.
@@ -1887,16 +1872,14 @@ schutzwürdige Daten mit dem Format ${sec.data.xxx} können wie folgt genutzt we
Beispiele:
festlegen eine Passphrase:
/secure passphrase Dies ist meine Passphrase
nutze Programm "pass" um die Passphrase beim Start auszulesen:
/set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"
verschlüsselt libera SASL Passwort:
/secure set libera meinPasswort
/set irc.server.libera.sasl_password "${sec.data.libera}"
verschlüsselt freenode SASL Passwort:
/secure set freenode meinPasswort
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
verschlüsselt oftc Passwort für nickserv:
/secure set oftc meinPasswort
/set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}"
Alternativbefehl um den eigenen Nick zu ghosten:
/alias add ghost /eval /msg -server libera nickserv ghost meinNick ${sec.data.libera}
/alias add ghost /eval /msg -server freenode nickserv ghost meinNick ${sec.data.freenode}
----
[[command_weechat_set]]
@@ -1983,7 +1966,7 @@ Nutzt man die "-quit" Funktion ist die Abfolge geringfügig anders:
5. WeeChat wird beendet
Die Sitzung kann zu einem späteren Zeitpunkt wiederhergestellt werden: weechat --upgrade
WICHTIG: Die Sitzung muss mit exakt den selben Konfigurationsdateien wiederhergestellt werden (*.conf)
Es ist möglich, die WeeChat-Sitzung auf einem anderen Computer wiederherzustellen, wenn Sie den Inhalt der WeeChat Verzeichnisse kopieren (siehe / debug dirs).
Es ist möglich die WeeChat-Sitzung auf einem anderen Rechner wiederherzustellen, sofern man den Inhalt des "~/.weechat" Verzeichnisses dorthin kopiert.
----
[[command_weechat_uptime]]
@@ -2025,7 +2008,7 @@ command: Befehl welcher ausgeführt werden soll (oder ein Text der an einen Buff
Hinweis: Der Befehl wird in dem Buffer ausgeführt, in welchem der /wait Befehl ausgeführt wurde (sollte der Buffer nicht mehr existieren, wird der Befehl nicht ausgeführt).
Beispiele:
Betritt nach 10 Sekunden den Kanal #test:
Betritt nach 10 Sekunden den Channel #test:
/wait 10 /join #test
Setzt nach 15 Minuten eine globale Abwesenheit:
/wait 15m /away -all Bin dann mal eben weg
@@ -2148,7 +2131,7 @@ Die folgenden Variablen können in den obigen Optionen genutzt werden:
- ${buffer.short_name}
- ${buffer.nicklist_nicks_count}
- irc_server: IRC Serverdaten, ausschließlich genutzt bei einem IRC Buffer (siehe hdata "irc_server" in API Dokumentation)
- irc_channel: IRC Kanaldaten, ausschließlich genutzt bei einem IRC Kanal-Buffer (siehe hdata "irc_channel" in API Dokumentation)
- irc_channel: IRC Channeldaten, ausschließlich genutzt bei einem IRC Channel Buffer (siehe hdata "irc_channel" in API Dokumentation)
- zusätzliche Variablen die durch buflist bereitgestellt werden:
- ${format_buffer}: der evaluierte Wert der Option buflist.format.buffer; dies kann in der Option buflist.format.buffer_current genutzt werden um zum Beispiel die Hintergrundfarbe zu verändern
- ${current_buffer}: ein Boolean ("0" oder "1"), "1" falls es sich um den aktuellen Buffer handelt; dies kann in einer Bedingung verwendet werden: ${if:${current_buffer}?...:...}
@@ -2168,7 +2151,6 @@ Die folgenden Variablen können in den obigen Optionen genutzt werden:
- ${hotlist}: die Hotlist in der Rohform
- ${hotlist_priority}: "none", "low", "message", "private" oder "highlight"
- ${format_lag}: die Verzögerung für einen IRC Server-Buffer, ist leer falls es keine Verzögerung gibt (evaluiert aus Option buflist.format.lag)
- ${format_tls_version}: Indikator der TLS Version für den Serverbuffer, Channels bleiben unberührt (evaluiert aus Option buflist.format.tls_version)
----
// end::buflist_commands[]
@@ -2275,14 +2257,14 @@ disable: deaktivieren der FIFO pipe
toggle: Status der FIFO pipe umschalten
Die FIFO-Pipe wird als Fernbedienung genutzt, es können Befehle oder Text von der Shell an die FIFO-Pipe geschickt werden
Standardmäßig heißt die FIFO-Pipe weechat_fifo_xxx (wobei xxx die WeeChat-Prozess-ID ist) und befindet sich im WeeChat-Laufzeitverzeichnis (siehe /debug dirs).
Standardmäßig ist die FIFO-Pipe in ~/.weechat/weechat_fifo
Folgendes Format wird erwartet:
plugin.buffer *Text oder Befehl an dieser Stelle
*Text oder Befehl an dieser Stelle
Beispiel um den eigenen Nick auf dem Server libera zu ändern:
echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
Beispiel um den eigenen Nick auf dem Server freenode zu ändern:
echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo
Bitte lese die Benutzeranleitung für weitere Informationen und Beispiele.
@@ -2531,7 +2513,7 @@ disable: die Protokollierung wird für den aktuellen Buffer deaktiviert (der Lev
Die Einstellungen "logger.level.*" und "logger.mask.*" können genutzt werden um den Level der Protokollierung festzulegen und um eine Maske für einen oder mehrere Buffer zu definieren.
Level der Protokollierung, die die IRC Erweiterung unterstützt:
1: Nachrichten von Usern (private und öffentliche Nachrichten) , notice (Server und Kanal)
1: Nachrichten von Usern (private und öffentliche Nachrichten) , notice (Server und Channel)
2: Wechsel von Nicks (/nick)
3: Nachrichten vom Server
4: join/part/quit Nachrichten
@@ -2546,7 +2528,7 @@ Beispiele:
/set logger.level.irc 3
Die Protokollierung, für den WeeChat Haupt-Buffer, wird deaktiviert:
/set logger.level.core.weechat 0
Für jeden IRC-Server wird ein separates Verzeichnis erstellt und darin eine eigene Protokoll-Datei, für jeden Kanal:
Für jeden IRC-Server wird ein separates Verzeichnis erstellt und darin eine eigene Protokoll-Datei, für jeden Channel:
/set logger.mask.irc "$server/$channel.weechatlog"
----
// end::logger_commands[]
@@ -2719,7 +2701,7 @@ Ohne Angabe eines Argumentes listet dieser Befehl alle geladenen Skripten auf.
stop: schließt den Server Socket (Clients bleiben verbunden)
name: Name des Relays (siehe Format weiter unten)
port: Port der für Relay genutzt werden soll
path: Pfad der für Relay genutzt werden soll (ausschließlich für UNIX Domain Socket); Pfad ist evaluiert (siehe Funktion string_eval_path_home in Erweiterung API Referenz)/n
path: Pfad der für Relay genutzt werden soll (ausschließlich für UNIX Domain Socket); "%h" wird durch das WeeChat Verzeichnis ersetzt, Standardverzeichnis: ("~/.weechat"), Inhalt ist evaluiert (siehe /help eval)
raw: öffnet einen Buffer mit Relay-Rohdaten
sslcertkey: setzt SSL Zertifikat/Schlüssel mittels Pfad in Einstellung relay.network.ssl_cert_key
@@ -2738,10 +2720,10 @@ Das "weechat" Protokoll wird von einem Remote-Interface genutzt um eine Verbindu
Ohne Angabe von Argumenten werden alle Relay-Clients in einem neuen Buffer dargestellt.
Beispiele:
IRC Proxy für Server "libera":
/relay add irc.libera 8000
IRC Proxy, für Server "libera", mit SSL:
/relay add ssl.irc.libera 8001
IRC Proxy für Server "freenode":
/relay add irc.freenode 8000
IRC Proxy, für Server "freenode", mit SSL:
/relay add ssl.irc.freenode 8001
IRC Proxy für alle Server (Client wählt aus), mit SSL:
/relay add ssl.irc 8002
WeeChat Protokoll:
@@ -2755,7 +2737,7 @@ Beispiele:
WeeChat Protokoll, mit SSL, mit IPv4 + IPv6:
/relay add ipv4.ipv6.ssl.weechat 9001
Weechat Protokoll über UNIX Domain Socket:
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
/relay add unix.weechat %h/relay_socket
----
// end::relay_commands[]
@@ -2835,17 +2817,7 @@ Im Skript-Buffer, werden folgende Statusangaben für ein Skript angezeigt:
| | | gehalten
| | Skript wird beim Start, von WeeChat, automatisch geladen
| Skript ist installiert (wird aber nicht ausgeführt)
beliebtes Skript
In der Ausgabe von /script list, wird der Status für ein Skript angegeben:
* ? i a H N
| | | | | |
| | | | | obsolete (neue Version verfügbar)
| | | | gehalten
| | | Skript wird beim Start, von WeeChat, automatisch geladen
| | Skript ist installiert (wird aber nicht ausgeführt)
| unbekanntes Skript (dieses Skript kann nicht heruntergeladen/aktualisiert werden)
beliebtes Skript
es wird empfohlen dieses Skript zu installieren
Tastenbefehle die im Skript-Buffer genutzt werden können:
alt+i installiert Skript (physikalisch)
@@ -2976,7 +2948,7 @@ listdefault: zeigt die standardmäßig genutzten Trigger an
modifier: Name(en) des modifier (erforderlich)
line: Buffertyp ("formatted", "free" oder "*"), Liste von Buffermasken, Tags
print: Buffer, Tags, Nachricht, Farben entfernen
command: Befehl (erforderlich), Beschreibung, Argumente, Beschreibung der Argumente, Vervollständigung (alle Argumente, außer dem Befehl werden ausgewertet, "${tg_trigger_name}" wird durch den Triggernamen ersetzt, siehe /help eval)
command: Befehl (erforderlich), Beschreibung, Argumente, Beschreibung der Argumente, Vervollständigung (Alle Argumente, außer dem Befehl werden ausgewertet, siehe /help eval)
command_run: Befehl(e) (erforderlich)
timer: Intervall (erforderlich), Anpassung an Sekunden (erforderlich), maximale Anzahl an Aufrufen
config: Name der Einstellung (erforderlich)
@@ -3008,7 +2980,7 @@ post_action: Aktion welche nach der Abarbeitung des Triggers ausgeführt werden
restore: stellt Trigger mit Standardwerten wieder her (funktioniert nur bei vorgegebenen Triggern)
default: stellt die standardmäßigen Trigger wieder her
monitor: öffnet den Trigger Monitor-Buffer, mit optionaler Filterfunktion:
filter: filtert Hooks/Trigger zum Anzeigen (ein Hook muss mit "@" beginnen, zum Beispiel "@signal"), mehrere Filter können durch Kommata voneinander getrennt werden; Platzhalter "*" kann im Namen des Trigger verwendet werden
Filter: zeigt Hooks/Trigger an (ein Hook muss mit "@" beginnen, zum Beispiel "@signal"), mehrere Filter können durch Kommata voneinander getrennt werden; Platzhalter "*" kann im Namen des Trigger verwendet werden
Wenn ein Trigger-Callback aufgerufen wird, dann wird folgende Befehlskette ausgeführt:
1. Überprüfung von Bedingungen; falls unwahr, beenden
+69 -153
View File
@@ -16,8 +16,8 @@
** Werte: sha224, sha256, sha384, sha512
** Standardwert: `+sha256+`
* [[option_sec.crypt.passphrase_command]] *sec.crypt.passphrase_command*
** Beschreibung: pass:none[Auslesen der Passphrase aus der Ausgabe des angegebenen Befehls (nur die erste Zeile wird verwendet und darf kein zusätzliches Zeichen enthalten); Diese Option wird nur verwendet, wenn die Datei sec.conf gelesen wird und wenn die Umgebungsvariable "WEECHAT_PASSPHRASE" nicht festgelegt ist (die Umgebungsvariable hat eine höhere Priorität); Beispiel mit Passwortspeicher: "/usr/bin/pass show weechat / passphrase"]
* [[option_sec.crypt.passphrase_file]] *sec.crypt.passphrase_file*
** Beschreibung: pass:none[Pfad zu einer Datei die die Passphrase enthält um damit schutzwürdige Daten zu ver- und entschlüsseln. Diese Einstellung findet nur Anwendung, wenn die Datei sec.conf gelesen wird. Es wird auch nur die erste Zeile eingelesen. Diese Datei wird nur verwendet, falls die Umgebungsvariable "WEECHAT_PASSPHRASE" nicht genutzt wird (die Umgebungsvariable besitzt eine höhere Priorität). Sicherheitshinweis: Es ist anzuraten dieser Datei nur für die eigene Person Leserechte zu gewähren und die Datei nicht im Heimatverzeichnis von WeeChat zu sichern (zum Beispiel im /home/ Order); Beispiel: "~/.weechat-passphrase"]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -55,7 +55,7 @@
** Standardwert: `+white+`
* [[option_weechat.color.chat_channel]] *weechat.color.chat_channel*
** Beschreibung: pass:none[Farbe für den Kanalnamen]
** Beschreibung: pass:none[Farbe für den Channel-Namen]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+white+`
@@ -403,7 +403,7 @@
** Standardwert: `+default+`
* [[option_weechat.color.status_number]] *weechat.color.status_number*
** Beschreibung: pass:none[Farbe des aktuellen Kanals in der Statuszeile]
** Beschreibung: pass:none[Farbe des aktuellen Channels in der Statuszeile]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+yellow+`
@@ -846,12 +846,6 @@
** Werte: on, off
** Standardwert: `+on+`
* [[option_weechat.look.hotlist_update_on_buffer_switch]] *weechat.look.hotlist_update_on_buffer_switch*
** Beschreibung: pass:none[Aktualisiert die Hotlist, wenn der Buffer gewechselt wird]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_weechat.look.input_cursor_scroll]] *weechat.look.input_cursor_scroll*
** Beschreibung: pass:none[Anzahl an Zeichen die nach links verschoben werden sollen, falls das Ende der Eingabezeile erreicht wird]
** Typ: integer
@@ -1146,12 +1140,6 @@
** Werte: beliebige Zeichenkette
** Standardwert: `+"- "+`
* [[option_weechat.look.read_marker_update_on_buffer_switch]] *weechat.look.read_marker_update_on_buffer_switch*
** Beschreibung: pass:none[Aktualisiert das Lesezeichen, wenn der Buffer gewechselt wird]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_weechat.look.save_config_on_exit]] *weechat.look.save_config_on_exit*
** Beschreibung: pass:none[die aktuelle Konfiguration wird beim Beenden automatisch gesichert]
** Typ: boolesch
@@ -1260,17 +1248,11 @@
** Werte: 1 .. 2147483647
** Standardwert: `+60+`
* [[option_weechat.network.gnutls_ca_system]] *weechat.network.gnutls_ca_system*
** Beschreibung: pass:none[lädt die standardmäßigen vertrauenswürdigen Zertifizierungsstellen des Systems beim Start; Dies kann deaktiviert werden, um Speicherplatz zu sparen, falls keine SSL-Verbindungen verwendet werden]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_weechat.network.gnutls_ca_user]] *weechat.network.gnutls_ca_user*
** Beschreibung: pass:none[zusätzliche Datei(en) bei den Zertifizierungsstellen; mehrere Dateien müssen durch Doppelpunkte getrennt werden (jeder Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
* [[option_weechat.network.gnutls_ca_file]] *weechat.network.gnutls_ca_file*
** Beschreibung: pass:none[Datei beinhaltet die digitalen Zertifikate ("%h" wird durch das WeeChat Verzeichnis ersetzt, Standardverzeichnis: "~/.weechat")]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
** Standardwert: `+"/etc/ssl/certs/ca-certificates.crt"+`
* [[option_weechat.network.gnutls_handshake_timeout]] *weechat.network.gnutls_handshake_timeout*
** Beschreibung: pass:none[Zeitüberschreitung für gnutls Handshake (in Sekunden)]
@@ -1303,10 +1285,10 @@
** Standardwert: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
** Beschreibung: pass:none[Pfad für die Suche nach Erweiterungen (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Beschreibung: pass:none[Suchpfad für Erweiterungen ("%h"' wird durch das WeeChat-Basisverzeichnis ersetzt, voreingestellt ist "~/.weechat")]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"${weechat_data_dir}/plugins"+`
** Standardwert: `+"%h/plugins"+`
* [[option_weechat.plugin.save_config_on_unload]] *weechat.plugin.save_config_on_unload*
** Beschreibung: pass:none[speichert Konfigurationen, falls Erweiterungen beendet werden]
@@ -1314,44 +1296,14 @@
** Werte: on, off
** Standardwert: `+on+`
* [[option_weechat.signal.sighup]] *weechat.signal.sighup*
** Beschreibung: pass:none[Befehl welcher ausgeführt werden soll, wenn das Signal empfangen wird. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"${if:${info:weechat_headless}?/reload:/quit -yes}"+`
* [[option_weechat.signal.sigquit]] *weechat.signal.sigquit*
** Beschreibung: pass:none[Befehl welcher ausgeführt werden soll, wenn das Signal empfangen wird. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"/quit -yes"+`
* [[option_weechat.signal.sigterm]] *weechat.signal.sigterm*
** Beschreibung: pass:none[Befehl welcher ausgeführt werden soll, wenn das Signal empfangen wird. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"/quit -yes"+`
* [[option_weechat.signal.sigusr1]] *weechat.signal.sigusr1*
** Beschreibung: pass:none[Befehl welcher ausgeführt werden soll, wenn das Signal empfangen wird. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
* [[option_weechat.signal.sigusr2]] *weechat.signal.sigusr2*
** Beschreibung: pass:none[Befehl welcher ausgeführt werden soll, wenn das Signal empfangen wird. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
* [[option_weechat.startup.command_after_plugins]] *weechat.startup.command_after_plugins*
** Beschreibung: pass:none[Befehl wird ausgeführt, wenn WeeChat gestartet wird, nachdem die Erweiterungen geladen wurden. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Beschreibung: pass:none[Nach dem Start von WeeChat wird dieser Befehl aufgerufen. Dies geschieht nachdem die Erweiterungen geladen worden sind (mehrere Befehle sind durch ";" zu trennen) (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
* [[option_weechat.startup.command_before_plugins]] *weechat.startup.command_before_plugins*
** Beschreibung: pass:none[Befehl wird ausgeführt, wenn WeeChat gestartet wird, bevor Erweiterungen geladen werden. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Beschreibung: pass:none[Nach dem Start von WeeChat wird dieser Befehl aufgerufen. Dies geschieht bevor die Erweiterungen geladen werden (mehrere Befehle sind durch ";" zu trennen) (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -1457,10 +1409,10 @@
** Standardwert: `+""+`
* [[option_logger.file.path]] *logger.file.path*
** Beschreibung: pass:none[Pfad für WeeChat-Protokolldateien; Datumsangaben sind zulässig (siehe man strftime) (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Beschreibung: pass:none[Pfad für WeeChat Protokolldateien; "%h" wird durch das WeeChat Verzeichnis ersetzt (Standardpfad: "~/.weechat"); eine Datumsspezifikation ist zulässig (siehe: man strftime) (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"${weechat_data_dir}/logs"+`
** Standardwert: `+"%h/logs/"+`
* [[option_logger.file.replacement_char]] *logger.file.replacement_char*
** Beschreibung: pass:none[Ersatzzeichen für Dateinamen, falls der Dateiname Sonderzeichen beinhaltet (z.B. das Trennzeichen bei Verzeichnissen "/")]
@@ -1723,7 +1675,7 @@
** Standardwert: `+"${color:default},"+`
* [[option_buflist.format.indent]] *buflist.format.indent*
** Beschreibung: pass:none[Zeichenkette die beim Einrücken von Kanal und privaten Buffern angezeigt wird (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Beschreibung: pass:none[Zeichenkette die beim Einrücken von Channel und privaten Buffern angezeigt wird (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+" "+`
@@ -1741,7 +1693,7 @@
** Standardwert: `+"${name}"+`
* [[option_buflist.format.nick_prefix]] *buflist.format.nick_prefix*
** Beschreibung: pass:none[Format des Nick-Präfix für einen Kanal (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Beschreibung: pass:none[Format des Nick-Präfix für einen Channel (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"${color_nick_prefix}${nick_prefix}"+`
@@ -1752,12 +1704,6 @@
** Werte: beliebige Zeichenkette
** Standardwert: `+"${color:green}${number}${if:${number_displayed}?.: }"+`
* [[option_buflist.format.tls_version]] *buflist.format.tls_version*
** Beschreibung: pass:none[Format für die TLS-Version für einen IRC-Serverbuffer (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+" ${color:default}(${if:${tls_version}==TLS1.3?${color:green}:${if:${tls_version}==TLS1.2?${color:yellow}:${color:red}}}${translate:${tls_version}}${color:default})"+`
* [[option_buflist.look.add_newline]] *buflist.look.add_newline*
** Beschreibung: pass:none[fügt einen Zeilenumbruch zwischen die einzelnen Buffer hinzu um pro Zeile einen Buffer anzuzeigen (empfohlen); falls deaktiviert muss ein Zeilenumbruch manuell hinzugefügt werden, "${\\n}", des Weiteren ist die Mausunterstützung nicht mehr gegeben]
** Typ: boolesch
@@ -1819,16 +1765,10 @@
** Standardwert: `+""+`
* [[option_buflist.look.sort]] *buflist.look.sort*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Feldern um die Buffer zu sortieren; jedes Feld ist entweder eine hdata Variable von Buffer ("var"), eine hdata Variable vom Typ IRC Server ("irc_server.var") oder eine hdata Variable vom Typ IRC Kanal ("irc_channel.var"); wird das "-" Zeichen vor einem Feld angewendet, wird die Ausgabe umgekehrt, um bei einem Vergleich nicht zwischen Groß- und Kleinschreibung zu unterscheiden wird das Zeichen "~" verwendet; Beispiel: "-~short_name" sortiert die Buffer nach ihren Kurznamen, wobei dies invertiert passiert und nicht zwischen Groß-oder Kleinschreibung unterschieden wird (Hinweis: der Inhalt ist evaluiert, vor dem Aufteilen in Felder, kann nur die Variable "bar_item" genutzt werden, um zwischen verschiedenen Buffer-Items zu unterscheiden, zum Beispiel "${bar_item.name}")]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Feldern um die Buffer zu sortieren; jedes Feld ist entweder eine hdata Variable von Buffer ("var"), eine hdata Variable vom Typ IRC Server ("irc_server.var") oder eine hdata Variable vom Typ IRC Channel ("irc_channel.var"); wird das "-" Zeichen vor einem Feld angewendet, wird die Ausgabe umgekehrt, um bei einem Vergleich nicht zwischen Groß- und Kleinschreibung zu unterscheiden wird das Zeichen "~" verwendet; Beispiel: "-~short_name" sortiert die Buffer nach ihrem Kurznamen, wobei dies invertiert passiert und nicht zwischen Groß-oder Kleinschreibung unterschieden wird (Hinweis: der Inhalt ist evaluiert, nur der Pointer der bar_item kann genutzt werden, Beispiel "bar_item.name")]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"number,-active"+`
* [[option_buflist.look.use_items]] *buflist.look.use_items*
** Beschreibung: pass:none[Anzahl der Buflist-Bar-Items, die verwendet werden können; die Item-Namen sind: "buflist", "buflist2", "buflist3"; Seien Sie vorsichtig, wenn Sie mehr als ein Bar-Item verwenden, wird die Anzeige der Bufferliste verlangsamt]
** Typ: integer
** Werte: 1 .. 3
** Standardwert: `+1+`
// end::buflist_options[]
// tag::fifo_options[]
@@ -1839,10 +1779,10 @@
** Standardwert: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
** Beschreibung: pass:none[Pfad für FIFO-Datei; WeeChat PID kann im Pfad mit ${info:pid} verwendet werden (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Beschreibung: pass:none[Pfad für eingehende Dateien: "%h" wird durch das WeeChat Verzeichnis ersetzt (Standardpfad: "~/.weechat"); WeeChat PID kann mit ${info:pid} genutzt werden (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
** Standardwert: `+"%h/weechat_fifo"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1913,7 +1853,7 @@
** Standardwert: `+off+`
* [[option_xfer.file.auto_accept_nicks]] *xfer.file.auto_accept_nicks*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Nicks deren Chat- und Transferanfragen automatisch akzeptiert werden. Format : "server.nick" (für einen speziellen Server) oder "nick" (global, für alle Server); Beispiel: "libera.FlashCode,andrew"]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Nicks deren Chat- und Transferanfragen automatisch akzeptiert werden. Format : "server.nick" (für einen speziellen Server) oder "nick" (global, für alle Server); Beispiel: "freenode.FlashCode,andrew"]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -1943,10 +1883,10 @@
** Standardwert: `+on+`
* [[option_xfer.file.download_path]] *xfer.file.download_path*
** Beschreibung: pass:none[Pfad zum Schreiben eingehender Dateien (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Beschreibung: pass:none[Pfad für eingehende Dateien: "%h" wird durch das WeeChat Verzeichnis ersetzt (Standardpfad: "~/.weechat") (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"${weechat_data_dir}/xfer"+`
** Standardwert: `+"%h/xfer"+`
* [[option_xfer.file.download_temporary_suffix]] *xfer.file.download_temporary_suffix*
** Beschreibung: pass:none[Dateiendung der temporären Datei, die während eines eingehenden Datei-Transfers genutzt wird und die gelöscht wird, sobald die Übertragung erfolgreich beendet wurde; wenn -leer-, dann wird keine temporäre Dateiendung während des Transfers genutzt]
@@ -1955,7 +1895,7 @@
** Standardwert: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
** Beschreibung: pass:none[Pfad zum Lesen von Dateien beim Senden (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Beschreibung: pass:none[Pfad für ausgehende Dateien (falls kein Pfad durch den Anwender angegeben wurde): "%h" wird durch das WeeChat Verzeichnis ersetzt (Standardpfad: "~/.weechat") (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"~"+`
@@ -2041,7 +1981,7 @@
** Standardwert: `+lightcyan+`
* [[option_irc.color.item_channel_modes]] *irc.color.item_channel_modes*
** Beschreibung: pass:none[Farbe der Kanal-Modes (neben des Kanalnamens)]
** Beschreibung: pass:none[Farbe der Channel-Modes (neben dem Channelnamen)]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+default+`
@@ -2064,24 +2004,6 @@
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+default+`
* [[option_irc.color.item_tls_version_deprecated]] *irc.color.item_tls_version_deprecated*
** Beschreibung: pass:none[Farbe die für eine unsicherere TLS-Version im Bar-Item "tls_version" genutzt wird]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+yellow+`
* [[option_irc.color.item_tls_version_insecure]] *irc.color.item_tls_version_insecure*
** Beschreibung: pass:none[Farbe die für eine unsichere TLS-Versionen im Bar-Item "tls_version" genutzt wirdFarbe für unsichere TLS-Versionen im Balkenelement "tls_version"]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+red+`
* [[option_irc.color.item_tls_version_ok]] *irc.color.item_tls_version_ok*
** Beschreibung: pass:none[Farbe die für eine sicherere TLS-Version im Bar-Item "tls_version" genutzt wird]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+green+`
* [[option_irc.color.message_account]] *irc.color.message_account*
** Beschreibung: pass:none[Textfarbe für "account" Nachrichten]
** Typ: Farbe
@@ -2095,7 +2017,7 @@
** Standardwert: `+brown+`
* [[option_irc.color.message_join]] *irc.color.message_join*
** Beschreibung: pass:none[Textfarbe in der die Meldungen für das Betreten eines Kanals angezeigt werden soll]
** Beschreibung: pass:none[Textfarbe in der die Meldungen für das Betreten eines Channels angezeigt werden soll]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+green+`
@@ -2107,7 +2029,7 @@
** Standardwert: `+red+`
* [[option_irc.color.message_quit]] *irc.color.message_quit*
** Beschreibung: pass:none[Textfarbe in der die Meldungen für das Verlassen/Beenden eines Kanals angezeigt werden soll]
** Beschreibung: pass:none[Textfarbe in der die Meldungen für das Verlassen/Beenden eines Channels angezeigt werden soll]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+red+`
@@ -2143,49 +2065,49 @@
** Standardwert: `+default+`
* [[option_irc.color.topic_current]] *irc.color.topic_current*
** Beschreibung: pass:none[Farbe in dem das aktuelle Thema des Kanals dargestellt werden soll (wenn ein Kanal betreten oder der Befehl /topic genutzt wird)]
** Beschreibung: pass:none[Farbe in dem das aktuelle Thema des Channels dargestellt werden soll (wenn ein Channel betreten oder der Befehl /topic genutzt wird)]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+default+`
* [[option_irc.color.topic_new]] *irc.color.topic_new*
** Beschreibung: pass:none[Farbe in dem das neue Thema des Kanals dargestellt werden soll, falls das Thema des Kanals geändert wurde]
** Beschreibung: pass:none[Farbe in dem das neue Thema des Channels dargestellt werden soll, falls das Thema des Channels geändert wurde]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+white+`
* [[option_irc.color.topic_old]] *irc.color.topic_old*
** Beschreibung: pass:none[Farbe in dem das alte Thema des Kanals dargestellt werden soll, falls das Thema des Kanals geändert wurde]
** Beschreibung: pass:none[Farbe in dem das alte Thema des Channels dargestellt werden soll, falls das Thema des Channels geändert wurde]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+default+`
* [[option_irc.look.buffer_open_before_autojoin]] *irc.look.buffer_open_before_autojoin*
** Beschreibung: pass:none[betritt man automatisch einen Kanal-Buffer (mittels autojoin Option) wird dieser direkt geöffnet, ohne auf die JOIN Nachricht des Servers zu warten; dies ist sinnvoll um die Kanäle immer an der selben Position bei einem Neustart zu öffnen]
** Beschreibung: pass:none[betritt man automatisch einen Channel-Buffer (mittels autojoin Option) wird dieser direkt geöffnet, ohne auf die JOIN Nachricht des Servers zu warten; dies ist sinnvoll um die Channels immer an der selben Position bei einem Neustart zu öffnen]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_irc.look.buffer_open_before_join]] *irc.look.buffer_open_before_join*
** Beschreibung: pass:none[betritt man mittels dem /join Befehl einen Kanal wird der Buffer direkt geöffnet, ohne auf die JOIN Nachricht des Servers zu warten]
** Beschreibung: pass:none[betritt man mittels dem /join Befehl einen Channel wird der Buffer direkt geöffnet, ohne auf die JOIN Nachricht des Servers zu warten]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
* [[option_irc.look.buffer_switch_autojoin]] *irc.look.buffer_switch_autojoin*
** Beschreibung: pass:none[wechselt automatisch zum Kanal-Buffer falls dieser automatisch betreten wurde (mittels der Serveroption "autojoin")]
** Beschreibung: pass:none[wechselt automatisch zum Channel-Buffer falls dieser automatisch betreten wurde (mittels der Serveroption "autojoin")]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_irc.look.buffer_switch_join]] *irc.look.buffer_switch_join*
** Beschreibung: pass:none[wechselt automatisch zum Kanal-Buffer falls dieser manuell betreten wurde (mittels dem /join Befehl)]
** Beschreibung: pass:none[wechselt automatisch zum Channel-Buffer falls dieser manuell betreten wurde (mittels dem /join Befehl)]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_irc.look.color_nicks_in_names]] *irc.look.color_nicks_in_names*
** Beschreibung: pass:none[nutzt in der Ausgabe von /names die jeweiligen Farbe des Nick (oder bei der Auflistung der Nicks wenn man einen Kanal betritt)]
** Beschreibung: pass:none[nutzt in der Ausgabe von /names die jeweiligen Farbe des Nick (oder bei der Auflistung der Nicks wenn man einen Channel betritt)]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
@@ -2203,7 +2125,7 @@
** Standardwert: `+on+`
* [[option_irc.look.color_pv_nick_like_channel]] *irc.look.color_pv_nick_like_channel*
** Beschreibung: pass:none[nutzt die selbe Farbe für die Darstellung des Nicks im Kanal wie auch im privaten Buffer]
** Beschreibung: pass:none[nutzt die selbe Farbe für die Darstellung des Nicks im Channel wie auch im privaten Buffer]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
@@ -2215,7 +2137,7 @@
** Standardwert: `+"%a, %d %b %Y %T %z"+`
* [[option_irc.look.display_away]] *irc.look.display_away*
** Beschreibung: pass:none[zeigt eine Nachricht an, sobald der Abwesenheitsstatus ein- bzw. ausgeschaltet wird (off: zeigt/sendet keine Nachricht, local: eine Nachricht wird lokal angezeigt, channel: sendet eine Nachricht an die Kanäle)]
** Beschreibung: pass:none[zeigt eine Nachricht an, sobald der Abwesenheitsstatus ein- bzw. ausgeschaltet wird (off: zeigt/sendet keine Nachricht, local: eine Nachricht wird lokal angezeigt, channel: sendet eine Nachricht an die Channels)]
** Typ: integer
** Werte: off, local, channel
** Standardwert: `+local+`
@@ -2257,13 +2179,13 @@
** Standardwert: `+on+`
* [[option_irc.look.display_join_message]] *irc.look.display_join_message*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Nachrichten die beim Betreten eines Kanals angezeigt werden sollen: 324 = Channel-Modi, 329 = Erstellungsdatum des Kanals, 332 = Topic, 333 = Nick/Datum für Topic, 353 = genutzte Namen im Kanal, 366 = Anzahl der Nicks im Kanal]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Nachrichten die beim Betreten eines Channels angezeigt werden sollen: 324 = Channel-Modi, 329 = Erstellungsdatum des Channels, 332 = Topic, 333 = Nick/Datum für Topic, 353 = genutzte Namen im Channel, 366 = Anzahl der Nicks im Channel]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"329,332,333,366"+`
* [[option_irc.look.display_old_topic]] *irc.look.display_old_topic*
** Beschreibung: pass:none[zeige das alte Thema an, falls das Thema des Kanals geändert wurde]
** Beschreibung: pass:none[zeige das alte Thema an, falls das Thema des Channels geändert wurde]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
@@ -2287,7 +2209,7 @@
** Standardwert: `+off+`
* [[option_irc.look.highlight_channel]] *irc.look.highlight_channel*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Wörtern die im Kanal-Buffern als Highlight erscheinen sollen (zwischen Groß- und Kleinschreibung wird nicht unterschieden. Um zwischen Groß- und Kleinschreibung zu unterscheiden muss zu Beginn "(?-i)" genutzt werden; des Weiteren können folgende Variablen genutzt werden: $nick, $channel und $server). Wird ein Buffer geöffnet, dann werden die angegeben Wörter dem Buffer-Merkmal "highlight_words" hinzugefügt. Dies bedeutet, dass diese Einstellung keinen direkten Einfluss auf schon geöffnete Buffer hat. Eine leere Zeichenkette deaktiviert ein Highlight für den Nick. Beispiel: "$nick", "(?-i)$nick"]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Wörtern die in Channel-Buffern als Highlight erscheinen sollen (zwischen Groß- und Kleinschreibung wird nicht unterschieden. Um zwischen Groß- und Kleinschreibung zu unterscheiden muss zu Beginn "(?-i)" genutzt werden; des Weiteren können folgende Variablen genutzt werden: $nick, $channel und $server). Wird ein Buffer geöffnet, dann werden die angegeben Wörter dem Buffer-Merkmal "highlight_words" hinzugefügt. Dies bedeutet, dass diese Einstellung keinen direkten Einfluss auf schon geöffnete Buffer hat. Eine leere Zeichenkette deaktiviert ein Highlight für den Nick. Beispiel: "$nick", "(?-i)$nick"]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"$nick"+`
@@ -2311,7 +2233,7 @@
** Standardwert: `+"irc_privmsg,irc_notice"+`
* [[option_irc.look.item_channel_modes_hide_args]] *irc.look.item_channel_modes_hide_args*
** Beschreibung: pass:none[unterdrückt die Ausgabe von Argumenten die die Kanalmodi betreffen, sofern der entsprechende Modus für den Kanal gesetzt ist ("*" unterdrückt jedwede Ausgabe von Argumenten; wird kein Wert angegeben, dann werden alle Argumente angezeigt); Beispiele: "kf" unterdrückt die Argumente, falls "k" oder "f" für den Kanal gesetzt sind]
** Beschreibung: pass:none[unterdrückt die Ausgabe von Argumenten die die Channel-Modi betreffen, sofern der entsprechende Modus für den Channel gesetzt ist ("*" unterdrückt jedwede Ausgabe von Argumenten; wird kein Wert angegeben, dann werden alle Argumente angezeigt); Beispiele: "kf" unterdrückt die Argumente, falls "k" oder "f" für den Channel gesetzt sind]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"k"+`
@@ -2335,7 +2257,7 @@
** Standardwert: `+on+`
* [[option_irc.look.join_auto_add_chantype]] *irc.look.join_auto_add_chantype*
** Beschreibung: pass:none[es wird dem Kanalnamen automatisch der Kanal-Typ vorangestellt, falls bei der Benutzung des /join Befehls der angegebene Kanalname keinen gültigen Typ besitzt; Beispiel: "/join weechat" wird als: "/join #weechat" versendet]
** Beschreibung: pass:none[es wird dem Channelnamen automatisch der Channel-Typ vorangestellt, falls bei der Benutzung des /join Befehls der angegebene Channel-Name keinen gültigen Typ besitzt; Beispiel: "/join weechat" wird als: "/join #weechat" versendet]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
@@ -2347,13 +2269,13 @@
** Standardwert: `+current+`
* [[option_irc.look.new_channel_position]] *irc.look.new_channel_position*
** Beschreibung: pass:none[ein neu geöffneter Kanal wird auf eine Position gezwungen (none = standardmäßige Position (sollte der letzte Buffer in der Liste sein), next = aktueller Buffer + 1, near_server = nach dem letztem Kanal/privaten Buffer des jeweiligen Servers)]
** Beschreibung: pass:none[ein neu geöffneter Channel wird auf eine Position gezwungen (none = standardmäßige Position (sollte der letzte Buffer in der Liste sein), next = aktueller Buffer + 1, near_server = nach dem letztem Channel/privaten Buffer des jeweiligen Servers)]
** Typ: integer
** Werte: none, next, near_server
** Standardwert: `+none+`
* [[option_irc.look.new_pv_position]] *irc.look.new_pv_position*
** Beschreibung: pass:none[ein neuer privater Buffer wird auf eine Position gezwungen (none = standardmäßige Position (sollte der letzte Buffer in der Liste sein), next = aktueller Buffer + 1, near_server = nach dem letztem Kanal/privaten Buffer des jeweiligen Servers)]
** Beschreibung: pass:none[ein neuer privater Buffer wird auf eine Position gezwungen (none = standardmäßige Position (sollte der letzte Buffer in der Liste sein), next = aktueller Buffer + 1, near_server = nach dem letztem Channel/privaten Buffer des jeweiligen Servers)]
** Typ: integer
** Werte: none, next, near_server
** Standardwert: `+none+`
@@ -2389,13 +2311,13 @@
** Standardwert: `+auto+`
* [[option_irc.look.notice_welcome_redirect]] *irc.look.notice_welcome_redirect*
** Beschreibung: pass:none[automatische Weiterleitung von Willkommen Nachrichten in den entsprechenden Kanal-Buffer. Solche Nachrichten haben als Empfänger den entsprechenden Nick. Der Kanalname wird aber der Nachricht vorangestellt. Eine solche ENTRYMSG Nachricht sieht auf dem Atheme IRC Server wie folgt aus: "[#channel\] Herzlich Willkommen in diesem Kanal ..."]
** Beschreibung: pass:none[automatische Weiterleitung von Willkommen Nachrichten in den entsprechenden Channel-Buffer. Solche Nachrichten haben als Empfänger den entsprechenden Nick. Der Channelname wird aber der Nachricht vorangestellt. Eine solche ENTRYMSG Nachricht sieht auf dem Atheme IRC Server wie folgt aus: "[#channel\] Herzlich Willkommen in diesem Channel ..."]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_irc.look.notice_welcome_tags]] *irc.look.notice_welcome_tags*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Schlagwörtern für Willkommen-Nachrichten die in einen Kanal umgeleitet werden. Zum Beispiel: "notify_private"]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Schlagwörtern für Willkommen-Nachrichten die in einen Channel umgeleitet werden. Zum Beispiel: "notify_private"]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2413,7 +2335,7 @@
** Standardwert: `+"notify_message"+`
* [[option_irc.look.part_closes_buffer]] *irc.look.part_closes_buffer*
** Beschreibung: pass:none[schließt den Buffer wenn "/part" im Kanal ausgeführt wird]
** Beschreibung: pass:none[schließt den Buffer wenn "/part" im Channel ausgeführt wird]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
@@ -2443,7 +2365,7 @@
** Standardwert: `+merge_with_core+`
* [[option_irc.look.smart_filter]] *irc.look.smart_filter*
** Beschreibung: pass:none[filtert join/part/quit/nick Nachrichten für einen Nick der einige Minuten im Kanal inaktiv gewesen ist (dazu muss ein Filter mit dem Schlagwort "irc_smart_filter" erstellt werden, siehe /help filter)]
** Beschreibung: pass:none[filtert join/part/quit/nick Nachrichten für einen Nick der einige Minuten im Channel inaktiv gewesen ist (dazu muss ein Filter mit dem Schlagwort "irc_smart_filter" erstellt werden, siehe /help filter)]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
@@ -2473,7 +2395,7 @@
** Standardwert: `+on+`
* [[option_irc.look.smart_filter_join_unmask]] *irc.look.smart_filter_join_unmask*
** Beschreibung: pass:none[Verzögerung (in Minuten) um Join Mitteilungen rückwirkend anzuzeigen, falls diese mittels "irc_smart_filter" unterdrückt wurden. Sollte ein Nick während der vorgegeben Zeit etwas im Kanal schreiben, dann wird seine Join Mitteilung angezeigt. Dies bezieht sich auf Nachrichten, eine Notice, Änderungen am Topic oder falls der Nick gewechselt wird (0 = deaktiviert: join-Mitteilungen bleiben verborgen)]
** Beschreibung: pass:none[Verzögerung (in Minuten) um Join Mitteilungen rückwirkend anzuzeigen, falls diese mittels "irc_smart_filter" unterdrückt wurden. Sollte ein Nick während der vorgegeben Zeit etwas im Channel schreiben, dann wird seine Join Mitteilung angezeigt. Dies bezieht sich auf Nachrichten, eine Notice, Änderungen am Topic oder falls der Nick gewechselt wird (0 = deaktiviert: join-Mitteilungen bleiben verborgen)]
** Typ: integer
** Werte: 0 .. 10080
** Standardwert: `+30+`
@@ -2503,7 +2425,7 @@
** Standardwert: `+off+`
* [[option_irc.look.topic_strip_colors]] *irc.look.topic_strip_colors*
** Beschreibung: pass:none[Farben werden im Kanalthema entfernt (wird nur genutzt wenn der Buffer-Titel angezeigt wird)]
** Beschreibung: pass:none[Farben werden im Channel-Thema entfernt (wird nur genutzt wenn der Buffer-Titel angezeigt wird)]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
@@ -2623,7 +2545,7 @@
** Standardwert: `+off+`
* [[option_irc.server_default.autojoin]] *irc.server_default.autojoin*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Kanälen, die beim Verbinden mit dem Server automatisch betreten werden (nachdem die Einstellungen command + delay ausgeführt wurden). Kanäle, die einen Schlüssel benötigen, müssen in der Auflistung als erstes aufgeführt werden. Die Schlüssel, zu den jeweiligen Kanälen, werden nach den Kanälen aufgeführt (eine Trennung von Kanälen und Schlüssel erfolgt mittels eines Leerzeichens. Schlüssel werden hintereinander auch durch Kommata voneinander getrennt) (Beispiel: "#channel1,#channel2,#channnel3 key1,key2", #channel1 und #channel2 sind durch jeweils einen Schlüssel, key1 und key2, geschützt) (Hinweis: Inhalt wird evaluiert, siehe /help eval; Serveroptionen sind mittels ${irc_server.xxx} evaluiert und ${server} wird durch den eigentlichen Servernamen ersetzt)]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Channels, die beim Verbinden mit dem Server automatisch betreten werden (nachdem die Einstellungen command + delay ausgeführt wurden). Channels die einen Schlüssel benötigen müssen in der Auflistung als erstes aufgeführt werden. Die Schlüssel, zu den jeweiligen Channels, werden nach den Channels aufgeführt (eine Trennung von Channels und Schlüssel erfolgt mittels einem Leerzeichen. Schlüssel werden untereinander auch durch Kommata voneinander getrennt) (Beispiel: "#channel1,#channel2,#channnel3 key1,key2", #channel1 und #channel2 sind durch jeweils einen Schlüssel, key1 und key2, geschützt) (Hinweis: Inhalt wird evaluiert, siehe /help eval; Serveroptionen sind mittels ${irc_server.xxx} evaluiert und ${server} wird durch den eigentlichen Servernamen ersetzt)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2641,13 +2563,13 @@
** Standardwert: `+10+`
* [[option_irc.server_default.autorejoin]] *irc.server_default.autorejoin*
** Beschreibung: pass:none[Kanäle automatisch betreten, falls man rausgeworfen wurde. Es kann eine lokale Buffer Variable für einen Kanal erstellt werden, diese lokale Variable wird vorrangig behandelt (Name der lokalen Variable: "autorejoin", Wert: "on" oder "off")]
** Beschreibung: pass:none[Channels automatisch betreten, falls man rausgeworfen wurde. Es kann eine lokale Buffer Variable für einen Channel erstellt werden, diese lokale Variable wird vorrangig behandelt (Name der lokalen Variable: "autorejoin", Wert: "on" oder "off")]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
* [[option_irc.server_default.autorejoin_delay]] *irc.server_default.autorejoin_delay*
** Beschreibung: pass:none[Wartezeit, in Sekunden, die verstreichen soll bevor man den Kanal automatisch erneut betritt (nachdem man rausgeworfen wurde)]
** Beschreibung: pass:none[Wartezeit, in Sekunden, die verstreichen soll bevor man den Channel automatisch erneut betritt (nachdem man rausgeworfen wurde)]
** Typ: integer
** Werte: 0 .. 86400
** Standardwert: `+30+`
@@ -2659,7 +2581,7 @@
** Standardwert: `+0+`
* [[option_irc.server_default.away_check_max_nicks]] *irc.server_default.away_check_max_nicks*
** Beschreibung: pass:none[Die Abwesenheit von Nutzern in Kanälen wird nicht überprüft wenn die Anzahl der Nutzer höher ist, als der angegebene Wert (0 = unbegrenzte Anzahl an Nutzern im Kanal)]
** Beschreibung: pass:none[Die Abwesenheit von Nutzern in Channels wird nicht überprüft wenn die Anzahl der Nutzer höher ist, als der angegebene Wert (0 = unbegrenzte Anzahl an Nutzern im Channel)]
** Typ: integer
** Werte: 0 .. 1000000
** Standardwert: `+25+`
@@ -2671,19 +2593,19 @@
** Standardwert: `+""+`
* [[option_irc.server_default.charset_message]] *irc.server_default.charset_message*
** Beschreibung: pass:none[Teil der IRC Nachricht (empfangen oder gesendet) die zum Zielzeichensatz dekodiert/kodiert werden soll; message = die komplette IRC Nachricht (Standard), channel = beginnend mit dem Kanalnamen (sofern dieser gefunden wird, ansonsten Fallback auf text), text = beginnend mit dem Nachrichtentext (dieser Wert sollte ausprobiert werden, falls es Probleme bei der Kodierung des Kanalnamens geben sollte)]
** Beschreibung: pass:none[Teil der IRC Nachricht (empfangen oder gesendet) die zum Zielzeichensatz dekodiert/kodiert werden soll; message = die komplette IRC Nachricht (Standard), channel = beginnend mit dem Channel-Namen (sofern dieser gefunden wird, ansonsten Fallback auf text), text = beginnend mit dem Nachrichtentext (dieser Wert sollte ausprobiert werden, falls es Probleme bei der Kodierung des Channel-Namen geben sollte)]
** Typ: integer
** Werte: message, channel, text
** Standardwert: `+message+`
* [[option_irc.server_default.command]] *irc.server_default.command*
** Beschreibung: pass:none[Befehl(e) welche nach einem Verbindungsaufbau zum Server und vor dem automatischem Betreten von Kanälen ausgeführt werden sollen (mehrere Befehle können durch ";" getrennt werden, will man ein Semikolon nutzen, schreibt man "\;", die Platzhalter $nick,$channel und $server werden durch den entsprechenden Wert ersetzt) (Hinweis: Inhalt wird evaluiert, siehe /help eval; Serveroptionen sind mittels ${irc_server.xxx} evaluiert und ${server} wird durch den eigentlichen Servernamen ersetzt)]
** Beschreibung: pass:none[Befehl(e) welche nach einem Verbindungsaufbau zum Server und vor dem automatischem Betreten von Channels ausgeführt werden sollen (mehrere Befehle müssen durch ";" getrennt werden, soll ein Semikolon genutzt werden, schreibt man "\;", die Platzhalter $nick,$channel und $server werden durch den entsprechenden Wert ersetzt) (Hinweis: Inhalt wird evaluiert, siehe /help eval; Serveroptionen sind mittels ${irc_server.xxx} evaluiert und ${server} wird durch den eigentlichen Servernamen ersetzt)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
* [[option_irc.server_default.command_delay]] *irc.server_default.command_delay*
** Beschreibung: pass:none[Wartezeit (in Sekunden) nach Ausführung des Befehls und bevor Kanäle automatisch betreten werden (Beispiel: es wird eine gewisse Zeit gewartet, um eine Authentifizierung zu ermöglichen)]
** Beschreibung: pass:none[Wartezeit (in Sekunden) nach Ausführung des Befehls und bevor Channels automatisch betreten werden (Beispiel: es wird eine gewisse Zeit gewartet, um eine Authentifizierung zu ermöglichen)]
** Typ: integer
** Werte: 0 .. 3600
** Standardwert: `+0+`
@@ -2694,12 +2616,6 @@
** Werte: 1 .. 3600
** Standardwert: `+60+`
* [[option_irc.server_default.default_chantypes]] *irc.server_default.default_chantypes*
** Beschreibung: pass:none[Kanal-Typ-Präfix, die verwendet werden sollen, wenn der Server diese nicht in Nachricht 005 sendet (Standard ist "#&")]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"#&"+`
* [[option_irc.server_default.ipv6]] *irc.server_default.ipv6*
** Beschreibung: pass:none[bei der Kommunikation mit dem Server wird das IPv6 Protokoll genutzt (sollte IPv6 nicht verfügbar sein dann wird automatisch auf IPv4 umgeschaltet); wird die Funktion deaktiviert, dann wird ausschließlich IPv4 genutzt]
** Typ: boolesch
@@ -2713,7 +2629,7 @@
** Standardwert: `+""+`
* [[option_irc.server_default.msg_kick]] *irc.server_default.msg_kick*
** Beschreibung: pass:none[Standardmitteilung einer kick-Nachricht, für die Befehle "/kick" und "/kickban" (Hinweis: Inhalt wird evaluiert, siehe /help eval; besondere Variablen ${nick} (eigener Nick), ${target} (betroffener Nick), ${channel} und ${server}, werden durch den entsprechenden Wert ersetzt)]
** Beschreibung: pass:none[Standardmitteilung einer kick-Nachricht, für die Befehle "/kick" und "/kickban" (Hinweis: Inhalt wird evaluiert, siehe /help eval; Variablen die genutzt werden können: ${nick}, ${channel} und ${server})]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2773,15 +2689,15 @@
** Standardwert: `+continue+`
* [[option_irc.server_default.sasl_key]] *irc.server_default.sasl_key*
** Beschreibung: pass:none[Datei mit privatem ECC-Schlüssel für den Mechanismus "ecdsa-nist256p-challenge" (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Beschreibung: pass:none[Datei mit privatem ECC Schlüssel für den "ecdsa-nist256p-challenge" Mechanismus ("%h" wird durch das WeeChat Verzeichnis ersetzt, standardmäßig "~/.weechat")]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
* [[option_irc.server_default.sasl_mechanism]] *irc.server_default.sasl_mechanism*
** Beschreibung: pass:none[Verfahren welches bei einer SASL Authentifizierung angewandt werden soll: "plain" Passwort wird im Klartext gesendet, "scram-sha-1" für SCRAM-Authentifizierung mit SHA-1-Digest-Algorithmus, "scram-sha-256" für SCRAM-Authenrifizierung mit SHA-256 Digest-Algorithmus, "scram-sha-512" für SCRAM-Authentifizierung mit SHA-512 Digest-Algorithmus, "ecdsa-nist256p-challenge" für öffentlich/private Schlüsselmethode, "external" SSL Zertifikat welches auf Client Seite vorliegt wird verwendet, "dh-blowfish" Passwort wird mittels blowfish verschlüsselt (unsicher, wird nicht empfohlen), "dh-aes" Passwort wird mittels AES verschlüsselt (unsicher, wird nicht empfohlen)]
** Beschreibung: pass:none[Verfahren welches bei einer SASL Authentifizierung angewandt werden soll: "plain" Passwort wird im Klartext gesendet, "ecdsa-nist256p-challenge" für öffentlich/private Schlüsselmethode, "external" SSL Zertifikat welches auf Client Seite vorliegt wird verwendet, "dh-blowfish" Passwort wird mittels blowfish verschlüsselt (unsicher, wird nicht empfohlen), "dh-aes" Passwort wird mittels AES verschlüsselt (unsicher, wird nicht empfohlen)]
** Typ: integer
** Werte: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** Werte: plain, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** Standardwert: `+plain+`
* [[option_irc.server_default.sasl_password]] *irc.server_default.sasl_password*
@@ -2815,7 +2731,7 @@
** Standardwert: `+off+`
* [[option_irc.server_default.ssl_cert]] *irc.server_default.ssl_cert*
** Beschreibung: pass:none[SSL-Zertifikatdatei zur automatischen Identifizierung Ihres Nick (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Beschreibung: pass:none[Datei für SSL Zertifikat um automatisch den eigenen Nick zu identifizieren ("%h" wird durch das WeeChat Verzeichnis ersetzt, Standardverzeichnis: "~/.weechat")]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2851,7 +2767,7 @@
** Standardwert: `+on+`
* [[option_irc.server_default.usermode]] *irc.server_default.usermode*
** Beschreibung: pass:none[Usermode(s) der direkt nach der Verbindung zum Server gesetzt werden soll. Dies geschieht bevor Befehle für den Server ausgeführt und bevor Kanäle automatisch betreten werden; Beispiele: "+R" (um den Modus "R" zu setzen), "+R-i" (setzt den Modus "R" und entfernt den Modus "i"); siehe /help mode um den Befehlssatz angezeigt zu bekommen (Hinweis: Inhalt wird evaluiert, siehe /help eval; Serveroptionen sind mittels ${irc_server.xxx} evaluiert und ${server} wird durch den eigentlichen Servernamen ersetzt)]
** Beschreibung: pass:none[Usermode(s) der direkt nach der Verbindung zum Server gesetzt werden soll. Dies geschieht bevor Befehle für den Server ausgeführt und bevor Channels automatisch betreten werden; Beispiele: "+R" (um den Modus "R" zu setzen), "+R-i" (setzt den Modus "R" und entfernt den Modus "i"); siehe /help mode um den Befehlssatz angezeigt zu bekommen (Hinweis: Inhalt wird evaluiert, siehe /help eval; Serveroptionen sind mittels ${irc_server.xxx} evaluiert und ${server} wird durch den eigentlichen Servernamen ersetzt)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2919,13 +2835,13 @@
** Standardwert: `+white+`
* [[option_relay.irc.backlog_max_minutes]] *relay.irc.backlog_max_minutes*
** Beschreibung: pass:none[Zeitangabe, in Minuten, wie lange die Zeilen im Verlaufsspeicher für jeden IRC Kanal gehalten werden sollen (0 = unbegrenzt, Beispiele: 1440 = einen Tag, 10080 = eine Woche, 43200 = einen Monat, 525600 = ein Jahr)]
** Beschreibung: pass:none[Zeitangabe, in Minuten, wie lange die Zeilen im Verlaufsspeicher für jeden IRC Channel gehalten werden sollen (0 = unbegrenzt, Beispiele: 1440 = einen Tag, 10080 = eine Woche, 43200 = einen Monat, 525600 = ein Jahr)]
** Typ: integer
** Werte: 0 .. 2147483647
** Standardwert: `+0+`
* [[option_relay.irc.backlog_max_number]] *relay.irc.backlog_max_number*
** Beschreibung: pass:none[maximale Anzahl an Zeilen im Verlaufsspeicher. Dies gilt für jeden IRC Kanal (0: keine Zeilenbegrenzung)]
** Beschreibung: pass:none[maximale Anzahl an Zeilen im Verlaufsspeicher. Dies gilt für jeden IRC Channel (0: keine Zeilenbegrenzung)]
** Typ: integer
** Werte: 0 .. 2147483647
** Standardwert: `+1024+`
@@ -2943,7 +2859,7 @@
** Standardwert: `+off+`
* [[option_relay.irc.backlog_tags]] *relay.irc.backlog_tags*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Nachrichten-Tags welche im Verlaufsspeicher von IRC Kanälen angezeigt werden (unterstützte Tags: "irc_join", "irc_part", "irc_quit", "irc_nick", "irc_privmsg"), "*" = alle unterstützten Tags]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Nachrichten-Tags welche im Verlaufsspeicher von IRC Channels angezeigt werden (unterstützte Tags: "irc_join", "irc_part", "irc_quit", "irc_nick", "irc_privmsg"), "*" = alle unterstützten Tags]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"irc_privmsg"+`
@@ -3039,10 +2955,10 @@
** Standardwert: `+100000+`
* [[option_relay.network.ssl_cert_key]] *relay.network.ssl_cert_key*
** Beschreibung: pass:none[Datei mit SSL-Zertifikat und privatem Schlüssel (zum Bedienen von Clients mit SSL) (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Beschreibung: pass:none[Datei mit SSL Zertifikat und privatem Schlüssel (zur Nutzung von Clients mit SSL)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"${weechat_config_dir}/ssl/relay.pem"+`
** Standardwert: `+"%h/ssl/relay.pem"+`
* [[option_relay.network.ssl_priorities]] *relay.network.ssl_priorities*
** Beschreibung: pass:none[Zeichenkette mit Prioritäten für gnutls (für die korrekte Syntax siehe gnutls Dokumentation unter Funktion gnutls_priority_init. Gebräuchliche Zeichenketten sind: "PERFORMANCE", "NORMAL", "SECURE128", "SECURE256", "EXPORT", "NONE")]
@@ -3345,7 +3261,7 @@
** Standardwert: `+lightmagenta+`
* [[option_script.look.columns]] *script.look.columns*
** Beschreibung: pass:none[Format in welchem die Spalten im Skript-Buffer dargestellt werden sollen. Es können folgende Spaltenbezeichnungen genutzt werden: %a=Autor, %d=Beschreibung, %D=Skript hinzugefügt, %e=Dateierweiterung, %l=Programmiersprache, %L=Lizenz, %n=Skriptname, mit Dateierweiterung, %N=Skriptname, %r=Voraussetzungen, %s=Status, %t=Schlagwörter, %u=Datum der letzten Überarbeitung, %v=Version, %V=installierte Version, %w=min_WeeChat_Version, %W=max_WeeChat_Version)]
** Beschreibung: pass:none[Format in welchem die Spalten im Skript Buffer dargestellt werden sollen. Es können folgende Spaltenbezeichnungen genutzt werden: %a=Autor, %d=Beschreibung, %D=hinzugefügt, %e=Dateierweiterung, %l=Programmiersprache, %L=Lizenz, %n=Skriptname, mit Dateierweiterung, %N=Skriptname, %r=Voraussetzungen, %s=Status, %t=Schlagwörter, %u=Datum der letzten Überarbeitung, %v=Version, %V=installierte Version, %w=min_WeeChat_Version, %W=max_WeeChat_Version)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%s %n %V %v %u | %d | %t"+`
@@ -3423,10 +3339,10 @@
** Standardwert: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
** Beschreibung: pass:none[lokales Cache-Verzeichnis für Skripten (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Beschreibung: pass:none[lokales Cache-Verzeichnis für die Script-Erweiterung; "%h" wird durch das WeeChat Verzeichnis ersetzt (Standardpfad: "~/.weechat") (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"${weechat_cache_dir}/script"+`
** Standardwert: `+"%h/script"+`
* [[option_script.scripts.url]] *script.scripts.url*
** Beschreibung: pass:none[URL für Datei mit der Auflistung aller Skripten]
+3 -2
View File
@@ -16,8 +16,9 @@
"--daemon").
*-d*, *--dir* _<path>_::
Erzwingen Sie ein einzelnes Verzeichnis für alle WeeChat-Dateien (Verzeichnis wird erstellt, wenn es nicht gefunden wird).
Es können vier Verzeichnisse angegeben werden, die durch Doppelpunkte getrennt sind (folgende Reihenfolge: Konfiguration, Daten, Cache, Laufzeit).
legt den Konfigurationsordner für WeeChat fest in welchem die Erweiterungen,
Skripten, Protokolldateien etc.pp. gesichert werden (Voreinstellung: "~/.weechat").
Sollte das Verzeichnis nicht existieren wird es beim Start angelegt.
Wird diese Option nicht genutzt, wird die Umgebungsvariable WEECHAT_HOME genutzt
(sofern diese vorhanden ist).
+27 -27
View File
@@ -9,7 +9,7 @@ indem man eine URL verwendet:
Um dem WeeChat IRC Support-Channel, mit dem Nick "mynick", beizutreten:
irc://mynick@irc.libera.chat/#weechat
irc://mynick@chat.freenode.net/#weechat
Um eine IPv6 Adresse zu nutzen, muss diese in eckige Klammern gesetzt werden:
@@ -17,79 +17,79 @@ Um eine IPv6 Adresse zu nutzen, muss diese in eckige Klammern gesetzt werden:
// end::plugin_options[]
// tag::files[]
$HOME/.config/weechat/weechat.conf::
$HOME/.weechat/weechat.conf::
WeeChats Konfigurationsdatei
$HOME/.config/weechat/plugins.conf::
$HOME/.weechat/plugins.conf::
Konfigurationsdatei für Erweiterungen
$HOME/.config/weechat/sec.conf::
$HOME/.weechat/sec.conf::
Konfigurationsdatei mit schutzwürdigen Daten
$HOME/.config/weechat/alias.conf::
$HOME/.weechat/alias.conf::
Konfigurationsdatei für _alias_ Erweiterung
$HOME/.config/weechat/buflist.conf::
$HOME/.weechat/buflist.conf::
Konfigurationsdatei für _buflist_ Erweiterung
$HOME/.config/weechat/charset.conf::
$HOME/.weechat/charset.conf::
Konfigurationsdatei für _charset_ Erweiterung
$HOME/.config/weechat/exec.conf::
$HOME/.weechat/exec.conf::
Konfigurationsdatei für _exec_ Erweiterung
$HOME/.config/weechat/fifo.conf::
$HOME/.weechat/fifo.conf::
Konfigurationsdatei für _fifo_ Erweiterung
$HOME/.config/weechat/fset.conf::
$HOME/.weechat/fset.conf::
Konfigurationsdatei für _fset_ Erweiterung
$HOME/.config/weechat/guile.conf::
$HOME/.weechat/guile.conf::
Konfigurationsdatei für _guile_ Erweiterung
$HOME/.config/weechat/irc.conf::
$HOME/.weechat/irc.conf::
Konfigurationsdatei für _irc_ Erweiterung
$HOME/.config/weechat/javascript.conf::
$HOME/.weechat/javascript.conf::
Konfigurationsdatei für _javascript_ Erweiterung
$HOME/.config/weechat/logger.conf::
$HOME/.weechat/logger.conf::
Konfigurationsdatei für _logger_ Erweiterung
$HOME/.config/weechat/lua.conf::
$HOME/.weechat/lua.conf::
Konfigurationsdatei für _lua_ Erweiterung
$HOME/.config/weechat/perl.conf::
$HOME/.weechat/perl.conf::
Konfigurationsdatei für _perl_ Erweiterung
$HOME/.config/weechat/php.conf::
$HOME/.weechat/php.conf::
Konfigurationsdatei für _php_ Erweiterung
$HOME/.config/weechat/python.conf::
$HOME/.weechat/python.conf::
Konfigurationsdatei für _python_ Erweiterung
$HOME/.config/weechat/relay.conf::
$HOME/.weechat/relay.conf::
Konfigurationsdatei für _relay_ Erweiterung
$HOME/.config/weechat/ruby.conf::
$HOME/.weechat/ruby.conf::
Konfigurationsdatei für _ruby_ Erweiterung
$HOME/.config/weechat/script.conf::
$HOME/.weechat/script.conf::
Konfigurationsdatei für _script_ Erweiterung
$HOME/.config/weechat/spell.conf::
$HOME/.weechat/spell.conf::
Konfigurationsdatei für _spell_ Erweiterung
$HOME/.config/weechat/tcl.conf::
$HOME/.weechat/tcl.conf::
Konfigurationsdatei für _tcl_ Erweiterung
$HOME/.config/weechat/trigger.conf::
$HOME/.weechat/trigger.conf::
Konfigurationsdatei für _trigger_ Erweiterung
$HOME/.config/weechat/xfer.conf::
$HOME/.weechat/xfer.conf::
Konfigurationsdatei für _xfer_ Erweiterung
$HOME/.local/share/weechat/weechat.log::
$HOME/.weechat/weechat.log::
WeeChat Protokolldatei
// end::files[]
@@ -97,7 +97,7 @@ $HOME/.local/share/weechat/weechat.log::
WeeChat wird programmiert von Sébastien Helleu und weiteren Beteiligten (eine vollständige Auflistung
findet man in der AUTHORS.adoc Datei).
Copyright (C) 2003-2021 {author}
Copyright (C) 2003-2020 {author}
WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
+34 -61
View File
@@ -249,31 +249,6 @@ Die Tasten "meta-OP" und "meta-OQ" können im Hinblick auf das jeweils genutzte
Um die korrekten Tasten zu finden, sollte man mit kbd:[Alt+k] die gewünschte Tastenkombination einfangen.
Siehe auch: link:weechat_user.de.html#key_bindings_command_line[Benutzerhandbuch / Tastenbelegung].
[[customize_buflist]]
=== Wie kann ich die Darstellung der Bufferliste anpassen, z.B. die Farbe des aktiven Buffers?
Mit folgendem Befehl können alle Optionen der Buflist angezeigt werden:
----
/fset buflist
----
Die Hintergrundfarbe des aktiven Buffers ist standardmäßig blau. Sie können diese
Farbe folgendermaßen ändern, z.B. in "red":
----
/set buflist.format.buffer_current "${color:,red}${format_buffer}"
----
[NOTE]
Vor dem Farbnamen "red" steht ein Komma, da die Farbe als Hintergrund und nicht als Textfarbe verwendet wird. +
Es kann auch eine beliebige numerische Farbe anstelle von "Rot" verwendet werden, z. B. "237" für Dunkelgrau.
Die Buflist-Erweiterung bietet viele Optionen, zum individualisieren. Bitte lesen Sie dazu die Hilfe von jeder Option.
Es gibt auch eine Wiki-Seite mit Beispielen, wie eine erweiterte Konfiguration aussehen kann:
https://github.com/weechat/weechat/wiki/buflist
[[customize_prefix]]
=== Wie kann ich die Länge eines Nicknamens begrenzen oder die Ausrichtung des Nicks im Chatbereich entfernen?
@@ -775,8 +750,7 @@ anstelle der kbd:[Shift]-Taste gedrückt werden).
Falls macOS genutzt wird,
muss mittels Homebrew `openssl` installiert werden.
Eine CA-Datei wird mittels Zertifikaten vom Systemschlüssel geladen.
Ab WeeChat ≤ 3.1 können Sie den Pfad zu Systemzertifikaten festlegen:
Der Pfad zu den Zertifikaten kann in WeeChat eingestellt werden:
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@@ -818,11 +792,10 @@ Im folgenden Beispiel muss "xxx" durch den betroffenen Servernamen ersetzt werde
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
----
[[irc_ssl_libera]]
=== Wie kann ich eine SSL gesicherte Verbindung zum libera Server herstellen?
[[irc_ssl_freenode]]
=== Wie kann ich eine SSL gesicherte Verbindung zum freenode Server herstellen?
Ab WeeChat ≤ 3.1 kann mit der Option _weechat.network.gnutls_ca_file_ eine Datei mit
Zertifikaten ausgewählt werden:
Die Option _weechat.network.gnutls_ca_file_ sollte auf die Zertifikationsdatei zeigen:
----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
@@ -842,9 +815,9 @@ dass die Zertifikate in einer anderen Datei bereitgestellt werden:
Konfiguration des Servers, Port angeben, SSL aktivieren und Verbindung herstellen:
----
/set irc.server.libera.addresses "irc.libera.chat/6697"
/set irc.server.libera.ssl on
/connect libera
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
----
[[irc_oauth]]
@@ -871,8 +844,8 @@ ist es ratsam auf diese Funktion zurückzugreifen
und sich nicht mittels "nickserv" zu authentifizieren:
----
/set irc.server.libera.sasl_username "meinNick"
/set irc.server.libera.sasl_password "xxxxxxx"
/set irc.server.freenode.sasl_username "meinNick"
/set irc.server.freenode.sasl_password "xxxxxxx"
----
Unterstützt der Server keine SASL Authentifizierung,
@@ -880,7 +853,7 @@ kann eine Verzögerung aktiviert werden,
um sich vor dem Betreten von Channels bei "nickserv" zu identifizieren:
----
/set irc.server.libera.command_delay 5
/set irc.server.freenode.command_delay 5
----
[[edit_autojoin]]
@@ -888,10 +861,10 @@ um sich vor dem Betreten von Channels bei "nickserv" zu identifizieren:
Um die Liste der autojoin Channels zu editieren,
kann der Befehl `/set` genutzt werden.
In folgendem Beispiel wird der "libera"-Server angepasst:
In folgendem Beispiel wird der "freenode"-Server angepasst:
----
/set irc.server.libera.autojoin [TAB]
/set irc.server.freenode.autojoin [TAB]
----
[NOTE]
@@ -1091,16 +1064,16 @@ das Skript _buffer_autoset.py_ nutzen:
----
Um zum Beispiel Highlights (Hervorhebungen) von Nick "mike" im Channel
#weechat auf dem IRC Server libera zu deaktivieren:
#weechat auf dem IRC Server freenode zu deaktivieren:
----
/buffer_autoset add irc.libera.#weechat hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2
----
Um dies auf den kompletten libera Server anzuwenden:
Um dies auf den kompletten freenode Server anzuwenden:
----
/buffer_autoset add irc.libera hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2
----
Für weitere Beispiele, siehe `+/help buffer_autoset+`.
@@ -1138,18 +1111,16 @@ Die Skripten für WeeChat sind mit anderen IRC-Clients nicht kompatibel und vice
[[scripts_update]]
=== Der Befehl "/script update" liest die Skriptliste nicht ein, wie kann ich das beheben?
Als erstes sollte das Kapitel über SSL Verbindungen in dieser FAQ gelesen werden.
Als erstes sollte das Kapitel über SSL Verbindungen in dieser FAQ gelesen werden
(besonders über die Option _weechat.network.gnutls_ca_file_).
Wenn das nicht hilft, sollte die Skriptliste von Hand gelöscht werden. Dazu
folgenden Befehl in der Shell ausführen:
----
$ rm ~/.cache/weechat/script/plugins.xml.gz
$ rm ~/.weechat/script/plugins.xml.gz
----
[NOTE]
Ab WeeChat ≤ 3.1, sollte der Pfad: _~/.weechat/script/plugins.xml.gz_ lauten.
Danach sollte man noch einmal versuchen die Datei herunter zu laden:
----
@@ -1169,7 +1140,7 @@ Das bedeutet aber auch, dass die Skripten von Hand aktuell gehalten werden müss
* und in der Shell, mit installiertem curl:
----
$ cd ~/.cache/weechat/script
$ cd ~/.weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
----
@@ -1221,8 +1192,9 @@ Damit WeeChat weniger Speicher benötigt, solltest Du folgende Tipps umsetzen:
Fifo, Logger, Perl, Python, Ruby, Lua, Tcl, Guile, JavaScript, PHP, Spell, Xfer
(wird für DCC benötigst), siehe `/help weechat.plugin.autoload`.
* installiere ausschließlich Skripten die Du auch nutzt
* Laden Sie keine Systemzertifikate, wenn SSL *NICHT* verwendet wird: Deaktivieren Sie diese Option:
_weechat.network.gnutls_ca_system_.
* falls man SSL *NICHT* nutzt, sollte kein Zertifikat geladen werden. In diesem
Fall, einfach den Eintrag in folgender Option leer lassen:
_weechat.network.gnutls_ca_file_
* der Wert der Option _weechat.history.max_buffer_lines_number_ sollte möglichst
niedrig eingestellt werden oder die Option _weechat.history.max_buffer_lines_minutes_
verwendet werden.
@@ -1281,20 +1253,22 @@ Beispiel:
----
/secure passphrase xxxxxxxxxx
/secure set libera_username username
/secure set libera_password xxxxxxxx
/set irc.server.libera.sasl_username "${sec.data.libera_username}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
/secure set freenode_username username
/secure set freenode_password xxxxxxxx
/set irc.server.freenode.sasl_username "${sec.data.freenode_username}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
----
[[sharing_config_files]]
=== Ich möchte meine WeeChat Konfiguration teilen. Welche Dateien kann ich weitergeben und welche sollte ich behalten?
Sie können Ihre _*.conf_ Konfigurationsdateien teilen, mit Ausnahme der Datei _sec.conf_, die Ihre mit
Ihrer Passphrase verschlüsselten Kennwörter enthält.
Es können alle _~/.weechat/*.conf_ Dateien geteilt werden.
Hiervon ausgenommen ist die Datei _sec.conf_,
die durch eine Passphrase verschlüsselte sensible Daten enthalten kann.
Einige andere Dateien enthalten möglicherweise vertrauliche Informationen wie
Kennwörter (sofern sie nicht mit dem Befehl `/secure` in _sec.conf_ gesichert werden).
In einigen Dateien wie _irc.conf_ können sensible Daten,
z.B. Passwörter für Server oder Channels im Klartext hinterlegt sein.
(Das heißt, insofern diese nicht mit Hilfe des Befehls `/secure` verschlüsselt in der Datei _sec.conf_ gesichert wurden).
Siehe link:weechat_user.de.html#files_and_directories[Benutzerhandbuch / Dateien und Verzeichnisse]
für weitere Informationen über Konfigurationsdateien.
@@ -1330,8 +1304,7 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /Pfad/zu/weechat
[[supported_os]]
=== Auf welchen Plattformen läuft WeeChat und wird es noch auf andere Betriebssysteme portiert?
WeeChat läuft auf den meisten Linux/BSD-Distributionen, GNU/Hurd, Mac OS und
Windows (Cygwin und Windows Subsystem für Linux) einwandfrei.
Eine vollständige Liste der Portierungen findest Du unter: https://weechat.org/download.
Wir geben unser Bestes, WeeChat auf möglichst viele Plattformen zu portieren.
Deshalb ist jede Hilfe gerne gesehen, die es uns ermöglicht,
+32 -25
View File
@@ -123,13 +123,13 @@ Um eine Verbindung zu einem IRC Server herzustellen, wird der
`/server` Befehl verwendet. Beispiel:
----
/server add libera irc.libera.chat/6697 -ssl
/server add freenode chat.freenode.net
----
In diesem Beispiel ist `libera` der interne, von Weechat genutzte Servername.
Mit dem Befehl `/connect libera` kann jetzt die Verbindung
zu diesem Libera-IRC-Server aufgebaut werden.
Alle für den Server relevanten Optionen sind unter _irc.server.libera.xxx_ zu finden.
In diesem Beispiel ist `freenode` der interne, von Weechat genutzte Servername.
Mit dem Befehl `/connect freenode` kann jetzt die Verbindung
zu diesem Freenode-IRC-Server aufgebaut werden.
Alle für den Server relevanten Optionen sind unter _irc.server.freenode.xxx_ zu finden.
Verwende die Hilfe, falls noch Fragen offen sind:
@@ -149,24 +149,31 @@ definiert ist (nicht "null"). Andernfalls verwendet WeeChat die Vorgabewerte
(_irc.server_default.xxx_).
Beispielsweise werden Standard Nicks verwendet (basierend auf dem Un*x Login).
Sollen speziell für den libera-Server andere Nicks genutzt werden,
Sollen speziell für den freenode-Server andere Nicks genutzt werden,
können diese mit folgendem Befehl angepasst werden:
----
/set irc.server.libera.nicks "meinNick,meinNick2,meinNick3,meinNick4,meinNick5"
/set irc.server.freenode.nicks "meinNick,meinNick2,meinNick3,meinNick4,meinNick5"
----
Benutzernamen und wirklichen Namen (realname) anpassen:
----
/set irc.server.libera.username "Mein Benutzername"
/set irc.server.libera.realname "Mein wirklicher Name"
/set irc.server.freenode.username "Mein Benutzername"
/set irc.server.freenode.realname "Mein wirklicher Name"
----
Beim Start von WeeChat automatisch die Verbindung zu einem Server herstellen:
----
/set irc.server.libera.autoconnect on
/set irc.server.freenode.autoconnect on
----
Beim Verbindungsaufbau SSL (sichere Verbindung) nutzen:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
----
Wenn der Server SASL unterstützt,
@@ -175,8 +182,8 @@ Der Benutzer wird auf diese Weise gegenüber dem IRC-Server identifiziert,
noch bevor Server-Befehle übermittelt oder Cannels (Chaträume) betreten werden können.
----
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
----
Wenn der Server keine SASL-Authentifizierung unterstützt,
@@ -184,7 +191,7 @@ muss der Benutzer sich nach dem Verbindungsaufbau bei "nickserv" identifizieren.
Der dafür notwendige IRC-Server-Befehl kann auch automatisch übermittelt werden:
----
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -200,19 +207,19 @@ Zuerst sollte die Passphrase gesetzt werden:
----
Jetzt wird das Passwort (`xxxxxx`)
für den Zugang zum Libera-Server verschlüsselt
und mit dem Bezeichner `libera_password` verknüpft:
für den Zugang zum Freenode-Server verschlüsselt
und mit dem Bezeichner `freenode_password` verknüpft:
----
/secure set libera_password xxxxxx
/secure set freenode_password xxxxxx
----
Das geschützte Libera-Passwort kann nun in anderen Optionen genutzt werden.
Das geschützte Freenode-Passwort kann nun in anderen Optionen genutzt werden.
Dazu wird anstelle des Klartext-Passwortes die Variable
`+${sec.data.libera_password}+` eingesetzt:
`+${sec.data.freenode_password}+` eingesetzt:
----
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
----
Das automatische Betreten (auto-join) von Channels (Chaträume) direkt nach dem
@@ -220,7 +227,7 @@ Verbindungsaufbau zum IRC-Server kann durch den Eintrag der gewünschten Channel
in folgender Option erreicht werden:
----
/set irc.server.libera.autojoin "#channel1,#channel2"
/set irc.server.freenode.autojoin "#channel1,#channel2"
----
[TIP]
@@ -232,28 +239,28 @@ sein kann).
Mit dem Befehl `/unset` können Server-Optionen zurückgesetzt werden.
Ist eine Server-Option zurückgesetzt, _wirkt_ der entsprechende Vorgabewert
aus dem fall-back-Bereich `irc.server_default.xxx`. So nimmt, beispielsweise
nach dem Rücksetzen der Libera-Nicks, diese Server-Option _automatisch_ den Wert
nach dem Rücksetzen der Freenode-Nicks, diese Server-Option _automatisch_ den Wert
der entsprechenden fall-back-Option `irc.server_default.nicks` an:
----
/unset irc.server.libera.nicks
/unset irc.server.freenode.nicks
----
*Andere Optionen:*
Werte anderer Server-Optionen (`xxx`) können festgelegt werden mit:
----
/set irc.server.libera.xxx Wert
/set irc.server.freenode.xxx Wert
----
[[connect_to_irc_server]]
== Verbinden mit dem IRC-Server
----
/connect libera
/connect freenode
----
Mittels obigem Befehl stellt WeeChat eine Verbindung zum libera Server
Mittels obigem Befehl stellt WeeChat eine Verbindung zum freenode Server
her und betritt automatisch die Kanäle die in der "autojoin" Server-Option
aufgeführt sind.
+67 -91
View File
@@ -72,18 +72,13 @@ und die Dokumentation für die Funktion `+hook_process+` in link:weechat_plugin_
[[languages_specificities]]
=== Besonderheiten der einzelnen Skriptsprachen
[[language_python]]
==== Python
[[python_module]]
===== Module
WeeChat definiert ein `weechat` Module welches mittels `import weechat`
importiert werden muss. +
Ein Python-Stub für die WeeChat-API ist im Repository verfügbar:
https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi].
importiert werden muss.
[[python_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+weechat.xxx(arg1, arg2, ...)+`.
@@ -91,7 +86,6 @@ Funktionen werden aufgerufen mittels `+weechat.xxx(arg1, arg2, ...)+`.
Die Funktionen `+print*+` werden bei python durch `+prnt*+` ersetzt
(`print` war ein reserviertes Schlüsselwort unter Python 2).
[[python_strings]]
===== In Callbacks empfangene Zeichen
Mit Python 3 und WeeChat ≥ 2.7 sind die Zeichenketten in Callbacks
@@ -148,23 +142,18 @@ Mit Python 2, das mittlerweile veraltet ist und nicht mehr verwendet werden soll
Zeichenkette die an die Callbacks gesendet wird immer vom Typ `str` und kann deshalb bei den
oben genannten Fällen, ungültige UTF-8 Daten enthalten.
[[language_perl]]
==== Perl
[[perl_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+weechat::xxx(arg1, arg2, ...);+`.
[[language_ruby]]
==== Ruby
[[ruby_init]]
===== Initialization
Es muss _weechat_init_ definiert werden und darin dann _register_ ausgeführt werden.
[[ruby_functions]]
===== Functions
Funktionen werden aufgerufen mittels `+Weechat.xxx(arg1, arg2, ...)+`.
@@ -189,26 +178,20 @@ Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical"
["default", "default", "default", "default"], "0", "items")
----
[[language_lua]]
==== Lua
[[lua_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+weechat.xxx(arg1, arg2, ...)+`.
[[language_tcl]]
==== Tcl
[[tcl_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+weechat::xxx arg1 arg2 ...+`.
[[language_guile]]
==== Guile (Scheme)
[[guile_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+(weechat:xxx arg1 arg2 ...)+`.
@@ -221,18 +204,14 @@ für andere Funktionen), da die Anzahl der Argumente die zulässige Anzahl in Gu
* config_new_option
* bar_new
[[language_javascript]]
==== JavaScript
[[javascript_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+weechat.xxx(arg1, arg2, ...);+`.
[[language_php]]
==== PHP
[[php_functions]]
===== Functions
Funktionen werden aufgerufen mittels `+weechat_xxx(arg1, arg2, ...);+`.
@@ -243,11 +222,11 @@ Funktionen werden aufgerufen mittels `+weechat_xxx(arg1, arg2, ...);+`.
Ein WeeChat-Skript muss sich bei WeeChat "registrieren". Dazu muss das Skript
zuerst die "register" Funktion ausführen.
Prototyp (Python):
Prototyp:
[source,python]
----
def register(name: str, author: str, version: str, license: str, description: str, shutdown_function: str, charset: str) -> int: ...
weechat.register(Name, Author, Version, Lizenz, Beschreibung, Shutdown_Funktion, Zeichensatz)
----
Argumente:
@@ -370,7 +349,7 @@ anlegen, der in das Verzeichnis _Skriptsprache/autoload_ zeigt.
Ein Beispiel für ein Python-Skript:
----
$ cd ~/.local/share/weechat/python/autoload
$ cd ~/.weechat/python/autoload
$ ln -s ../script.py
----
@@ -813,58 +792,58 @@ Liste der Konstanten in Skript API:
| Kategorie | Konstanten
| return codes |
`WEECHAT_RC_OK` (integer) +
`WEECHAT_RC_OK_EAT` (integer) +
`WEECHAT_RC_ERROR` (integer)
WEECHAT_RC_OK +
WEECHAT_RC_OK_EAT +
WEECHAT_RC_ERROR
| Konfigurationsdatei |
`WEECHAT_CONFIG_READ_OK` (integer) +
`WEECHAT_CONFIG_READ_MEMORY_ERROR` (integer) +
`WEECHAT_CONFIG_READ_FILE_NOT_FOUND` (integer) +
`WEECHAT_CONFIG_WRITE_OK` (integer) +
`WEECHAT_CONFIG_WRITE_ERROR` (integer) +
`WEECHAT_CONFIG_WRITE_MEMORY_ERROR` (integer) +
`WEECHAT_CONFIG_OPTION_SET_OK_CHANGED` (integer) +
`WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE` (integer) +
`WEECHAT_CONFIG_OPTION_SET_ERROR` (integer) +
`WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_RESET` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_ERROR` (integer)
WEECHAT_CONFIG_READ_OK +
WEECHAT_CONFIG_READ_MEMORY_ERROR +
WEECHAT_CONFIG_READ_FILE_NOT_FOUND +
WEECHAT_CONFIG_WRITE_OK +
WEECHAT_CONFIG_WRITE_ERROR +
WEECHAT_CONFIG_WRITE_MEMORY_ERROR +
WEECHAT_CONFIG_OPTION_SET_OK_CHANGED +
WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE +
WEECHAT_CONFIG_OPTION_SET_ERROR +
WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND +
WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET +
WEECHAT_CONFIG_OPTION_UNSET_OK_RESET +
WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED +
WEECHAT_CONFIG_OPTION_UNSET_ERROR
| sortierte Listen |
`WEECHAT_LIST_POS_SORT` (string) +
`WEECHAT_LIST_POS_BEGINNING` (string) +
`WEECHAT_LIST_POS_END` (string)
WEECHAT_LIST_POS_SORT +
WEECHAT_LIST_POS_BEGINNING +
WEECHAT_LIST_POS_END
| Hotlist |
`WEECHAT_HOTLIST_LOW` (string) +
`WEECHAT_HOTLIST_MESSAGE` (string) +
`WEECHAT_HOTLIST_PRIVATE` (string) +
`WEECHAT_HOTLIST_HIGHLIGHT` (string)
WEECHAT_HOTLIST_LOW +
WEECHAT_HOTLIST_MESSAGE +
WEECHAT_HOTLIST_PRIVATE +
WEECHAT_HOTLIST_HIGHLIGHT
| hook Prozesse |
`WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
`WEECHAT_HOOK_PROCESS_ERROR` (integer)
WEECHAT_HOOK_PROCESS_RUNNING +
WEECHAT_HOOK_PROCESS_ERROR
| hook Connect |
`WEECHAT_HOOK_CONNECT_OK` (integer) +
`WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND` (integer) +
`WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND` (integer) +
`WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED` (integer) +
`WEECHAT_HOOK_CONNECT_PROXY_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_MEMORY_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_TIMEOUT` (integer) +
`WEECHAT_HOOK_CONNECT_SOCKET_ERROR` (integer)
WEECHAT_HOOK_CONNECT_OK +
WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND +
WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND +
WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED +
WEECHAT_HOOK_CONNECT_PROXY_ERROR +
WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR +
WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR +
WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR +
WEECHAT_HOOK_CONNECT_MEMORY_ERROR +
WEECHAT_HOOK_CONNECT_TIMEOUT +
WEECHAT_HOOK_CONNECT_SOCKET_ERROR
| hook Signal |
`WEECHAT_HOOK_SIGNAL_STRING` (string) +
`WEECHAT_HOOK_SIGNAL_INT` (string) +
`WEECHAT_HOOK_SIGNAL_POINTER` (string)
WEECHAT_HOOK_SIGNAL_STRING +
WEECHAT_HOOK_SIGNAL_INT +
WEECHAT_HOOK_SIGNAL_POINTER
|===
[[common_tasks]]
@@ -907,13 +886,13 @@ weechat.prnt("", "%sfalsche Anzahl an Argumenten" % weechat.prefix("error"))
weechat.prnt("", "Text %sGeld auf Blau" % weechat.color("yellow,blue"))
# sucht einen bestimmten Buffer und gibt dort einen Text aus
# (der Name des Buffers muss folgendes Format besitzen Erweiterung.Name, Beispiel: "irc.libera.#weechat")
buffer = weechat.buffer_search("irc", "libera.#weechat")
# (der Name des Buffers muss folgendes Format besitzen Erweiterung.Name, Beispiel: "irc.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
weechat.prnt(buffer, "Nachricht im #weechat Channel")
# die zweite Möglichkeit einen Buffer zu suchen (empfohlen!)
# (bitte beachten Sie dass der Server- und Channelname durch ein Komma zu trennen sind)
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
weechat.prnt(buffer, "Nachricht im #weechat Channel")
----
@@ -935,7 +914,7 @@ Beispiele:
weechat.command("", "/help")
# sendet den Text "Hallo" in den IRC Channel #weechat (die Teilnehmer des Channels sehen diese Nachricht)
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
weechat.command(buffer, "Hallo")
----
@@ -1009,7 +988,7 @@ Um zu sehen welche lokalen Variablen für einen Buffer gesetzt sind führen Sie
bitte in WeeChat folgenden Befehl aus:
----
/buffer listvar
/buffer localvar
----
[[hooks]]
@@ -1242,7 +1221,7 @@ xxx,irc_raw_in2_yyy::
[source,python]
----
def join_cb(data, signal, signal_data):
# Das Signal lautet: "libera,irc_in2_join"
# Das Signal lautet: "freenode,irc_in2_join"
# signal_data enthält die IRC Nachricht, zum Beispiel: ":nick!user@host JOIN :#channel"
server = signal.split(",")[0]
msg = weechat.info_get_hashtable("irc_message_parse", {"message": signal_data})
@@ -1296,66 +1275,63 @@ Das Ergebnis ist eine Hashtabelle mit folgenden Schlüsseln
(das Beispiel bezieht sich auf folgende IRC Nachricht:
`+@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!+`):
[width="100%",cols="3,^2,10,7",options="header"]
[width="100%",cols="1,^2,10,8",options="header"]
|===
| Schlüssel | Seit WeeChat ^(1)^ | Beschreibung | Beispiel
| Schlüssel | WeeChat version | Beschreibung | Beispiel
| Tags | 0.4.0 |
| Tags | 0.4.0 |
Tags in der Nachricht (kann leer sein). |
`+time=2015-06-27T16:40:35.000Z+`
| message_without_tags | 0.4.0 |
| message_without_tags | 0.4.0 |
Die IRC Nachricht ohne Tags (wie eine Nachricht ohne Tags). |
`+:nick!user@host PRIVMSG #weechat :hello!+`
| nick | 0.3.4 |
| nick | 0.3.4 |
der ursprüngliche Nick. |
`+nick+`
| user | 2.7 |
| user | 2.7 |
der ursprüngliche Benutzer. |
`+user+`
| host | 0.3.4 |
| host | 0.3.4 |
der ursprüngliche Host (beinhaltet den Nick). |
`+nick!user@host+`
| command | 0.3.4 |
| command | 0.3.4 |
der Befehl (_PRIVMSG_, _NOTICE_, ...). |
`+PRIVMSG+`
| channel | 0.3.4 |
| channel | 0.3.4 |
der Zielchanne.l|
`+#weechat+`
| arguments | 0.3.4 |
| arguments | 0.3.4 |
das Argument des Befehls (beinhaltet den Channel). |
`+#weechat :hello!+`
| text | 1.3 |
| text | 1.3 |
der Text (zum Beispiel eine Nachricht eines Users). |
`+hello!+`
| pos_command | 1.3 |
| pos_command | 1.3 |
Index von _command_ innerhalb einer Nachricht ("-1" falls _command_ nicht gefunden wird). |
`+47+`
| pos_arguments | 1.3 |
| pos_arguments | 1.3 |
Index von_arguments_ innerhalb einer Nachricht ("-1" falls _arguments_ nicht gefunden wird). |
`+55+`
| pos_channel | 1.3 |
| pos_channel | 1.3 |
Index von _channel_ innerhalb einer Nachricht ("-1" falls _channel_ nicht gefunden wird). |
`+55+`
| pos_text | 1.3 |
| pos_text | 1.3 |
Index von _text_ innerhalb einer Nachricht ("-1" falls _text_ nicht gefunden wird). |
`+65+`
|===
[NOTE]
^(1)^ Der Schlüssel wurde mit dieser WeeChat Version eingeführt.
[source,python]
----
dict = weechat.info_get_hashtable(
@@ -1417,8 +1393,8 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[source,python]
----
# Zum Beispiel, das WeeChat-Konfigurationsverzeichnis: "/home/user/.config/weechat"
weechat.prnt("", "WeeChat config dir: %s" % weechat.info_get("weechat_config_dir", ""))
# WeeChat Hauptverzeichnis, zum Beispiel: "/home/xxxx/.weechat"
weechat.prnt("", "WeeChat Hauptverzeichnis: %s" % weechat.info_get("weechat_dir", ""))
# Inaktivität der Tastatur
weechat.prnt("", "Tastatur ist seit %s Sekunden nicht mehr betätigt worden" % weechat.info_get("inactivity", ""))
+1 -1
View File
@@ -141,7 +141,7 @@ prahle vor Anderen, dass Du die neueste WeeChat-Version verwendest :)
Solltest Du nun ein merkwürdiges Verhalten bemerken (es können diverse Probleme
oder Abstürze auftreten oder einfach Dein Bier überkochen) zögere nicht, komme
in den Channel _#weechat_ auf _irc.libera.chat_ (A.d.Ü.: englischsprachig) und
in den Channel _#weechat_ auf _chat.freenode.net_ (A.d.Ü.: englischsprachig) und
berichte uns darüber.
Auch falls alles korrekt funktionieren sollte gib uns trotzdem Bescheid, wir
File diff suppressed because it is too large Load Diff
+3 -3
View File
@@ -1,6 +1,6 @@
#!/usr/bin/env python3
#
# Copyright (C) 2008-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2008-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
@@ -674,7 +674,7 @@ class AutogenDoc():
for info in sorted(infos[plugin]):
_inf = infos[plugin][info]
desc = translate(_inf['description'])
args_desc = translate(_inf['args_description']) or '-'
args_desc = translate(_inf['args_description'] or '-')
self.write('| %s | %s | %s | %s\n',
escape(plugin), escape(info), escape(desc),
escape(args_desc))
@@ -694,7 +694,7 @@ class AutogenDoc():
for info in sorted(infos_hashtable[plugin]):
_inh = infos_hashtable[plugin][info]
desc = translate(_inh['description'])
args_desc = translate(_inh['args_description']) or '-'
args_desc = translate(_inh['args_description'])
output_desc = translate(_inh['output_description']) or '-'
self.write('| %s | %s | %s | %s | %s\n',
escape(plugin), escape(info), escape(desc),
+1 -1
View File
@@ -1,6 +1,6 @@
<!--
Custom styles for Asciidoctor
Copyright (C) 2016-2021 Sébastien Helleu <flashcode@flashtux.org>
Copyright (C) 2016-2020 Sébastien Helleu <flashcode@flashtux.org>
-->
<style>
#header,#content,#footnotes,#footer {
+14 -16
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
@@ -32,21 +32,19 @@ if(ENABLE_MAN)
add_custom_target(doc-man-weechat-en ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/man1)
if(ENABLE_HEADLESS)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.en.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.en.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.en.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.en.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (en)"
)
add_custom_target(doc-man-weechat-headless-en ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/man1)
endif()
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.en.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.en.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.en.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.en.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (en)"
)
add_custom_target(doc-man-weechat-headless-en ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/man1)
endif()
if(ENABLE_DOC)
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2006 Julien Louis <ptitlouis@sysif.net>
#
# This file is part of WeeChat, the extensible chat client.
@@ -120,10 +120,6 @@
| weechat | bars_options | options for bars
| weechat | buffer_local_variable_value | value of a buffer local variable
| weechat | buffer_local_variables | buffer local variables
| weechat | buffer_properties_get | properties that can be read on a buffer
| weechat | buffer_properties_set | properties that can be set on a buffer
@@ -233,10 +233,6 @@ _hook_connect_   (pointer, hdata: "hook") +
_hook_fd_   (pointer, hdata: "hook") +
_hook_timer_connection_   (pointer, hdata: "hook") +
_hook_timer_sasl_   (pointer, hdata: "hook") +
_sasl_scram_client_first_   (string) +
_sasl_scram_salted_pwd_   (other) +
_sasl_scram_salted_pwd_size_   (integer) +
_sasl_scram_auth_message_   (string) +
_is_connected_   (integer) +
_ssl_connected_   (integer) +
_disconnected_   (integer) +
+3 -15
View File
@@ -20,8 +20,6 @@
| irc | irc_is_channel | 1 if string is a valid IRC channel name for server | server,channel (server is optional)
| irc | irc_is_message_ignored | 1 if the nick is ignored (message is not displayed) | server,message (message is the raw IRC message)
| irc | irc_is_nick | 1 if string is a valid IRC nick name | server,nickname (server is optional)
| irc | irc_nick | get current nick on a server | server name
@@ -60,7 +58,7 @@
| php | php_version | version of the interpreter used | -
| python | python2_bin | path to Python 2.x interpreter (*deprecated* since version 2.6, scripts must use Python 3 only) | -
| python | python2_bin | path to python 2.x interpreter | -
| python | python_eval | evaluation of source code | source code to execute
@@ -76,7 +74,7 @@
| ruby | ruby_version | version of the interpreter used | -
| spell | spell_dict | comma-separated list of dictionaries used in buffer | buffer pointer ("0x12345678") or buffer full name ("irc.libera.#weechat")
| spell | spell_dict | comma-separated list of dictionaries used in buffer | buffer pointer ("0x12345678") or buffer full name ("irc.freenode.#weechat")
| tcl | tcl_eval | evaluation of source code | source code to execute
@@ -134,15 +132,7 @@
| weechat | version_number | WeeChat version (as number) | -
| weechat | weechat_cache_dir | WeeChat cache directory | -
| weechat | weechat_config_dir | WeeChat config directory | -
| weechat | weechat_daemon | 1 if WeeChat is running in daemon mode (headless, in background) | -
| weechat | weechat_data_dir | WeeChat data directory | -
| weechat | weechat_dir | WeeChat directory (*deprecated* since version 3.2, replaced by "weechat_config_dir", "weechat_data_dir", "weechat_cache_dir" and "weechat_runtime_dir") | -
| weechat | weechat_dir | WeeChat directory | -
| weechat | weechat_headless | 1 if WeeChat is running headless | -
@@ -150,8 +140,6 @@
| weechat | weechat_localedir | WeeChat "locale" directory | -
| weechat | weechat_runtime_dir | WeeChat runtime directory | -
| weechat | weechat_sharedir | WeeChat "share" directory | -
| weechat | weechat_site | WeeChat site | -
@@ -14,7 +14,5 @@
| weechat | focus_info | get focus info | "x": x coordinate (string with integer >= 0), "y": y coordinate (string with integer >= 0) | see function "hook_focus" in Plugin API reference
| weechat | secured_data | secured data | - | secured data: names and values (be careful: the values are sensitive data: do NOT print/log them anywhere)
|===
// end::infos_hashtable[]
+69 -97
View File
@@ -161,7 +161,7 @@ Examples:
To disconnect from a server or stop any connection attempt, use command /disconnect.
Examples:
/connect libera
/connect freenode
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
@@ -219,7 +219,6 @@ Examples:
----
/dehalfop <nick> [<nick>...]
* -yes
nick: nick or mask (wildcard "*" is allowed)
*: remove channel half-operator status from everybody on channel except yourself
@@ -301,10 +300,10 @@ Note: the regular expression can start with "(?-i)" to become case sensitive.
Examples:
ignore nick "toto" everywhere:
/ignore add toto
ignore host "toto@domain.com" on libera server:
/ignore add toto@domain.com libera
ignore host "toto*@*.domain.com" on libera/#weechat:
/ignore add toto*@*.domain.com libera #weechat
ignore host "toto@domain.com" on freenode server:
/ignore add toto@domain.com freenode
ignore host "toto*@*.domain.com" on freenode/#weechat:
/ignore add toto*@*.domain.com freenode #weechat
----
[[command_irc_info]]
@@ -349,7 +348,7 @@ nick: nick
Examples:
/join #weechat
/join #protectedchan,#weechat key
/join -server libera #weechat
/join -server freenode #weechat
/join -noswitch #weechat
----
@@ -361,7 +360,7 @@ Examples:
channel: channel name
nick: nick
reason: reason (evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)
reason: reason (special variables $nick, $channel and $server are replaced by their value)
----
[[command_irc_kickban]]
@@ -372,7 +371,7 @@ channel: channel name
channel: channel name
nick: nick
reason: reason (evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)
reason: reason (special variables $nick, $channel and $server are replaced by their value)
It is possible to kick/ban with a mask, nick will be extracted from mask and replaced by "*".
@@ -402,7 +401,7 @@ server_mask: list of servers must match this mask
----
[[command_irc_list]]
* `+list+`: list channels and their topics
* `+list+`: list channels and their topic
----
/list [-server <server>] [-re <regex>] [<channel>[,<channel>...]] [<target>]
@@ -552,10 +551,10 @@ Without argument, this command displays notifications for current server (or all
Examples:
notify when "toto" joins/quits current server:
/notify add toto
notify when "toto" joins/quits libera server:
/notify add toto libera
notify when "toto" is away or back on libera server:
/notify add toto libera -away
notify when "toto" joins/quits freenode server:
/notify add toto freenode
notify when "toto" is away or back on freenode server:
/notify add toto freenode -away
----
[[command_irc_op]]
@@ -673,7 +672,7 @@ option: extra option, for some servers
channel: channel name
nick: nick
reason: reason (special variables $nick, $channel and $server are replaced by their values)
reason: reason (special variables $nick, $channel and $server are replaced by their value)
----
[[command_irc_restart]]
@@ -775,16 +774,16 @@ nooption: set boolean option to 'off' (for example: -nossl)
Examples:
/server listfull
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add freenode chat.freenode.net
/server add freenode chat.freenode.net/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server copy freenode freenode-test
/server rename freenode-test freenode2
/server reorder freenode2 freenode
/server del freenode
/server deloutq
/server raw
/server raw s:libera
/server raw s:freenode
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
@@ -933,7 +932,6 @@ target: server name
----
/voice <nick> [<nick>...]
* -yes
nick: nick or mask (wildcard "*" is allowed)
*: give voice to everybody on channel
@@ -1022,7 +1020,7 @@ Note: in command, special variables are replaced:
$n-m: arguments from 'n' to 'm'
$*: all arguments
$~: last argument
$var: where "var" is a local variable of buffer (see /buffer listvar)
$var: where "var" is a local variable of buffer (see /buffer localvar)
examples: $nick, $channel, $server, $plugin, $name
Examples:
@@ -1115,9 +1113,7 @@ Examples:
renumber [<number1> [<number2> [<start>]]]
close [<n1>[-<n2>]|<name>...]
notify [<level>]
listvar [<number>|<name>]
setvar <name> [<value>]
delvar <name>
localvar [<number>|<name>]
set <property> [<value>]
get <property>
<number>|-|+|<name>
@@ -1141,10 +1137,8 @@ renumber: renumber buffers (works only if option weechat.look.buffer_auto_renumb
message: for messages from users + highlights
all: all messages
reset: reset to default value (all)
listvar: display local variables in a buffer
setvar: set a local variable in the current buffer
delvar: delete a local variable from the current buffer
set: set a property in the current buffer
localvar: display local variables for the buffer
set: set a property for current buffer
get: display a property of current buffer
number: jump to buffer by number, possible prefix:
'+': relative jump, add number to current
@@ -1302,11 +1296,11 @@ infolists: display infos about infolists
----
/eval [-n|-s] [-d] <expression>
[-n] [-d [-d]] -c <expression1> <operator> <expression2>
[-n] [-d] -c <expression1> <operator> <expression2>
-n: display result without sending it to buffer (debug mode)
-s: split expression before evaluating it (many commands can be separated by semicolons)
-d: display debug output after evaluation (with two -d: more verbose debug)
-d: display debug output after evaluation
-c: evaluate as condition: use operators and parentheses, return a boolean value ("0" or "1")
expression: expression to evaluate, variables with format ${variable} are replaced (see below); many commands can be separated by semicolons
operator: a logical or comparison operator:
@@ -1341,45 +1335,39 @@ To force a string comparison, you can add double quotes around each expression,
"50" > "100" ==> 1
Some variables are replaced in expression, using the format ${variable}, variable can be, by order of priority:
1. the string itself without evaluation (format: "raw:xxx")
2. an evaluated sub-string (format: "eval:xxx")
3. an evaluated condition (format: "eval_cond:xxx")
4. a string with escaped chars (format: "esc:xxx" or "\xxx")
5. a string with chars to hide (format: "hide:char,string")
6. a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
1. an evaluated sub-string (format: "eval:xxx")
2. a string with escaped chars (format: "esc:xxx" or "\xxx")
3. a string with chars to hide (format: "hide:char,string")
4. a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
or max chars displayed on screen (format: "cutscr:max,suffix,string" or "cutscr:+max,suffix,string")
7. a reversed string (format: "rev:xxx" or "revscr:xxx")
8. a repeated string (format: "repeat:count,string")
9. length of a string (format: "length:xxx" or "lengthscr:xxx")
10. a color (format: "color:xxx", see "Plugin API reference", function "color")
11. a modifier (format: "modifier:name,data,string")
12. an info (format: "info:name,arguments", arguments are optional)
13. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
14. current date/time (format: "date" or "date:format")
15. an environment variable (format: "env:XXX")
16. a ternary operator (format: "if:condition?value_if_true:value_if_false")
17. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
18. a translated string (format: "translate:xxx")
19. an option (format: "file.section.option")
20. a local variable in buffer
21. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
5. a reversed string (format: "rev:xxx" or "revscr:xxx")
6. a repeated string (format: "repeat:count,string")
7. length of a string (format: "length:xxx" or "lengthscr:xxx")
8. a color (format: "color:xxx", see "Plugin API reference", function "color")
9. a modifier (format: "modifier:name,data,string")
10. an info (format: "info:name,arguments", arguments are optional)
11. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
12. current date/time (format: "date" or "date:format")
13. an environment variable (format: "env:XXX")
14. a ternary operator (format: "if:condition?value_if_true:value_if_false")
15. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
16. an option (format: "file.section.option")
17. a local variable in buffer
18. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
Format for hdata can be one of following:
hdata.var1.var2...: start with a hdata (pointer must be known), and ask variables one after one (other hdata can be followed)
hdata[list].var1.var2...: start with a hdata using a list/pointer/pointer name, for example:
hdata[list].var1.var2...: start with a hdata using a list, for example:
${buffer[gui_buffers].full_name}: full name of first buffer in linked list of buffers
${plugin[weechat_plugins].name}: name of first plugin in linked list of plugins
hdata[pointer].var1.var2...: start with a hdata using a pointer, for example:
${buffer[0x1234abcd].full_name}: full name of the buffer with this pointer (can be used in triggers)
${buffer[my_pointer].full_name}: full name of the buffer with this pointer name (can be used in triggers)
For name of hdata and variables, please look at "Plugin API reference", function "weechat_hdata_get".
Examples (simple strings):
/eval -n ${raw:${info:version}} ==> ${info:version}
/eval -n ${eval_cond:${window.win_width}>100} ==> 1
/eval -n ${info:version} ==> 0.4.3
/eval -n ${env:HOME} ==> /home/user
/eval -n ${weechat.look.scroll_amount} ==> 3
/eval -n ${sec.data.password} ==> secret
/eval -n ${sec.data.freenode_password} ==> secret
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
@@ -1396,7 +1384,6 @@ Examples (simple strings):
/eval -n ${calc:(5+2)*3} ==> 21
/eval -n ${base_encode:64,test} ==> dGVzdA==
/eval -n ${base_decode:64,dGVzdA==} ==> test
/eval -n ${translate:Plugin} ==> Extension
Examples (conditions):
/eval -n -c ${window.buffer.number} > 2 ==> 0
@@ -1419,7 +1406,6 @@ Examples (conditions):
enable|disable|toggle [<name>|@]
add|addreplace <name> <buffer>[,<buffer>...] <tags> <regex>
rename <name> <new_name>
recreate <name>
del <name>|-all
list: list all filters
@@ -1430,11 +1416,10 @@ Examples (conditions):
add: add a filter
addreplace: add or replace an existing filter
rename: rename a filter
recreate: set input with the command used to edit the filter
del: delete a filter
-all: delete all filters
buffer: comma separated list of buffers where filter is active:
- this is full name including plugin (example: "irc.libera.#weechat" or "irc.server.libera")
- this is full name including plugin (example: "irc.freenode.#weechat" or "irc.server.freenode")
- "*" means all buffers
- a name starting with '!' is excluded
- wildcard "*" is allowed
@@ -1469,11 +1454,11 @@ Examples:
filter nicks displayed when joining channels or with /names:
/filter add nicks * irc_366 *
filter nick "toto" on IRC channel #weechat:
/filter add toto irc.libera.#weechat nick_toto *
/filter add toto irc.freenode.#weechat nick_toto *
filter IRC join/action messages from nick "toto":
/filter add toto * nick_toto+irc_join,nick_toto+irc_action *
filter lines containing "weechat sucks" on IRC channel #weechat:
/filter add sucks irc.libera.#weechat * weechat sucks
/filter add sucks irc.freenode.#weechat * weechat sucks
filter lines that are strictly equal to "WeeChat sucks" on all buffers:
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -1675,7 +1660,7 @@ Examples:
-core: no output on WeeChat core buffer
-current: no output on current buffer
-buffer: no output on specified buffer
name: full buffer name (examples: "irc.server.libera", "irc.libera.#weechat")
name: full buffer name (examples: "irc.server.freenode", "irc.freenode.#weechat")
command: command to execute silently (a '/' is automatically added if not found at beginning of command)
If no target is specified (-core, -current or -buffer), then default is to mute all buffers.
@@ -1686,7 +1671,7 @@ Examples:
message to current IRC channel:
/mute -current msg * hi!
message to #weechat channel:
/mute -buffer irc.libera.#weechat msg #weechat hi!
/mute -buffer irc.freenode.#weechat msg #weechat hi!
----
[[command_weechat_plugin]]
@@ -1754,7 +1739,7 @@ Examples:
display message on core buffer with prefix "abc":
/print -core abc\tThe message
display a message on channel #weechat:
/print -buffer irc.libera.#weechat Message on #weechat
/print -buffer irc.freenode.#weechat Message on #weechat
display a snowman (U+2603):
/print -escape \u2603
send alert (BEL):
@@ -1876,7 +1861,7 @@ Keys on secure buffer:
alt+v toggle values
When a passphrase is used (data encrypted), it is asked by WeeChat on startup.
It is possible to set environment variable "WEECHAT_PASSPHRASE" to prevent the prompt (this same variable is used by WeeChat on /upgrade), or to set option sec.crypt.passphrase_command to read the passphrase from the output of an external command like a password manager (see /help sec.crypt.passphrase_command).
It is possible to set environment variable "WEECHAT_PASSPHRASE" to prevent the prompt (this same variable is used by WeeChat on /upgrade), or to set option sec.crypt.passphrase_file to read the passphrase from a file (see /help sec.crypt.passphrase_file).
Secured data with format ${sec.data.xxx} can be used in:
- command /eval
@@ -1887,16 +1872,14 @@ Secured data with format ${sec.data.xxx} can be used in:
Examples:
set a passphrase:
/secure passphrase this is my passphrase
use program "pass" to read the passphrase on startup:
/set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"
encrypt libera SASL password:
/secure set libera mypassword
/set irc.server.libera.sasl_password "${sec.data.libera}"
encrypt freenode SASL password:
/secure set freenode mypassword
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
encrypt oftc password for nickserv:
/secure set oftc mypassword
/set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}"
alias to ghost the nick "mynick":
/alias add ghost /eval /msg -server libera nickserv ghost mynick ${sec.data.libera}
/alias add ghost /eval /msg -server freenode nickserv ghost mynick ${sec.data.freenode}
----
[[command_weechat_set]]
@@ -1983,7 +1966,7 @@ With option "-quit", the process is slightly different:
5. quit WeeChat
Then later you can restore session with command: weechat --upgrade
IMPORTANT: you must restore the session with exactly same configuration (files *.conf).
It is possible to restore WeeChat session on another machine if you copy the content of WeeChat home directories (see /debug dirs).
It is possible to restore WeeChat session on another machine if you copy the content of directory "~/.weechat".
----
[[command_weechat_uptime]]
@@ -2168,7 +2151,6 @@ The following variables can be used in these options:
- ${hotlist}: the raw hotlist
- ${hotlist_priority}: "none", "low", "message", "private" or "highlight"
- ${format_lag}: the lag for an IRC server buffer, empty if there's no lag (evaluation of option buflist.format.lag)
- ${format_tls_version}: indicator of TLS version for a server buffer, empty for channels (evaluation of option buflist.format.tls_version)
----
// end::buflist_commands[]
@@ -2275,14 +2257,14 @@ disable: disable FIFO pipe
toggle: toggle FIFO pipe
FIFO pipe is used as remote control of WeeChat: you can send commands or text to the FIFO pipe from your shell.
By default the FIFO pipe is called weechat_fifo_xxx (where xxx is the WeeChat process id) and located in the WeeChat runtime directory (see /debug dirs).
By default the FIFO pipe is in ~/.weechat/weechat_fifo
The expected format is one of:
plugin.buffer *text or command here
*text or command here
For example to change your libera nick:
echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
For example to change your freenode nick:
echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo
Please read the user's guide for more info and examples.
@@ -2719,7 +2701,7 @@ Without argument, this command lists all loaded scripts.
stop: close the server socket (clients remain connected)
name: relay name (see format below)
port: port used for relay
path: path used for relay (for UNIX domain socket only); path is evaluated (see function string_eval_path_home in plugin API reference)
path: path used for relay (for UNIX domain socket only); "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default), content is evaluated (see /help eval)
raw: open buffer with raw Relay data
sslcertkey: set SSL certificate/key using path in option relay.network.ssl_cert_key
@@ -2738,10 +2720,10 @@ The "weechat" protocol allows a remote interface to connect on the port, see the
Without argument, this command opens buffer with list of relay clients.
Examples:
irc proxy, for server "libera":
/relay add irc.libera 8000
irc proxy, for server "libera", with SSL:
/relay add ssl.irc.libera 8001
irc proxy, for server "freenode":
/relay add irc.freenode 8000
irc proxy, for server "freenode", with SSL:
/relay add ssl.irc.freenode 8001
irc proxy, for all servers (client will choose), with SSL:
/relay add ssl.irc 8002
weechat protocol:
@@ -2755,7 +2737,7 @@ Examples:
weechat protocol with SSL, using IPv4 + IPv6:
/relay add ipv4.ipv6.ssl.weechat 9001
weechat protocol over UNIX domain socket:
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
/relay add unix.weechat %h/relay_socket
----
// end::relay_commands[]
@@ -2837,16 +2819,6 @@ On script buffer, the possible status for each script are:
| installed
popular script
In output of /script list, the possible status for each script are:
* ? i a H N
| | | | | |
| | | | | obsolete (new version available)
| | | | held
| | | autoloaded
| | installed
| unknown script (can not be downloaded/updated)
popular script
Keys on script buffer:
alt+i install script
alt+r remove script
@@ -2976,7 +2948,7 @@ listdefault: list default triggers
modifier: name(s) of modifier (required)
line: buffer type ("formatted", "free" or "*"), list of buffer masks, tags
print: buffer, tags, message, strip colors
command: command (required), description, arguments, description of arguments, completion (all arguments except command are evaluated, "${tg_trigger_name}" is replaced by the trigger name, see /help eval)
command: command (required), description, arguments, description of arguments, completion (all arguments except command are evaluated, see /help eval)
command_run: command(s) (required)
timer: interval (required), align on second, max calls
config: name(s) of option (required)
+34 -118
View File
@@ -16,8 +16,8 @@
** values: sha224, sha256, sha384, sha512
** default value: `+sha256+`
* [[option_sec.crypt.passphrase_command]] *sec.crypt.passphrase_command*
** description: pass:none[read the passphrase from the output of this system command (only the first line is used and it must not contain any extra character); this option is used only when reading file sec.conf and if the environment variable "WEECHAT_PASSPHRASE" is not set (the environment variable has higher priority); example with password-store: "/usr/bin/pass show weechat/passphrase"]
* [[option_sec.crypt.passphrase_file]] *sec.crypt.passphrase_file*
** description: pass:none[path to a file containing the passphrase to encrypt/decrypt secured data; this option is used only when reading file sec.conf; only first line of file is used; this file is used only if the environment variable "WEECHAT_PASSPHRASE" is not set (the environment variable has higher priority); security note: it is recommended to keep this file readable only by you and store it outside WeeChat home (for example in your home); example: "~/.weechat-passphrase"]
** type: string
** values: any string
** default value: `+""+`
@@ -846,12 +846,6 @@
** values: on, off
** default value: `+on+`
* [[option_weechat.look.hotlist_update_on_buffer_switch]] *weechat.look.hotlist_update_on_buffer_switch*
** description: pass:none[update the hotlist when switching buffers]
** type: boolean
** values: on, off
** default value: `+on+`
* [[option_weechat.look.input_cursor_scroll]] *weechat.look.input_cursor_scroll*
** description: pass:none[number of chars displayed after end of input line when scrolling to display end of line]
** type: integer
@@ -1146,12 +1140,6 @@
** values: any string
** default value: `+"- "+`
* [[option_weechat.look.read_marker_update_on_buffer_switch]] *weechat.look.read_marker_update_on_buffer_switch*
** description: pass:none[update the read marker when switching buffers]
** type: boolean
** values: on, off
** default value: `+on+`
* [[option_weechat.look.save_config_on_exit]] *weechat.look.save_config_on_exit*
** description: pass:none[save configuration file on exit]
** type: boolean
@@ -1260,17 +1248,11 @@
** values: 1 .. 2147483647
** default value: `+60+`
* [[option_weechat.network.gnutls_ca_system]] *weechat.network.gnutls_ca_system*
** description: pass:none[load system's default trusted certificate authorities on startup; this can be turned off to save some memory only if you are not using SSL connections at all]
** type: boolean
** values: on, off
** default value: `+on+`
* [[option_weechat.network.gnutls_ca_user]] *weechat.network.gnutls_ca_user*
** description: pass:none[extra file(s) with certificate authorities; multiple files must be separated by colons (each path is evaluated, see function string_eval_path_home in plugin API reference)]
* [[option_weechat.network.gnutls_ca_file]] *weechat.network.gnutls_ca_file*
** description: pass:none[file containing the certificate authorities ("%h" will be replaced by WeeChat home, "~/.weechat" by default)]
** type: string
** values: any string
** default value: `+""+`
** default value: `+"/etc/ssl/certs/ca-certificates.crt"+`
* [[option_weechat.network.gnutls_handshake_timeout]] *weechat.network.gnutls_handshake_timeout*
** description: pass:none[timeout (in seconds) for gnutls handshake]
@@ -1303,10 +1285,10 @@
** default value: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
** description: pass:none[path for searching plugins (path is evaluated, see function string_eval_path_home in plugin API reference)]
** description: pass:none[path for searching plugins ("%h" will be replaced by WeeChat home, "~/.weechat" by default)]
** type: string
** values: any string
** default value: `+"${weechat_data_dir}/plugins"+`
** default value: `+"%h/plugins"+`
* [[option_weechat.plugin.save_config_on_unload]] *weechat.plugin.save_config_on_unload*
** description: pass:none[save configuration files when unloading plugins]
@@ -1314,44 +1296,14 @@
** values: on, off
** default value: `+on+`
* [[option_weechat.signal.sighup]] *weechat.signal.sighup*
** description: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+"${if:${info:weechat_headless}?/reload:/quit -yes}"+`
* [[option_weechat.signal.sigquit]] *weechat.signal.sigquit*
** description: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+"/quit -yes"+`
* [[option_weechat.signal.sigterm]] *weechat.signal.sigterm*
** description: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+"/quit -yes"+`
* [[option_weechat.signal.sigusr1]] *weechat.signal.sigusr1*
** description: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+""+`
* [[option_weechat.signal.sigusr2]] *weechat.signal.sigusr2*
** description: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+""+`
* [[option_weechat.startup.command_after_plugins]] *weechat.startup.command_after_plugins*
** description: pass:none[command executed when WeeChat starts, after loading plugins; multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** description: pass:none[command executed when WeeChat starts, after loading plugins (note: content is evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+""+`
* [[option_weechat.startup.command_before_plugins]] *weechat.startup.command_before_plugins*
** description: pass:none[command executed when WeeChat starts, before loading plugins; multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** description: pass:none[command executed when WeeChat starts, before loading plugins (note: content is evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+""+`
@@ -1457,10 +1409,10 @@
** default value: `+""+`
* [[option_logger.file.path]] *logger.file.path*
** description: pass:none[path for WeeChat log files; date specifiers are permitted (see man strftime) (path is evaluated, see function string_eval_path_home in plugin API reference)]
** description: pass:none[path for WeeChat log files; "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default); date specifiers are permitted (see man strftime) (note: content is evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+"${weechat_data_dir}/logs"+`
** default value: `+"%h/logs/"+`
* [[option_logger.file.replacement_char]] *logger.file.replacement_char*
** description: pass:none[replacement char for special chars in filename built with mask (like directory delimiter)]
@@ -1752,12 +1704,6 @@
** values: any string
** default value: `+"${color:green}${number}${if:${number_displayed}?.: }"+`
* [[option_buflist.format.tls_version]] *buflist.format.tls_version*
** description: pass:none[format for TLS version on an IRC server buffer (note: content is evaluated, see /help buflist)]
** type: string
** values: any string
** default value: `+" ${color:default}(${if:${tls_version}==TLS1.3?${color:green}:${if:${tls_version}==TLS1.2?${color:yellow}:${color:red}}}${translate:${tls_version}}${color:default})"+`
* [[option_buflist.look.add_newline]] *buflist.look.add_newline*
** description: pass:none[add newline between the buffers displayed, so each buffer is displayed on a separate line (recommended); if disabled, newlines must be manually added in the formats with "${\n}", and the mouse actions are not possible any more]
** type: boolean
@@ -1819,16 +1765,10 @@
** default value: `+""+`
* [[option_buflist.look.sort]] *buflist.look.sort*
** description: pass:none[comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case insensitive comparison; example: "-~short_name" for case insensitive and reverse sort on buffer short name (note: the content is evaluated, before being split into fields, but at that time "bar_item" is the only variable that can be used, to distinguish between different buflist items, for example "${bar_item.name}")]
** description: pass:none[comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case insensitive comparison; example: "-~short_name" for case insensitive and reverse sort on buffer short name (note: content is evaluated, only the pointer to bar_item can be used, for example "bar_item.name")]
** type: string
** values: any string
** default value: `+"number,-active"+`
* [[option_buflist.look.use_items]] *buflist.look.use_items*
** description: pass:none[number of buflist bar items that can be used; the item names are: "buflist", "buflist2", "buflist3"; be careful, using more than one bar item slows down the display of buffers list]
** type: integer
** values: 1 .. 3
** default value: `+1+`
// end::buflist_options[]
// tag::fifo_options[]
@@ -1839,10 +1779,10 @@
** default value: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
** description: pass:none[path for FIFO file; WeeChat PID can be used in path with ${info:pid} (path is evaluated, see function string_eval_path_home in plugin API reference)]
** description: pass:none[path for FIFO file; "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default); WeeChat PID can be used in path with ${info:pid} (note: content is evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
** default value: `+"%h/weechat_fifo"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1913,7 +1853,7 @@
** default value: `+off+`
* [[option_xfer.file.auto_accept_nicks]] *xfer.file.auto_accept_nicks*
** description: pass:none[comma-separated list of nicks for which the incoming files and chats are automatically accepted; format is "server.nick" (for a specific server) or "nick" (for all servers); example: "libera.FlashCode,andrew"]
** description: pass:none[comma-separated list of nicks for which the incoming files and chats are automatically accepted; format is "server.nick" (for a specific server) or "nick" (for all servers); example: "freenode.FlashCode,andrew"]
** type: string
** values: any string
** default value: `+""+`
@@ -1943,10 +1883,10 @@
** default value: `+on+`
* [[option_xfer.file.download_path]] *xfer.file.download_path*
** description: pass:none[path for writing incoming files (path is evaluated, see function string_eval_path_home in plugin API reference)]
** description: pass:none[path for writing incoming files: "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default) (note: content is evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+"${weechat_data_dir}/xfer"+`
** default value: `+"%h/xfer"+`
* [[option_xfer.file.download_temporary_suffix]] *xfer.file.download_temporary_suffix*
** description: pass:none[temporary filename suffix used during the transfer for a file received, it is removed after successful transfer; if empty string, no filename suffix is used during the transfer]
@@ -1955,7 +1895,7 @@
** default value: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
** description: pass:none[path for reading files when sending (path is evaluated, see function string_eval_path_home in plugin API reference)]
** description: pass:none[path for reading files when sending (when no path is specified by user): "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default) (note: content is evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+"~"+`
@@ -2064,24 +2004,6 @@
** values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline
** default value: `+default+`
* [[option_irc.color.item_tls_version_deprecated]] *irc.color.item_tls_version_deprecated*
** description: pass:none[color for deprecated TLS versions in bar item "tls_version"]
** type: color
** values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline
** default value: `+yellow+`
* [[option_irc.color.item_tls_version_insecure]] *irc.color.item_tls_version_insecure*
** description: pass:none[color for insecure TLS versions in bar item "tls_version"]
** type: color
** values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline
** default value: `+red+`
* [[option_irc.color.item_tls_version_ok]] *irc.color.item_tls_version_ok*
** description: pass:none[color for higher supported TLS version in bar item "tls_version"]
** type: color
** values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline
** default value: `+green+`
* [[option_irc.color.message_account]] *irc.color.message_account*
** description: pass:none[color for text in account messages]
** type: color
@@ -2287,19 +2209,19 @@
** default value: `+off+`
* [[option_irc.look.highlight_channel]] *irc.look.highlight_channel*
** description: pass:none[comma separated list of words to highlight in channel buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their values), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"]
** description: pass:none[comma separated list of words to highlight in channel buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their value), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"]
** type: string
** values: any string
** default value: `+"$nick"+`
* [[option_irc.look.highlight_pv]] *irc.look.highlight_pv*
** description: pass:none[comma separated list of words to highlight in private buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their values), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"]
** description: pass:none[comma separated list of words to highlight in private buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their value), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"]
** type: string
** values: any string
** default value: `+"$nick"+`
* [[option_irc.look.highlight_server]] *irc.look.highlight_server*
** description: pass:none[comma separated list of words to highlight in server buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their values), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"]
** description: pass:none[comma separated list of words to highlight in server buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their value), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"]
** type: string
** values: any string
** default value: `+"$nick"+`
@@ -2677,7 +2599,7 @@
** default value: `+message+`
* [[option_irc.server_default.command]] *irc.server_default.command*
** description: pass:none[command(s) to run after connection to server and before auto-join of channels (many commands can be separated by ";", use "\;" for a semicolon, special variables $nick, $channel and $server are replaced by their values) (note: commands are evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)]
** description: pass:none[command(s) to run after connection to server and before auto-join of channels (many commands can be separated by ";", use "\;" for a semicolon, special variables $nick, $channel and $server are replaced by their value) (note: content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)]
** type: string
** values: any string
** default value: `+""+`
@@ -2694,12 +2616,6 @@
** values: 1 .. 3600
** default value: `+60+`
* [[option_irc.server_default.default_chantypes]] *irc.server_default.default_chantypes*
** description: pass:none[channel type prefixes to use if the server does not send them in message 005 (default is "#&")]
** type: string
** values: any string
** default value: `+"#&"+`
* [[option_irc.server_default.ipv6]] *irc.server_default.ipv6*
** description: pass:none[use IPv6 protocol for server communication (try IPv6 then fallback to IPv4); if disabled, only IPv4 is used]
** type: boolean
@@ -2713,19 +2629,19 @@
** default value: `+""+`
* [[option_irc.server_default.msg_kick]] *irc.server_default.msg_kick*
** description: pass:none[default kick message used by commands "/kick" and "/kickban" (note: content is evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)]
** description: pass:none[default kick message used by commands "/kick" and "/kickban" (note: content is evaluated, see /help eval; special variables ${nick}, ${channel} and ${server} are replaced by their value)]
** type: string
** values: any string
** default value: `+""+`
* [[option_irc.server_default.msg_part]] *irc.server_default.msg_part*
** description: pass:none[default part message (leaving channel) (note: content is evaluated, see /help eval; special variables ${nick}, ${channel} and ${server} are replaced by their values; "%v" is replaced by WeeChat version if there is no ${...} in string)]
** description: pass:none[default part message (leaving channel) (note: content is evaluated, see /help eval; special variables ${nick}, ${channel} and ${server} are replaced by their value; "%v" is replaced by WeeChat version if there is no ${...} in string)]
** type: string
** values: any string
** default value: `+"WeeChat ${info:version}"+`
* [[option_irc.server_default.msg_quit]] *irc.server_default.msg_quit*
** description: pass:none[default quit message (disconnecting from server) (note: content is evaluated, see /help eval; special variables ${nick}, ${channel} and ${server} are replaced by their values; "%v" is replaced by WeeChat version if there is no ${...} in string)]
** description: pass:none[default quit message (disconnecting from server) (note: content is evaluated, see /help eval; special variables ${nick}, ${channel} and ${server} are replaced by their value; "%v" is replaced by WeeChat version if there is no ${...} in string)]
** type: string
** values: any string
** default value: `+"WeeChat ${info:version}"+`
@@ -2773,15 +2689,15 @@
** default value: `+continue+`
* [[option_irc.server_default.sasl_key]] *irc.server_default.sasl_key*
** description: pass:none[file with ECC private key for mechanism "ecdsa-nist256p-challenge" (path is evaluated, see function string_eval_path_home in plugin API reference)]
** description: pass:none[file with ECC private key for mechanism "ecdsa-nist256p-challenge" ("%h" will be replaced by WeeChat home, "~/.weechat" by default)]
** type: string
** values: any string
** default value: `+""+`
* [[option_irc.server_default.sasl_mechanism]] *irc.server_default.sasl_mechanism*
** description: pass:none[mechanism for SASL authentication: "plain" for plain text password, "scram-sha-1" for SCRAM authentication with SHA-1 digest algorithm, "scram-sha-256" for SCRAM authentication with SHA-256 digest algorithm, "scram-sha-512" for SCRAM authentication with SHA-512 digest algorithm, "ecdsa-nist256p-challenge" for key-based challenge authentication, "external" for authentication using client side SSL cert, "dh-blowfish" for blowfish crypted password (insecure, not recommended), "dh-aes" for AES crypted password (insecure, not recommended)]
** description: pass:none[mechanism for SASL authentication: "plain" for plain text password, "ecdsa-nist256p-challenge" for key-based challenge authentication, "external" for authentication using client side SSL cert, "dh-blowfish" for blowfish crypted password (insecure, not recommended), "dh-aes" for AES crypted password (insecure, not recommended)]
** type: integer
** values: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** values: plain, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** default value: `+plain+`
* [[option_irc.server_default.sasl_password]] *irc.server_default.sasl_password*
@@ -2815,7 +2731,7 @@
** default value: `+off+`
* [[option_irc.server_default.ssl_cert]] *irc.server_default.ssl_cert*
** description: pass:none[SSL certificate file used to automatically identify your nick (path is evaluated, see function string_eval_path_home in plugin API reference)]
** description: pass:none[SSL certificate file used to automatically identify your nick ("%h" will be replaced by WeeChat home, "~/.weechat" by default)]
** type: string
** values: any string
** default value: `+""+`
@@ -3039,10 +2955,10 @@
** default value: `+100000+`
* [[option_relay.network.ssl_cert_key]] *relay.network.ssl_cert_key*
** description: pass:none[file with SSL certificate and private key (for serving clients with SSL) (path is evaluated, see function string_eval_path_home in plugin API reference)]
** description: pass:none[file with SSL certificate and private key (for serving clients with SSL)]
** type: string
** values: any string
** default value: `+"${weechat_config_dir}/ssl/relay.pem"+`
** default value: `+"%h/ssl/relay.pem"+`
* [[option_relay.network.ssl_priorities]] *relay.network.ssl_priorities*
** description: pass:none[string with priorities for gnutls (for syntax, see documentation of function gnutls_priority_init in gnutls manual, common strings are: "PERFORMANCE", "NORMAL", "SECURE128", "SECURE256", "EXPORT", "NONE")]
@@ -3345,7 +3261,7 @@
** default value: `+lightmagenta+`
* [[option_script.look.columns]] *script.look.columns*
** description: pass:none[format of columns displayed in script buffer: following column identifiers are replaced by their values: %a=author, %d=description, %D=date added, %e=extension, %l=language, %L=license, %n=name with extension, %N=name, %r=requirements, %s=status, %t=tags, %u=date updated, %v=version, %V=version loaded, %w=min_weechat, %W=max_weechat)]
** description: pass:none[format of columns displayed in script buffer: following column identifiers are replaced by their value: %a=author, %d=description, %D=date added, %e=extension, %l=language, %L=license, %n=name with extension, %N=name, %r=requirements, %s=status, %t=tags, %u=date updated, %v=version, %V=version loaded, %w=min_weechat, %W=max_weechat)]
** type: string
** values: any string
** default value: `+"%s %n %V %v %u | %d | %t"+`
@@ -3423,10 +3339,10 @@
** default value: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
** description: pass:none[local cache directory for scripts (path is evaluated, see function string_eval_path_home in plugin API reference)]
** description: pass:none[local cache directory for scripts; "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default) (note: content is evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+"${weechat_cache_dir}/script"+`
** default value: `+"%h/script"+`
* [[option_script.scripts.url]] *script.scripts.url*
** description: pass:none[URL for file with list of scripts]
+3 -3
View File
@@ -15,9 +15,9 @@
"--daemon").
*-d*, *--dir* _<path>_::
Force a single directory for all WeeChat files (directory is created if not found).
Four directories can be given, separated by colons (in this order: config,
data, cache, runtime).
Set path as home for WeeChat (used for configuration files, logs, user
plugins and scripts), default value is "~/.weechat" (note: directory is
created if not found by WeeChat).
If this option is not given, the environment variable WEECHAT_HOME is used
(if not empty).
+27 -27
View File
@@ -8,7 +8,7 @@ With irc plugin, you can connect to temporary server with an URL like:
To join WeeChat IRC channel support with nick "mynick":
irc://mynick@irc.libera.chat/#weechat
irc://mynick@chat.freenode.net/#weechat
IPv6 address can be enclosed in brackets to add a port after address, for
example:
@@ -17,79 +17,79 @@ example:
// end::plugin_options[]
// tag::files[]
$HOME/.config/weechat/weechat.conf::
$HOME/.weechat/weechat.conf::
main WeeChat configuration file
$HOME/.config/weechat/plugins.conf::
$HOME/.weechat/plugins.conf::
plugins configuration file
$HOME/.config/weechat/sec.conf::
$HOME/.weechat/sec.conf::
configuration file with secured data
$HOME/.config/weechat/alias.conf::
$HOME/.weechat/alias.conf::
configuration file for _alias_ plugin
$HOME/.config/weechat/buflist.conf::
$HOME/.weechat/buflist.conf::
configuration file for _buflist_ plugin
$HOME/.config/weechat/charset.conf::
$HOME/.weechat/charset.conf::
configuration file for _charset_ plugin
$HOME/.config/weechat/exec.conf::
$HOME/.weechat/exec.conf::
configuration file for _exec_ plugin
$HOME/.config/weechat/fifo.conf::
$HOME/.weechat/fifo.conf::
configuration file for _fifo_ plugin
$HOME/.config/weechat/fset.conf::
$HOME/.weechat/fset.conf::
configuration file for _fset_ plugin
$HOME/.config/weechat/guile.conf::
$HOME/.weechat/guile.conf::
configuration file for _guile_ plugin
$HOME/.config/weechat/irc.conf::
$HOME/.weechat/irc.conf::
configuration file for _irc_ plugin
$HOME/.config/weechat/javascript.conf::
$HOME/.weechat/javascript.conf::
configuration file for _javascript_ plugin
$HOME/.config/weechat/logger.conf::
$HOME/.weechat/logger.conf::
configuration file for _logger_ plugin
$HOME/.config/weechat/lua.conf::
$HOME/.weechat/lua.conf::
configuration file for _lua_ plugin
$HOME/.config/weechat/perl.conf::
$HOME/.weechat/perl.conf::
configuration file for _perl_ plugin
$HOME/.config/weechat/php.conf::
$HOME/.weechat/php.conf::
configuration file for _php_ plugin
$HOME/.config/weechat/python.conf::
$HOME/.weechat/python.conf::
configuration file for _python_ plugin
$HOME/.config/weechat/relay.conf::
$HOME/.weechat/relay.conf::
configuration file for _relay_ plugin
$HOME/.config/weechat/ruby.conf::
$HOME/.weechat/ruby.conf::
configuration file for _ruby_ plugin
$HOME/.config/weechat/script.conf::
$HOME/.weechat/script.conf::
configuration file for _script_ plugin
$HOME/.config/weechat/spell.conf::
$HOME/.weechat/spell.conf::
configuration file for _spell_ plugin
$HOME/.config/weechat/tcl.conf::
$HOME/.weechat/tcl.conf::
configuration file for _tcl_ plugin
$HOME/.config/weechat/trigger.conf::
$HOME/.weechat/trigger.conf::
configuration file for _trigger_ plugin
$HOME/.config/weechat/xfer.conf::
$HOME/.weechat/xfer.conf::
configuration file for _xfer_ plugin
$HOME/.local/share/weechat/weechat.log::
$HOME/.weechat/weechat.log::
WeeChat log file
// end::files[]
@@ -97,7 +97,7 @@ $HOME/.local/share/weechat/weechat.log::
WeeChat is written by Sébastien Helleu and contributors (complete list is in
the AUTHORS.adoc file).
Copyright (C) 2003-2021 {author}
Copyright (C) 2003-2020 {author}
WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
+16 -15
View File
@@ -98,7 +98,6 @@ The main WeeChat directories are:
|       gui/ | Unit tests for interfaces functions.
|       plugins/ | Unit tests for plugins.
|          irc/ | Unit tests for IRC plugin.
|          trigger/ | Unit tests for trigger plugin.
| doc/ | Documentation.
| po/ | Translations files (gettext).
| debian/ | Debian packaging.
@@ -128,7 +127,6 @@ WeeChat "core" is located in following directories:
|    wee-config.c | Configuration options for WeeChat core (file weechat.conf).
|    wee-crypto.c | Cryptographic functions.
|    wee-debug.c | Some debug functions.
|    wee-dir.c | Directory/file functions.
|    wee-eval.c | Evaluation of expressions with references to internal vars.
|    wee-hashtable.c | Hashtables.
|    wee-hdata.c | Hdata (direct access to data using hashtables).
@@ -142,7 +140,6 @@ WeeChat "core" is located in following directories:
|    wee-secure.c | Secured data functions.
|    wee-secure-buffer.c | Secured data buffer.
|    wee-secure-config.c | Secured data options (file sec.conf).
|    wee-signal.c | Signal functions.
|    wee-string.c | Functions on strings.
|    wee-upgrade-file.c | Internal upgrade system.
|    wee-upgrade.c | Upgrade for WeeChat core (buffers, lines, history, ...).
@@ -397,16 +394,13 @@ WeeChat "core" is located in following directories:
|          test-core-arraylist.cpp | Tests: arraylists.
|          test-core-calc.cpp | Tests: calculation of expressions.
|          test-core-crypto.cpp | Tests: cryptographic functions.
|          test-core-dir.cpp | Tests: directory/file functions.
|          test-core-eval.cpp | Tests: evaluation of expressions.
|          test-core-hashtble.cpp | Tests: hashtables.
|          test-core-hdata.cpp | Tests: hdata.
|          test-core-hook.cpp | Tests: hooks.
|          test-core-infolist.cpp | Tests: infolists.
|          test-core-list.cpp | Tests: lists.
|          test-core-network.cpp | Tests: network functions.
|          test-core-secure.cpp | Tests: secured data.
|          test-core-signal.cpp | Tests: signals.
|          test-core-string.cpp | Tests: strings.
|          test-core-url.cpp | Tests: URLs.
|          test-core-utf8.cpp | Tests: UTF-8.
@@ -426,8 +420,6 @@ WeeChat "core" is located in following directories:
|             test-irc-nick.cpp | Tests: IRC nicks.
|             test-irc-protocol.cpp | Tests: IRC protocol.
|             test-irc-server.cpp | Tests: IRC server.
|          trigger/ | Root of unit tests for trigger plugin.
|             test-trigger.cpp | Tests: triggers.
|          relay/ | Root of unit tests for Relay plugin.
|             test-relay-auth.cpp | Tests: clients authentication.
@@ -503,7 +495,7 @@ Example in C:
/*
* weechat.c - core functions for WeeChat
*
* Copyright (C) 2021 Your Name <your@email.com>
* Copyright (C) 2020 Your Name <your@email.com>
*
* This file is part of WeeChat, the extensible chat client.
*
@@ -1098,12 +1090,18 @@ Any patch for bug or new feature must be done on master branch, preferred way
is a GitHub pull request. A patch can also be sent by e-mail
(made with `git diff` or `git format-patch`).
Format of commit message is the following (with automatic close of a GitHub issue):
Format of commit message is the following (to close a GitHub issue):
----
component: fix a problem (closes #123)
----
For a Savannah bug:
----
component: fix a problem (bug #12345)
----
Where _component_ is one of following:
* WeeChat core: _core_ (files in root directory, _po/_ and _src/_,
@@ -1116,17 +1114,20 @@ Some rules to follow:
* Use only English.
* Use infinitive form of verb.
* If commit is related to a GitHub issue, write it in parenthesis after
the message, with this format: `(issue #123)` or `(closes #123)` to close it.
* If commit is related to something in tracker, write it in parenthesis after
the message, with this format:
** GitHub: closes #123
** Savannah: bug #12345, task #12345, patch #12345
Examples of commit messages:
----
core: add callback "nickcmp" for nick comparison in buffers
core: update Japanese translations
irc: add command /unquiet (closes #36)
python: fix crash when unloading a script without pointer to interpreter
core: add callback "nickcmp" for nick comparison in buffers
irc: fix freeze when reading on socket with SSL enabled (bug #35097)
ruby: add detection of ruby version 1.9.3 in CMake
python: fix crash when unloading a script without pointer to interpreter
core: update Japanese translations (patch #7783)
----
[[translations]]
+31 -63
View File
@@ -227,34 +227,6 @@ For example to use kbd:[F1], kbd:[F2], kbd:[Alt+F1] and kbd:[Alt+F2]:
Keys "meta-OP" and "meta-OQ" may be different in your terminal. To find key
code press kbd:[Alt+k] then key.
[[customize_buflist]]
=== How can I customize the list of buffers list, like the color of the active buffer?
You can browse all buflist options with the command:
----
/fset buflist
----
The background of the active buffer is blue by default, you can change it
like this, for example to `red`:
----
/set buflist.format.buffer_current "${color:,red}${format_buffer}"
----
[NOTE]
There's a comma before the color name "red" because it is used as the background,
not the text color. +
You can also use any numeric color instead of `red`,
like `237` for dark gray.
The buflist plugin provides lot of options that you can customize, please read
the help on each option.
There's also a wiki page with examples of advanced buflist configuration:
https://github.com/weechat/weechat/wiki/buflist
[[customize_prefix]]
=== How can I reduce length of nicks or remove nick alignment in chat area?
@@ -727,8 +699,7 @@ you have to use kbd:[Alt] instead of kbd:[Shift]).
If you are using macOS, you must install `openssl` from Homebrew.
A CA file will be bootstrapped using certificates from the system keychain.
With WeeChat ≤ 3.1, you can then set the path to system certificates:
You can then set the path to certificates in WeeChat:
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@@ -765,11 +736,10 @@ by your server name:
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
----
[[irc_ssl_libera]]
=== How can I connect to libera server using SSL?
[[irc_ssl_freenode]]
=== How can I connect to freenode server using SSL?
With WeeChat ≤ 3.1, set option _weechat.network.gnutls_ca_file_ to file with
certificates:
Set option _weechat.network.gnutls_ca_file_ to file with certificates:
----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
@@ -788,9 +758,9 @@ Check that you have this file on your system (commonly brought by package
Setup server port, SSL, then connect:
----
/set irc.server.libera.addresses "irc.libera.chat/6697"
/set irc.server.libera.ssl on
/connect libera
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
----
[[irc_oauth]]
@@ -815,25 +785,25 @@ If the server supports SASL, you should use that instead of sending the
command for nickserv authentication, for example:
----
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
----
If the server does not support SASL, you can add a delay (between command and
join of channels):
----
/set irc.server.libera.command_delay 5
/set irc.server.freenode.command_delay 5
----
[[edit_autojoin]]
=== How can I add/remove channels from autojoin option?
You can use the `/set` command to edit the list of autojoin channels,
for example for the "libera" server:
for example for the "freenode" server:
----
/set irc.server.libera.autojoin [TAB]
/set irc.server.freenode.autojoin [TAB]
----
[NOTE]
@@ -1004,16 +974,16 @@ _buffer_autoset.py_ script:
----
For example, to permanently disable highlights from "mike" on #weechat
on the IRC server libera:
on the IRC server freenode:
----
/buffer_autoset add irc.libera.#weechat hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2
----
To apply it to the entire libera server instead:
To apply it to the entire freenode server instead:
----
/buffer_autoset add irc.libera hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2
----
For more examples, see `+/help buffer_autoset+`.
@@ -1049,17 +1019,15 @@ Scripts are not compatible with other IRC clients.
[[scripts_update]]
=== The command "/script update" can not read scripts, how to fix that?
First check questions about SSL connection in this FAQ.
First check questions about SSL connection in this FAQ
(especially the option _weechat.network.gnutls_ca_file_).
If still not working, try to manually delete the scripts file (in your shell):
----
$ rm ~/.cache/weechat/script/plugins.xml.gz
$ rm ~/.weechat/script/plugins.xml.gz
----
[NOTE]
With WeeChat ≤ 3.1, the path should be: _~/.weechat/script/plugins.xml.gz_.
And update scripts again in WeeChat:
----
@@ -1079,7 +1047,7 @@ have to update manually the file yourself to get updates):
* in your shell, with curl installed:
----
$ cd ~/.cache/weechat/script
$ cd ~/.weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
----
@@ -1129,8 +1097,8 @@ You can try following tips to consume less memory:
fifo, logger, perl, python, ruby, lua, tcl, guile, javascript, php, spell,
xfer (used for DCC). See `/help weechat.plugin.autoload`.
* Load only scripts that you really need.
* Do not load system certificates if SSL is *NOT* used: turn off this option:
_weechat.network.gnutls_ca_system_.
* Do not load certificates if SSL is *NOT* used: set empty string in option
_weechat.network.gnutls_ca_file_.
* Reduce value of option _weechat.history.max_buffer_lines_number_ or set value
of option _weechat.history.max_buffer_lines_minutes_.
* Reduce value of option _weechat.history.max_commands_.
@@ -1186,20 +1154,21 @@ For example:
----
/secure passphrase xxxxxxxxxx
/secure set libera_username username
/secure set libera_password xxxxxxxx
/set irc.server.libera.sasl_username "${sec.data.libera_username}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
/secure set freenode_username username
/secure set freenode_password xxxxxxxx
/set irc.server.freenode.sasl_username "${sec.data.freenode_username}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
----
[[sharing_config_files]]
=== I want to share my WeeChat configuration, what files should I share and what should I keep private?
You can share configuration files _*.conf_ except the file _sec.conf_ which
You can share files _~/.weechat/*.conf_ except the file _sec.conf_ which
contains your passwords ciphered with your passphrase.
Some other files may contain sensitive info like passwords (if they are not
stored in _sec.conf_ with the `/secure` command).
Some other files like _irc.conf_ may contain sensitive info like passwords
for servers/channels (if they are not stored in _sec.conf_ with the `/secure`
command).
See the link:weechat_user.en.html#files_and_directories[User's guide / Files and directories]
for more information about configuration files.
@@ -1235,8 +1204,7 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
[[supported_os]]
=== What is the list of supported platforms for WeeChat? Will it be ported to other operating systems?
WeeChat runs fine on most Linux/BSD distributions, GNU/Hurd, Mac OS and Windows
(Cygwin and Windows Subsystem for Linux).
The full list is on this page: https://weechat.org/download
We do our best to run on as many platforms as possible. Help is welcome for
some OS' we don't have, to test WeeChat.
File diff suppressed because it is too large Load Diff
+28 -21
View File
@@ -105,12 +105,12 @@ other plugins in the list.
You can add an IRC server with the `/server` command, for example:
----
/server add libera irc.libera.chat/6697 -ssl
/server add freenode chat.freenode.net
----
In this command, `libera` is the internal server name used by WeeChat:
you'll be able to connect with `/connect libera` and the server options
are _irc.server.libera.xxx_.
In this command, `freenode` is the internal server name used by WeeChat:
you'll be able to connect with `/connect freenode` and the server options
are _irc.server.freenode.xxx_.
As usual, help is available if you're lost:
@@ -129,38 +129,45 @@ For each server option, WeeChat uses its value if it is defined (not
"null"). Otherwise WeeChat uses default value ("irc.server_default.xxx").
For example there are default nicks (based on your un*x login), and you can
override them for the libera server with following command:
override them for the freenode server with following command:
----
/set irc.server.libera.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
/set irc.server.freenode.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
----
To set the user and real names:
----
/set irc.server.libera.username "My user name"
/set irc.server.libera.realname "My real name"
/set irc.server.freenode.username "My user name"
/set irc.server.freenode.realname "My real name"
----
To enable auto-connect to server at startup:
----
/set irc.server.libera.autoconnect on
/set irc.server.freenode.autoconnect on
----
To connect with SSL:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
----
If SASL is available on the server, you can use it for authentication (you will be
identified before you join channels):
----
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
----
To run a command after connection to server, for example to authenticate
with nickserv (only if you don't use SASL for authentication):
----
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -175,23 +182,23 @@ First setup a passphrase:
/secure passphrase this is my secret passphrase
----
Then add a secured data with your libera password:
Then add a secured data with your freenode password:
----
/secure set libera_password xxxxxxx
/secure set freenode_password xxxxxxx
----
Then you can use `+${sec.data.libera_password}+` instead of your password in the
Then you can use `+${sec.data.freenode_password}+` instead of your password in the
IRC options mentioned above, for example:
----
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
----
To auto-join some channels when connecting to server:
----
/set irc.server.libera.autojoin "#channel1,#channel2"
/set irc.server.freenode.autojoin "#channel1,#channel2"
----
[TIP]
@@ -203,24 +210,24 @@ To remove a value of a server option, and use the default value instead,
for example to use default nicks (irc.server_default.nicks):
----
/unset irc.server.libera.nicks
/unset irc.server.freenode.nicks
----
Other options: you can setup other options with the following command ("xxx" is
option name):
----
/set irc.server.libera.xxx value
/set irc.server.freenode.xxx value
----
[[connect_to_irc_server]]
== Connect to IRC server
----
/connect libera
/connect freenode
----
With this command, WeeChat connects to the libera server and auto-joins the
With this command, WeeChat connects to the freenode server and auto-joins the
channels configured in the "autojoin" server option.
[NOTE]
+72 -72
View File
@@ -436,11 +436,11 @@ hda:
item 2:
__path: ['0x558d62840ea0']
number: 1
full_name: 'irc.server.libera'
full_name: 'irc.server.freenode'
item 3:
__path: ['0x558d62a9cea0']
number: 2
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
----
* Request all lines of first buffer:
@@ -588,15 +588,15 @@ inf: ('version_number', '34144256')
* Request WeeChat directory:
----
(info_weechat_config_dir) info weechat_config_dir
(info_weechat_dir) info weechat_dir
----
Response:
[source,python]
----
id: 'info_weechat_config_dir'
inf: ('weechat_config_dir', '/home/user/.config/weechat')
id: 'info_weechat_dir'
inf: ('weechat_dir', '/home/xxx/.weechat')
----
[[command_infolist]]
@@ -747,7 +747,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.libera.#weechat_)
_core.weechat_ or _irc.freenode.#weechat_)
Examples:
@@ -856,10 +856,10 @@ hda:
prefix_color: None
----
* Request nicklist for buffer "irc.libera.#weechat":
* Request nicklist for buffer "irc.freenode.#weechat":
----
(nicklist_weechat) nicklist irc.libera.#weechat
(nicklist_weechat) nicklist irc.freenode.#weechat
----
Response:
@@ -948,7 +948,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.libera.#weechat_)
_core.weechat_ or _irc.freenode.#weechat_)
* _data_: data to send to buffer: if beginning by `/`, this will be executed as
a command on buffer, otherwise text is sent as input of buffer
@@ -963,7 +963,7 @@ input core.weechat /help filter
* Send message "hello!" to #weechat channel:
----
input irc.libera.#weechat hello!
input irc.freenode.#weechat hello!
----
[[command_completion]]
@@ -983,7 +983,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.libera.#weechat_)
_core.weechat_ or _irc.freenode.#weechat_)
* _position_: position for completion in string (starts to 0);
if the value is -1, the position is the length of _data_ (so the completion
is made at the end of _data_)
@@ -1144,7 +1144,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.libera.#weechat_); name "*" can be used to
_core.weechat_ or _irc.freenode.#weechat_); name "*" can be used to
specify all buffers
* _options_: one of following keywords, separated by commas (default is
_buffers,upgrade,buffer,nicklist_ for "*" and _buffer,nicklist_ for a buffer):
@@ -1179,14 +1179,14 @@ sync core.buffer
* Synchronize #weechat channel, without nicklist:
----
sync irc.libera.#weechat buffer
sync irc.freenode.#weechat buffer
----
* Get general signals + all signals for #weechat channel:
----
sync * buffers,upgrade
sync irc.libera.#weechat
sync irc.freenode.#weechat
----
[[command_desync]]
@@ -1209,7 +1209,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.libera.#weechat_); name "*" can be used to
_core.weechat_ or _irc.freenode.#weechat_); name "*" can be used to
specify all buffers
* _options_: one of following keywords, separated by commas (default is
_buffers,upgrade,buffer,nicklist_ for "*" and _buffer,nicklist_ for a buffer);
@@ -1217,7 +1217,7 @@ Arguments:
[NOTE]
When using buffer "*", the other buffers synchronized (using a name) are kept. +
So if you send: "sync *", then "sync irc.libera.#weechat", then "desync *",
So if you send: "sync *", then "sync irc.freenode.#weechat", then "desync *",
the updates on #weechat channel will still be sent by WeeChat (you must remove
it explicitly to stop updates).
@@ -1235,13 +1235,13 @@ desync * buffers,upgrade,buffer,nicklist
* Desynchronize nicklist for #weechat channel (keep buffer updates):
----
desync irc.libera.#weechat nicklist
desync irc.freenode.#weechat nicklist
----
* Desynchronize #weechat channel:
----
desync irc.libera.#weechat
desync irc.freenode.#weechat
----
[[command_test]]
@@ -1481,7 +1481,7 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| short_name | string | Short name (example: _#weechat_).
| nicklist | integer | 1 if buffer has a nicklist, otherwise 0.
| title | string | Buffer title.
@@ -1490,8 +1490,8 @@ Data sent as hdata:
| next_buffer | pointer | Pointer to next buffer.
|===
Example: channel _#weechat_ joined on libera, new buffer
_irc.libera.#weechat_:
Example: channel _#weechat_ joined on freenode, new buffer
_irc.freenode.#weechat_:
[source,python]
----
@@ -1511,13 +1511,13 @@ hda:
item 1:
__path: ['0x35a8a60']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
short_name: None
nicklist: 0
title: None
local_variables: {
'plugin': 'irc',
'name': 'libera.#weechat',
'name': 'freenode.#weechat',
}
prev_buffer: '0x34e7400'
next_buffer: '0x0'
@@ -1535,12 +1535,12 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.libera.#weechat_ moved to number 2:
Example: buffer _irc.freenode.#weechat_ moved to number 2:
[source,python]
----
@@ -1556,7 +1556,7 @@ hda:
item 1:
__path: ['0x34588c0']
number: 2
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x347b9f0'
next_buffer: '0x3471bc0'
----
@@ -1573,12 +1573,12 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.libera.#weechat_ merged with buffer #2:
Example: buffer _irc.freenode.#weechat_ merged with buffer #2:
[source,python]
----
@@ -1594,7 +1594,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1611,12 +1611,12 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.libera.#weechat_ unmerged:
Example: buffer _irc.freenode.#weechat_ unmerged:
[source,python]
----
@@ -1632,7 +1632,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1651,12 +1651,12 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.libera.#weechat_ hidden:
Example: buffer _irc.freenode.#weechat_ hidden:
[source,python]
----
@@ -1672,7 +1672,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1691,12 +1691,12 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.libera.#weechat_ unhidden:
Example: buffer _irc.freenode.#weechat_ unhidden:
[source,python]
----
@@ -1712,7 +1712,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1729,7 +1729,7 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| short_name | string | Short name (example: _#weechat_).
| local_variables | hashtable | Local variables.
|===
@@ -1750,15 +1750,15 @@ hda:
item 1:
__path: ['0x4df7b80']
number: 5
full_name: 'irc.libera.Flash2'
full_name: 'irc.freenode.Flash2'
short_name: 'Flash2'
local_variables: {
'server': 'libera',
'server': 'freenode',
'plugin': 'irc',
'type': 'private',
'channel': 'FlashCode',
'nick': 'test',
'name': 'libera.Flash2',
'name': 'freenode.Flash2',
}
----
@@ -1774,7 +1774,7 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| title | string | Buffer title.
|===
@@ -1793,7 +1793,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
title: 'Welcome on #weechat! https://weechat.org/'
----
@@ -1811,10 +1811,10 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
|===
Example: buffer _irc.libera.#weechat_ has been cleared:
Example: buffer _irc.freenode.#weechat_ has been cleared:
[source,python]
----
@@ -1828,7 +1828,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
----
[[message_buffer_type_changed]]
@@ -1843,7 +1843,7 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| type | integer | Buffer type: 0 = formatted (default), 1 = free content.
|===
@@ -1879,11 +1879,11 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| local_variables | hashtable | Local variables.
|===
Example: local variable _test_ added in buffer _irc.libera.#weechat_:
Example: local variable _test_ added in buffer _irc.freenode.#weechat_:
[source,python]
----
@@ -1898,15 +1898,15 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
local_variables: {
'server': 'libera',
'server': 'freenode',
'test': 'value',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'libera.#weechat',
'name': 'freenode.#weechat',
}
----
@@ -1922,11 +1922,11 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| local_variables | hashtable | Local variables.
|===
Example: local variable _test_ updated in buffer _irc.libera.#weechat_:
Example: local variable _test_ updated in buffer _irc.freenode.#weechat_:
[source,python]
----
@@ -1941,7 +1941,7 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
local_variables: {
'server': 'local',
'test': 'value2',
@@ -1949,7 +1949,7 @@ hda:
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'libera.#weechat',
'name': 'freenode.#weechat',
}
----
@@ -1965,11 +1965,11 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| local_variables | hashtable | Local variables.
|===
Example: local variable _test_ removed from buffer _irc.libera.#weechat_:
Example: local variable _test_ removed from buffer _irc.freenode.#weechat_:
[source,python]
----
@@ -1984,14 +1984,14 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.libera.#prout'
full_name: 'irc.freenode.#prout'
local_variables: {
'server': 'local',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'libera.#weechat',
'name': 'freenode.#weechat',
}
----
@@ -2017,7 +2017,7 @@ Data sent as hdata:
| message | string | Message.
|===
Example: new message _hello!_ from nick _FlashCode_ on buffer _irc.libera.#weechat_:
Example: new message _hello!_ from nick _FlashCode_ on buffer _irc.freenode.#weechat_:
[source,python]
----
@@ -2066,10 +2066,10 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
|===
Example: buffer _irc.libera.#weechat_ is being closed by WeeChat:
Example: buffer _irc.freenode.#weechat_ is being closed by WeeChat:
[source,python]
----
@@ -2083,7 +2083,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
----
[[message_nicklist]]
@@ -2109,7 +2109,7 @@ Data sent as hdata:
| prefix_color | string | Prefix color (only for a nick).
|===
Example: nicklist for buffer _irc.libera.#weechat_:
Example: nicklist for buffer _irc.freenode.#weechat_:
[source,python]
----
@@ -2529,7 +2529,7 @@ objects, and then set of objects (path with pointers, then objects).
* _values_: list of values (number of values is number of keys returned for
hdata)
Example of hdata with two buffers (weechat core and libera server) and two
Example of hdata with two buffers (weechat core and freenode server) and two
keys (_number_ and _full_name_):
....
@@ -2537,10 +2537,10 @@ keys (_number_ and _full_name_):
hdata buffer:gui_buffers(*) number,full_name
# response
┌────────┬──────────────────────────┬───╥─────────┬───┬──────────────╥─────────┬───┬───────────────────┐
│ buffer │ number:int,full_name:str │ 2 ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │ irc.server.libera
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴───────────────────┘
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └───────────────────────────────┘
┌────────┬──────────────────────────┬───╥─────────┬───┬──────────────╥─────────┬───┬─────────────────────
│ buffer │ number:int,full_name:str │ 2 ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │ irc.server.freenode
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴─────────────────────
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └─────────────────────────────────
h-path keys count buffer 1 buffer 2
....
@@ -2682,7 +2682,7 @@ An item is:
** _type_: type of variable (_int_, _str_, ...)
** _value_: value of variable
Example of infolist with two buffers (weechat core and libera server):
Example of infolist with two buffers (weechat core and freenode server):
....
# command
+67 -91
View File
@@ -66,17 +66,12 @@ link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference].
[[languages_specificities]]
=== Languages specificities
[[language_python]]
==== Python
[[python_module]]
===== Module
WeeChat defines a `weechat` module which must be imported with `import weechat`. +
A Python stub for WeeChat API is available in the repository:
https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi].
WeeChat defines a `weechat` module which must be imported with `import weechat`.
[[python_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...)+`.
@@ -84,7 +79,6 @@ Functions are called with `+weechat.xxx(arg1, arg2, ...)+`.
Functions `+print*+` are called `+prnt*+` in python (because `print` was a
reserved keyword in Python 2).
[[python_strings]]
===== Strings received in callbacks
In Python 3 and with WeeChat ≥ 2.7, the strings received in callbacks have type
@@ -138,23 +132,18 @@ In Python 2, which is now deprecated and should not be used any more, the
strings sent to callbacks are always of type `str`, and may contain invalid
UTF-8 data, in the cases mentioned above.
[[language_perl]]
==== Perl
[[perl_functions]]
===== Functions
Functions are called with `+weechat::xxx(arg1, arg2, ...);+`.
[[language_ruby]]
==== Ruby
[[ruby_init]]
===== Initialization
You have to define _weechat_init_ and call _register_ inside.
[[ruby_functions]]
===== Functions
Functions are called with `+Weechat.xxx(arg1, arg2, ...)+`.
@@ -179,26 +168,20 @@ Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical"
["default", "default", "default", "default"], "0", "items")
----
[[language_lua]]
==== Lua
[[lua_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...)+`.
[[language_tcl]]
==== Tcl
[[tcl_functions]]
===== Functions
Functions are called with `+weechat::xxx arg1 arg2 ...+`.
[[language_guile]]
==== Guile (Scheme)
[[guile_functions]]
===== Functions
Functions are called with `+(weechat:xxx arg1 arg2 ...)+`.
@@ -211,18 +194,14 @@ arguments in Guile:
* config_new_option
* bar_new
[[language_javascript]]
==== JavaScript
[[javascript_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...);+`.
[[language_php]]
==== PHP
[[php_functions]]
===== Functions
Functions are called with `+weechat_xxx(arg1, arg2, ...);+`.
@@ -233,11 +212,11 @@ Functions are called with `+weechat_xxx(arg1, arg2, ...);+`.
All WeeChat scripts must "register" themselves to WeeChat, and this must be
first WeeChat function called in script.
Prototype (Python):
Prototype:
[source,python]
----
def register(name: str, author: str, version: str, license: str, description: str, shutdown_function: str, charset: str) -> int: ...
weechat.register(name, author, version, license, description, shutdown_function, charset)
----
Arguments:
@@ -358,7 +337,7 @@ WeeChat is starting.
For example with Python:
----
$ cd ~/.local/share/weechat/python/autoload
$ cd ~/.weechat/python/autoload
$ ln -s ../script.py
----
@@ -797,58 +776,58 @@ List of constants in script API:
| Category | Constants
| return codes |
`WEECHAT_RC_OK` (integer) +
`WEECHAT_RC_OK_EAT` (integer) +
`WEECHAT_RC_ERROR` (integer)
WEECHAT_RC_OK +
WEECHAT_RC_OK_EAT +
WEECHAT_RC_ERROR
| configuration files |
`WEECHAT_CONFIG_READ_OK` (integer) +
`WEECHAT_CONFIG_READ_MEMORY_ERROR` (integer) +
`WEECHAT_CONFIG_READ_FILE_NOT_FOUND` (integer) +
`WEECHAT_CONFIG_WRITE_OK` (integer) +
`WEECHAT_CONFIG_WRITE_ERROR` (integer) +
`WEECHAT_CONFIG_WRITE_MEMORY_ERROR` (integer) +
`WEECHAT_CONFIG_OPTION_SET_OK_CHANGED` (integer) +
`WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE` (integer) +
`WEECHAT_CONFIG_OPTION_SET_ERROR` (integer) +
`WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_RESET` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_ERROR` (integer)
WEECHAT_CONFIG_READ_OK +
WEECHAT_CONFIG_READ_MEMORY_ERROR +
WEECHAT_CONFIG_READ_FILE_NOT_FOUND +
WEECHAT_CONFIG_WRITE_OK +
WEECHAT_CONFIG_WRITE_ERROR +
WEECHAT_CONFIG_WRITE_MEMORY_ERROR +
WEECHAT_CONFIG_OPTION_SET_OK_CHANGED +
WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE +
WEECHAT_CONFIG_OPTION_SET_ERROR +
WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND +
WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET +
WEECHAT_CONFIG_OPTION_UNSET_OK_RESET +
WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED +
WEECHAT_CONFIG_OPTION_UNSET_ERROR
| sorted lists |
`WEECHAT_LIST_POS_SORT` (string) +
`WEECHAT_LIST_POS_BEGINNING` (string) +
`WEECHAT_LIST_POS_END` (string)
WEECHAT_LIST_POS_SORT +
WEECHAT_LIST_POS_BEGINNING +
WEECHAT_LIST_POS_END
| hotlist |
`WEECHAT_HOTLIST_LOW` (string) +
`WEECHAT_HOTLIST_MESSAGE` (string) +
`WEECHAT_HOTLIST_PRIVATE` (string) +
`WEECHAT_HOTLIST_HIGHLIGHT` (string)
WEECHAT_HOTLIST_LOW +
WEECHAT_HOTLIST_MESSAGE +
WEECHAT_HOTLIST_PRIVATE +
WEECHAT_HOTLIST_HIGHLIGHT
| hook process |
`WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
`WEECHAT_HOOK_PROCESS_ERROR` (integer)
WEECHAT_HOOK_PROCESS_RUNNING +
WEECHAT_HOOK_PROCESS_ERROR
| hook connect |
`WEECHAT_HOOK_CONNECT_OK` (integer) +
`WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND` (integer) +
`WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND` (integer) +
`WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED` (integer) +
`WEECHAT_HOOK_CONNECT_PROXY_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_MEMORY_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_TIMEOUT` (integer) +
`WEECHAT_HOOK_CONNECT_SOCKET_ERROR` (integer)
WEECHAT_HOOK_CONNECT_OK +
WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND +
WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND +
WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED +
WEECHAT_HOOK_CONNECT_PROXY_ERROR +
WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR +
WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR +
WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR +
WEECHAT_HOOK_CONNECT_MEMORY_ERROR +
WEECHAT_HOOK_CONNECT_TIMEOUT +
WEECHAT_HOOK_CONNECT_SOCKET_ERROR
| hook signal |
`WEECHAT_HOOK_SIGNAL_STRING` (string) +
`WEECHAT_HOOK_SIGNAL_INT` (string) +
`WEECHAT_HOOK_SIGNAL_POINTER` (string)
WEECHAT_HOOK_SIGNAL_STRING +
WEECHAT_HOOK_SIGNAL_INT +
WEECHAT_HOOK_SIGNAL_POINTER
|===
[[common_tasks]]
@@ -889,13 +868,13 @@ weechat.prnt("", "%swrong arguments" % weechat.prefix("error"))
weechat.prnt("", "text %syellow on blue" % weechat.color("yellow,blue"))
# search buffer and display message
# (full name of buffer is plugin.name, for example: "irc.libera.#weechat")
buffer = weechat.buffer_search("irc", "libera.#weechat")
# (full name of buffer is plugin.name, for example: "irc.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
weechat.prnt(buffer, "message on #weechat channel")
# other solution to find an IRC buffer (better)
# (note that server and channel are separated by a comma)
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
weechat.prnt(buffer, "message on #weechat channel")
----
@@ -916,7 +895,7 @@ Examples:
weechat.command("", "/help")
# send "hello" to #weechat IRC channel (users on channel will see message)
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
weechat.command(buffer, "hello")
----
@@ -986,7 +965,7 @@ weechat.buffer_set(buffer, "localvar_del_myvar", "")
To see local variables of a buffer, do this command in WeeChat:
----
/buffer listvar
/buffer localvar
----
[[hooks]]
@@ -1217,7 +1196,7 @@ xxx,irc_raw_in2_yyy::
[source,python]
----
def join_cb(data, signal, signal_data):
# signal is for example: "libera,irc_in2_join"
# signal is for example: "freenode,irc_in2_join"
# signal_data is IRC message, for example: ":nick!user@host JOIN :#channel"
server = signal.split(",")[0]
msg = weechat.info_get_hashtable("irc_message_parse", {"message": signal_data})
@@ -1269,66 +1248,63 @@ The result is a hashtable with following keys
(the example values are built with this message:
`+@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!+`):
[width="100%",cols="3,^2,10,7",options="header"]
[width="100%",cols="1,^2,10,8",options="header"]
|===
| Key | Since WeeChat ^(1)^ | Description | Example
| Key | WeeChat version | Description | Example
| tags | 0.4.0 |
| tags | 0.4.0 |
The tags in message (can be empty). |
`+time=2015-06-27T16:40:35.000Z+`
| message_without_tags | 0.4.0 |
| message_without_tags | 0.4.0 |
The message without the tags (the same as message if there are no tags). |
`+:nick!user@host PRIVMSG #weechat :hello!+`
| nick | 0.3.4 |
| nick | 0.3.4 |
The origin nick. |
`+nick+`
| user | 2.7 |
| user | 2.7 |
The origin user. |
`+user+`
| host | 0.3.4 |
| host | 0.3.4 |
The origin host (includes the nick). |
`+nick!user@host+`
| command | 0.3.4 |
| command | 0.3.4 |
The command (_PRIVMSG_, _NOTICE_, ...). |
`+PRIVMSG+`
| channel | 0.3.4 |
| channel | 0.3.4 |
The target channel. |
`+#weechat+`
| arguments | 0.3.4 |
| arguments | 0.3.4 |
The command arguments (includes the channel). |
`+#weechat :hello!+`
| text | 1.3 |
| text | 1.3 |
The text (for example user message). |
`+hello!+`
| pos_command | 1.3 |
| pos_command | 1.3 |
The index of _command_ in message ("-1" if _command_ was not found). |
`+47+`
| pos_arguments | 1.3 |
| pos_arguments | 1.3 |
The index of _arguments_ in message ("-1" if _arguments_ was not found). |
`+55+`
| pos_channel | 1.3 |
| pos_channel | 1.3 |
The index of _channel_ in message ("-1" if _channel_ was not found). |
`+55+`
| pos_text | 1.3 |
| pos_text | 1.3 |
The index of _text_ in message ("-1" if _text_ was not found). |
`+65+`
|===
[NOTE]
^(1)^ The key has been introduced in this WeeChat version.
[source,python]
----
dict = weechat.info_get_hashtable(
@@ -1389,8 +1365,8 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[source,python]
----
# WeeChat config directory, for example: "/home/user/.config/weechat"
weechat.prnt("", "WeeChat config dir: %s" % weechat.info_get("weechat_config_dir", ""))
# WeeChat home directory, for example: "/home/xxxx/.weechat"
weechat.prnt("", "WeeChat home dir: %s" % weechat.info_get("weechat_dir", ""))
# keyboard inactivity
weechat.prnt("", "Inactivity since %s seconds" % weechat.info_get("inactivity", ""))
+1 -1
View File
@@ -126,6 +126,6 @@ If you're still awake you should see the familiar interface and brag about
having the newest possible version of WeeChat. ;)
Now if you experience strange behavior (it may have issues or crash or boil
your beer) don't hesitate to join _#weechat_ at _irc.libera.chat_ and tell us.
your beer) don't hesitate to join _#weechat_ at _chat.freenode.net_ and tell us.
If it doesn't crash - tell us too, we need your feedback!
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2012-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2012-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2012-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2012-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+141 -103
View File
@@ -1,4 +1,4 @@
= WeeChat guía rápida
= WeeChat Quick Start Guide
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: es
@@ -7,54 +7,57 @@
:docinfo1:
Traductores:
// TRANSLATION MISSING
Translators:
* Lázaro A. <uranio-235@myopera.com>, 2012
* Victorhck <victorhck@mailbox.org>, 2021
[[start]]
== Iniciar WeeChat
Es recomendable un emulador de terminal para X (pero no indispensable)
Es recomendable una terminal emulada para X (pero no indispensable)
rxvt-unicode: tiene un buen soporte para UTF-8, y no da problemas con
los atajos de teclado predeterminados.
los atajas de teclados predeterminados.
Ejecuta desde una consola:
// TRANSLATION MISSING
Run from your shell:
----
$ weechat
----
[[help]]
== Ayuda en línea
== Ayuda en linea
WeeChat tiene ayuda para todos los comandos, simplemente escriba:
WeeChat tiene ayuda para todos los comandos, solo teclee:
----
/help
----
Para obtener ayuda específica de un comando, escriba:
Para obtener ayuda específicamente de un comando, teclee:
----
/help comando
----
También hay ayuda disponible para las opciones:
// TRANSLATION MISSING
Help is available for options as well:
----
/help config.section.option
----
(donde `config` es el nombre de la configuración del núcleo o del
complemento que desea configurar, `section`, la sección de esa configuración
plugin que desea configurar, `section`, la sección de esa configuración
y `option` el nombre de la opción).
// TRANSLATION MISSING
[[options]]
== Configurar las opciones
== Set options
Para configurar una opción, utilice:
Para configurar una opción, use:
----
/set config.section.option valor
@@ -63,66 +66,75 @@ Para configurar una opción, utilice:
WeeChat usará inmediatamente el nuevo valor asignado (*no* es necesario
reiniciar WeeChat después de aplicar cambios a la configuración).
Todas las opciones se guardarán de manera automática cuando cierre
WeeChat o usando el comando `/save` para forzar a WeeChat a
Todas las opciones se salvarán de manera automática cuando cierre
WeeChat o usando el comando `/save` para forzar la forzar a WeeChat a
guardar todos los archivos de configuración.
// TRANSLATION MISSING
[IMPORTANT]
*No se recomienda* editar los archivos de configuración a mano porque WeeChat
puede escribirlos en cualquier momento (por ejemplo al ejecutar `/quit`) y después de cualquier cambio
debería ejecutar el comando `/reload` (con el riesgo de perder otros cambios
que todavía no fueron guardados con `/save`). +
Puede utilizar el comando `/set`, que comprueba el valor y aplica inmediatamente
los cambios.
It is *not recommended* to edit configuration files by hand because WeeChat
may write them at any time (for example on `/quit`) and after any change
you must run the command `/reload` (with the risk of losing other changes
that were not yet saved with `/save`). +
You can use the command `/set`, which checks the value and applies immediately
the changes.
El complemento _fset_ le permite navegar fácilmente por las opciones y cambiarlas.
// TRANSLATION MISSING
The plugin _fset_ allows you to easily browse options and change them.
Por ejemplo para mostrar las opciones de WeeChat:
// TRANSLATION MISSING
For example to display WeeChat options:
----
/fset weechat.*
----
Opciones de IRC:
// TRANSLATION MISSING
IRC options:
----
/fset irc.*
----
El comando `/fset` dispone de autocompletado de parte de los nombres de opciones, así por ejemplo si
escribe `/fset hot` y presiona kbd:[Tab] el resto del comando será autocompletado como `/fset hotlist`.
Si pulsa kbd:[Enter], se mostrarán las opciones sobre los atajos de teclado.
// TRANSLATION MISSING
The `/fset` command has completion on part of option names, so for example if
you type `/fset hot` and press kbd:[Tab] this is completed as `/fset hotlist`.
If you press kbd:[Enter], options about the hotlist are displayed.
Para más información sobre el comando `/fset` y las teclas, vea `/help fset`.
// TRANSLATION MISSING
For more information about `/fset` command and keys, see `/help fset`.
[[core_vs_plugins]]
== Núcleo vs Complementos
== Núcleo vs Plugins
Llamaremos "Núcleo de WeeChat" a la aplicación que solo se usa para
mostrar información en pantalla e interactuar con el usuario, eso es lo
único que hace el núcleo de WeeChat sin no tiene complementos. (para los
único que hace el núcleo de WeeChat sin no tiene plugins. (para los
fieles seguidores: IRC fue parte del núcleo para las versiones ≤
0.2.6).
Todos los protocolos de red como IRC, provienen de complementos separados.
Todos los protocolos de red como IRC, provienen en plugins separados.
Use el comando `/plugin` para ver una lista de los complementos cargados,
Use el comando `/plugin` para ver una lista de los plugins cargados,
seguramente vera irc y otros.
// TRANSLATION MISSING
[[add_irc_server]]
== Añadir un servidor IRC
== Add an IRC server
Puede añadir un servidor IRC mediante el comando `/server`, por ejemplo:
// TRANSLATION MISSING
You can add an IRC server with `/server` command, for example:
----
/server add libera irc.libera.chat/6697 -ssl
/server add freenode chat.freenode.net
----
En este comando, `libera` es el nombre interno del servidor utilizado por WeeChat:
más tarde podrá conectar con ese servidor mediante `/connect libera` y las opciones del servidor
serán _irc.server.libera.xxx_.
// TRANSLATION MISSING
In this command, `freenode` is the internal server name used by WeeChat:
you'll be able to connect with `/connect freenode` and the server options
are _irc.server.freenode.xxx_.
Si se encuentra perdido, puede consultar la ayuda disponible:
La ayuda está disponible; si te pierdes:
----
/help server
@@ -131,9 +143,9 @@ Si se encuentra perdido, puede consultar la ayuda disponible:
[[irc_server_options]]
== Personalizar las opciones de un servidor IRC
WeeChat usa las opciones predeterminadas para todos los servidores
WeeChat usa las opciones por defecto para todos los servidores
("predeterminado") si no le especifica un valor individual a un servidor
en específico. Esas opciones predeterminadas son las que se muestran en
en específico. Esas opciones por defectos son las que se muestran en
"irc.server_default.*"
Para cada opción de "server", WeeChat usa estos valores previamente
@@ -141,105 +153,123 @@ asignados siempre y cuando no sean Nulos. Si no hay nada asignado,
WeeChat usara los valores predeterminados ("irc.server_default.xxx")
Por ejemplo, tenemos el nick por defecto (que se basa en su login) pero
usted puedes sobreescribirlo para el servidor identificado como libera
usted puedes sobreescribirlo para el servidor identificado como freenode
de la siguiente manera:
----
/set irc.server.libera.nicks "nick,nick2,nick3,nick4,nick5"
/set irc.server.freenode.nicks "nick,nick2,nick3,nick4,nick5"
----
También para configurar el nombre de usuario y el nombre real:
----
/set irc.server.libera.username "Mi nombre de usuario"
/set irc.server.libera.realname "Mi nombre real"
/set irc.server.freenode.username "Mi nombre de usuario"
/set irc.server.freenode.realname "Mi nombre real"
----
Para que el servidor se conecte cuando WeeChat inicie:
----
/set irc.server.libera.autoconnect on
/set irc.server.freenode.autoconnect on
----
Si la opción SASL está disponible en el servidor, puede utilizarla para autentificarse (será
identificado o identificada antes de unirse a los canales):
// TRANSLATION MISSING
To connect with SSL:
----
/set irc.server.libera.sasl_username "nick"
/set irc.server.libera.sasl_password "xxxxxxx"
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
----
Para ejecutar un comando después de conectarse al servidor, por ejemplo autentificarse
con el servicio de identificación de nicks nickserv (solo si no utiliza SASL para autentificarse):
// TRANSLATION MISSING
If SASL is available on server, you can use it for authentication (you will be
identified before you join channels):
----
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
/set irc.server.freenode.sasl_username "nick"
/set irc.server.freenode.sasl_password "xxxxxxx"
----
// TRANSLATION MISSING
To run a command after connection to server, for example to authenticate
with nickserv (only if you don't use SASL for authentication):
----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
----
// TRANSLATION MISSING
[NOTE]
Muchos comandos en la opción _command_ pueden ser separados por `;` (punto y coma).
Many commands in option _command_ can be separated by `;` (semi-colon).
Si quiere proteger su contraseña en los archivos de configuración, puede utilizar
una securización de los datos.
// TRANSLATION MISSING
If you want to protect your password in configuration files, you can use
secured data.
Primero configure una frase de contraseña
// TRANSLATION MISSING
First setup a passphrase:
----
/secure passphrase this is my secret passphrase
----
Después añada un dato securizado con su contraseña de libera:
// TRANSLATION MISSING
Then add a secured data with your freenode password:
----
/secure set libera_password xxxxxxx
/secure set freenode_password xxxxxxx
----
Después puede utilizar `+${sec.data.libera_password}+` en vez de su contraseña en
las opciones de IRC mencionadas anteriormente, por ejemplo:
// TRANSLATION MISSING
Then you can use `+${sec.data.freenode_password}+` instead of your password in
IRC options mentioned above, for example:
----
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
----
Para unirse automáticamente a canales cuando el servidor se conecte:
----
/set irc.server.libera.autojoin "#uncanal,#otrocanal"
/set irc.server.freenode.autojoin "#uncanal,#otrocanal"
----
// TRANSLATION MISSING
[TIP]
Puede completar el nombre y el valor de las opciones con la tecla kbd:[Tab]
y kbd:[Shift+Tab] para un autocompletado parcial (útil para palabras largas como
el nombre de la opción).
You can complete name and value of options with the kbd:[Tab] key
and kbd:[Shift+Tab] for a partial completion (useful for long words like
the name of option).
Para eliminar un valor asignado a una opción de servidor y usar los
valores predeterminados en su lugar, por ejemplo, usar el nick predeterminado
valores por defecto en su lugar, por ejemplo, usar el nick por defecto
(irc.server_default.nicks):
----
/unset irc.server.libera.nicks
/unset irc.server.freenode.nicks
----
Otras opciones: puede configurar otras opciones con el siguiente comando,
Otras opciones: pude configurar otras opciones con el siguiente comando,
donde "xxx" es el nombre de la opción.
----
/set irc.server.libera.xxx valor
/set irc.server.freenode.xxx valor
----
[[connect_to_irc_server]]
== Conectarse a un servidor IRC
----
/connect libera
/connect freenode
----
Con este comando, WeeChat se conecta al servidor de libera y inicia sesión automáticamente en
los canales configurados en la opción del servidor "autojoin".
// TRANSLATION MISSING
With this command, WeeChat connects to the freenode server and auto-joins the
channels configured in the "autojoin" server option.
// TRANSLATION MISSING
[NOTE]
Este comando también puede usarse para crear y conectarse a un nuevo
servidor sin usar el comando `/server` (vea `/help connect`).
servidor sin usar el comando `/server` (see `/help connect`).
Por defecto, todos los buffers del servidor están junto al buffer de
núcleo. Para cambiar entre el buffer del núcleo y el buffer de los
@@ -267,32 +297,36 @@ Sale de un canal (mantiene el buffer abierto):
/part [mensaje de partida]
----
Cierra un servidor, canal o buffer privado (`/close` es un alias para
// TRANSLATION MISSING
Close a server, channel or private buffer (`/close` is an alias for
`/buffer close`):
----
/close
----
// TRANSLATION MISSING
[WARNING]
Al cerrar el buffer del servidor cerrará todos los buffer de canales/privados
Closing the server buffer will close all channel/private buffers.
Para desconectar del servidor, en el buffer del servidor ejecute:
// TRANSLATION MISSING
Disconnect from server, on the server buffer:
----
/disconnect
----
// TRANSLATION MISSING
[[irc_private_messages]]
== Mensajes privados en IRC
== IRC private messages
Abre un buffer y envíe un mensaje a otra persona (nick _foo_):
Open a buffer and send a message to another user (nick _foo_):
----
/query foo esto es un mensaje
/query foo this is a message
----
Cierra el buffer privado:
Close the private buffer:
----
/close
@@ -301,11 +335,11 @@ Cierra el buffer privado:
[[buffer_window]]
== Manipulando buffer/ventana
Un buffer, es un componente vinculado a un complemento con un número, una
Un buffer, es un componente vinculado a un plugin con un número, una
categoría y un nombre. El buffer contiene los datos que se muestran en
la pantalla.
Una ventana es una vista de un buffer. De manera predeterminada, una sola ventana
Una ventana es una vista de un buffer. Por defecto, una sola ventana
muestra un solo buffer. Si divide la pantalla, podrá ver muchas
ventanas conteniendo varios buffer al mismo tiempo.
@@ -323,7 +357,8 @@ junto a otras mas grande (2/3) use el comando
/window splitv 33
----
Para eliminar esa división:
// TRANSLATION MISSING
To remove the split:
----
/window merge
@@ -332,19 +367,19 @@ Para eliminar esa división:
[[key_bindings]]
== Atajos de teclado
WeeChat usa muchas teclas por defecto. Éstas, están bien
WeeChat usa muchas teclas por defecto. Las mismas, están bien
explicadas en la documentación pero debe conocer al menos la mas
importantes.
- kbd:[Alt+←] / kbd:[Alt+→] o kbd:[F5] / kbd:[F6]: Cambiará al buffer
- kbd:[Alt+←] / kbd:[Alt+→] o kbd:[F5] / kbd:[F6]: Cambiara al buffer
siguiente/anterior
// TRANSLATION MISSING
- kbd:[F1] / kbd:[F2]: desplazará la barra de scroll con la lista de buffers ("buflist")
- kbd:[F7] / kbd:[F8]: cambiará a la siguiente/anterior ventana (cuando la pantalla
- kbd:[F1] / kbd:[F2]: scroll bar with list of buffers ("buflist")
- kbd:[F7] / kbd:[F8]: Cambiara a la siguiente/anterior ventana (cuando la pantalla
este dividida)
- kbd:[F9] / kbd:[F10]: desplazamiento del texto en la barra de título
- kbd:[F11] / kbd:[F12]: desplazamiento del texto en la lista de nicks
- kbd:[Tab]: completa los textos o nicks que se escriben
- kbd:[F9] / kbd:[F10]: desplazamiento del texto en la barra de titulo
- kbd:[F11] / kbd:[F12]: desplazamiento del texto en la lista de nick
- kbd:[Tab]: Completa los textos o nick que se escriben
- kbd:[PgUp] / kbd:[PgDn]: desplazamiento del texto en el buffer
- kbd:[Alt+a]: salta al siguiente buffer con actividad reciente
@@ -356,10 +391,10 @@ alguna tecla.
Por ejemplo, para asignar la combinación kbd:[Alt+!] al comando `/buffer close`:
----
/key bind (presionamos Alt-k) (presionamos Alt-!) /buffer close
/key bind (presionamos alt-k) (presionamos alt-!) /buffer close
----
El comando tendrá un aspecto similar a esto:
El comando se vera mas o menos así:
----
/key bind meta-! /buffer close
@@ -372,25 +407,28 @@ Para eliminar una combinación:
----
[[plugins_scripts]]
== Complementos/scripts
== Plugins/scripts
En algunas distribuciones como Debian, los complementos están disponibles en
En algunas distribuciones como Debian, los plugins están disponibles en
un paquete separado (como weechat-plugin).
Los complementos se cargan de manera automática cuando son encontrados por WeeChat
Los plugins se cargan de manera automática cuando son encontrados por WeeChat
(por favor, refierase a la documentación de WeeChat para ver como cargar/descargar
complementos y scripts).
plugins y scripts).
Muchos scripts externo (ofrecidos por colaboradores) están disponibles para WeeChat, puede
descargar e instalar scripts desde el repositorio mediante el comando `/script`,
por ejemplo:
// TRANSLATION MISSING
Many external scripts (from contributors) are available for WeeChat, you can
download and install scripts from the repository with the `/script` command,
for example:
----
/script install go.py
----
Vea `/help script` para obtener más información.
// TRANSLATION MISSING
See `/help script` for more info.
Hay una lista de scripts disponibles en WeeChat mediante el comando `/script` o en este enlace:
// TRANSLATION MISSING
A list of scripts is available in WeeChat with `/script` or at this URL:
https://weechat.org/scripts
[[more_doc]]
@@ -399,4 +437,4 @@ https://weechat.org/scripts
Ahora puede usar WeeChat y leer las FAQ/documentación para cada pregunta
en: https://weechat.org/doc
¡Disfrute de WeeChat!
Disfrute de WeeChat!
+14 -16
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
@@ -32,21 +32,19 @@ if(ENABLE_MAN)
add_custom_target(doc-man-weechat-fr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/fr/man1)
if(ENABLE_HEADLESS)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.fr.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.fr.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.fr.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.fr.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (fr)"
)
add_custom_target(doc-man-weechat-headless-fr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/fr/man1)
endif()
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.fr.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.fr.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.fr.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.fr.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (fr)"
)
add_custom_target(doc-man-weechat-headless-fr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/fr/man1)
endif()
if(ENABLE_DOC)
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2006 Julien Louis <ptitlouis@sysif.net>
#
# This file is part of WeeChat, the extensible chat client.
@@ -120,10 +120,6 @@
| weechat | bars_options | options pour les barres
| weechat | buffer_local_variable_value | valeur d'une variable locale du tampon
| weechat | buffer_local_variables | variables locales du tampon
| weechat | buffer_properties_get | propriétés qui peuvent être lues sur un tampon
| weechat | buffer_properties_set | propriétés qui peuvent être changées sur un tampon
@@ -233,10 +233,6 @@ _hook_connect_   (pointer, hdata: "hook") +
_hook_fd_   (pointer, hdata: "hook") +
_hook_timer_connection_   (pointer, hdata: "hook") +
_hook_timer_sasl_   (pointer, hdata: "hook") +
_sasl_scram_client_first_   (string) +
_sasl_scram_salted_pwd_   (other) +
_sasl_scram_salted_pwd_size_   (integer) +
_sasl_scram_auth_message_   (string) +
_is_connected_   (integer) +
_ssl_connected_   (integer) +
_disconnected_   (integer) +
+3 -15
View File
@@ -20,8 +20,6 @@
| irc | irc_is_channel | 1 si la chaîne est un nom de canal IRC valide pour le serveur | serveur,canal (le serveur est optionnel)
| irc | irc_is_message_ignored | 1 si le pseudo est ignoré (le message n'est pas affiché) | serveur,message (message est le message brut IRC)
| irc | irc_is_nick | 1 si la chaîne est un pseudo IRC valide | serveur,pseudo (le serveur est optionnel)
| irc | irc_nick | retourne le pseudo utilisé actuellement sur un serveur | nom de serveur
@@ -60,7 +58,7 @@
| php | php_version | version de l'interpréteur utilisé | -
| python | python2_bin | chemin vers l'interpréteur Python 2.x (*obsolète* depuis la version 2.6, les scripts doivent utiliser seulement Python 3) | -
| python | python2_bin | chemin vers l'interpréteur python 2.x | -
| python | python_eval | évaluation de code source | code source à exécuter
@@ -76,7 +74,7 @@
| ruby | ruby_version | version de l'interpréteur utilisé | -
| spell | spell_dict | liste de dictionnaires (séparés par des virgules) utilisés sur le tampon | pointeur vers un tampon ("0x12345678") ou nom complet de tampon ("irc.libera.#weechat")
| spell | spell_dict | liste de dictionnaires (séparés par des virgules) utilisés sur le tampon | pointeur vers un tampon ("0x12345678") ou nom complet de tampon ("irc.freenode.#weechat")
| tcl | tcl_eval | évaluation de code source | code source à exécuter
@@ -134,15 +132,7 @@
| weechat | version_number | version de WeeChat (sous forme de nombre) | -
| weechat | weechat_cache_dir | répertoire du cache WeeChat | -
| weechat | weechat_config_dir | répertoire de la configuration WeeChat | -
| weechat | weechat_daemon | 1 si WeeChat tourne en mode démon (sans interface, en tâche de fond) | -
| weechat | weechat_data_dir | répertoire des données WeeChat | -
| weechat | weechat_dir | répertoire de WeeChat (*obsolète depuis la version 3.2, remplacé par "weechat_config_dir", "weechat_data_dir", "weechat_cache_dir" et "weechat_runtime_dir") | -
| weechat | weechat_dir | répertoire de WeeChat | -
| weechat | weechat_headless | 1 si WeeChat tourne sans interface | -
@@ -150,8 +140,6 @@
| weechat | weechat_localedir | répertoire "locale" de WeeChat | -
| weechat | weechat_runtime_dir | répertoire de "runtime" WeeChat | -
| weechat | weechat_sharedir | répertoire "share" de WeeChat | -
| weechat | weechat_site | site WeeChat | -
@@ -14,7 +14,5 @@
| weechat | focus_info | obtenir l'information de focus | "x" : coordonnée x (chaîne avec un entier >= 0), "y" : coordonnée y (chaîne avec un entier >= 0) | voir la fonction hook_focus dans la Référence API extension
| weechat | secured_data | données sécurisées | - | données sécurisées : noms et valeurs (attention : les valeurs sont des données sensibles : il ne faut PAS les afficher/logger)
|===
// end::infos_hashtable[]
+68 -96
View File
@@ -161,7 +161,7 @@ nooption : définir l'option booléenne à 'off' (par exemple : -nossl)
Pour se déconnecter du serveur ou stopper toute tentative de connexion, utilisez la commande /disconnect.
Exemples :
/connect libera
/connect freenode
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
@@ -219,7 +219,6 @@ Exemples :
----
/dehalfop <pseudo> [<pseudo>...]
* -yes
pseudo : pseudo ou masque (le caractère joker "*" est autorisé)
* : retirer le statut de demi-opérateur de tout le monde sur le canal excepté vous-même
@@ -301,10 +300,10 @@ Note : l'expression régulière peut commencer par "(?-i)" pour devenir sensibl
Exemples :
ignorer le pseudo "toto" partout :
/ignore add toto
ignorer le hôte "toto@domain.com" sur le serveur libera :
/ignore add toto@domain.com libera
ignorer le hôte "toto*@*.domain.com" sur libera/#weechat :
/ignore add toto*@*.domain.com libera #weechat
ignorer le hôte "toto@domain.com" sur le serveur freenode :
/ignore add toto@domain.com freenode
ignorer le hôte "toto*@*.domain.com" sur freenode/#weechat :
/ignore add toto*@*.domain.com freenode #weechat
----
[[command_irc_info]]
@@ -349,7 +348,7 @@ pseudo : pseudo
Exemples :
/join #weechat
/join #protectedchan,#weechat key
/join -server libera #weechat
/join -server freenode #weechat
/join -noswitch #weechat
----
@@ -361,7 +360,7 @@ Exemples :
canal : nom du canal
pseudo : pseudo
raison : raison (évaluée, voir /help eval ; les variables spéciales ${nick} (propre pseudo), ${target} (pseudo cible), ${channel} et ${server} sont remplacées par leur valeurs)
raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leur valeur)
----
[[command_irc_kickban]]
@@ -372,7 +371,7 @@ raison : raison (évaluée, voir /help eval ; les variables spéciales ${nick}
canal : nom du canal
pseudo : pseudo
raison : raison (évaluée, voir /help eval ; les variables spéciales ${nick} (propre pseudo), ${target} (pseudo cible), ${channel} et ${server} sont remplacées par leur valeurs)
raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leur valeur)
Il est possible d'éjecter/bannir avec un masque, le pseudo sera extrait du masque et remplacé par "*".
@@ -402,7 +401,7 @@ masque_serveur : liste des serveurs correspondant au masque
----
[[command_irc_list]]
* `+list+`: lister les canaux et leurs titres
* `+list+`: lister les canaux et leur titre
----
/list [-server <serveur>] [-re <regex>] [<canal>[,<canal>...]] [<cible>]
@@ -552,10 +551,10 @@ Sans paramètre, cette commande affiche les notifications pour le serveur couran
Exemples :
notifier quand "toto" rejoint/quitte le serveur courant :
/notify add toto
notifier quand "toto" rejoint/quitte le serveur libera :
/notify add toto libera
notifier quand "toto" est absent ou de retour sur le serveur libera :
/notify add toto libera -away
notifier quand "toto" rejoint/quitte le serveur freenode :
/notify add toto freenode
notifier quand "toto" est absent ou de retour sur le serveur freenode :
/notify add toto freenode -away
----
[[command_irc_op]]
@@ -673,7 +672,7 @@ option : option supplémentaire, pour certains serveurs
canal : nom du canal
pseudo : pseudo
raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leurs valeurs)
raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leur valeur)
----
[[command_irc_restart]]
@@ -775,16 +774,16 @@ nom_machine : nom ou adresse IP du serveur avec port en option (défaut : 6667
Exemples :
/server listfull
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add freenode chat.freenode.net
/server add freenode chat.freenode.net/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server copy freenode freenode-test
/server rename freenode-test freenode2
/server reorder freenode2 freenode
/server del freenode
/server deloutq
/server raw
/server raw s:libera
/server raw s:freenode
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
@@ -933,7 +932,6 @@ pseudo : pseudo
----
/voice <pseudo> [<pseudo>...]
* -yes
pseudo : pseudo ou masque (le caractère joker "*" est autorisé)
* : donner la voix à tout le monde sur le canal
@@ -1022,7 +1020,7 @@ Note : dans la commande, les variables spéciales sont remplacées :
$n-m : paramètres de 'n' à 'm'
$* : tous les paramètres
$~ : le dernier paramètre
$var : où "var" est une variable locale du tampon (voir /buffer listvar)
$var : où "var" est une variable locale du tampon (voir /buffer localvar)
exemples : $nick, $channel, $server, $plugin, $name
Exemples :
@@ -1115,9 +1113,7 @@ Exemples :
renumber <nombre1> [<nombre2> [<départ>]]
close [<n1>[-<n2>]|<nom>...]
notify [<niveau>]
listvar [<nombre>|<nom>]
setvar <nom> [<valeur>]
delvar <nom>
localvar [<nombre>|<nom>]
set <propriété> [<valeur>]
get <propriété>
<nombre>|<nom>
@@ -1141,9 +1137,7 @@ renumber : renuméroter des tampons (fonctionne seulement si l'option weechat.l
message : pour les messages d'utilisateurs + highlights
all : pour tous les messages
reset : réinitialise à valeur par défaut (all)
listvar : afficher la liste des variables locales d'un tampon
setvar : modifier une variable locale du tampon courant
delvar : supprimer une variable locale du tampon courant
localvar : afficher la liste des variables locales pour le tampon
set : modifier une propriété du tampon courant
get : afficher une propriété du tampon courant
nombre : sauter au tampon qui a ce numéro, préfixe possible :
@@ -1301,12 +1295,12 @@ infolists : afficher des infos sur les infolists
* `+eval+`: évaluer une expression
----
/eval [-n|-s] [-d [-d]] <expression>
/eval [-n|-s] [-d] <expression>
[-n] [-d] -c <expression1> <opérateur> <expression2>
-n : afficher le résultat sans envoyer au tampon (mode debug)
-s : découper l'expression avant de l'évaluer (plusieurs commandes peuvent être séparées par des points-virgules)
-d : afficher la sortie de debug après l'évaluation (avec deux -d : mode debug plus verbeux)
-d : afficher la sortie de debug après l'évaluation
-c : évaluer comme une condition : utiliser les opérateurs et les parenthèses, retourner une valeur booléenne ("0" ou "1")
expression : expression à évaluer, les variables avec le format ${variable} sont remplacées (voir ci-dessous) ; plusieurs commandes peuvent être séparées par des points-virgules
opérateur : un opérateur logique ou de comparaison :
@@ -1341,45 +1335,39 @@ Pour forcer une comparaison de chaînes, vous pouvez ajouter des guillemets auto
"50" > "100" ==> 1
Des variables sont remplacées dans l'expression, en utilisant le format ${variable}, la variable pouvant être, par ordre de priorité :
1. la chaîne elle-même sans évaluation (format : "raw:xxx")
2. une sous-chaîne évaluée (format : "eval:xxx")
3. une condition évaluée (format : "eval_cond:xxx")
4. une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx")
5. une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne")
6. une chaîne avec un maximum de caractères (format : "cut:max,suffixe,chaîne" ou "cut:+max,suffixe,chaîne")
1. une sous-chaîne évaluée (format : "eval:xxx")
2. une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx")
3. une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne")
4. une chaîne avec un maximum de caractères (format : "cut:max,suffixe,chaîne" ou "cut:+max,suffixe,chaîne")
ou un maximum de caractères affichés à l'écran (format : "cutscr:max,suffixe,chaîne" ou "cutscr:+max,suffixe,chaîne")
7. une chaîne inversée (format : "rev:xxx" ou "revscr:xxx")
8. une chaîne répétée (format : "repeat:nombre,chaîne")
9. longueur d'une chaîne (format : "length:xxx" ou "lengthscr:xxx")
10. une couleur (format : "color:xxx", voir la "Référence API extension", fonction "color")
11. un modificateur (format : "modifier:nom,données,chaîne")
12. une info (format : "info:nom,paramètres", les paramètres sont optionnels)
13. une chaîne encodée/decodée en base 16, 32 ou 64 (format : "base_encode:base,xxx" ou "base_decode:base,xxx")
14. la date/heure courante (format : "date" ou "date:format")
15. une variable d'environnement (format : "env:XXX")
16. un opérateur ternaire (format : "if:condition?valeur_si_vrai:valeur_si_faux")
17. le résultat d'une expression avec parenthèses et les opérateurs + - * / // % ** (format: "calc:xxx")
18. une chaîne traduite (format : "translate:xxx")
19. une option (format : "fichier.section.option")
20. une variable locale du tampon
21. un hdata/variable (la valeur est automatiquement convertie en chaîne), par défaut "window" et "buffer" pointent vers la fenêtre et le tampon courants.
5. une chaîne inversée (format : "rev:xxx" ou "revscr:xxx")
6. une chaîne répétée (format : "repeat:nombre,chaîne")
7. longueur d'une chaîne (format : "length:xxx" ou "lengthscr:xxx")
8. une couleur (format : "color:xxx", voir la "Référence API extension", fonction "color")
9. un modificateur (format : "modifier:nom,données,chaîne")
10. une info (format : "info:nom,paramètres", les paramètres sont optionnels)
11. une chaîne encodée/decodée en base 16, 32 ou 64 (format : "base_encode:base,xxx" ou "base_decode:base,xxx")
12. la date/heure courante (format : "date" ou "date:format")
13. une variable d'environnement (format : "env:XXX")
14. un opérateur ternaire (format : "if:condition?valeur_si_vrai:valeur_si_faux")
15. le résultat d'une expression avec parenthèses et les opérateurs + - * / // % ** (format: "calc:xxx")
16. une option (format : "fichier.section.option")
17. une variable locale du tampon
18. un hdata/variable (la valeur est automatiquement convertie en chaîne), par défaut "window" et "buffer" pointent vers la fenêtre et le tampon courants.
Le format du hdata peut être le suivant :
hdata.var1.var2... : démarrer avec un hdata (le pointeur doit être connu), et demander les variables l'une après l'autre (d'autres hdata peuvent être suivis)
hdata[liste].var1.var2... : démarrer avec un hdata en utilisant une liste/pointeur/nom de pointeur, par exemple :
hdata[liste].var1.var2... : démarrer avec un hdata en utilisant une liste, par exemple :
${buffer[gui_buffers].full_name} : nom complet du premier tampon dans la liste chaînée des tampons
${plugin[weechat_plugins].name} : nom de la première extension dans la liste chaînée des extensions
hdata[pointeur].var1.var2... : démarrer avec un hdata en utilisant un pointeur, par exemple :
${buffer[0x1234abcd].full_name} : nom complet du tampon avec ce pointeur (peut être utilisé dans les triggers)
${buffer[my_pointer].full_name} : nom complet du tampon avec ce nom de pointeur (peut être utilisé dans les triggers)
Pour le nom du hdata et des variables, voir la "Référence API extension", fonction "weechat_hdata_get".
Exemples (chaînes simples) :
/eval -n ${raw:${info:version}} ==> ${info:version}
/eval -n ${eval_cond:${window.win_width}>100} ==> 1
/eval -n ${info:version} ==> 0.4.3
/eval -n ${env:HOME} ==> /home/user
/eval -n ${weechat.look.scroll_amount} ==> 3
/eval -n ${sec.data.password} ==> secret
/eval -n ${sec.data.freenode_password} ==> secret
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
@@ -1396,7 +1384,6 @@ Exemples (chaînes simples) :
/eval -n ${calc:(5+2)*3} ==> 21
/eval -n ${base_encode:64,test} ==> dGVzdA==
/eval -n ${base_decode:64,dGVzdA==} ==> test
/eval -n ${translate:Plugin} ==> Extension
Exemples (conditions) :
/eval -n -c ${window.buffer.number} > 2 ==> 0
@@ -1419,7 +1406,6 @@ Exemples (conditions) :
enable|disable|toggle [<nom>|@]
add|addreplace <nom> <tampon>[,<tampon>...] <étiquettes> <regex>
rename <nom> <nouveau_nom>
recreate <nom>
del <nom>|-all
list : lister tous les filtres
@@ -1430,11 +1416,10 @@ Exemples (conditions) :
add : ajouter un filtre
addreplace : ajouter ou remplacer un filtre existant
rename : renommer un filtre
recreate : définir la ligne de commande utilisée pour modifier le filtre
del : supprimer un filtre
-all : supprimer tous les filtres
tampon : liste des tampons, séparés par des virgules, où le filtre est actif :
- il s'agit du nom complet incluant l'extension (exemple : "irc.libera.#weechat" ou "irc.server.libera")
- il s'agit du nom complet incluant l'extension (exemple : "irc.freenode.#weechat" ou "irc.server.freenode")
- "*" signifie tous les tampons
- un nom commençant par '!' est exclu
- le caractère joker "*" est autorisé
@@ -1469,11 +1454,11 @@ Exemples :
filtrer les pseudos afficher en rejoignant les canaux ou avec /names :
/filter add nicks * irc_366 *
filtrer le pseudo "toto" sur le canal IRC #weechat :
/filter add toto irc.libera.#weechat nick_toto *
/filter add toto irc.freenode.#weechat nick_toto *
filtrer les messages IRC join/action du pseudo "toto" :
/filter add toto * nick_toto+irc_join,nick_toto+irc_action *
filtrer les lignes contenant "weechat sucks" sur le canal IRC #weechat :
/filter add sucks irc.libera.#weechat * weechat sucks
/filter add sucks irc.freenode.#weechat * weechat sucks
filtrer les lignes qui sont strictement égales à "WeeChat sucks" sur tous les tampons :
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -1675,7 +1660,7 @@ Exemples :
-core : pas d'affichage sur le tampon core WeeChat
-current : pas d'affichage sur le tampon courant
-buffer : pas d'affichage sur le tampon spécifié
nom : nom complet du tampon (exemples : "irc.server.libera", "irc.libera.#weechat")
nom : nom complet du tampon (exemples : "irc.server.freenode", "irc.freenode.#weechat")
commande : commande à exécuter silencieusement (un '/' est automatiquement ajouté s'il n'est pas trouvé au début de la commande)
Si aucune cible n'est spécifiée (-core, -current ou -buffer), alors par défaut tous les tampons seront silencieux.
@@ -1686,7 +1671,7 @@ Exemples :
message au canal IRC courant :
/mute -current msg * bonjour !
message au canal #weechat :
/mute -buffer irc.libera.#weechat msg #weechat bonjour !
/mute -buffer irc.freenode.#weechat msg #weechat bonjour !
----
[[command_weechat_plugin]]
@@ -1754,7 +1739,7 @@ Exemples :
afficher un message sur le tampon core avec le préfixe "abc" :
/print -core abc\tLe message
afficher un message sur le canal #weechat :
/print -buffer irc.libera.#weechat Message sur #weechat
/print -buffer irc.freenode.#weechat Message sur #weechat
afficher un bonhomme de neige (U+2603) :
/print -escape \u2603
envoyer une alerte (BEL) :
@@ -1876,7 +1861,7 @@ Les touches sur le tampon des données sécurisées :
alt+v afficher/cacher les valeurs
Lorsqu'une phrase de chiffrement est utilisée (données chiffrées), elle est demandée au démarrage de WeeChat.
Il est possible de définir la variable d'environnement WEECHAT_PASSPHRASE pour éviter la demande (cette même variable est utilisée par WeeChat sur le /upgrade) ou de définir l'option sec.crypt.passphrase_command pour lire la phrase de chiffrement depuis la sortie d'une commande externe comme un coffre-fort à mots de passe (voir /help sec.crypt.passphrase_command).
Il est possible de définir la variable d'environnement WEECHAT_PASSPHRASE pour éviter la demande (cette même variable est utilisée par WeeChat sur le /upgrade) ou de définir l'option sec.crypt.passphrase_file pour lire la phrase de chiffrement depuis un fichier (voir /help sec.crypt.passphrase_file).
Les données sécurisées avec le format ${sec.data.xxx} peuvent être utilisées dans :
- la commande /eval
@@ -1887,16 +1872,14 @@ Les données sécurisées avec le format ${sec.data.xxx} peuvent être utilisée
Exemples :
définir une phrase de chiffrement :
/secure passphrase ceci est ma phrase de chiffrement
utiliser le programme "pass" pour lire la phrase de chiffrement au démarrage :
/set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"
chiffrer le mot de passe libera SASL :
/secure set libera motdepasse
/set irc.server.libera.sasl_password "${sec.data.libera}"
chiffrer le mot de passe freenode SASL :
/secure set freenode motdepasse
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
chiffrer le mot de passe oftc pour nickserv :
/secure set oftc motdepasse
/set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}"
alias pour ghost du pseudo "pseudo" :
/alias add ghost /eval /msg -server libera nickserv ghost pseudo ${sec.data.libera}
/alias add ghost /eval /msg -server freenode nickserv ghost pseudo ${sec.data.freenode}
----
[[command_weechat_set]]
@@ -1983,7 +1966,7 @@ Avec l'option "-quit", le processus est légèrement différent :
5. quitter WeeChat
Et plus tard vous pouvez restaurer la session avec la commande : weechat --upgrade
IMPORTANT : vous devez restaurer la session avec exactement la même configuration (fichiers *.conf).
Il est également possible de restaurer la session WeeChat sur une autre machine si vous y copiez le contenu des répertoires personnels de WeeChat (voir /debug dirs).
Il est également possible de restaurer la session WeeChat sur une autre machine si vous y copiez le contenu du répertoire "~/.weechat".
----
[[command_weechat_uptime]]
@@ -2168,7 +2151,6 @@ Les variables suivantes peuvent être utilisées dans ces options :
- ${hotlist} : la hotlist brute
- ${hotlist_priority} : "none", "low", "message", "private" ou "highlight"
- ${format_lag} : le lag pour un tampon de serveur IRC, vide s'il n'y a pas de lag (évaluation de l'option buflist.format.lag)
- ${format_tls_version}: indicateur de la version de TLS pour le serveur courant, vide pour les canaux (évaluation de l'option buflist.format.tls_version)
----
// end::buflist_commands[]
@@ -2275,14 +2257,14 @@ disable : désactiver le tube FIFO
toggle : activer/désactiver le tube FIFO
Le tube FIFO est utilisé comme contrôle à distance de WeeChat : vous pouvez envoyer des commandes ou du texte au tube FIFO depuis votre shell.
Par défaut le tube FIFO se nomme weechat_fifo_xxx (où xxx est l'id du processus WeeChat) et situé dans le répertoire "runtime" de WeeChat (voir /debug dirs).
Par défaut le tube FIFO est dans ~/.weechat/weechat_fifo
Le format attendu est l'un des suivants :
plugin.buffer *texte ou commande ici
*texte ou commande ici
Par exemple pour changer votre pseudo sur libera :
echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345
Par exemple pour changer votre pseudo sur freenode :
echo 'irc.server.freenode */nick autrepseudo' >~/.weechat/weechat_fifo
Merci de lire le guide utilisateur pour plus d'information et des exemples.
@@ -2719,7 +2701,7 @@ Sans paramètre, cette commande liste les scripts chargés.
stop : fermer le socket serveur (les clients restent connectés)
nom : nom du relai (voir le format ci-dessous)
port : port utilisé pour le relai
chemin : chemin utilisé pour le relai (pour un socket de domaine UNIX seulement) ; le chemin est évalué (voir la fonction string_eval_path_home dans la référence API extension)
chemin : chemin utilisé pour le relai (pour un socket de domaine UNIX seulement) ; "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat"), le contenu est évalué (voir /help eval)
raw : ouvrir le tampon avec les données brutes Relay
sslcertkey : définir le certificat/clé SSL en utilisant le chemin de l'option relay.network.ssl_cert_key
@@ -2738,10 +2720,10 @@ Le protocole "weechat" permet à une interface distante de se connecter sur le p
Sans paramètre, cette commande ouvre le tampon avec la liste des clients pour le relai.
Exemples :
proxy irc, pour le serveur "libera" :
/relay add irc.libera 8000
proxy irc, pour le serveur "libera", avec SSL :
/relay add ssl.irc.libera 8001
proxy irc, pour le serveur "freenode" :
/relay add irc.freenode 8000
proxy irc, pour le serveur "freenode", avec SSL :
/relay add ssl.irc.freenode 8001
proxy irc, pour tous les serveurs (le client choisira), avec SSL :
/relay add ssl.irc 8002
protocole weechat :
@@ -2755,7 +2737,7 @@ Exemples :
protocole weechat avec SSL, en utilisant IPv4 + IPv6 :
/relay add ipv4.ipv6.ssl.weechat 9001
protocole weechat avec un socket de domaine UNIX :
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
/relay add unix.weechat %h/relay_socket
----
// end::relay_commands[]
@@ -2837,16 +2819,6 @@ Sur le tampon des scripts, les statuts pour chaque script sont :
| installé
script populaire
Dans la sortie de /script list, les statuts pour chaque script sont :
* ? i a H N
| | | | | |
| | | | | obsolète (nouvelle version disponible)
| | | | figé
| | | chargé auto
| | installé
| script inconnu (ne peut pas être téléchargé/mis à jour)
script populaire
Les touches sur le tampon des scripts :
alt+i installer le script
alt+r supprimer le script
@@ -2976,7 +2948,7 @@ listdefault : lister les triggers par défaut
modifier : nom(s) de modificateur (obligatoire)
line : type de tampon ("formatted", "free" ou "*"), liste de masques de tampons, étiquettes
print : tampon, étiquettes, message, suppression des couleurs (0/1)
command : commande (obligatoire), description, paramètres, description des paramètres, complétion (tous les paramètres sauf la commande sont évalués, "${tg_trigger_name}" est remplacé par le nom du trigger, voir /help eval)
command : commande (obligatoire), description, paramètres, description des paramètres, complétion (tous les paramètres sauf la commande sont évalués, voir /help eval)
command_run : commande(s) (obligatoire)
timer : intervalle (obligatoire), alignement sur la seconde, nombre max d'appels
config : nom(s) de l'option (obligatoire)
+31 -115
View File
@@ -16,8 +16,8 @@
** valeurs: sha224, sha256, sha384, sha512
** valeur par défaut: `+sha256+`
* [[option_sec.crypt.passphrase_command]] *sec.crypt.passphrase_command*
** description: pass:none[lire la phrase de chiffrement depuis la sortie de cette commande système (seule la première ligne est utilisée et elle ne doit contenir aucun autre caractère) ; cette option est utilisée seulement pour lire le fichier sec.conf et si la variable d'environnement "WEECHAT_PASSPHRASE" n'est pas définie (la variable d'environnement a une priorité plus haute) ; exemple avec password-store : "/usr/bin/pass show weechat/passphrase"]
* [[option_sec.crypt.passphrase_file]] *sec.crypt.passphrase_file*
** description: pass:none[chemin vers un fichier contenant la phrase de chiffrement pour (dé)chiffrer les données sécurisées ; cette option est utilisée seulement lors de la lecture du fichier sec.conf ; seulement la première ligne du fichier est utilisée ; ce fichier est utilisé seulement si la variable d'environnement "WEECHAT_PASSPHRASE" n'est pas définie (la variable d'environnement a une priorité plus haute) ; note de sécurité : il est recommandé de garder ce fichier en lecture seulement par vous et de le stocker en dehors du "home" WeeChat (par exemple dans votre "home") ; exemple : "~/.weechat-passphrase"]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -846,12 +846,6 @@
** valeurs: on, off
** valeur par défaut: `+on+`
* [[option_weechat.look.hotlist_update_on_buffer_switch]] *weechat.look.hotlist_update_on_buffer_switch*
** description: pass:none[mettre à jour la hotlist lors du changement de tampon]
** type: booléen
** valeurs: on, off
** valeur par défaut: `+on+`
* [[option_weechat.look.input_cursor_scroll]] *weechat.look.input_cursor_scroll*
** description: pass:none[nombre de caractères affichés après la fin de la ligne de saisie lors d'un défilement pour afficher la fin de la ligne]
** type: entier
@@ -1146,12 +1140,6 @@
** valeurs: toute chaîne
** valeur par défaut: `+"- "+`
* [[option_weechat.look.read_marker_update_on_buffer_switch]] *weechat.look.read_marker_update_on_buffer_switch*
** description: pass:none[mettre à jour le marqueur de données non lues lors du changement de tampon]
** type: booléen
** valeurs: on, off
** valeur par défaut: `+on+`
* [[option_weechat.look.save_config_on_exit]] *weechat.look.save_config_on_exit*
** description: pass:none[sauvegarder la configuration en quittant]
** type: booléen
@@ -1260,17 +1248,11 @@
** valeurs: 1 .. 2147483647
** valeur par défaut: `+60+`
* [[option_weechat.network.gnutls_ca_system]] *weechat.network.gnutls_ca_system*
** description: pass:none[charger les certificats des autorités de certification système au démarrage ; cela peut être désactivée pour économiser de la mémoire, seulement si vous n'utilisez pas du tout de connexions SSL]
** type: booléen
** valeurs: on, off
** valeur par défaut: `+on+`
* [[option_weechat.network.gnutls_ca_user]] *weechat.network.gnutls_ca_user*
** description: pass:none[fichier(s) supplémentaire(s) avec des autorités de certification ; plusieurs fichiers doivent être séparés par ":" (chaque chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
* [[option_weechat.network.gnutls_ca_file]] *weechat.network.gnutls_ca_file*
** description: pass:none[fichier contenant les autorités de certification ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
** valeur par défaut: `+"/etc/ssl/certs/ca-certificates.crt"+`
* [[option_weechat.network.gnutls_handshake_timeout]] *weechat.network.gnutls_handshake_timeout*
** description: pass:none[délai d'attente maximum (en secondes) pour la poignée de main (handshake) gnutls]
@@ -1303,10 +1285,10 @@
** valeur par défaut: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
** description: pass:none[chemin de recherche des extensions (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** description: pass:none[chemin de recherche des extensions ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"${weechat_data_dir}/plugins"+`
** valeur par défaut: `+"%h/plugins"+`
* [[option_weechat.plugin.save_config_on_unload]] *weechat.plugin.save_config_on_unload*
** description: pass:none[sauvegarder les fichiers de configuration lors du déchargement des extensions]
@@ -1314,44 +1296,14 @@
** valeurs: on, off
** valeur par défaut: `+on+`
* [[option_weechat.signal.sighup]] *weechat.signal.sighup*
** description: pass:none[commande à exécuter lorsque le signal est reçu, plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"${if:${info:weechat_headless}?/reload:/quit -yes}"+`
* [[option_weechat.signal.sigquit]] *weechat.signal.sigquit*
** description: pass:none[commande à exécuter lorsque le signal est reçu, plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"/quit -yes"+`
* [[option_weechat.signal.sigterm]] *weechat.signal.sigterm*
** description: pass:none[commande à exécuter lorsque le signal est reçu, plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"/quit -yes"+`
* [[option_weechat.signal.sigusr1]] *weechat.signal.sigusr1*
** description: pass:none[commande à exécuter lorsque le signal est reçu, plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
* [[option_weechat.signal.sigusr2]] *weechat.signal.sigusr2*
** description: pass:none[commande à exécuter lorsque le signal est reçu, plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
* [[option_weechat.startup.command_after_plugins]] *weechat.startup.command_after_plugins*
** description: pass:none[commande exécutée quand WeeChat démarre, après le chargement des extensions ; plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** description: pass:none[commande exécutée quand WeeChat démarre, après le chargement des extensions (note : le contenu est évalué, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
* [[option_weechat.startup.command_before_plugins]] *weechat.startup.command_before_plugins*
** description: pass:none[commande exécutée quand WeeChat démarre, avant le chargement des extensions ; plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** description: pass:none[commande exécutée quand WeeChat démarre, avant le chargement des extensions (note : le contenu est évalué, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -1457,10 +1409,10 @@
** valeur par défaut: `+""+`
* [[option_logger.file.path]] *logger.file.path*
** description: pass:none[chemin pour les fichiers de log WeeChat ; les caractères de formatage de date sont autorisés (voir man strftime) (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** description: pass:none[chemin pour les fichiers de log WeeChat ; "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") ; les caractères de formatage de date sont autorisés (voir man strftime) (note : le contenu est évalué, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"${weechat_data_dir}/logs"+`
** valeur par défaut: `+"%h/logs/"+`
* [[option_logger.file.replacement_char]] *logger.file.replacement_char*
** description: pass:none[caractère de remplacement dans le nom de fichier construit avec le masque (comme le délimiteur de répertoire)]
@@ -1752,12 +1704,6 @@
** valeurs: toute chaîne
** valeur par défaut: `+"${color:green}${number}${if:${number_displayed}?.: }"+`
* [[option_buflist.format.tls_version]] *buflist.format.tls_version*
** description: pass:none[format pour la version de TLS sur un serveur IRC (note : le contenu est évalué, voir /help buflist)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+" ${color:default}(${if:${tls_version}==TLS1.3?${color:green}:${if:${tls_version}==TLS1.2?${color:yellow}:${color:red}}}${translate:${tls_version}}${color:default})"+`
* [[option_buflist.look.add_newline]] *buflist.look.add_newline*
** description: pass:none[ajouter une nouvelle ligne entre les tampons affichés, de sorte que chaque tampon est affiché sur une ligne séparée (recommandé) ; si désactivé, les nouvelles lignes doivent être ajoutées dans les formats avec "${\n}", et les actions de souris ne sont plus possibles]
** type: booléen
@@ -1819,16 +1765,10 @@
** valeur par défaut: `+""+`
* [[option_buflist.look.sort]] *buflist.look.sort*
** description: pass:none[liste de champs séparés par des virgules pour trier les tampons ; chaque champ est une variable hdata du tampon ("var"), une variable hdata du serveur IRC ("irc_server.var") ou une variable hdata du canal IRC ("irc_channel.var") ; le caractère "-" peut être utilisé pour inverser l'ordre, le caractère "~" peut être utilisé pour effectuer une comparaison insensible à la casse ; exemple : "-~short_name" pour un tri inverse insensible à la casse sur le nom court du tampon (note : le contenu est évalué, avant d'être découpé en champs, mais à cet instant "bar_item" est la seule variable qui peut être utilisée, pour distinguer les différents objets de barre buflist, par exemple "${bar_item.name}")]
** description: pass:none[liste de champs séparés par des virgules pour trier les tampons ; chaque champ est une variable hdata du tampon ("var"), une variable hdata du serveur IRC ("irc_server.var") ou une variable hdata du canal IRC ("irc_channel.var") ; le caractère "-" peut être utilisé pour inverser l'ordre, le caractère "~" peut être utilisé pour effectuer une comparaison insensible à la casse ; exemple : "-~short_name" pour un tri inverse insensible à la casse sur le nom court du tampon (note : le contenu est évalué, seul le pointeur vers bar_item peut être utilisé, par exemple "bar_item.name")]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"number,-active"+`
* [[option_buflist.look.use_items]] *buflist.look.use_items*
** description: pass:none[nombre d'objets de barre buflist qui peuvent être utilisés ; les objets de barre sont : "buflist", "buflist2", "buflist3" ; attention, utiliser plus d'un objet de barre ralentit l'affichage de la liste des tampons]
** type: entier
** valeurs: 1 .. 3
** valeur par défaut: `+1+`
// end::buflist_options[]
// tag::fifo_options[]
@@ -1839,10 +1779,10 @@
** valeur par défaut: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
** description: pass:none[chemin pour le tube FIFO ; le PID de WeeChat peut être utilisé dans le chemin avec ${info:pid} (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** description: pass:none[chemin pour le tube FIFO ; "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") ; le PID de WeeChat peut être utilisé dans le chemin avec ${info:pid} (note : le contenu est évalué, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
** valeur par défaut: `+"%h/weechat_fifo"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1913,7 +1853,7 @@
** valeur par défaut: `+off+`
* [[option_xfer.file.auto_accept_nicks]] *xfer.file.auto_accept_nicks*
** description: pass:none[liste de pseudos (séparés par des virgules) pour lesquels les demandes d'envoi de fichiers et de discussion sont automatiquement acceptées ; le format est "serveur.pseudo" (pour un serveur spécifique) ou "pseudo" (pour tous les serveurs) ; exemple : "libera.FlashCode,andrew"]
** description: pass:none[liste de pseudos (séparés par des virgules) pour lesquels les demandes d'envoi de fichiers et de discussion sont automatiquement acceptées ; le format est "serveur.pseudo" (pour un serveur spécifique) ou "pseudo" (pour tous les serveurs) ; exemple : "freenode.FlashCode,andrew"]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -1943,10 +1883,10 @@
** valeur par défaut: `+on+`
* [[option_xfer.file.download_path]] *xfer.file.download_path*
** description: pass:none[chemin où écrire les fichiers reçus (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** description: pass:none[chemin où écrire les fichiers reçus : "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") (note : le contenu est évalué, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"${weechat_data_dir}/xfer"+`
** valeur par défaut: `+"%h/xfer"+`
* [[option_xfer.file.download_temporary_suffix]] *xfer.file.download_temporary_suffix*
** description: pass:none[suffixe de fichier temporaire utilisé pendant le transfert pour un fichier reçu, il est supprimé après un transfert réussi ; si chaîne vide, aucun suffixe de fichier n'est utilisé pendant le transfert]
@@ -1955,7 +1895,7 @@
** valeur par défaut: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
** description: pass:none[chemin lire les fichiers à envoyer (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** description: pass:none[chemin pour lire les fichiers envoyés (quand aucun chemin n'est spécifié par l'utilisateur) : "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") (note : le contenu est évalué, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"~"+`
@@ -2064,24 +2004,6 @@
** valeurs: un nom de couleur WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numéro de couleur du terminal ou un alias ; des attributs sont autorisés avant la couleur (seulement pour la couleur du texte, pas le fond) : "*" pour le gras, "!" pour la vidéo inverse, "/" pour l'italique, "_" pour le souligné
** valeur par défaut: `+default+`
* [[option_irc.color.item_tls_version_deprecated]] *irc.color.item_tls_version_deprecated*
** description: pass:none[couleur pour les versions obsolètes de TLS dans l'objet de barre "tls_version"]
** type: couleur
** valeurs: un nom de couleur WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numéro de couleur du terminal ou un alias ; des attributs sont autorisés avant la couleur (seulement pour la couleur du texte, pas le fond) : "*" pour le gras, "!" pour la vidéo inverse, "/" pour l'italique, "_" pour le souligné
** valeur par défaut: `+yellow+`
* [[option_irc.color.item_tls_version_insecure]] *irc.color.item_tls_version_insecure*
** description: pass:none[couleur pour les versions non sécurisées de TLS dans l'objet de barre "tls_version"]
** type: couleur
** valeurs: un nom de couleur WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numéro de couleur du terminal ou un alias ; des attributs sont autorisés avant la couleur (seulement pour la couleur du texte, pas le fond) : "*" pour le gras, "!" pour la vidéo inverse, "/" pour l'italique, "_" pour le souligné
** valeur par défaut: `+red+`
* [[option_irc.color.item_tls_version_ok]] *irc.color.item_tls_version_ok*
** description: pass:none[couleur pour la version de TLS la plus haute dans l'objet de barre "tls_version"]
** type: couleur
** valeurs: un nom de couleur WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numéro de couleur du terminal ou un alias ; des attributs sont autorisés avant la couleur (seulement pour la couleur du texte, pas le fond) : "*" pour le gras, "!" pour la vidéo inverse, "/" pour l'italique, "_" pour le souligné
** valeur par défaut: `+green+`
* [[option_irc.color.message_account]] *irc.color.message_account*
** description: pass:none[couleur pour le texte dans les messages account]
** type: couleur
@@ -2677,7 +2599,7 @@
** valeur par défaut: `+message+`
* [[option_irc.server_default.command]] *irc.server_default.command*
** description: pass:none[commande(s) à exécuter après la connexion au serveur et avant le "join" automatique des canaux (plusieurs commandes peuvent être séparées par ";", utilisez "\;" pour un point-virgule, les variables spéciales $nick, $channel et $server sont remplacées par leurs valeurs) (note : les commandes sont évaluées, voir /help eval ; les options de serveur sont évaluées avec ${irc_server.xxx} et ${server} est remplacé par le nom du serveur)]
** description: pass:none[commande(s) à exécuter après la connexion au serveur et avant le "join" automatique des canaux (plusieurs commandes peuvent être séparées par ";", utilisez "\;" pour un point-virgule, les variables spéciales $nick, $channel et $server sont remplacées par leur valeur) (note : le contenu est évalué, voir /help eval ; les options de serveur sont évaluées avec ${irc_server.xxx} et ${server} est remplacé par le nom du serveur)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -2694,12 +2616,6 @@
** valeurs: 1 .. 3600
** valeur par défaut: `+60+`
* [[option_irc.server_default.default_chantypes]] *irc.server_default.default_chantypes*
** description: pass:none[préfixes de types de canaux à utiliser si le serveur ne les envoie pas dans le message 005 (par défaut "#&")]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"#&"+`
* [[option_irc.server_default.ipv6]] *irc.server_default.ipv6*
** description: pass:none[utiliser le protocole IPv6 pour la communication avec le serveur (essayer IPv6 puis repli sur l'IPv4) ; si désactivé, seulement l'IPv4 est utilisé]
** type: booléen
@@ -2713,19 +2629,19 @@
** valeur par défaut: `+""+`
* [[option_irc.server_default.msg_kick]] *irc.server_default.msg_kick*
** description: pass:none[message par défaut pour l'éjection utilisé par les commandes "/kick" et "/kickban" (note : le contenu est évalué, voir /help eval ; les variables spéciales ${nick} (propre pseudo), ${target} (pseudo cible), ${channel} et ${server} sont remplacées par leur valeurs)]
** description: pass:none[message par défaut pour l'éjection utilisé par les commandes "/kick" et "/kickban" (note : le contenu est évalué, voir /help eval ; les variables spéciales ${nick}, ${channel} et ${server} sont remplacées par leur valeur)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
* [[option_irc.server_default.msg_part]] *irc.server_default.msg_part*
** description: pass:none[message par défaut pour le part (en quittant un canal) (note : le contenu est évalué, voir /help eval ; les variables spéciales ${nick}, ${channel} et ${server} sont remplacées par leur valeurs ; "%v" est remplacé par la version de WeeChat s'il n'y a pas de ${...} dans la chaîne)]
** description: pass:none[message par défaut pour le part (en quittant un canal) (note : le contenu est évalué, voir /help eval ; les variables spéciales ${nick}, ${channel} et ${server} sont remplacées par leur valeur ; "%v" est remplacé par la version de WeeChat s'il n'y a pas de ${...} dans la chaîne)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"WeeChat ${info:version}"+`
* [[option_irc.server_default.msg_quit]] *irc.server_default.msg_quit*
** description: pass:none[message de fin par défaut (lors de la déconnexion du serveur) (note : le contenu est évalué, voir /help eval ; les variables spéciales ${nick}, ${channel} et ${server} sont remplacées par leurs valeurs ; "%v" est remplacé par la version de WeeChat s'il n'y a pas de ${...} dans la chaîne)]
** description: pass:none[message de fin par défaut (lors de la déconnexion du serveur) (note : le contenu est évalué, voir /help eval ; les variables spéciales ${nick}, ${channel} et ${server} sont remplacées par leur valeur ; "%v" est remplacé par la version de WeeChat s'il n'y a pas de ${...} dans la chaîne)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"WeeChat ${info:version}"+`
@@ -2773,15 +2689,15 @@
** valeur par défaut: `+continue+`
* [[option_irc.server_default.sasl_key]] *irc.server_default.sasl_key*
** description: pass:none[fichier avec la clé privée ECC pour le mécanisme "ecdsa-nist256p-challenge" (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** description: pass:none[fichier avec la clé privée ECC pour le mécanisme "ecdsa-nist256p-challenge" ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
* [[option_irc.server_default.sasl_mechanism]] *irc.server_default.sasl_mechanism*
** description: pass:none[mécanisme pour l'authentification SASL : "plain" pour un mot de passe en clair, "scram-sha-1" pour une authentification SCRAM avec algorithme de hachage SHA-1, "scram-sha-256" pour une authentification SCRAM avec algorithme de hachage SHA-256, "scram-sha-512" pour une authentification SCRAM avec algorithme de hachage SHA-512, "ecdsa-nist256p-challenge" pour une authentification par challenge avec clé, "external" pour une authentification en utilisant un certificat SSL côté client, "dh-blowfish" pour un mot de passe chiffré avec blowfish (non sûr, non recommandé), "dh-aes" pour un mot de passe chiffré avec AES (non sûr, non recommandé)]
** description: pass:none[mécanisme pour l'authentification SASL : "plain" pour un mot de passe en clair, "ecdsa-nist256p-challenge" pour une authentification par challenge avec clé, "external" pour une authentification en utilisant un certificat SSL côté client, "dh-blowfish" pour un mot de passe chiffré avec blowfish (non sûr, non recommandé), "dh-aes" pour un mot de passe chiffré avec AES (non sûr, non recommandé)]
** type: entier
** valeurs: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** valeurs: plain, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** valeur par défaut: `+plain+`
* [[option_irc.server_default.sasl_password]] *irc.server_default.sasl_password*
@@ -2815,7 +2731,7 @@
** valeur par défaut: `+off+`
* [[option_irc.server_default.ssl_cert]] *irc.server_default.ssl_cert*
** description: pass:none[fichier de certificat SSL utilisé pour identifier automatiquement votre pseudo (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** description: pass:none[fichier de certificat SSL utilisé pour identifier automatiquement votre pseudo ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -3039,10 +2955,10 @@
** valeur par défaut: `+100000+`
* [[option_relay.network.ssl_cert_key]] *relay.network.ssl_cert_key*
** description: pass:none[fichier avec le certificat et la clé privée SSL (pour servir les clients avec SSL) (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** description: pass:none[fichier avec le certificat et la clé privée SSL (pour servir les clients avec SSL)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"${weechat_config_dir}/ssl/relay.pem"+`
** valeur par défaut: `+"%h/ssl/relay.pem"+`
* [[option_relay.network.ssl_priorities]] *relay.network.ssl_priorities*
** description: pass:none[chaîne avec les priorités pour gnutls (pour la syntaxe, voir la documentation de la fonction gnutls_priority_init du manuel gnutls, les chaînes courantes sont : "PERFORMANCE", "NORMAL", "SECURE128", "SECURE256", "EXPORT", "NONE")]
@@ -3345,7 +3261,7 @@
** valeur par défaut: `+lightmagenta+`
* [[option_script.look.columns]] *script.look.columns*
** description: pass:none[format des colonnes affichées dans le tampon des scripts : les identifiants de colonne suivants sont remplacés par leurs valeurs : %a=auteur, %d=description, %D=date d'ajout, %e=extension, %l=langage, %L=licence, %n=nom avec extension, %N=nom, %r=dépendances, %s=statuts, %t=étiquettes, %u=date de mise à jour, %v=version, %V=version chargée, %w=min_weechat, %W=max_weechat]
** description: pass:none[format des colonnes affichées dans le tampon des scripts : les identifiants de colonne suivants sont remplacés par leur valeur : %a=auteur, %d=description, %D=date d'ajout, %e=extension, %l=langage, %L=licence, %n=nom avec extension, %N=nom, %r=dépendances, %s=statuts, %t=étiquettes, %u=date de mise à jour, %v=version, %V=version chargée, %w=min_weechat, %W=max_weechat]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%s %n %V %v %u | %d | %t"+`
@@ -3423,10 +3339,10 @@
** valeur par défaut: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
** description: pass:none[répertoire du cache local pour les scripts (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** description: pass:none[répertoire du cache local pour les scripts ; "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") (note : le contenu est évalué, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"${weechat_cache_dir}/script"+`
** valeur par défaut: `+"%h/script"+`
* [[option_script.scripts.url]] *script.scripts.url*
** description: pass:none[URL pour le fichier avec la liste des scripts]
+4 -4
View File
@@ -15,10 +15,10 @@
*weechat-headless*, non compatible avec l'option "--daemon").
*-d*, *--dir* _<répertoire>_::
Forcer un unique répertoire pour tous les fichiers WeeChat (le répertoire
est créé s'il n'est pas trouvé).
Quatre répertoires peuvent être donnés, séparés par ":" (dans cet ordre :
config, data, cache, runtime).
Définir le répertoire comme étant la base de WeeChat
(utilisé pour les fichiers de configuration, logs, extensions
et scripts de l'utilisateur), la valeur par défaut est "~/.weechat"
(note : le répertoire est créé s'il n'est pas trouvé par WeeChat).
Si cette option n'est pas donnée, la variable d'environnement WEECHAT_HOME
est utilisée (si non vide).
+27 -27
View File
@@ -10,7 +10,7 @@ temporaire avec une URL, comme ceci :
Pour rejoindre le canal IRC de support WeeChat avec le pseudo "monpseudo" :
irc://monpseudo@irc.libera.chat/#weechat
irc://monpseudo@chat.freenode.net/#weechat
Les adresses IPv6 peuvent être entourées par des crochets pour ajouter un port
après, par exemple :
@@ -19,79 +19,79 @@ après, par exemple :
// end::plugin_options[]
// tag::files[]
$HOME/.config/weechat/weechat.conf::
$HOME/.weechat/weechat.conf::
fichier de configuration principal de WeeChat
$HOME/.config/weechat/plugins.conf::
$HOME/.weechat/plugins.conf::
fichier de configuration des extensions
$HOME/.config/weechat/sec.conf::
$HOME/.weechat/sec.conf::
fichier de configuration avec les données sécurisées
$HOME/.config/weechat/alias.conf::
$HOME/.weechat/alias.conf::
fichier de configuration pour l'extension _alias_
$HOME/.config/weechat/buflist.conf::
$HOME/.weechat/buflist.conf::
fichier de configuration pour l'extension _buflist_
$HOME/.config/weechat/charset.conf::
$HOME/.weechat/charset.conf::
fichier de configuration pour l'extension _charset_
$HOME/.config/weechat/exec.conf::
$HOME/.weechat/exec.conf::
fichier de configuration pour l'extension _exec_
$HOME/.config/weechat/fifo.conf::
$HOME/.weechat/fifo.conf::
fichier de configuration pour l'extension _fifo_
$HOME/.config/weechat/fset.conf::
$HOME/.weechat/fset.conf::
fichier de configuration pour l'extension _fset_
$HOME/.config/weechat/guile.conf::
$HOME/.weechat/guile.conf::
fichier de configuration pour l'extension _guile_
$HOME/.config/weechat/irc.conf::
$HOME/.weechat/irc.conf::
fichier de configuration pour l'extension _irc_
$HOME/.config/weechat/javascript.conf::
$HOME/.weechat/javascript.conf::
fichier de configuration pour l'extension _javascript_
$HOME/.config/weechat/logger.conf::
$HOME/.weechat/logger.conf::
fichier de configuration pour l'extension _logger_
$HOME/.config/weechat/lua.conf::
$HOME/.weechat/lua.conf::
fichier de configuration pour l'extension _lua_
$HOME/.config/weechat/perl.conf::
$HOME/.weechat/perl.conf::
fichier de configuration pour l'extension _perl_
$HOME/.config/weechat/php.conf::
$HOME/.weechat/php.conf::
fichier de configuration pour l'extension _php_
$HOME/.config/weechat/python.conf::
$HOME/.weechat/python.conf::
fichier de configuration pour l'extension _python_
$HOME/.config/weechat/relay.conf::
$HOME/.weechat/relay.conf::
fichier de configuration pour l'extension _relay_
$HOME/.config/weechat/ruby.conf::
$HOME/.weechat/ruby.conf::
fichier de configuration pour l'extension _ruby_
$HOME/.config/weechat/script.conf::
$HOME/.weechat/script.conf::
fichier de configuration pour l'extension _script_
$HOME/.config/weechat/spell.conf::
$HOME/.weechat/spell.conf::
fichier de configuration pour l'extension _spell_
$HOME/.config/weechat/tcl.conf::
$HOME/.weechat/tcl.conf::
fichier de configuration pour l'extension _tcl_
$HOME/.config/weechat/trigger.conf::
$HOME/.weechat/trigger.conf::
fichier de configuration pour l'extension _trigger_
$HOME/.config/weechat/xfer.conf::
$HOME/.weechat/xfer.conf::
fichier de configuration pour l'extension _xfer_
$HOME/.local/share/weechat/weechat.log::
$HOME/.weechat/weechat.log::
fichier de log de WeeChat
// end::files[]
@@ -99,7 +99,7 @@ $HOME/.local/share/weechat/weechat.log::
WeeChat est écrit par Sébastien Helleu et des contributeurs (la liste complète
est dans le fichier AUTHORS.adoc).
Copyright (C) 2003-2021 {author}
Copyright (C) 2003-2020 {author}
WeeChat est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier
sous les termes de la GNU General Public License telle que publiée par la
+1 -1
View File
@@ -25,7 +25,7 @@ WeeChat (Wee Enhanced Environment for Chat) est un client de discussion libre,
rapide et léger, conçu pour différents systèmes d'exploitation.
Il est hautement paramétrable et extensible avec des scripts.
La commande *weechat-headless* lance WeeChat en mode « headless » (sans interface).
La commande *weechat-headless* lance WeeChat en mode « headless » (sans interface).
Elle peut être utilisée pour des tests ou lancer WeeChat en daemon
avec l'option "--daemon".
+18 -18
View File
@@ -68,7 +68,7 @@ Les répertoires principaux de WeeChat sont :
|       hook/ | Fonctions sur les "hooks".
|    gui/ | Fonctions pour les tampons, fenêtres, ... (utilisées par toutes les interfaces).
|       curses/ | Interface Curses.
|          headless/ | Mode sans interface (« headless »).
|          headless/ | Mode sans interface (« headless »).
|          normal/ | Interface Curses.
|    plugins/ | API extension/script.
|       alias/ | Extension Alias.
@@ -100,7 +100,6 @@ Les répertoires principaux de WeeChat sont :
|       gui/ | Tests unitaires pour les fonctions de l'interface.
|       plugins/ | Tests unitaires pour les extensions.
|          irc/ | Tests unitaires pour l'extension IRC.
|          trigger/ | Tests unitaires pour l'extension trigger.
| doc/ | Documentation.
| po/ | Fichiers de traductions (gettext).
| debian/ | Empaquetage Debian.
@@ -130,7 +129,6 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|    wee-config.c | Options de configuration du cœur de WeeChat (fichier weechat.conf).
|    wee-crypto.c | Fonctions de cryptographie.
|    wee-debug.c | Quelques fonctions de debug.
|    wee-dir.c | Fonctions sur les répertoires/fichiers.
|    wee-eval.c | Évaluation d'expressions avec des références à des variables internes.
|    wee-hashtable.c | Tables de hachage.
|    wee-hdata.c | Hdata (accès direct aux données en utilisant des tables de hachage).
@@ -144,7 +142,6 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|    wee-secure.c | Fonctions pour les données sécurisées.
|    wee-secure-buffer.c | Tampon pour les données sécurisées.
|    wee-secure-config.c | Options des données sécurisées (fichier sec.conf).
|    wee-signal.c | Fonctions sur les signaux.
|    wee-string.c | Fonctions sur les chaînes de caractères.
|    wee-upgrade-file.c | Système de mise à jour interne.
|    wee-upgrade.c | Mise à jour du cœur de WeeChat (tampons, lignes, historique, ...).
@@ -202,7 +199,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|       gui-curses-mouse.c | Souris.
|       gui-curses-term.c | Fonctions pour le terminal.
|       gui-curses-window.c | Fenêtres.
|       headless/ | Mode sans interface (« headless »).
|       headless/ | Mode sans interface (« headless »).
|          main.c | Point d'entrée pour le mode sans interface.
|          ncurses-fake.c | Fausse bibliothèque ncurses.
|       normal/ | Interface Curses.
@@ -399,16 +396,13 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|          test-core-arraylist.cpp | Tests : listes avec tableau (« arraylists »).
|          test-core-calc.cpp | Tests : calcul d'expressions.
|          test-core-crypto.cpp | Tests : fonctions cryptographiques.
|          test-core-dir.cpp | Tests : répertoires/fichiers.
|          test-core-eval.cpp | Tests : évaluation d'expressions.
|          test-core-hashtble.cpp | Tests : tables de hachage.
|          test-core-hdata.cpp | Tests : hdata.
|          test-core-hook.cpp | Tests : hooks.
|          test-core-infolist.cpp | Tests : infolists.
|          test-core-list.cpp | Tests : listes.
|          test-core-network.cpp | Tests : fonctions réseau.
|          test-core-secure.cpp | Tests : données sécurisées.
|          test-core-signal.cpp | Tests : signaux.
|          test-core-string.cpp | Tests : chaînes.
|          test-core-url.cpp | Tests : URLs.
|          test-core-utf8.cpp | Tests : UTF-8.
@@ -428,8 +422,6 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|             test-irc-nick.cpp | Tests : pseudos IRC.
|             test-irc-protocol.cpp | Tests : protocole IRC.
|             test-irc-server.cpp | Tests : serveur IRC.
|          trigger/ | Racine des tests unitaires pour l'extension trigger.
|             test-trigger.cpp | Tests : triggers.
|          relay/ | Racine des tests unitaires pour l'extension Relay.
|             test-relay-auth.cpp | Tests : authentification des clients.
|===
@@ -504,7 +496,7 @@ Exemple en C :
/*
* weechat.c - core functions for WeeChat
*
* Copyright (C) 2021 Your Name <your@email.com>
* Copyright (C) 2020 Your Name <your@email.com>
*
* This file is part of WeeChat, the extensible chat client.
*
@@ -1116,13 +1108,18 @@ Tout patch pour un bug ou une nouvelle fonctionnalité doit être effectué sur
branche master, le format préféré étant une "pull request" sur GitHub. Un patch
peut aussi être envoyé par e-mail (fait avec `git diff` ou `git format-patch`).
Le format du message de commit est le suivant (avec fermeture automatique
du bug GitHub) :
Le format du message de commit est le suivant (pour fermer un bug GitHub) :
----
component: fix a problem (closes #123)
----
Pour un bug Savannah :
----
component: fix a problem (bug #12345)
----
Où _component_ est :
* pour le cœur WeeChat : _core_ (les fichiers dans le répertoire racine, _po/_
@@ -1135,17 +1132,20 @@ Quelques règles à suivre :
* Utilisez seulement l'anglais.
* Utilisez des verbes à l'infinitif.
* Si le commit est relatif à un bug GitHub, écrivez-le entre parenthèses après
le message, avec ce format : `(issue #123)` ou `(closes #123)` pour le fermer.
* Si le commit est relatif au tracker, écrivez-le entre parenthèses après le
message, avec ce format :
** GitHub : closes #123
** Savannah : bug #12345, task #12345, patch #12345
Exemples de messages de commit :
----
core: add callback "nickcmp" for nick comparison in buffers
core: update Japanese translations
irc: add command /unquiet (closes #36)
python: fix crash when unloading a script without pointer to interpreter
core: add callback "nickcmp" for nick comparison in buffers
irc: fix freeze when reading on socket with SSL enabled (bug #35097)
ruby: add detection of ruby version 1.9.3 in CMake
python: fix crash when unloading a script without pointer to interpreter
core: update Japanese translations (patch #7783)
----
[[translations]]
+35 -67
View File
@@ -237,34 +237,6 @@ Par exemple pour utiliser kbd:[F1], kbd:[F2], kbd:[Alt+F1] et kbd:[Alt+F2] :
Les touches "meta-OP" et "meta-OQ" peuvent être différentes dans votre terminal.
Pour trouver le code de la touche appuyez sur kbd:[Alt+k] puis la touche.
[[customize_buflist]]
=== Comment puis-je configurer la liste des tampons, comme la couleur du tampon actif ?
Vous pouvez afficher toutes les options buflist avec la commande :
----
/fset buflist
----
Le fond du tampon actif est bleu par défaut, vous pouvez le changer comme ceci,
par exemple en rouge (`red`) :
----
/set buflist.format.buffer_current "${color:,red}${format_buffer}"
----
[NOTE]
Il y a une virgule avant le nom de la couleur "red" parce qu'elle est utilisée
comme couleur de fond et non de texte. +
Vous pouvez aussi utiliser une couleur numérique à la place de `red`, comme
`237` pour du gris foncé.
L'extension buflist met à disposition beaucoup d'options que vous pouvez changer,
merci de lire l'aide sur chaque option.
Il y a aussi une page wiki avec des examples avancés de configuration buflist :
https://github.com/weechat/weechat/wiki/buflist
[[customize_prefix]]
=== Comment puis-je réduire la longueur des pseudos ou supprimer l'alignement des pseudos dans la zone de discussion ?
@@ -750,9 +722,8 @@ kbd:[Alt] au lieu de kbd:[Shift]).
=== J'ai des problèmes pour me connecter au serveur avec SSL, que puis-je faire ?
Si vous utilisez macOS, vous devez installer `openssl` depuis Homebrew.
Un fichier CA sera installé avec le le trousseau système.
Avec WeeChat ≤ 3.1, vous pouvez définir le chemin vers les certificats système :
Un fichier CA sera installé avec le le trousseau système. Vous pouvez alors
définie le chemin vers les certificats sous WeeChat :
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@@ -790,11 +761,11 @@ seulement), remplacez "xxx" par le nom de votre serveur :
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
----
[[irc_ssl_libera]]
=== Comment puis-je me connecter à libera avec SSL ?
[[irc_ssl_freenode]]
=== Comment puis-je me connecter à freenode avec SSL ?
Avec WeeChat ≤ 3.1, positionnez l'option _weechat.network.gnutls_ca_file_ avec
le fichier des certificats :
Positionnez l'option _weechat.network.gnutls_ca_file_ avec le fichier des
certificats :
----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
@@ -814,9 +785,9 @@ Vérifiez que vous avez bien ce fichier (fourni généralement par le paquet
Configurez le port du serveur, SSL, puis connectez-vous :
----
/set irc.server.libera.addresses "irc.libera.chat/6697"
/set irc.server.libera.ssl on
/connect libera
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
----
[[irc_oauth]]
@@ -841,25 +812,25 @@ Si le serveur supporte SASL, vous devriez l'utiliser au lieu d'envoyer une
commande pour l'authentification avec nickserv, par exemple :
----
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
----
Si le serveur ne supporte pas SASL, vous pouvez ajouter un délai (entre la
commande et le join des canaux) :
----
/set irc.server.libera.command_delay 5
/set irc.server.freenode.command_delay 5
----
[[edit_autojoin]]
=== Comment puis-je ajouter/supprimer des canaux de l'option autojoin ?
Vous pouvez utiliser la commande `/set` pour éditer la liste des canaux de
l'autojoin, par exemple pour le serveur libera :
l'autojoin, par exemple pour le serveur freenode :
----
/set irc.server.libera.autojoin [TAB]
/set irc.server.freenode.autojoin [TAB]
----
[NOTE]
@@ -1039,16 +1010,16 @@ du script _buffer_autoset.py_ :
----
Par exemple, pour désactiver de manière permanente les highlights de "mike" sur
#weechat sur le serveur IRC libera :
#weechat sur le serveur IRC freenode :
----
/buffer_autoset add irc.libera.#weechat hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2
----
Pour l'appliquer à l'ensemble du serveur libera :
Pour l'appliquer à l'ensemble du serveur freenode :
----
/buffer_autoset add irc.libera hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2
----
Pour plus d'exemples, voir `+/help buffer_autoset+`.
@@ -1087,18 +1058,16 @@ Les scripts ne sont pas compatibles avec d'autres clients IRC.
[[scripts_update]]
=== La commande "/script update" ne peut pas lire les scripts, comment corriger ça ?
Consultez d'abord les questions à propos des connexions SSL dans cette FAQ.
Consultez d'abord les questions à propos des connexions SSL dans cette FAQ
(en particulier l'option _weechat.network.gnutls_ca_file_).
Si cela ne fonctionne toujours pas, essayez de supprimer manuellement le fichier
avec les scripts (dans votre shell) :
----
$ rm ~/.cache/weechat/script/plugins.xml.gz
$ rm ~/.weechat/script/plugins.xml.gz
----
[NOTE]
Avec WeeChat ≤ 3.1, le chemin devrait être : _~/.weechat/script/plugins.xml.gz_.
Et mettez à jour les scripts à nouveau dans WeeChat :
----
@@ -1119,12 +1088,12 @@ vous-même pour obtenir les mises à jour) :
* dans votre shell, avec curl installé :
----
$ cd ~/.cache/weechat/script
$ cd ~/.weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
----
[[spell_dictionaries]]
=== J'ai installé des dictionnaires aspell sur mon système, comment les utiliser sans redémarrer WeeChat ?
=== J'ai installé des dictionnaires aspell sur mon système, comment les utiliser sans redémarrer WeeChat ?
Vous devez recharger l'extension spell :
@@ -1173,8 +1142,8 @@ Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire :
spell, xfer (utilisé pour les DCC).
Voir `/help weechat.plugin.autoload`.
* Charger uniquement les scripts dont vous avez vraiment besoin.
* Ne pas charger les certificats si SSL n'est *PAS* utilisé : désactiver
l'option _weechat.network.gnutls_ca_system_.
* Ne pas charger les certificats si SSL n'est *PAS* utilisé : affecter une
chaîne vide pour l'option _weechat.network.gnutls_ca_file_.
* Réduire la valeur de l'option _weechat.history.max_buffer_lines_number_ ou
affecter une valeur à l'option _weechat.history.max_buffer_lines_minutes_.
* Réduire la valeur de l'option _weechat.history.max_commands_.
@@ -1233,22 +1202,22 @@ Par exemple :
----
/secure passphrase xxxxxxxxxx
/secure set libera_username username
/secure set libera_password xxxxxxxx
/set irc.server.libera.sasl_username "${sec.data.libera_username}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
/secure set freenode_username username
/secure set freenode_password xxxxxxxx
/set irc.server.freenode.sasl_username "${sec.data.freenode_username}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
----
[[sharing_config_files]]
=== Je souhaite partager ma configuration de WeeChat, quels fichiers dois-je partager et que dois-je garder privé ?
=== Je souhaite partager ma configuration de WeeChat, quels fichiers dois-je partager et que dois-je garder privé ?
Vous pouvez partager les fichiers de configuration _*.conf_ sauf le fichier
Vous pouvez partager les fichiers _~/.weechat/*.conf_ sauf le fichier
_sec.conf_ qui contient vos mots de passes chiffrés avec votre phrase
de chiffrement.
Quelques autres fichiers peuvent contenir des informations sensibles comme
des mots de passes (s'ils ne sont pas stockés dans _sec.conf_ avec la commande
`/secure`).
Quelques autres fichiers comme _irc.conf_ peuvent contenir des informations
sensibles comme les mots de passes des serveurs/canaux (s'ils ne sont pas
stockés dans _sec.conf_ avec la commande `/secure`).
Voir le link:weechat_user.fr.html#files_and_directories[Guide utilisateur / Fichiers et répertoires]
pour plus d'informations sur les fichiers de configuration.
@@ -1284,8 +1253,7 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
[[supported_os]]
=== Quelle est la liste des plates-formes supportées par WeeChat ? Sera-t-il porté sur d'autres systèmes d'exploitation ?
WeeChat tourne bien sur la plupart des distributions Linux/BSD, GNU/Hurd, Mac OS
et Windows (Cygwin et Windows Subsystem for Linux).
La liste complète est sur cette page : https://weechat.org/download
Nous faisons le maximum pour supporter le plus de plates-formes possible.
Toute aide est la bienvenue pour les systèmes que nous n'avons pas, pour y
File diff suppressed because it is too large Load Diff
+28 -21
View File
@@ -110,12 +110,12 @@ devriez voir "irc" et d'autres extensions dans cette liste.
Vous pouvez ajouter un serveur IRC avec la commande `/server`, par exemple :
----
/server add libera irc.libera.chat/6697 -ssl
/server add freenode chat.freenode.net
----
Dans cette commande, `libera` est le nom interne du serveur utilisé par
WeeChat : vous pourrez vous connecter avec `/connect libera` et les options
du serveur sont _irc.server.libera.xxx_.
Dans cette commande, `freenode` est le nom interne du serveur utilisé par
WeeChat : vous pourrez vous connecter avec `/connect freenode` et les options
du serveur sont _irc.server.freenode.xxx_.
Comme d'habitude, de l'aide est disponible si vous êtes perdus :
@@ -135,31 +135,38 @@ définie (non "null"). Sinon WeeChat utilise la valeur par défaut
("irc.server_default.xxx").
Par exemple il y a des pseudos par défaut (basés sur votre login un*x), et
vous pouvez les écraser pour le serveur libera avec la commande suivante :
vous pouvez les écraser pour le serveur freenode avec la commande suivante :
----
/set irc.server.libera.nicks "pseudo,pseudo2,pseudo3,pseudo4,pseudo5"
/set irc.server.freenode.nicks "pseudo,pseudo2,pseudo3,pseudo4,pseudo5"
----
Pour modifier le nom d'utilisateur et nom réel :
----
/set irc.server.libera.username "Mon nom d'utilisateur"
/set irc.server.libera.realname "Mon nom réel"
/set irc.server.freenode.username "Mon nom d'utilisateur"
/set irc.server.freenode.realname "Mon nom réel"
----
Pour activer la connexion automatique au serveur lors du démarrage :
----
/set irc.server.libera.autoconnect on
/set irc.server.freenode.autoconnect on
----
Pour se connecter avec SSL :
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
----
Si SASL est disponible sur le serveur, vous pouvez l'utiliser pour
l'authentification (vous serez identifié avant de rejoindre les canaux) :
----
/set irc.server.libera.sasl_username "pseudo"
/set irc.server.libera.sasl_password "xxxxxxx"
/set irc.server.freenode.sasl_username "pseudo"
/set irc.server.freenode.sasl_password "xxxxxxx"
----
Pour lancer une commande après connexion au serveur, par exemple pour
@@ -167,7 +174,7 @@ s'authentifier auprès de nickserv (seulement si vous n'utilisez pas SASL pour
l'authentification) :
----
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -183,23 +190,23 @@ Définissez d'abord une phrase de chiffrement :
/secure passphrase this is my secret passphrase
----
Puis ajoutez une donnée sécurisée avec votre mot de passe libera :
Puis ajoutez une donnée sécurisée avec votre mot de passe freenode :
----
/secure set libera_password xxxxxxx
/secure set freenode_password xxxxxxx
----
Vous pouvez alors utiliser `+${sec.data.libera_password}+` au lieu de votre
Vous pouvez alors utiliser `+${sec.data.freenode_password}+` au lieu de votre
mot de passe dans les options IRC mentionnées ci-dessus, par exemple :
----
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
----
Pour rejoindre automatiquement des canaux lors de la connexion au serveur :
----
/set irc.server.libera.autojoin "#canal1,#canal2"
/set irc.server.freenode.autojoin "#canal1,#canal2"
----
[TIP]
@@ -212,24 +219,24 @@ défaut à la place, par exemple pour utiliser les pseudos par défaut
(irc.server_default.nicks) :
----
/unset irc.server.libera.nicks
/unset irc.server.freenode.nicks
----
Autres options : vous pouvez modifier les autres options avec la commande
suivante ("xxx" est le nom d'une option) :
----
/set irc.server.libera.xxx valeur
/set irc.server.freenode.xxx valeur
----
[[connect_to_irc_server]]
== Se connecter au serveur IRC
----
/connect libera
/connect freenode
----
Avec cette commande, WeeChat se connecte au serveur libera et rejoint
Avec cette commande, WeeChat se connecte au serveur freenode et rejoint
automatiquement les canaux configurés dans l'option "autojoin" du serveur.
[NOTE]
+72 -72
View File
@@ -447,11 +447,11 @@ hda:
item 2:
__path: ['0x558d62840ea0']
number: 1
full_name: 'irc.server.libera'
full_name: 'irc.server.freenode'
item 3:
__path: ['0x558d62a9cea0']
number: 2
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
----
* Demander toutes les lignes du premier tampon :
@@ -599,15 +599,15 @@ inf: ('version_number', '34144256')
* Demander le répertoire de WeeChat :
----
(info_weechat_config_dir) info weechat_config_dir
(info_weechat_dir) info weechat_dir
----
Réponse :
[source,python]
----
id: 'info_weechat_config_dir'
inf: ('weechat_config_dir', '/home/user/.config/weechat')
id: 'info_weechat_dir'
inf: ('weechat_dir', '/home/xxx/.weechat')
----
[[command_infolist]]
@@ -759,7 +759,7 @@ Syntaxe :
Paramètres :
* _tampon_ : pointeur (par exemple : "0x1234abcd") ou nom complet du tampon (par exemple :
_core.weechat_ ou _irc.libera.#weechat_)
_core.weechat_ ou _irc.freenode.#weechat_)
Exemples :
@@ -868,10 +868,10 @@ hda:
prefix_color: None
----
* Demander la liste de pseudos pour le tampon "irc.libera.#weechat" :
* Demander la liste de pseudos pour le tampon "irc.freenode.#weechat" :
----
(nicklist_weechat) nicklist irc.libera.#weechat
(nicklist_weechat) nicklist irc.freenode.#weechat
----
Réponse :
@@ -960,7 +960,7 @@ Syntaxe :
Paramètres :
* _tampon_ : pointeur (par exemple : "0x1234abcd") ou nom complet du tampon (par exemple :
_core.weechat_ ou _irc.libera.#weechat_)
_core.weechat_ ou _irc.freenode.#weechat_)
* _données_ : données à envoyer au tampon : si elles commencent par `/`,
cela sera exécuté comme une commande sur le tampon, sinon le texte est envoyé
comme entrée sur le tampon
@@ -976,7 +976,7 @@ input core.weechat /help filter
* Envoyer le message "bonjour !" sur le canal #weechat :
----
input irc.libera.#weechat bonjour !
input irc.freenode.#weechat bonjour !
----
[[command_completion]]
@@ -996,7 +996,7 @@ Syntaxe :
Paramètres :
* _tampon_ : pointeur (par exemple : "0x1234abcd") ou nom complet du tampon (par exemple :
_core.weechat_ ou _irc.libera.#weechat_)
_core.weechat_ ou _irc.freenode.#weechat_)
* _position_ : position dans la chaîne pour la complétion (démarre à 0) ;
si la valeur est -1, la position est la longueur de _données_ (donc la
complétion se fait à la fin de _données_)
@@ -1157,7 +1157,7 @@ Syntaxe :
Paramètres :
* _tampon_ : pointeur (par exemple : "0x1234abcd") ou nom complet du tampon (par exemple :
_core.weechat_ ou _irc.libera.#weechat_); le nom "*" peut être utilisé pour
_core.weechat_ ou _irc.freenode.#weechat_); le nom "*" peut être utilisé pour
spécifier tous les tampons
* _options_ : un ou plusieurs mots-clés, séparés par des virgules (par défaut
_buffers,upgrade,buffer,nicklist_ pour "*" et _buffer,nicklist_ pour un
@@ -1194,14 +1194,14 @@ sync core.buffer
* Synchroniser le canal #weechat, sans la liste de pseudos :
----
sync irc.libera.#weechat buffer
sync irc.freenode.#weechat buffer
----
* Obtenir les signaux généraux + tous les signaux pour le canal #weechat :
----
sync * buffers,upgrade
sync irc.libera.#weechat
sync irc.freenode.#weechat
----
[[command_desync]]
@@ -1225,7 +1225,7 @@ Syntaxe :
Paramètres :
* _tampon_ : pointeur (par exemple : "0x1234abcd") ou nom complet du tampon (par exemple :
_core.weechat_ ou _irc.libera.#weechat_); le nom "*" peut être utilisé pour
_core.weechat_ ou _irc.freenode.#weechat_); le nom "*" peut être utilisé pour
spécifier tous les tampons
* _options_ : un ou plusieurs mots-clés, séparés par des virgules (le défaut est
_buffers,upgrade,buffer,nicklist_ pour "*" et _buffer,nicklist_ pour un
@@ -1234,7 +1234,7 @@ Paramètres :
[NOTE]
En utilisant le tampon "*", les autres tampons synchronisés (en utilisant un
nom) sont gardés. +
Donc si vous envoyez : "sync *", puis "sync irc.libera.#weechat", puis
Donc si vous envoyez : "sync *", puis "sync irc.freenode.#weechat", puis
"desync *", les mises à jour sur le canal #weechat seront toujours envoyées par
WeeChat (vous devez le retirer explicitement pour stopper les mises à jour).
@@ -1253,13 +1253,13 @@ desync * buffers,upgrade,buffer,nicklist
mises à jour du tampon) :
----
desync irc.libera.#weechat nicklist
desync irc.freenode.#weechat nicklist
----
* Désynchroniser le canal #weechat :
----
desync irc.libera.#weechat
desync irc.freenode.#weechat
----
[[command_test]]
@@ -1504,7 +1504,7 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| short_name | chaîne | Nom court (exemple : _#weechat_).
| nicklist | entier | 1 si le tampon a une liste de pseudos, sinon 0.
| title | chaîne | Titre du tampon.
@@ -1513,8 +1513,8 @@ Données envoyées dans le hdata :
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : canal _#weechat_ rejoint sur libera, nouveau tampon
_irc.libera.#weechat_ :
Exemple : canal _#weechat_ rejoint sur freenode, nouveau tampon
_irc.freenode.#weechat_ :
[source,python]
----
@@ -1534,13 +1534,13 @@ hda:
item 1:
__path: ['0x35a8a60']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
short_name: None
nicklist: 0
title: None
local_variables: {
'plugin': 'irc',
'name': 'libera.#weechat',
'name': 'freenode.#weechat',
}
prev_buffer: '0x34e7400'
next_buffer: '0x0'
@@ -1558,12 +1558,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.libera.#weechat_ déplacé vers le numéro 2 :
Exemple : tampon _irc.freenode.#weechat_ déplacé vers le numéro 2 :
[source,python]
----
@@ -1579,7 +1579,7 @@ hda:
item 1:
__path: ['0x34588c0']
number: 2
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x347b9f0'
next_buffer: '0x3471bc0'
----
@@ -1596,12 +1596,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.libera.#weechat_ mélangé avec le tampon n°2 :
Exemple : tampon _irc.freenode.#weechat_ mélangé avec le tampon n°2 :
[source,python]
----
@@ -1617,7 +1617,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1634,12 +1634,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.libera.#weechat_ sorti du mélange :
Exemple : tampon _irc.freenode.#weechat_ sorti du mélange :
[source,python]
----
@@ -1655,7 +1655,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1674,12 +1674,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.libera.#weechat_ masqué :
Exemple : tampon _irc.freenode.#weechat_ masqué :
[source,python]
----
@@ -1695,7 +1695,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1714,12 +1714,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.libera.#weechat_ démasqué :
Exemple : tampon _irc.freenode.#weechat_ démasqué :
[source,python]
----
@@ -1735,7 +1735,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1752,7 +1752,7 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| short_name | chaîne | Nom court (exemple : _#weechat_).
| local_variables | table de hachage | Variables locales.
|===
@@ -1773,15 +1773,15 @@ hda:
item 1:
__path: ['0x4df7b80']
number: 5
full_name: 'irc.libera.Flash2'
full_name: 'irc.freenode.Flash2'
short_name: 'Flash2'
local_variables: {
'server': 'libera',
'server': 'freenode',
'plugin': 'irc',
'type': 'private',
'channel': 'FlashCode',
'nick': 'test',
'name': 'libera.Flash2',
'name': 'freenode.Flash2',
}
----
@@ -1797,7 +1797,7 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| title | chaîne | Titre du tampon.
|===
@@ -1816,7 +1816,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
title: 'Welcome on #weechat! https://weechat.org/'
----
@@ -1834,10 +1834,10 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
|===
Exemple : tampon _irc.libera.#weechat_ vidé :
Exemple : tampon _irc.freenode.#weechat_ vidé :
[source,python]
----
@@ -1851,7 +1851,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
----
[[message_buffer_type_changed]]
@@ -1866,7 +1866,7 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| type | entier | Type de tampon : 0 = formaté (par défaut), 1 = contenu libre.
|===
@@ -1902,12 +1902,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| local_variables | table de hachage | Variables locales.
|===
Exemple : variable locale _test_ ajoutée dans le tampon
_irc.libera.#weechat_ :
_irc.freenode.#weechat_ :
[source,python]
----
@@ -1922,15 +1922,15 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
local_variables: {
'server': 'libera',
'server': 'freenode',
'test': 'value',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'libera.#weechat',
'name': 'freenode.#weechat',
}
----
@@ -1946,12 +1946,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| local_variables | table de hachage | Variables locales.
|===
Exemple : variable locale _test_ mise à jour dans le tampon
_irc.libera.#weechat_ :
_irc.freenode.#weechat_ :
[source,python]
----
@@ -1966,7 +1966,7 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
local_variables: {
'server': 'local',
'test': 'value2',
@@ -1974,7 +1974,7 @@ hda:
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'libera.#weechat',
'name': 'freenode.#weechat',
}
----
@@ -1990,11 +1990,11 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| local_variables | table de hachage | Variables locales.
|===
Exemple : variable locale _test_ supprimée du tampon _irc.libera.#weechat_ :
Exemple : variable locale _test_ supprimée du tampon _irc.freenode.#weechat_ :
[source,python]
----
@@ -2009,14 +2009,14 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.libera.#prout'
full_name: 'irc.freenode.#prout'
local_variables: {
'server': 'local',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'libera.#weechat',
'name': 'freenode.#weechat',
}
----
@@ -2043,7 +2043,7 @@ Données envoyées dans le hdata :
|===
Exemple : nouveau message _hello!_ du pseudo _FlashCode_ sur le tampon
_irc.libera.#weechat_ :
_irc.freenode.#weechat_ :
[source,python]
----
@@ -2092,10 +2092,10 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
|===
Exemple : tampon _irc.libera.#weechat_ en cours de fermeture par WeeChat :
Exemple : tampon _irc.freenode.#weechat_ en cours de fermeture par WeeChat :
[source,python]
----
@@ -2109,7 +2109,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.libera.#weechat'
full_name: 'irc.freenode.#weechat'
----
[[message_nicklist]]
@@ -2137,7 +2137,7 @@ Données envoyées dans le hdata :
| prefix_color | chaîne | Couleur du préfixe (seulement pour un pseudo).
|===
Exemple : liste de pseudos pour le tampon _irc.libera.#weechat_ :
Exemple : liste de pseudos pour le tampon _irc.freenode.#weechat_ :
[source,python]
----
@@ -2567,17 +2567,17 @@ objets).
retournées pour le hdata)
Exemple de hdata avec deux tampons (tampon "core" weechat et le serveur
libera) et deux clés (_number_ et _full_name_) :
freenode) et deux clés (_number_ et _full_name_) :
....
# commande
hdata buffer:gui_buffers(*) number,full_name
# réponse
┌────────┬──────────────────────────┬───╥─────────┬───┬──────────────╥─────────┬───┬───────────────────┐
│ buffer │ number:int,full_name:str │ 2 ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │ irc.server.libera
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴───────────────────┘
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └───────────────────────────────┘
┌────────┬──────────────────────────┬───╥─────────┬───┬──────────────╥─────────┬───┬─────────────────────
│ buffer │ number:int,full_name:str │ 2 ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │ irc.server.freenode
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴─────────────────────
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └───────────────────────────────
h-path clés nombre tampon 1 tampon 2
....
@@ -2721,7 +2721,7 @@ Un élément est :
** _value_ : valeur de la variable
Exemple d'infolist avec deux tampons (tampon "core" weechat et le serveur
libera) :
freenode) :
....
# commande
+67 -91
View File
@@ -72,17 +72,12 @@ link:weechat_plugin_api.en.html#_hook_process[Référence API extension WeeChat]
[[languages_specificities]]
=== Spécificités des langages
[[language_python]]
==== Python
[[python_module]]
===== Module
WeeChat définit un module `weechat` qui doit être importé avec `import weechat`. +
Un "stub" Python pour l'API WeeChat est disponible dans le dépôt :
https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi].
WeeChat définit un module `weechat` qui doit être importé avec `import weechat`.
[[python_functions]]
===== Fonctions
Les fonctions sont appelées avec `+weechat.xxx(arg1, arg2, ...)+`.
@@ -90,7 +85,6 @@ Les fonctions sont appelées avec `+weechat.xxx(arg1, arg2, ...)+`.
Les fonctions `+print*+` se nomment `+prnt*+` en python (car `print` était un
mot clé réservé en Python 2).
[[python_strings]]
===== Chaînes reçues dans les fonctions de rappel
En Python 3 et avec WeeChat ≥ 2.7, les chaînes reçues dans les fonctions de
@@ -147,23 +141,18 @@ En Python 2, qui est déconseillé et ne devrait plus être utilisé, les chaîn
envoyées aux fonctions de rappel sont toujours de type `str`, et peuvent contenir
des données invalides UTF-8, dans les cas mentionnés ci-dessus.
[[language_perl]]
==== Perl
[[perl_functions]]
===== Fonctions
Les fonctions sont appelées par `+weechat::xxx(arg1, arg2, ...);+`.
[[language_ruby]]
==== Ruby
[[ruby_init]]
===== Initialisation
Vous devez définir _weechat_init_ et appeler _register_ dedans.
[[ruby_functions]]
===== Fonctions
Les fonctions sont appelées par `+Weechat.xxx(arg1, arg2, ...)+`.
@@ -189,26 +178,20 @@ Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical"
["default", "default", "default", "default"], "0", "items")
----
[[language_lua]]
==== Lua
[[lua_functions]]
===== Fonctions
Les fonctions sont appelées par `+weechat.xxx(arg1, arg2, ...)+`.
[[language_tcl]]
==== Tcl
[[tcl_functions]]
===== Fonctions
Les fonctions sont appelées par `+weechat::xxx arg1 arg2 ...+`.
[[language_guile]]
==== Guile (Scheme)
[[guile_functions]]
===== Fonctions
Les fonctions sont appelées par `+(weechat:xxx arg1 arg2 ...)+`.
@@ -221,18 +204,14 @@ excède la limite de Guile :
* config_new_option
* bar_new
[[language_javascript]]
==== JavaScript
[[javascript_functions]]
===== Fonctions
Les fonctions sont appelées par `+weechat.xxx(arg1, arg2, ...);+`.
[[language_php]]
==== PHP
[[php_functions]]
===== Fonctions
Les fonctions sont appelées par `+weechat_xxx(arg1, arg2, ...);+`.
@@ -243,11 +222,11 @@ Les fonctions sont appelées par `+weechat_xxx(arg1, arg2, ...);+`.
Tous les scripts WeeChat doivent s'enregistrer ("register") auprès de WeeChat,
et cela doit être la première fonction WeeChat appelée dans le script.
Prototype (Python) :
Prototype :
[source,python]
----
def register(name: str, author: str, version: str, license: str, description: str, shutdown_function: str, charset: str) -> int: ...
weechat.register(name, author, version, license, description, shutdown_function, charset)
----
Paramètres :
@@ -370,7 +349,7 @@ automatiquement le script quand WeeChat démarre.
Par exemple en Python :
----
$ cd ~/.local/share/weechat/python/autoload
$ cd ~/.weechat/python/autoload
$ ln -s ../script.py
----
@@ -817,58 +796,58 @@ Liste des constantes de l'API script :
| Catégorie | Constantes
| codes retour |
`WEECHAT_RC_OK` (entier) +
`WEECHAT_RC_OK_EAT` (entier) +
`WEECHAT_RC_ERROR` (entier)
WEECHAT_RC_OK +
WEECHAT_RC_OK_EAT +
WEECHAT_RC_ERROR
| fichiers de configuration |
`WEECHAT_CONFIG_READ_OK` (entier) +
`WEECHAT_CONFIG_READ_MEMORY_ERROR` (entier) +
`WEECHAT_CONFIG_READ_FILE_NOT_FOUND` (entier) +
`WEECHAT_CONFIG_WRITE_OK` (entier) +
`WEECHAT_CONFIG_WRITE_ERROR` (entier) +
`WEECHAT_CONFIG_WRITE_MEMORY_ERROR` (entier) +
`WEECHAT_CONFIG_OPTION_SET_OK_CHANGED` (entier) +
`WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE` (entier) +
`WEECHAT_CONFIG_OPTION_SET_ERROR` (entier) +
`WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND` (entier) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET` (entier) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_RESET` (entier) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED` (entier) +
`WEECHAT_CONFIG_OPTION_UNSET_ERROR` (entier)
WEECHAT_CONFIG_READ_OK +
WEECHAT_CONFIG_READ_MEMORY_ERROR +
WEECHAT_CONFIG_READ_FILE_NOT_FOUND +
WEECHAT_CONFIG_WRITE_OK +
WEECHAT_CONFIG_WRITE_ERROR +
WEECHAT_CONFIG_WRITE_MEMORY_ERROR +
WEECHAT_CONFIG_OPTION_SET_OK_CHANGED +
WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE +
WEECHAT_CONFIG_OPTION_SET_ERROR +
WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND +
WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET +
WEECHAT_CONFIG_OPTION_UNSET_OK_RESET +
WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED +
WEECHAT_CONFIG_OPTION_UNSET_ERROR
| listes triées |
`WEECHAT_LIST_POS_SORT` (chaîne) +
`WEECHAT_LIST_POS_BEGINNING` (chaîne) +
`WEECHAT_LIST_POS_END` (chaîne)
WEECHAT_LIST_POS_SORT +
WEECHAT_LIST_POS_BEGINNING +
WEECHAT_LIST_POS_END
| hotlist |
`WEECHAT_HOTLIST_LOW` (chaîne) +
`WEECHAT_HOTLIST_MESSAGE` (chaîne) +
`WEECHAT_HOTLIST_PRIVATE` (chaîne) +
`WEECHAT_HOTLIST_HIGHLIGHT` (chaîne)
WEECHAT_HOTLIST_LOW +
WEECHAT_HOTLIST_MESSAGE +
WEECHAT_HOTLIST_PRIVATE +
WEECHAT_HOTLIST_HIGHLIGHT
| hook process |
`WEECHAT_HOOK_PROCESS_RUNNING` (entier) +
`WEECHAT_HOOK_PROCESS_ERROR` (entier)
WEECHAT_HOOK_PROCESS_RUNNING +
WEECHAT_HOOK_PROCESS_ERROR
| hook connect |
`WEECHAT_HOOK_CONNECT_OK` (entier) +
`WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND` (entier) +
`WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND` (entier) +
`WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED` (entier) +
`WEECHAT_HOOK_CONNECT_PROXY_ERROR` (entier) +
`WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR` (entier) +
`WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR` (entier) +
`WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR` (entier) +
`WEECHAT_HOOK_CONNECT_MEMORY_ERROR` (entier) +
`WEECHAT_HOOK_CONNECT_TIMEOUT` (entier) +
`WEECHAT_HOOK_CONNECT_SOCKET_ERROR` (entier)
WEECHAT_HOOK_CONNECT_OK +
WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND +
WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND +
WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED +
WEECHAT_HOOK_CONNECT_PROXY_ERROR +
WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR +
WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR +
WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR +
WEECHAT_HOOK_CONNECT_MEMORY_ERROR +
WEECHAT_HOOK_CONNECT_TIMEOUT +
WEECHAT_HOOK_CONNECT_SOCKET_ERROR
| hook signal |
`WEECHAT_HOOK_SIGNAL_STRING` (chaîne) +
`WEECHAT_HOOK_SIGNAL_INT` (chaîne) +
`WEECHAT_HOOK_SIGNAL_POINTER` (chaîne)
WEECHAT_HOOK_SIGNAL_STRING +
WEECHAT_HOOK_SIGNAL_INT +
WEECHAT_HOOK_SIGNAL_POINTER
|===
[[common_tasks]]
@@ -910,13 +889,13 @@ weechat.prnt("", "%smauvais paramètres" % weechat.prefix("error"))
weechat.prnt("", "texte %sjaune sur bleu" % weechat.color("yellow,blue"))
# chercher un tampon et afficher un message
# (le nom complet d'un tampon est extension.nom, par exemple : "irc.libera.#weechat")
buffer = weechat.buffer_search("irc", "libera.#weechat")
# (le nom complet d'un tampon est extension.nom, par exemple : "irc.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
weechat.prnt(buffer, "message sur le canal #weechat")
# autre solution pour chercher un tampon IRC (meilleure)
# (notez que le serveur et le canal sont séparés par une virgule)
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
weechat.prnt(buffer, "message sur le canal #weechat")
----
@@ -938,7 +917,7 @@ Exemples :
weechat.command("", "/help")
# envoyer "bonjour" au canal IRC #weechat (les utilisateurs sur le canal verront le message)
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
weechat.command(buffer, "bonjour")
----
@@ -1013,7 +992,7 @@ Pour voir les variables locales d'un tampon, exécutez cette commande dans
WeeChat :
----
/buffer listvar
/buffer localvar
----
[[hooks]]
@@ -1251,7 +1230,7 @@ xxx,irc_raw_in2_yyy::
[source,python]
----
def join_cb(data, signal, signal_data):
# signal est par exemple : "libera,irc_in2_join"
# signal est par exemple : "freenode,irc_in2_join"
# signal_data est le message IRC, par exemple : ":nick!user@host JOIN :#canal"
server = signal.split(",")[0]
msg = weechat.info_get_hashtable("irc_message_parse", {"message": signal_data})
@@ -1306,67 +1285,64 @@ Le résultat est une table de hachage avec les clés suivantes
(les exemples de valeurs sont construits avec ce message :
`+@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!+`) :
[width="100%",cols="3,^2,10,7",options="header"]
[width="100%",cols="1,^2,10,8",options="header"]
|===
| Clé | Depuis WeeChat ^(1)^ | Description | Exemple
| Clé | Version de WeeChat | Description | Exemple
| tags | 0.4.0 |
| tags | 0.4.0 |
Les étiquettes dans le message (peut être vide). |
`+time=2015-06-27T16:40:35.000Z+`
| message_without_tags | 0.4.0 |
| message_without_tags | 0.4.0 |
Le message sans les étiquettes (la même chose que le message s'il n'y a pas
d'étiquettes). |
`+:nick!user@host PRIVMSG #weechat :hello!+`
| nick | 0.3.4 |
| nick | 0.3.4 |
Le pseudo d'origine. |
`+nick+`
| user | 2.7 |
| user | 2.7 |
L'utilisateur d'origine. |
`+user+`
| host | 0.3.4 |
| host | 0.3.4 |
L'hôte d'origine (incluant le pseudo). |
`+nick!user@host+`
| command | 0.3.4 |
| command | 0.3.4 |
La commande (_PRIVMSG_, _NOTICE_, ...). |
`+PRIVMSG+`
| channel | 0.3.4 |
| channel | 0.3.4 |
Le canal cible. |
`+#weechat+`
| arguments | 0.3.4 |
| arguments | 0.3.4 |
Les paramètres de la commande (incluant le canal). |
`+#weechat :hello!+`
| text | 1.3 |
| text | 1.3 |
Le texte (par exemple un message utilisateur). |
`+hello!+`
| pos_command | 1.3 |
| pos_command | 1.3 |
La position de _command_ dans le message ("-1" si _command_ n'a pas été trouvé). |
`+47+`
| pos_arguments | 1.3 |
| pos_arguments | 1.3 |
La position de _arguments_ dans le message ("-1" si _arguments_ n'a pas été trouvé). |
`+55+`
| pos_channel | 1.3 |
| pos_channel | 1.3 |
La position de _channel_ dans le message ("-1" si _channel_ n'a pas été trouvé). |
`+55+`
| pos_text | 1.3 |
| pos_text | 1.3 |
La position de _text_ dans le message ("-1" si _text_ n'a pas été trouvé). |
`+65+`
|===
[NOTE]
^(1)^ La clé a été introduite dans cette version de WeeChat.
[source,python]
----
dict = weechat.info_get_hashtable(
@@ -1429,8 +1405,8 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[source,python]
----
# répertoire de config WeeChat, par exemple : "/home/user/.config/weechat"
weechat.prnt("", "Répertoire de config WeeChat : %s" % weechat.info_get("weechat_config_dir", ""))
# répertoire de WeeChat, par exemple : "/home/xxxx/.weechat"
weechat.prnt("", "Répertoire WeeChat : %s" % weechat.info_get("weechat_dir", ""))
# inactivité clavier
weechat.prnt("", "Inactivité depuis %s secondes" % weechat.info_get("inactivity", ""))
+1 -1
View File
@@ -132,7 +132,7 @@ Si vous êtes encore éveillé, vous devriez voir une interface familière et
pouvoir vous vanter d'utiliser la version la plus récente possible de WeeChat ;)
Maintenant si vous obtenez un comportement étrange ou un plantage, n'hésitez
pas à nous en avertir sur _#weechat_, serveur _irc.libera.chat_.
pas à nous en avertir sur _#weechat_, serveur _chat.freenode.net_.
S'il n'y a pas de plantage, dites-le nous aussi, nous avons besoin de votre
retour et de vos impressions !
File diff suppressed because it is too large Load Diff
+14 -16
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
@@ -32,21 +32,19 @@ if(ENABLE_MAN)
add_custom_target(doc-man-weechat-it ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/it/man1)
if(ENABLE_HEADLESS)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.it.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.it.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.it.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.it.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (it)"
)
add_custom_target(doc-man-weechat-headless-it ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/it/man1)
endif()
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.it.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.it.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.it.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.it.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (it)"
)
add_custom_target(doc-man-weechat-headless-it ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/it/man1)
endif()
if(ENABLE_DOC)
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#

Some files were not shown because too many files have changed in this diff Show More