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

Compare commits

..

246 Commits

Author SHA1 Message Date
Sébastien Helleu 3e180a3c90 Version 3.2.1 2021-09-04 13:16:44 +02:00
Sébastien Helleu 8b1331f98d relay: fix crash when decoding a malformed websocket frame 2021-09-04 11:39:22 +02:00
Sébastien Helleu 70c09f1f5a Version 3.2 2021-06-13 09:28:25 +02:00
Sébastien Helleu 1adf6927e5 irc: fix translation of SASL errors 2021-06-13 09:16:09 +02:00
Sébastien Helleu de6575dd32 doc: update Polish auto-generated files 2021-06-10 21:28:15 +02:00
Krzysztof Korościk 4b3785ad1e po: updated polish translation 2021-06-10 00:18:03 +02:00
Sébastien Helleu 2a71d79b37 doc: update German auto-generated file 2021-06-07 07:13:54 +02:00
Nils Görs 5775e9cd10 core: update German translations 2021-06-05 23:09:34 +02:00
Sébastien Helleu 7dd3b0016c Version 3.2-rc1 2021-06-04 21:30:54 +02:00
Sébastien Helleu f8872c415b doc: add IRC SASL SCRAM mechanisms in user's guide (issue #1628) 2021-06-01 21:29:55 +02:00
Sébastien Helleu 8c57e8abd3 irc: add comments about parameter sasl_error (issue #1628) 2021-06-01 21:17:13 +02:00
Sébastien Helleu e365e66eeb irc: add support of SASL mechanisms SCRAM-SHA-1, SCRAM-SHA-256 and SCRAM-SHA-512 (closes #1628) 2021-06-01 20:45:11 +02:00
Sébastien Helleu 5cffb7179f api: add function crypto_hmac (issue #1628) 2021-06-01 20:39:04 +02:00
Sébastien Helleu 6ac6cf7293 tests: add test of base64 encode/decode with NUL char in string 2021-06-01 20:39:04 +02:00
Sébastien Helleu 576406888c doc: update German auto-generated files 2021-06-01 20:39:04 +02:00
Nils Görs ae60c3ec66 core: update German translations 2021-05-30 19:06:05 +02:00
Sébastien Helleu 466fed4f5b irc: add ${target} in help of server msg_kick option 2021-05-30 15:22:30 +02:00
Sébastien Helleu b21589944e core, irc, script: fix typos 2021-05-29 14:33:13 +02:00
Sébastien Helleu 4a41625989 irc: add variable "${target}" (target nick) in commands /kick and /kickban 2021-05-29 14:26:30 +02:00
Nils Görs a9b976274e doc: update German documentation 2021-05-28 13:46:02 +02:00
Sébastien Helleu 1181ab454e doc: use secured data in relay examples (user's guide) 2021-05-28 13:37:31 +02:00
Nils Görs c676148a63 core: update German translations 2021-05-28 09:30:29 +02:00
Victorhck f3428d48f3 doc: update Spanish quickstart guide 2021-05-27 20:59:53 +02:00
Sébastien Helleu 557dd8f4a5 core: update translations (issue #1647) 2021-05-27 18:28:52 +02:00
Filip H.F. "FiXato" Slagter d4f3bc596d clarify (max) bar size to be in chars/lines
(max) bar size was described to be in chars, though this only applies to the left/right bars. This change clarifies that top/bottom bars would have their size defined in lines.
2021-05-27 18:14:18 +02:00
Filip H.F. "FiXato" Slagter ddc5d56a65 Typo fix
Zomming -> Zooming
2021-05-26 19:53:11 +02:00
Sébastien Helleu b94907c249 doc: replace freenode-tor by a generic TOR example in user's guide 2021-05-26 10:07:59 +02:00
Sébastien Helleu dfdd5b1c50 core: add signals "cursor_start" and "cursor_end" 2021-05-26 08:53:31 +02:00
Sébastien Helleu 7cc61cdbb3 core: replace freenode by libera in command examples 2021-05-25 18:44:10 +02:00
Sébastien Helleu e5f58b77c1 core, buflist, irc, relay: replace freenode by libera in comments 2021-05-25 13:39:55 +02:00
Sébastien Helleu 18c82fc5c7 tests: replace freenode by libera in tests 2021-05-25 13:38:12 +02:00
Sébastien Helleu f55dcde4ff doc: replace freenode by libera in release notes 2021-05-25 13:37:43 +02:00
Sébastien Helleu a25f0f1928 doc: replace freenode by libera in contributing guide 2021-05-25 13:37:24 +02:00
Sébastien Helleu c20d3778d6 doc: replace freenode by libera in man page 2021-05-25 07:59:21 +02:00
Sébastien Helleu 1a7e49ac3f doc: replace freenode by libera in user's guide 2021-05-25 07:56:07 +02:00
Sébastien Helleu 8bd0df9b70 doc: replace freenode by libera in tester's guide 2021-05-25 07:34:01 +02:00
Sébastien Helleu afaff533c8 doc: replace freenode by libera in scripting guide 2021-05-25 07:27:13 +02:00
Sébastien Helleu 08ab8bef83 doc: replace freenode by libera in replay protocol 2021-05-25 07:22:32 +02:00
Sébastien Helleu 14c5e656f2 doc: replace freenode by libera in plugin API reference 2021-05-25 07:13:44 +02:00
Sébastien Helleu dc46bbf63d doc: replace freenode by libera in FAQ 2021-05-25 07:07:12 +02:00
Sébastien Helleu 0577fd1c99 doc: replace freenode by libera in quickstart guide 2021-05-25 07:02:55 +02:00
Krzysztof Korościk 6915f4e4c0 doc: updated polish translation 2021-05-24 22:52:51 +02:00
Sébastien Helleu f7dd2dbd55 doc: update Polish auto-generated files 2021-05-24 13:00:09 +02:00
Krzysztof Korościk d436ab6b0d po: updated polish translation 2021-05-23 18:25:01 +02:00
Sébastien Helleu 0886b38725 doc: update German auto-generated file 2021-05-23 08:15:33 +02:00
Nils Görs e3f4c4811f core: update German translations 2021-05-22 23:42:16 +02:00
Sébastien Helleu 35b35f6923 core: fix typo 2021-05-22 09:47:30 +02:00
Sébastien Helleu f8419c6aa6 doc: update auto-generated files 2021-05-22 09:17:36 +02:00
Sébastien Helleu 9ac3f887a5 core: add split of commands before evaluation in release notes (issue #1643) 2021-05-22 09:16:32 +02:00
Sébastien Helleu 15b001b011 core: update translations (issue #1643) 2021-05-22 08:58:36 +02:00
Sébastien Helleu d949ebb088 core: split signal command before evaluating it (issue #1643) 2021-05-22 08:52:46 +02:00
Sébastien Helleu b74af1d2da core: split startup command before evaluating it (issue #1643) 2021-05-22 08:51:38 +02:00
Sébastien Helleu e350437c81 irc: split server command before evaluating it (issue #1643) 2021-05-22 08:48:24 +02:00
Sébastien Helleu 4065972000 core: fix tests when NLS is disabled 2021-05-21 13:51:47 +02:00
Giuseppe Bilotta 916f57f31d core: fix build error if ENABLE_NLS is OFF
wee-eval.c calls gettext directly, but gettext is not a function if
ENABLE_NLS is off. Fix by defining a gettext macro (that expands to its
first argument) if NLS support is disabled.
2021-05-21 13:22:05 +02:00
Sébastien Helleu badd231b82 core: add build without NLS in CI 2021-05-21 13:19:16 +02:00
Sébastien Helleu 2f2cf55f74 doc: format script with black 2021-05-20 20:07:36 +02:00
Nils Görs 5d4ee9e471 core: update German translations 2021-05-20 14:19:01 +02:00
Sébastien Helleu d09fe80fd1 core: merge two entries into one about GnuTLS options 2021-05-18 21:34:24 +02:00
Sébastien Helleu 447abad79e core: display old default values for options affected by XDG directories in release notes 2021-05-18 21:30:34 +02:00
Sébastien Helleu b43958ac92 irc: use constant GNUTLS_TLS1_3 only with GnuTLS >= 3.6.3
This constant was introduced in GnuTLS 3.6.3.

This fixes a build error on these old distributions:

- Debian Stretch
- Debian Jessie
- Ubuntu Bionic
- Ubuntu Xenial
2021-05-17 12:59:41 +02:00
Sébastien Helleu a071ee5012 tests: remove dependency on French locale in eval tests 2021-05-16 20:17:07 +02:00
Sébastien Helleu cf7ac76de9 tests: add missing include of locale.h in eval tests 2021-05-16 19:09:18 +02:00
Sébastien Helleu 215f12d859 tests: remove commented includes 2021-05-16 19:08:35 +02:00
Nils Görs 59d1811987 core: update German translations 2021-05-16 16:29:54 +02:00
Sébastien Helleu 89e43eaf40 core: set server name when connecting to server with TLS (SNI extension) only if it's not an IPV4/IPv6 (closes #1635) 2021-05-16 14:52:11 +02:00
Sébastien Helleu e03642e9df tests: add tests on translation in evaluated expressions 2021-05-16 14:09:07 +02:00
Sébastien Helleu 58c66474ce core: add contributor (issue #1609) 2021-05-16 13:50:19 +02:00
Emir Sarı 431b799b01 core: update Turkish translations (issue #1609) 2021-05-16 13:39:44 +02:00
Sébastien Helleu 4c25151f31 core: move build option CA_FILE in build section 2021-05-16 10:11:23 +02:00
Sébastien Helleu dd916d5e52 doc: update auto-generated files 2021-05-16 10:08:04 +02:00
Sébastien Helleu d18680e442 core: update ChangeLog (issue #1622) 2021-05-16 10:01:17 +02:00
Sébastien Helleu 92410e9949 irc: sort config options alphabetically (issue #1622) 2021-05-16 10:01:14 +02:00
Sébastien Helleu e6a3d08704 buflist, irc, xfer: do not translate "cleartext" in buffer local variable "tls_version" (issue #1622)
The text "cleartext" is translated for display only: directly with gettext in
IRC plugin and with "${translate:${tls_version}}" in the buflist evaluated
format.
2021-05-16 10:01:07 +02:00
Sébastien Helleu 5bce484c01 api: add translated string in evaluation of expressions with "translate:xxx" (issue #1622) 2021-05-16 10:01:03 +02:00
Sébastien Helleu 7e10038f4b core: update translations (issue #1622) 2021-05-16 10:00:57 +02:00
Andrew Potter 94c902adfc irc, buflist: add bar item "tls_version" with options for colors, add buflist format "${format_tls_version}" (issue #1622) 2021-05-16 10:00:30 +02:00
Nils Görs 670c5cd745 core: update German translations 2021-05-15 23:45:36 +02:00
Sébastien Helleu a7db77e253 core: remove obsolete translations 2021-05-15 16:53:14 +02:00
Sébastien Helleu 3102eccda2 core: fix French translation of /help fifo 2021-05-15 16:52:43 +02:00
Sébastien Helleu b714d3dc91 core: fix punctuation in German translation 2021-05-15 14:40:01 +02:00
Nils Görs 0d8aeee738 core: update German translations 2021-05-15 13:58:01 +02:00
Sébastien Helleu 9d96d5d450 doc: add missing names for anchors in scripting guide 2021-05-14 19:19:49 +02:00
Sébastien Helleu 168dbaf020 doc: add link to Python stub in scripting guide (issue #1377) 2021-05-14 19:19:45 +02:00
Sébastien Helleu 13cb870b9a core: add generator and Python stub file for WeeChat API (issue #1377) 2021-05-14 19:19:45 +02:00
Sébastien Helleu a5903e8020 doc: add type annotations in Python prototype (scripting guide) (issue #1377) 2021-05-13 20:24:59 +02:00
Sébastien Helleu fafe2c9d2e doc: add type annotations in Python prototypes (plugin API reference) (issue #1377) 2021-05-13 20:24:59 +02:00
Sébastien Helleu 3e122ed900 doc: add types of constants in scripting guide (issue #1377) 2021-05-13 15:47:21 +02:00
Sébastien Helleu 33767b22f3 doc: fix translations in Italian and Japanese plugin API reference 2021-05-13 09:57:50 +02:00
Sébastien Helleu 11b311ce2f core: add GnuTLS CA changes in release notes 2021-05-12 21:00:21 +02:00
Sébastien Helleu bbdeb51bc1 doc: add missing French translations in user's guide 2021-05-12 20:44:07 +02:00
Sébastien Helleu c588ee21bc core: improve options to load GnuTLS system/user CAs (closes #972)
Changes:

* new option: weechat.network.gnutls_ca_system
* option weechat.network.gnutls_ca_file renamed to
  weechat.network.gnutls_ca_user
* reload certificates when options are changed
* remove build option CA_FILE
2021-05-12 20:39:40 +02:00
Sébastien Helleu b7112e4090 core: add slack.py version in release notes 2021-05-11 22:41:13 +02:00
Sébastien Helleu be575e5400 core: update translations (issue #1285) 2021-05-11 21:39:46 +02:00
Sébastien Helleu 7f8f5f94e3 core: update ChangeLog (issue #1285) 2021-05-11 21:07:43 +02:00
Sébastien Helleu 6e528a1d62 core: add XDG directories in release notes (issue #1285) 2021-05-11 21:07:41 +02:00
Sébastien Helleu a9e210121b fifo: add PID in default FIFO pipe filename (issue #1285)
This is to prevent two WeeChat using the same runtime directory to use the same
FIFO pipe.
2021-05-11 21:07:39 +02:00
Sébastien Helleu 6925ea3ccb doc: add missing names for anchors in user's guide (issue #1285) 2021-05-11 21:07:36 +02:00
Sébastien Helleu 70cdf21681 doc: add XDG directories support in docs (issue #1285) 2021-05-11 21:07:30 +02:00
Sébastien Helleu 87d4ea9286 doc: remove tag "translation missing" in French user's guide (issue #1285) 2021-05-11 21:07:28 +02:00
Sébastien Helleu d9f5bce6ee doc: add file wee-dir.c in developer's guide (issue #1285) 2021-05-11 21:07:26 +02:00
Sébastien Helleu f71b4f78fd doc: add link to CMake option in environment variable WEECHAT_HOME (user's guide) (issue #1285) 2021-05-11 21:07:24 +02:00
Sébastien Helleu a3f8647a72 doc: change default value of WEECHAT_HOME CMake option to empty string (user's guide) (issue #1285) 2021-05-11 21:07:21 +02:00
Sébastien Helleu 664fb12db7 doc: remove wrong default value of option weechat.network.gnutls_ca_file (user's guide) (issue #1285) 2021-05-11 21:07:19 +02:00
Sébastien Helleu cb4c3b0226 doc: use XDG config directory in Relay SSL chapter (user's guide) (issue #1285) 2021-05-11 21:07:17 +02:00
Sébastien Helleu 7d75d82f6a doc: use XDG config directory in chapter on IRC server certificate (user's guide) (issue #1285) 2021-05-11 21:07:15 +02:00
Sébastien Helleu 49844a71f0 doc: use XDG config directory in SASL ECDSA-NIST256P-CHALLENGE chapter (user's guide) (issue #1285) 2021-05-11 21:07:11 +02:00
Sébastien Helleu 5210d501d4 doc: replace "%h" by "${weechat_config_dir}" in examples of values for IRC server option "ssl_cert" (user's guide) (issue #1285) 2021-05-11 21:07:09 +02:00
Sébastien Helleu 3833b965e4 doc: replace "%h" by "${weechat_config_dir}" in examples of values for IRC server option "sasl_key" (user's guide) (issue #1285) 2021-05-11 21:07:07 +02:00
Sébastien Helleu 703106a31f core: mention evaluation with string_eval_path_home for CMake/autotools option CA_FILE (issue #1285) 2021-05-11 21:07:04 +02:00
Sébastien Helleu 43ba8d3b73 xfer: remove "%h" from /help xfer.file.upload_path (issue #1285) 2021-05-11 21:07:02 +02:00
Sébastien Helleu 6170f97cd6 xfer: change default value of option xfer.file.download_path to "${weechat_data_dir}/xfer" (issue #1285) 2021-05-11 21:07:00 +02:00
Sébastien Helleu 19bf10647c script: change default value of option script.scripts.path to "${weechat_cache_dir}/script" (issue #1285) 2021-05-11 21:06:58 +02:00
Sébastien Helleu 4459119409 relay: change default value of option relay.network.ssl_cert_key to "${weechat_config_dir}/ssl/relay.pem" (issue #1285) 2021-05-11 21:06:56 +02:00
Sébastien Helleu 047a668275 relay: remove "%h" from help on UNIX socket path option (issue #1285) 2021-05-11 21:06:54 +02:00
Sébastien Helleu 36847bd305 relay: remove "%h" from /help relay (issue #1285) 2021-05-11 21:06:51 +02:00
Sébastien Helleu 005ef8a4a9 logger: change default value of option logger.file.path to "${weechat_data_dir}/logs" (issue #1285) 2021-05-11 21:06:49 +02:00
Sébastien Helleu 7e79145d46 fifo: change default value of option fifo.file.path to "${weechat_runtime_dir}/weechat_fifo" (issue #1285) 2021-05-11 21:06:46 +02:00
Sébastien Helleu d2c5bba356 core: change default value of option weechat.plugin.path to "${weechat_data_dir}/plugins" (issue #1285) 2021-05-11 21:06:42 +02:00
Sébastien Helleu 0f9640a5f3 core: split WeeChat home in 4 directories, use XDG directories by default (issue #1285)
The 4 directories (which can be the same):

- config: configuration files, certificates
- data: log/upgrade files, local plugins, scripts, xfer files
- cache: script repository, scripts downloaded (temporary location)
- runtime: FIFO pipe, relay UNIX sockets
2021-05-11 21:06:34 +02:00
Sébastien Helleu 4c5fcb743b core: move home directory functions from weechat.c to wee-dir.c (issue #1285) 2021-05-11 21:06:32 +02:00
Sébastien Helleu 269576eea2 core: move directory/file functions from wee-util.c to wee-dir.c (issue #1285) 2021-05-11 21:06:29 +02:00
Sébastien Helleu 9eecad496d logger: remove unused variable weechat_dir (issue #1285) 2021-05-11 21:06:27 +02:00
Sébastien Helleu 5361722699 core: set WeeChat home to empty string by default in CMake and autotools (issue #1285) 2021-05-11 21:06:24 +02:00
Sébastien Helleu e07221d7c5 relay: evaluate option relay.network.ssl_cert_key (issue #1285) 2021-05-11 21:06:22 +02:00
Sébastien Helleu 39b629550b irc: evaluate options irc.server_default.ssl_cert and irc.server.xxx.ssl_cert (issue #1285) 2021-05-11 21:06:19 +02:00
Sébastien Helleu d7d594873b irc: evaluate options irc.server_default.sasl_key and irc.server.xxx.sasl_key (issue #1285) 2021-05-11 21:06:17 +02:00
Sébastien Helleu f923524a21 core: evaluate option weechat.plugin.path (issue #1285) 2021-05-11 21:06:13 +02:00
Sébastien Helleu e5d18e1221 core: evaluate option weechat.network.gnutls_ca_file (issue #1285) 2021-05-11 21:05:42 +02:00
Sébastien Helleu 9e7d052517 core: update ChangeLog (issue #1636) 2021-05-08 07:33:17 +02:00
Sébastien Helleu f3f3c54372 core: add detection of function mallinfo2 in autotools (issue #1636) 2021-05-08 07:33:12 +02:00
Andrew Potter b222e75019 core: Use mallinfo2() when available
mallinfo() is deprecated in glibc 2.33
2021-05-08 07:25:44 +02:00
Sébastien Helleu aa7860c942 doc: update German auto-generated file 2021-05-05 13:59:04 +02:00
Sébastien Helleu ed560a785a doc: fix list of supported OS in FAQ 2021-05-05 13:57:11 +02:00
Sébastien Helleu e95fdc3a0a core: display a warning when the file with certificate authorities is not found (option weechat.network.gnutls_ca_file) 2021-05-04 20:37:15 +02:00
Sébastien Helleu 9f0e7fb47e xfer: make file transfer fail when option xfer.file.auto_rename is off and file already exists (closes #1633) 2021-04-26 20:51:17 +02:00
Nils Görs bcd889cf90 doc: update German documentation 2021-04-21 07:53:47 +02:00
Sébastien Helleu 65ea67204c doc: translate changes in chapter on bar conditions (user's guide) 2021-04-18 12:08:11 +02:00
Tobias Rehbein 2c674a54d4 doc: Update weechat.bar.*.condition to use info:term_width
In cf93e953b the `weechat.bar.*.condition` examples have been changed to use
`${info:term_width}` instead of `${window.win_width}`. The user guide still
shows the old example. This commit syncs the user guide with the on-line help.
2021-04-18 12:00:29 +02:00
Nils Görs 2fbedfec1a doc: update German documentation 2021-04-18 09:58:09 +02:00
Sébastien Helleu 1181ac069e doc: add link to Archlinux wiki page about core dump files (user's guide) 2021-04-17 14:21:50 +02:00
Nils Görs 950c2bb898 core: update German translations 2021-04-13 11:44:40 +02:00
Sébastien Helleu 6b62456119 Revert "core: add option "-save" in command /upgrade (closes #1630)"
This reverts commit 1df1903d23.

This is not so easy to implement: it requires saving state of plugins, and
plugins like irc can not save the connected state (except in a real upgrade
case where the sockets are still valid after exec of the new binary).
2021-04-13 00:11:11 +02:00
Sébastien Helleu 1df1903d23 core: add option "-save" in command /upgrade (closes #1630) 2021-04-12 20:48:32 +02:00
Sébastien Helleu ae39b7ce61 tests: fix if/else blocks in trigger tests 2021-04-11 10:42:24 +02:00
Sébastien Helleu 044bcd0751 doc: improve display of WeeChat version in info_hashtable "irc_message_parse" (scripting guide) 2021-04-11 09:47:13 +02:00
Sébastien Helleu 5d30e0faac doc: mark info "python2_bin" as deprecated since version 2.6 (plugin API reference) 2021-04-11 09:31:49 +02:00
Sébastien Helleu e58c827c91 trigger: add tests on main trigger functions 2021-04-11 09:20:49 +02:00
Sébastien Helleu 1f0636bab6 irc: remove unused variable ptr_address and dead code 2021-04-10 14:11:11 +02:00
Sébastien Helleu 7bd23700de irc: remove dead assignment on variable pos_message 2021-04-10 13:26:46 +02:00
Sébastien Helleu 937ecb62c4 trigger: remove useless test 2021-04-10 12:21:16 +02:00
Sébastien Helleu 2e67b13edd trigger: check that option is not NULL in function trigger_search_with_option 2021-04-09 21:36:12 +02:00
Sébastien Helleu 7c5cbefd51 trigger: fix description of function trigger_name_valid 2021-04-08 20:56:37 +02:00
Sébastien Helleu b6b78df3d2 trigger: check that trigger is not NULL in functions trigger_rename and trigger_copy 2021-04-08 20:55:37 +02:00
Nils Görs 4da5647e9f doc: update German documentation 2021-04-07 12:38:35 +02:00
Sébastien Helleu fae9bdf8f8 trigger: add variables "${tg_shell_argc}" and "${tg_shell_argvN}" in command trigger evaluated strings (closes #1624) 2021-04-06 18:37:22 +02:00
Sébastien Helleu 3bf585ba04 core: evaluate left/right part of comparison after split on the comparison operator in ${if:xxx} (closes #1627)
To force evaluation of the expression before doing the comparison (less safe),
the "${eval_cond:xxx}" can be used.

With the old behavior we had:

    >> ${if:a==b}
    == [0]
    >> ${if:${raw:a==b}}
    == [0]
    >> ${if:${eval_cond:${raw:a==b}}}
    == [0]

And with the new behavior, we have:

    >> ${if:a==b}
    == [0]
    >> ${if:${raw:a==b}}
    == [1]
    >> ${if:${eval_cond:${raw:a==b}}}
    == [0]
2021-04-04 14:44:18 +02:00
Sébastien Helleu 1aefb0a546 doc: update German auto-generated file 2021-03-29 22:32:56 +02:00
Nils Görs efd5a8bd14 core: update German translations 2021-03-29 09:22:07 +02:00
Sébastien Helleu 4f606ceb64 buflist: improve help on option buflist.look.sort 2021-03-21 09:34:40 +01:00
Sébastien Helleu 027966e5e9 core: update ChangeLog (issue #1621) 2021-03-21 09:01:08 +01:00
Trygve Aaberge 6b23d855d8 buflist: Fix wrong pointers being used in hdata_compare
This used pointer1 and pointer2 which are pointers to the buffers, but
it should use ptr_hotlist1 and ptr_hotlist1 which are pointers to the
hotlists it is trying to compare.
2021-03-21 08:59:37 +01:00
Sébastien Helleu e8a58a27cd core: update ChangeLog (issue #1591, issue #1592) 2021-03-20 13:08:35 +01:00
Trygve Aaberge 472eab38e5 core: Prevent switching to start of visited buffers when jumping to next
If you run /input jump_next_visited_buffer right after switching to a
buffer, weechat changes to the first buffer in the visited buffers list.
That is, it wraps around and goes to the buffer you visited the longest
ago. This patch fixes that.

The reason it happens is that when you switch to a buffer (normally,
i.e. in another way than using jump_previously_visited_buffer/
jump_next_visited_buffer) gui_buffers_visited_index is set to -1 (in
gui_buffer_visited_add). This makes gui_buffer_visited_get_index_next
return 0 because it returns gui_buffers_visited_index + 1, which makes
gui_input_jump_next_visited_buffer jump to the first buffer in the list
of visited buffers.

Fixes #1591
2021-03-20 13:07:20 +01:00
Sébastien Helleu aa4beb99e8 doc: update German auto-generated file 2021-03-20 09:20:51 +01:00
Nils Görs 741c1b4e87 doc: update German documentation 2021-03-20 07:52:35 +01:00
Nils Görs a715403d60 core: update German translations 2021-03-20 06:36:19 +01:00
Sébastien Helleu 40ab0bb11e core: update ChangeLog 2021-03-19 23:27:00 +01:00
Sébastien Helleu 3b76a8dd82 core: add repository ppa:ondrej/php in CI 2021-03-19 07:12:23 +01:00
Sébastien Helleu bcddb06094 core: do not force build of JavaScript plugin in CI 2021-03-19 09:14:59 +01:00
Sébastien Helleu 611ea27edc tests: disable pylint error useless-object-inheritance 2021-03-19 09:14:59 +01:00
Sébastien Helleu bacd50c7a7 core: replace pylint3 by pylint in CI on Ubuntu 20.04 2021-03-19 09:14:59 +01:00
Sébastien Helleu da91ddef98 core: first remove package php7.4-common in CI on Ubuntu 20.04
See: https://github.com/actions/virtual-environments/issues/2859
2021-03-19 09:14:59 +01:00
Sébastien Helleu 692d313fe3 core: switch from Ubuntu 18.04 to 20.04 in CI 2021-03-19 09:14:59 +01:00
Sébastien Helleu 4d96a3a84d core: add pointer name in description of function eval_replace_vars_cb 2021-03-18 07:35:12 +01:00
Sébastien Helleu 0d5b7ae9d0 doc: update German auto-generated files 2021-03-17 21:58:18 +01:00
Sébastien Helleu 8ee7d46605 api: add support of pointer names in function string_eval_expression (direct and in hdata)
These two formats are now supported, if "pointer_name" is present in the
"pointers" hashtable:

* "${pointer_name}": value of pointer (example: "0x1234abcd")
* ${buffer[pointer_name].full_name}: use of a pointer name instead of pointer
  value or list name
2021-03-17 21:57:16 +01:00
Sébastien Helleu c54cadace5 tests: use macros UINT32_C and UINT64_C for integer constants of type uint32_t and uint64_t
This fixes the following compiler warnings: "integer constant is so large that
it is unsigned".
2021-03-17 21:56:43 +01:00
Nils Görs 84d9de798a core: update German translations 2021-03-17 14:16:16 +01:00
Sébastien Helleu e4ff17e162 doc: add section "plugin" in weechat.conf (user's guide) 2021-03-16 19:03:45 +01:00
Sébastien Helleu 0dc7fbcb0c core: add options to customize commands on system signals, quit by default on SIGHUP when not running headless (closes #1595)
New options to customize behavior on signals received, with the default
behavior:

- weechat.signal.sighup: quit in normal mode, reload config in headless
- weechat.signal.sigquit: quit
- weechat.signal.sigterm: quit
- weechat.signal.sigusr1: no command executed by default
- weechat.signal.sigusr2: no command executed by default

The signals SIGUSR1 and SIGUSR2 are introduced by this commit, so it's now
possible to run commands when they are received.

The SIGHUP signal makes now WeeChat quit, it was the behavior before version
2.9 of WeeChat (see commit de1e61f7cd).
2021-03-16 18:47:31 +01:00
Sébastien Helleu bb41de8c02 api: add info "weechat_daemon" 2021-03-14 14:11:06 +01:00
Sébastien Helleu a02a2fbaae doc: use full path /usr/bin/pass in example for option sec.crypt.passphrase_command 2021-03-14 13:38:50 +01:00
Sébastien Helleu e37f2569f9 core: mention /fset command in header comment of configuration files 2021-03-14 11:36:07 +01:00
Sébastien Helleu ab282db3a6 core: update ChangeLog (closes #1618) 2021-03-14 10:56:51 +01:00
Sébastien Helleu 8c793fe7cc fset: add fset bar on configuration reload (issue #1618) 2021-03-14 10:56:24 +01:00
Sébastien Helleu 35b5adbc4c buflist: always add buflist bar when plugin is loaded, hide bar by default if buflist is disabled (issue #1618) 2021-03-14 10:55:48 +01:00
Sébastien Helleu a4440ba8e5 buflist: add buflist bar on configuration reload (issue #1618) 2021-03-14 10:55:24 +01:00
Nils Görs 3bdae5b464 doc: update German documentation 2021-03-13 23:56:16 +01:00
Sébastien Helleu d2c56084f8 doc: add upgrade chapter in user's guide 2021-03-13 15:17:01 +01:00
Sébastien Helleu 5311c103d5 debian: update debian/ubuntu patches with new Standards-Version 2021-03-08 20:48:06 +01:00
Sébastien Helleu 39bd4e2099 debian: fix watch according to download page changes 2021-03-08 20:38:25 +01:00
Sébastien Helleu 35ca5cde9c debian: bump Standards-Version to 4.5.1 2021-03-08 20:37:43 +01:00
Sébastien Helleu c49255a851 core: add missing include of sys/time.h in C headers 2021-03-07 13:21:24 +01:00
Sébastien Helleu 2b1c2d6d05 Version 3.2-dev 2021-03-07 12:11:55 +01:00
Sébastien Helleu ae2f25109c Version 3.1 2021-03-07 11:54:55 +01:00
Sébastien Helleu 7dd7da1d7b core: reorder release notes for version 3.1 2021-03-07 09:45:06 +01:00
Sébastien Helleu 3983e9fa1e core: fix compilation of tests on FreeBSD 2021-03-07 09:33:06 +01:00
Sébastien Helleu 4307733853 debian: update changelog 2021-03-07 08:57:53 +01:00
Sébastien Helleu 4014c1140a doc: update Polish auto-generated files 2021-03-06 19:02:53 +01:00
Krzysztof Korościk 65a732449e doc: updated polish user guide 2021-03-06 18:49:12 +01:00
Krzysztof Korościk 4fd3c5e1d6 po: updated polish translation 2021-03-06 18:10:42 +01:00
Sébastien Helleu e9c8b8bf0f core: add contributor in AUTHORS.adoc (issue #1615) 2021-03-05 21:00:17 +01:00
Sébastien Helleu ca4d7b37c6 core: fix pt_BR translations 2021-03-05 20:51:43 +01:00
Érico Rolim 23a3096e1d core: update pt_BR translations. 2021-03-05 20:50:50 +01:00
Sébastien Helleu c17aeeba29 core: force Ubuntu 18.04 for CI 2021-03-05 20:45:31 +01:00
Sébastien Helleu c3cc06ff27 core: fix quoted line in cursor mode (closes #1602)
Regression was introduced in version 2.7 by commit
93d2dbf3e1.
2021-02-28 17:13:52 +01:00
Sébastien Helleu 3ca58c2fd9 Version 3.1-rc1 2021-02-28 12:06:49 +01:00
Sébastien Helleu 1862f4b3d2 core: add missing "xxx" in format of evaluated expressions (ChangeLog) 2021-02-28 12:03:47 +01:00
Nils Görs f06d434a0c Merge branch 'master' of https://github.com/weechat/weechat 2021-02-27 13:58:11 +01:00
Nils Görs 00d6183cd8 doc: update German documentation 2021-02-27 13:57:49 +01:00
Sébastien Helleu ceaf480ba7 core: fix paragraph in release notes 2021-02-27 13:49:55 +01:00
Sébastien Helleu 0f71b4ccc8 irc: add bar item "irc_nick_prefix" 2021-02-27 13:44:24 +01:00
Sébastien Helleu a811da3a42 doc: add missing available bar items (user's guide) 2021-02-27 12:56:09 +01:00
Sébastien Helleu 83379469aa irc: fix separator between nick and host in bar item "irc_nick_host"
Use "!" instead of "@" to separate nick from host, like it is done in IRC
protocol.

The nick and host is now displayed as "nick!user@host" instead of
"nick@user@host".
2021-02-27 09:02:09 +01:00
Sébastien Helleu 6a7da6d473 fset: fix description of function fset_bar_item_fset_cb 2021-02-27 08:57:32 +01:00
Sébastien Helleu 7b15742a11 doc: fix example of value for bar item "irc_nick_modes" (user's guide) 2021-02-26 18:45:21 +01:00
Sébastien Helleu 5339e6aa17 doc: update German auto-generated file 2021-02-26 18:41:14 +01:00
Nils Görs 2a31544242 core: update German translations 2021-02-26 14:02:42 +01:00
Sébastien Helleu 3d587ad37d core: add info_hashtable "secured_data" 2021-02-25 19:06:47 +01:00
Sébastien Helleu 5725c8561c doc: remove references to Savannah in developer's guide 2021-02-20 11:12:14 +01:00
Sébastien Helleu 49ac7dd9f5 doc: split dependencies in two tables: required and optional (user's guide) 2021-02-19 20:12:18 +01:00
Sébastien Helleu d10e8342d3 core: convert "totp" to upper case in ChangeLog 2021-02-16 07:47:42 +01:00
Sébastien Helleu 1a86036edb doc: update German auto-generated file 2021-02-11 07:16:11 +01:00
Sébastien Helleu ab47c1abf7 core: move line from "New features" to "Bug fixes" (issue #1612) 2021-02-11 07:12:55 +01:00
Nils Görs 69af1ac0ae core: update German translations 2021-02-10 08:10:06 +01:00
Sébastien Helleu b6a935b1c3 core: move line to appropriate version in ChangeLog 2021-02-10 07:56:43 +01:00
Sébastien Helleu 45c372ebc8 core: move line from "New features" to "Bug fixes" (issue #1613) 2021-02-09 20:42:58 +01:00
Sébastien Helleu 840551dcfa doc: update German auto-generated files 2021-02-09 20:37:35 +01:00
Sébastien Helleu 630fe0581f buflist: add option buflist.look.use_items to speed up display of buflist (closes #1613) 2021-02-09 20:34:56 +01:00
Sébastien Helleu d74f2e3183 core: add fixed behavior of command /window splitv in release notes 2021-02-09 20:19:22 +01:00
Sébastien Helleu 00409cba6a core: fix wrong size of the new window after vertical split (closes #1612) 2021-02-08 18:47:44 +01:00
Nils Görs 8a6a135b45 core: update German translations 2021-02-08 13:41:59 +01:00
Sébastien Helleu 47112a113e core: update help on option sec.crypt.passphrase_command, update translations 2021-02-08 13:12:54 +01:00
Sébastien Helleu d08e9aed1c core: update translations 2021-02-07 11:00:12 +01:00
Sébastien Helleu 1c3c8c92c7 core: update ChangeLog (closes #992, closes #993) 2021-02-07 09:52:15 +01:00
Kevin Pulo df12f8de34 core: add options weechat.look.hotlist_update_on_buffer_switch and weechat.look.read_marker_update_on_buffer_switch
Both default to "on" (no change to previous behavior).

If hotlist_update_on_buffer_switch is "off", then when switching away from a
buffer, the hotlist is not cleared.

If read_marker_update_on_buffer_switch is "off", then when switching away from
a buffer, the read marker is not set to the end of the buffer.

This allows users to choose to have fully manual control over when hotlist
counts and buffer read markers are reset.

Fixes #992.
2021-02-07 09:48:19 +01:00
Sébastien Helleu 84d4be1bee core: update ChangeLog (remove option sec.crypt.passphrase_file) 2021-02-06 16:20:11 +01:00
Sébastien Helleu f1c681c832 core: replace option sec.crypt.passphrase_file by sec.crypt.passphrase_command (closes #141)
The command is used to read the passphrase on startup, for example using your
favorite password manager.

Note: only the passphrase is read from the program, the secured data is still
stored encrypted in sec.conf and handled by WeeChat itself.
2021-02-06 16:07:14 +01:00
Sébastien Helleu fe9ec8fbda doc: update German auto-generated files 2021-02-05 20:08:18 +01:00
Sébastien Helleu a93e598c35 core: add raw string in evaluation of expressions with "raw:xxx" (closes #1611) 2021-02-05 20:07:16 +01:00
Nils Görs 64fe602aae core: update German translations 2021-02-05 10:56:49 +01:00
Sébastien Helleu a34959a619 irc: add info "irc_is_message_ignored" 2021-02-03 18:30:32 +01:00
Sébastien Helleu 42a86f0a36 core: add version 3.0.1 in ChangeLog, release notes and weechat.spec 2021-01-31 10:38:57 +01:00
Nils Görs a250a50ca5 core: update German translations 2021-01-31 10:32:26 +01:00
Nils Görs 8bdc58f32d core: update German translations 2021-01-31 09:32:26 +01:00
239 changed files with 22219 additions and 13278 deletions
+13 -8
View File
@@ -1,18 +1,21 @@
name: CI
on: [push, pull_request]
on:
- push
- pull_request
jobs:
build:
name: ${{ matrix.config.name }}
runs-on: ubuntu-latest
runs-on: ubuntu-20.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: "" }
@@ -25,9 +28,10 @@ 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 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
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
- name: Test patches
run: ./tools/build-debian.sh test-patches
@@ -37,10 +41,11 @@ jobs:
- name: Check Python scripts
run: |
pylint3 --additional-builtins=_ doc/docgen.py
pylint3 tests/scripts/python/testapigen.py
pylint3 tests/scripts/python/testapi.py
pylint3 tests/scripts/python/unparse.py
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
- name: Build and run tests
env:
+2
View File
@@ -43,7 +43,9 @@ Alphabetically:
* Elizabeth Myers (Elizacat)
* Elián Hanisch (m4v)
* Emanuele Giaquinta
* Emir Sarı
* emk
* Érico Nogueira
* Esteban I. Ruiz Moreno (Exio)
* Evgeny Shmarnev
* Felix Eckhofer
+2 -13
View File
@@ -134,23 +134,11 @@ 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 "WeeChat home directory for config, logs, scripts.. (default is \"~/.weechat\")"
STRING "Force a single WeeChat home directory for config, logs, scripts, etc."
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)
@@ -170,6 +158,7 @@ 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)
+88 -10
View File
@@ -15,32 +15,110 @@ https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes]
(file _ReleaseNotes.adoc_ in sources).
[[v3.1]]
== Version 3.1 (under dev)
[[v3.2.1]]
== Version 3.2.1 (2021-09-04)
Bug fixes::
* relay: fix crash when decoding a malformed websocket frame
[[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"
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 evaluation of conditions in evaluation of expressions with "eval_cond:" (issue #1582)
* 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
* exec: fix search of command by identifier
* 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
* spell: fix crash with IRC color codes in command line (issue #1589)
* spell: fix refresh of bar item "spell_suggest" when the input becomes empty (issue #1586)
Documentation::
* do not build weechat-headless man page if headless binary is disabled (issue #1607)
[[v3.0.1]]
== Version 3.0.1 (2021-01-31)
Bug fixes::
* exec: fix search of command by identifier
* spell: fix refresh of bar item "spell_suggest" when the input becomes empty (issue #1586)
* spell: fix crash with IRC color codes in command line (issue #1589)
[[v3.0]]
== Version 3.0 (2020-11-11)
@@ -177,7 +255,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::
@@ -228,7 +306,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:"
* core: add reverse of string for screen in evaluation of expressions with "revscr:xxx"
* 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"
@@ -463,7 +541,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:" (issue #1200)
* core: add reverse of string in evaluation of expressions with "rev:xxx" (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)
@@ -658,7 +736,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:" (number of chars) and "cutscr:" (number of chars displayed on screen)
* 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 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: _chat.freenode.net_, channel _#weechat_).
(server: _irc.libera.chat_, 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]
+227 -8
View File
@@ -17,8 +17,209 @@ https://weechat.org/files/changelog/ChangeLog-devel.html[ChangeLog]
(file _ChangeLog.adoc_ in sources).
[[v3.2.1]]
== Version 3.2.1 (2021-09-04)
Bug fix and maintenance release.
[[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 (under dev)
== 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
@@ -32,6 +233,24 @@ 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)
Bug fix and maintenance release.
[[v3.0]]
== Version 3.0 (2020-11-11)
@@ -148,7 +367,7 @@ using this modifier and the "modifier_data" argument must be updated.
The old format contained plugin name + ";" + buffer name + ";" + tags:
----
irc;freenode.#weechat;tag1,tag2,tag3
irc;libera.#weechat;tag1,tag2,tag3
----
The new format contains buffer pointer + ";" + tags:
@@ -160,7 +379,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.html/[colorize_lines.pl] 3.9
* https://weechat.org/scripts/source/colorize_lines.pl/[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
@@ -224,8 +443,8 @@ For example you can do that:
----
/secure passphrase my_secret_passphrase
/secure set freenode my_password
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
/secure set libera my_password
/set irc.server.libera.sasl_password "${sec.data.libera}"
----
This will be displayed like that in WeeChat, using the new regex value of
@@ -233,8 +452,8 @@ _cmd_pass_ trigger:
----
/secure passphrase ********************
/secure set freenode ***********
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
/secure set libera ***********
/set irc.server.libera.sasl_password "${sec.data.libera}"
----
If you want to use the new trigger regex after upgrade, you can do:
@@ -1046,7 +1265,7 @@ Globally (default value for all servers):
For a specific server:
----
/set irc.server.freenode.nicks_alternate off
/set irc.server.libera.nicks_alternate off
----
[[v1.3]]
-1
View File
@@ -33,7 +33,6 @@ endif()
set(V8_INC_PATHS
/usr/include
/usr/include/v8
${CMAKE_INCLUDE_PATH}
)
find_path(V8_INCLUDE_DIR v8.h PATHS ${V8_INC_PATHS})
+1 -1
View File
@@ -5,6 +5,7 @@
#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
@@ -17,5 +18,4 @@
#define WEECHAT_SHAREDIR "@WEECHAT_SHAREDIR@"
#define LOCALEDIR "@LOCALEDIR@"
#define WEECHAT_HOME "@WEECHAT_HOME@"
#define CA_FILE "@CA_FILE@"
#define _GNU_SOURCE 1
+7 -15
View File
@@ -98,6 +98,7 @@ 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
@@ -133,8 +134,7 @@ 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 "~/.weechat"])
AH_VERBATIM([CA_FILE], [#define CA_FILE "/etc/ssl/certs/ca-certificates.crt"])
AH_VERBATIM([WEECHAT_HOME], [#define WEECHAT_HOME ""])
# Arguments for ./configure
@@ -171,19 +171,10 @@ 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, [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".])
AC_ARG_VAR(WEECHAT_HOME, [Force a single WeeChat home directory for config, logs, scripts, etc.])
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=""
@@ -1547,7 +1538,6 @@ 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 ""
@@ -1561,8 +1551,10 @@ if test "x$not_asked" != "x" || test "x$not_found" != "x"; then
fi
echo ""
echo "WeeChat home directory is ${WEECHAT_HOME}"
echo ""
if test "x$WEECHAT_HOME" != "x" ; then
echo "WeeChat home directory is forced by default to: ${WEECHAT_HOME}"
echo ""
fi
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.4.0
Standards-Version: 4.5.1
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,3 +1,17 @@
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.4.0
Standards-Version: 4.5.1
Homepage: https://weechat.org/
Vcs-Git: https://salsa.debian.org/kolter/weechat.git
Vcs-Browser: https://salsa.debian.org/kolter/weechat
+2 -2
View File
@@ -1,2 +1,2 @@
version=3
opts=pgpsigurlmangle=s/$/.asc/ https://weechat.org/files/src/weechat-(\d.*)\.tar\.bz2
version=4
opts=pgpsigurlmangle=s/$/.asc/ https://weechat.org/download/ /files/src/weechat-(\d.*)\.tar\.xz
+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>_::
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)
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).
Pokud tato volba není zadána, použije se promněná prostředí WEECHAT_HOME
(pokud není prázdná)
+26 -26
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@chat.freenode.net/#weechat
irc://mynick@irc.libera.chat/#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/.weechat/weechat.conf::
$HOME/.config/weechat/weechat.conf::
hlavní konfigurační soubor WeeChatu
$HOME/.weechat/plugins.conf::
$HOME/.config/weechat/plugins.conf::
soubor konfigurace pluginů
$HOME/.weechat/sec.conf::
$HOME/.config/weechat/sec.conf::
konfigurační soubor s chráněnými daty
$HOME/.weechat/alias.conf::
$HOME/.config/weechat/alias.conf::
configurační soubor pro _alias_ plugin
$HOME/.weechat/buflist.conf::
$HOME/.config/weechat/buflist.conf::
konfigurační soubor pro _buflist_ plugin
$HOME/.weechat/charset.conf::
$HOME/.config/weechat/charset.conf::
konfigurační soubor pro _charset_ plugin
$HOME/.weechat/exec.conf::
$HOME/.config/weechat/exec.conf::
konfigurační soubor pro _exec_ plugin
$HOME/.weechat/fifo.conf::
$HOME/.config/weechat/fifo.conf::
konfigurační soubor pro _fifo_ plugin
$HOME/.weechat/fset.conf::
$HOME/.config/weechat/fset.conf::
konfigurační soubor pro _fset_ plugin
$HOME/.weechat/guile.conf::
$HOME/.config/weechat/guile.conf::
konfigurační soubor pro _guile_ plugin
$HOME/.weechat/irc.conf::
$HOME/.config/weechat/irc.conf::
konfigurační soubor pro _irc_ plugin
$HOME/.weechat/javascript.conf::
$HOME/.config/weechat/javascript.conf::
konfigurační soubor pro _javascript_ plugin
$HOME/.weechat/logger.conf::
$HOME/.config/weechat/logger.conf::
konfigurační soubor pro _logger_ plugin
$HOME/.weechat/lua.conf::
$HOME/.config/weechat/lua.conf::
konfigurační soubor pro _lua_ plugin
$HOME/.weechat/perl.conf::
$HOME/.config/weechat/perl.conf::
konfigurační soubor pro _perl_ plugin
$HOME/.weechat/php.conf::
$HOME/.config/weechat/php.conf::
konfigurační soubor pro _php_ plugin
$HOME/.weechat/python.conf::
$HOME/.config/weechat/python.conf::
konfigurační soubor pro _python_ plugin
$HOME/.weechat/relay.conf::
$HOME/.config/weechat/relay.conf::
konfigurační soubor pro _relay_ plugin
$HOME/.weechat/ruby.conf::
$HOME/.config/weechat/ruby.conf::
konfigurační soubor pro _ruby_ plugin
$HOME/.weechat/script.conf::
$HOME/.config/weechat/script.conf::
konfigurační soubor pro _script_ plugin
$HOME/.weechat/spell.conf::
$HOME/.config/weechat/spell.conf::
konfigurační soubor pro _spell_ plugin
$HOME/.weechat/tcl.conf::
$HOME/.config/weechat/tcl.conf::
konfigurační soubor pro _tcl_ plugin
$HOME/.weechat/trigger.conf::
$HOME/.config/weechat/trigger.conf::
konfigurační soubor pro _trigger_ plugin
$HOME/.weechat/xfer.conf::
$HOME/.config/weechat/xfer.conf::
konfigurační soubor pro _xfer_ plugin
$HOME/.weechat/weechat.log::
$HOME/.local/share/weechat/weechat.log::
soubor záznamů WeeChatu
// end::files[]
+21 -28
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 freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
// 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_.
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_.
Jako obvykle je poskytována nápověda pokud se ztratíte:
@@ -138,45 +138,38 @@ 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 freenode s následujícím příkazem:
ji přepsat pro libera s následujícím příkazem:
----
/set irc.server.freenode.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
/set irc.server.libera.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
----
Nastavení username a realname:
----
/set irc.server.freenode.username "Mé uživatelské jméno"
/set irc.server.freenode.realname "Mé skutečné jméno"
/set irc.server.libera.username "Mé uživatelské jméno"
/set irc.server.libera.realname "Mé skutečné jméno"
----
K zapnutí automatického připojení při spuštění:
----
/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
/set irc.server.libera.autoconnect 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.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.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.freenode.command "/msg nickserv identify xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -194,24 +187,24 @@ First setup a passphrase:
----
// TRANSLATION MISSING
Then add a secured data with your freenode password:
Then add a secured data with your libera password:
----
/secure set freenode_password xxxxxxx
/secure set libera_password xxxxxxx
----
// TRANSLATION MISSING
Then you can use `+${sec.data.freenode_password}+` instead of your password in
Then you can use `+${sec.data.libera_password}+` instead of your password in
IRC options mentioned above, for example:
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
K automatickému připojení některých kanálů při připojování k serveru:
----
/set irc.server.freenode.autojoin "#channel1,#channel2"
/set irc.server.libera.autojoin "#channel1,#channel2"
----
// TRANSLATION MISSING
@@ -224,25 +217,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.freenode.nicks
/unset irc.server.libera.nicks
----
Ostatní volby: můžete nastavit ostatní volby s následujícím příkazem ("xxx" je
název volby):
----
/set irc.server.freenode.xxx value
/set irc.server.libera.xxx value
----
[[connect_to_irc_server]]
== Připojení k IRC serveru
----
/connect freenode
/connect libera
----
// TRANSLATION MISSING
With this command, WeeChat connects to the freenode server and auto-joins the
With this command, WeeChat connects to the libera server and auto-joins the
channels configured in the "autojoin" server option.
// TRANSLATION MISSING
+11 -11
View File
@@ -18,23 +18,23 @@
| guile | guile_script | Liste der Skripten
| irc | irc_channel | aktueller IRC-Channel
| irc | irc_channel | aktueller IRC-Kanal
| irc | irc_channel_nicks_hosts | Liste der Nicks und Hostnamen des aktuellen Channels
| irc | irc_channel_nicks_hosts | Liste der Nicks und Hostnamen des aktuellen Kanals
| irc | irc_channel_topic | Thema des aktuellen IRC-Channels
| irc | irc_channel_topic | Thema des aktuellen IRC-Kanals
| irc | irc_channels | Channels auf allen IRC Servern
| irc | irc_channels | Kanäle auf allen IRC Servern
| irc | irc_ignores_numbers | Anzahl für festgelegte Ignorierungen
| irc | irc_modelist_masks | Modelist Maske für aktuellen IRC Channel; benötigtes Argument: modelist mode
| irc | irc_modelist_masks | Modelist Maske 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_modelist_numbers | Modelist Nummern für aktuellen IRC Kanal; benötigtes Argument: modelist mode
| irc | irc_msg_kick | Standardmitteilung wenn man jemanden aus einem Channel wirft
| irc | irc_msg_kick | Standardmitteilung wenn man jemanden aus einem Kanal wirftchannel
| irc | irc_msg_part | Standardmitteilung beim Verlassen (/part) eines IRC-Channels
| irc | irc_msg_part | Standardmitteilung beim Verlassen (/part) eines IRC-Kanals
| 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 | Channels des derzeitigen IRC-Server
| irc | irc_server_channels | Kanäle des derzeitigen IRC-Server
| irc | irc_server_nick | Nick beim derzeitigen IRC-Server
| irc | irc_server_nicks | Nicks für alle Channels auf dem aktuellen IRC-Server
| irc | irc_server_nicks | Nicks für alle Kanäle 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 Channel
| irc | nick | Liste der Nicks im aktuellen Kanal
| javascript | javascript_script | Liste der Skripten
+6 -2
View File
@@ -53,7 +53,7 @@ _next_script_   (pointer, hdata: "guile_script") +
| irc
| [[hdata_irc_channel]]<<hdata_irc_channel,irc_channel>>
| IRC-Channel
| IRC-Kanal
| -
| _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,6 +233,10 @@ _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 Channels eines IRC-Servers | Channel Pointer (optional) | Server,Channel (Channel ist optional)
| irc | irc_channel | Liste der Kanäle eines IRC-Servers | Pointer vom Kanal (optional) | Server,Kanal (Kanal 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 Channel-Mode-Liste für einen IRC-Channel | Modelist Pointer (optional) | Server,Channel,Type (Type ist optional)
| irc | irc_modelist | Liste der Kanalmoduslisten für einen IRC-Kanal | Modelist Pointer (optional) | Server,Channel,Type (Type 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_modelist_item | Liste der Items in der Kanal-Modeliste | Modelist Item Pointer (optional) | Server,Channel,Type,Nummer (Nummer ist optional)
| irc | irc_nick | Liste der Nicks im IRC-Channel | Nick Pointer (optional) | server,channel,nick (nick ist optional)
| irc | irc_nick | Liste der Nicks im IRC-Kanal | Nick Pointer (optional) | server,channel,nick (nick ist optional)
| irc | irc_notify | Liste mit Benachrichtigungen | Benachrichtigungspointer (optional) | Servername (Platzhalter "*" kann verwendet werden) (optional)
+17 -5
View File
@@ -16,9 +16,11 @@
| guile | guile_version | Version des verwendeten Interpreters | -
| irc | irc_buffer | holt Buffer Pointer für einen IRC Server/Channel/Nick | server,channel,nick (Channel und Nicks sind optional)
| irc | irc_buffer | holt Buffer Pointer für einen IRC Server/Kanal/Nick | server,channel,nick (Kanal und Nicks sind optional)
| 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_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_nick | 1, falls die Zeichenkette ein gültiger IRC Nickname ist | Server,Nickname (Server ist optional)
@@ -58,7 +60,7 @@
| php | php_version | Version des verwendeten Interpreters | -
| python | python2_bin | Pfad für Python 2.x Interpreter | -
| python | python2_bin | Pfad zum Python 2.x Interpreter (*veraltet*, seit WeeChat Version 2.6 müssen Skripten Python3 verwenden) | -
| python | python_eval | Evaluierung des Quelltextes | Quelltext welcher ausgeführt werden soll
@@ -74,7 +76,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.freenode.#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.libera.#weechat")
| tcl | tcl_eval | Evaluierung des Quelltextes | Quelltext welcher ausgeführt werden soll
@@ -132,7 +134,15 @@
| weechat | version_number | WeeChat-Version (als Zahl) | -
| weechat | weechat_dir | WeeChat Verzeichnis | -
| 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_headless | 1, falls WeeChat im Hintergrundmodus ausgeführt wird | -
@@ -140,6 +150,8 @@
| 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,11 +8,13 @@
|===
| 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": 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_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_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[]
+158 -150
View File
@@ -14,32 +14,32 @@ target: Servername
----
[[command_irc_allchan]]
* `+allchan+`: führt einen Befehl aus der an alle Channels gesendet wird, die mit einem Server verbunden sind
* `+allchan+`: führt einen Befehl aus der an alle Kanäle 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 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
-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
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 Channel
$channel Name des Kanals
$nick Nickname der auf dem Server genutzt wird
${irc_server.xxx} Variable xxx von Server
${irc_channel.xxx} Variable xxx von Channel
${irc_channel.xxx} Variable xxx von Kanal
Beispiele:
führe den Befehl '/me Ich teste gerade etwas...' für alle Channels aus:
führe den Befehl '/me Ich teste gerade etwas...' für alle Kanäle aus:
/allchan /me Ich teste gerade etwas...
schicke 'Hallo Welt' an jeden Channel, ausgenommen an den #weechat Channel:
schicke 'Hallo Welt' an jeden Kanal, ausgenommen an den #weechat Kanal:
/allchan -exclude=#weechat Hallo Welt
schicke 'Hallo Welt' an jeden Channel, ausgenommen an den #weechat Channel und Channels die mit #linux beginnen:
schicke 'Hallo Welt' an jeden Kanal, ausgenommen an den #weechat Kanal und Kanäle die mit #linux beginnen:
/allchan -exclude=#weechat,#linux* Hallo Welt
schickt den Text 'Hallo' an alle Channels die mit #linux beginnen:
schickt den Text 'Hallo' an alle Kanäle 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 Channel
$channel Name des Kanals
$nick Nickname der auf dem Server genutzt wird
${irc_server.xxx} Variable xxx von Server
${irc_channel.xxx} Variable xxx von Channel
${irc_channel.xxx} Variable xxx von Kanal
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 Channel
channel: Name des Kanals
nick: Nick oder Host
Ohne Angabe von Argumenten wird die Ban-Liste für den aktuellen Channel angezeigt.
Ohne Angabe von Argumenten wird die Ban-Liste für den aktuellen Kanal 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 freenode
/connect libera
/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 Channelname an welchen eine CTCP-Nachricht geschickt werden soll ('*' = aktuellen Channel)
target: Nick- oder Kanalname an welchen eine CTCP-Nachricht geschickt werden soll ('*' = aktueller Kanal)
type: CTCP-Nachricht (Beispiele: "version", "ping", usw.)
arguments: Argumente für CTCP
@@ -188,12 +188,12 @@ Beispiele:
----
[[command_irc_cycle]]
* `+cycle+`: Einen Channel verlassen und wieder betreten
* `+cycle+`: Einen Kanal verlassen und wieder betreten
----
/cycle [<channel>[,<channel>...]] [<message>]
channel: Name des Channels
channel: Name des Kanals
message: Abschiedsnachricht (wird anderen Usern angezeigt)
----
@@ -222,7 +222,7 @@ Beispiel:
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: entzieht allen Nicks im Channel den half-operator-Status, ausgenommen sich selber
*: entzieht allen Nicks im Kanal den half-operator-Status, ausgenommen sich selber
----
[[command_irc_deop]]
@@ -233,7 +233,7 @@ nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: entzieht allen Nicks im Channel den Operator-Status, ausgenommen sich selber
*: entzieht allen Nicks im Kanal den Operator-Status, ausgenommen sich selber
----
[[command_irc_devoice]]
@@ -244,7 +244,7 @@ nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: entzieht allen Nicks im Channel den voice-Status
*: entzieht allen Nicks im Kanal den voice-Status
----
[[command_irc_die]]
@@ -276,11 +276,11 @@ target: Servername
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: vergibt an alle Nicks im Channel den half-operator-Status
*: vergibt an alle Nicks im Kanal den half-operator-Status
----
[[command_irc_ignore]]
* `+ignore+`: Ignoriert Nicks/Hosts von Channels oder Servern
* `+ignore+`: Ignoriert Nicks/Hosts von Kanälen oder Servern
----
/ignore list
@@ -294,17 +294,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 Channel, in dem die Ignorierung statt finden soll
channel: Name des Kanals, 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 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
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
----
[[command_irc_info]]
@@ -317,13 +317,13 @@ target: Servername
----
[[command_irc_invite]]
* `+invite+`: Eine Person in einen Channel einladen
* `+invite+`: Eine Person in einen Kanal einladen
----
/invite <nick> [<nick>...] [<channel>]
nick: Nickname
channel: Name des Channels
channel: Name des Kanals
----
[[command_irc_ison]]
@@ -336,43 +336,43 @@ nick: Nickname
----
[[command_irc_join]]
* `+join+`: einen Channel betreten
* `+join+`: einen Kanal betreten
----
/join [-noswitch] [-server <server>] [<channel1>[,<channel2>...]] [<key1>[,<key2>...]]
-noswitch: es wird nicht zu dem angegebenen Channel gewechselt
-noswitch: es wird nicht zu dem angegebenen Kanal gewechselt
server: an angegebenen Server (interner Name) senden
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)
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)
Beispiele:
/join #weechat
/join #geschützter_Channel,#weechat Zugriffsschlüssel
/join -server freenode #weechat
/join #geschützter_Kanal,#weechat Zugriffsschlüssel
/join -server libera #weechat
/join -noswitch #weechat
----
[[command_irc_kick]]
* `+kick+`: wirft einen User aus einem Channel
* `+kick+`: wirft einen User aus einem Kanal
----
/kick [<channel>] <nick> [<reason>]
channel: Channelname
channel: Kanalname
nick: Nick der rausgeworfen werden soll
reason: Begründung für den Rauswurf (Variablen die genutzt werden können: $nick, $channel und $server)
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)
----
[[command_irc_kickban]]
* `+kickban+`: wirft einen User aus einem Channel und sein Host kommt auf die Bannliste
* `+kickban+`: wirft einen User aus einem Kanal und sein Host kommt auf die Bannliste
----
/kickban [<channel>] <nick> [<reason>]
channel: Channelname
channel: Kanalname
nick: Nickname der rausgeworfen und gebannt werden soll
reason: Begründung weshalb der User rausgeworfen wurde (Variablen die genutzt werden können: $nick, $channel und $server)
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)
Es ist möglich kick/ban mittels einer Maske auszuführen. Der Nick wird aus der Maske heraus gefiltert und durch "*" ersetzt.
@@ -402,22 +402,22 @@ server_mask: die aufzulistenden Server sollen diesem Muster entsprechen
----
[[command_irc_list]]
* `+list+`: Channels mit ihrem Thema auflisten
* `+list+`: Kanäle und deren Themen 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 Channel
channel: aufzulistender Kanal
target: Servername
Beispiele:
listet alle Channels des Servers auf (dies kann bei großen Netzwerken sehr lange dauern):
listet alle Kanäle des Servers auf (dies kann bei großen Netzwerken sehr lange dauern):
/list
listet den Channel #weechat auf:
listet den Kanal #weechat auf:
/list #weechat
listet alle Channels auf die mit "#weechat" beginnen (dies kann bei großen Netzwerken sehr lange dauern):
listet alle Kanäle auf die mit "#weechat" beginnen (dies kann bei großen Netzwerken sehr lange dauern):
/list -re #weechat.*
----
@@ -438,7 +438,7 @@ target: Server, der die Anfrage weiterleiten soll
----
[[command_irc_me]]
* `+me+`: eine CTCP ACTION an den aktuellen Channel senden
* `+me+`: eine CTCP ACTION an den aktuellen Kanal senden
----
/me <message>
@@ -447,26 +447,26 @@ message: zu sendende Nachricht
----
[[command_irc_mode]]
* `+mode+`: Eigenschaften eines Channel oder von einem User ändern
* `+mode+`: Eigenschaften eines Kanals 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
Channel-Eigenschaften:
channel: zu ändernder Channel (standardmäßig der erste Channel)
Kanal-Eigenschaften:
channel: zu ändernder Kanal (standardmäßig der erste Kanal)
o: vergibt/entzieht Operator Privilegien
p: privater Channel
s: geheimer Channel
i: geschlossener Channel (Zutritt nur mit Einladung)
p: privater Kanal
s: geheimer Kanal
i: geschlossener Kanal (Zutritt nur mit Einladung)
t: nur Operatoren dürfen das Thema setzen
n: keine Nachrichten von außerhalb des Channels zulassen
m: moderierter Channel (schreiben nur mit Voice)
l: maximale Anzahl an Usern im Channel festlegen
n: keine Nachrichten von außerhalb des Kanals zulassen
m: moderierter Kanal (schreiben nur mit Voice)
l: maximale Anzahl an Usern im Kanal festlegen
b: Bannmaske für zu sperrende User (in nick!ident@host-Form)
e: legt Ausnahmemaske fest
v: vergibt/entzieht Schreibrechte (voice) in moderierten Channels
k: legt ein Passwort für den Channel fest
v: vergibt/entzieht Schreibrechte (voice) in moderierten Kanälen
k: legt ein Passwort für den Kanal fest
User-Eigenschaften:
nick: zu ändernder Nickname
i: User als unsichtbar kennzeichnen
@@ -493,23 +493,23 @@ target: Servername
----
[[command_irc_msg]]
* `+msg+`: Nachricht an Nick/Channel verschicken
* `+msg+`: Nachricht an Nick/Kanal verschicken
----
/msg [-server <server>] <target>[,<target>...] <text>
server: schicke an diesen Server (interner Servername)
target: Nick oder Channel (darf eine Maske sein, '*' = aktueller Channel)
target: Nick oder Kanal (darf eine Maske sein, '*' = aktueller c)
text: zu sendender Text
----
[[command_irc_names]]
* `+names+`: Nicknamen in Channels auflisten
* `+names+`: Nicknamen des Kanals auflisten
----
/names [<channel>[,<channel>...]]
channel: Name des Channels
channel: Name des Kanals
----
[[command_irc_nick]]
@@ -529,7 +529,7 @@ nick: neuer Nickname
/notice [-server <server>] <target> <text>
server: an diesen Server senden (interner Name)
target: Nick- oder Channelname
target: Nick- oder Kanalname
text: zu sendender Text
----
@@ -552,21 +552,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 freenode Server an- oder abmeldet:
/notify add toto freenode
Benachrichtigung falls "toto" den Befehl away am freenode Server nutzt:
/notify add toto freenode -away
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
----
[[command_irc_op]]
* `+op+`: Channel-Operator Status an Nicknamen vergeben
* `+op+`: Status des Kanal-Operator an Nicknamen vergeben
----
/op <nick> [<nick>...]
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: vergibt an alle Nicks im Channel den Operator-Status
*: vergibt an alle Nicks im Kanal den Operator-Status
----
[[command_irc_oper]]
@@ -580,12 +580,12 @@ password: Passwort
----
[[command_irc_part]]
* `+part+`: Einen Channel verlassen
* `+part+`: Einen Kanal verlassen
----
/part [<channel>[,<channel>...]] [<message>]
channel: Name des Channels welcher verlassen werden soll
channel: Name des Kanals welcher verlassen werden soll
message: Abschiedsnachricht (wird anderen Usern angezeigt)
----
@@ -622,15 +622,15 @@ target: Nickname
----
[[command_irc_quiet]]
* `+quiet+`: Nicks oder Hosts das Wort entziehen (User können im Channel erst schreiben, wenn sie "+v" oder höher besitzen)
* `+quiet+`: Nicks oder Hosts das Wort entziehen (User können im Kanal erst schreiben, wenn sie "+v" oder höher besitzen)
----
/quiet [<channel>] [<nick> [<nick>...]]
channel: Name des Channel
channel: Name des Kanals
nick: Nick oder Host
Ohne Angabe von Argumenten wird die Quiet-Liste für den aktuellen Channel angezeigt.
Ohne Angabe von Argumenten wird die Quiet-Liste für den aktuellen Kanal angezeigt.
----
[[command_irc_quote]]
@@ -652,7 +652,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: Channels werden nicht betreten (auch falls autojoin für diesen Server aktiviert ist)
-nojoin: Kanäle werden nicht betreten (auch falls autojoin für diesen Server aktiviert ist)
-switch: wechselt zur nächsten Server-Adresse
----
@@ -666,12 +666,12 @@ option: zusätzliche Einstellung, die von manchen Servern berücksichtigt wird
----
[[command_irc_remove]]
* `+remove+`: zwingt einen User einen Channel zu verlassen
* `+remove+`: zwingt einen User einen Kanal zu verlassen
----
/remove [<channel>] <nick> [<reason>]
channel: Channelname
channel: Kanalname
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 +686,23 @@ target: Servername
----
[[command_irc_sajoin]]
* `+sajoin+`: fordert einen User auf einen oder mehrere Channel zu betreten
* `+sajoin+`: fordert einen User auf einen oder mehrere Kanäle zu betreten
----
/sajoin <nick> <channel>[,<channel>...]
nick: Nickname
channel: Name des Channels
channel: Name des Kanals
----
[[command_irc_samode]]
* `+samode+`: ändert den Modus des Channels ohne das Operator-Privilegien vorliegen
* `+samode+`: ändert den Modus des Kanals ohne das Operator-Privilegien vorliegen
----
/samode [<channel>] <mode>
Channel: Name des Channel
Mode: neuer Modus für Channel
Channel: Name des Kanals
Mode: neuer Modus für Kanal
----
[[command_irc_sanick]]
@@ -716,13 +716,13 @@ new_nick: neuer Nickname
----
[[command_irc_sapart]]
* `+sapart+`: zwingt einen User den oder die Channel(s) zu verlassen
* `+sapart+`: zwingt einen User den oder die Kanäle zu verlassen
----
/sapart <nick> <channel>[,<channel>...]
nick: Nickname
channel: Name des Channels
channel: Name des Kanals
----
[[command_irc_saquit]]
@@ -775,16 +775,16 @@ nooption: stellt die Boolean Einstellung auf 'off' (Beispiel: -nossl)
Beispiele:
/server listfull
/server add freenode chat.freenode.net
/server add freenode chat.freenode.net/6697 -ssl -autoconnect
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy freenode freenode-test
/server rename freenode-test freenode2
/server reorder freenode2 freenode
/server del freenode
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server deloutq
/server raw
/server raw s:freenode
/server raw s:libera
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
@@ -846,7 +846,7 @@ target: Name des Servers
user: Benutzername
target: Servername
channel: Channelname
channel: Kanalname
----
[[command_irc_time]]
@@ -859,14 +859,14 @@ target: Zeit des angegebenen Servers abfragen
----
[[command_irc_topic]]
* `+topic+`: Thema des Channels abfragen/setzen
* `+topic+`: Thema des Kanals abfragen/setzen
----
/topic [<channel>] [<topic>|-delete]
channel: Name des Channels
topic: neues Thema für den Channel
-delete: entfernt das Thema des Channels
channel: Name des Kanals
topic: neues Thema für den Kanal
-delete: entfernt das Thema des Kanals
----
[[command_irc_trace]]
@@ -884,7 +884,7 @@ target: Servername
----
/unban [<channel>] <nick>|<number> [<nick>|<number>...]
channel: Name des Channel
channel: Name des Kanals
nick: Nick oder Host
number: ban Nummer (wird beim Befehl /ban angezeigt)
----
@@ -895,7 +895,7 @@ channel: Name des Channel
----
/unquiet [<channel>] <nick>|<number> [<nick>|<number>...]
channel: Name des Channel
channel: Name des Kanals
nick: Nick oder Host
number: Quiet-Nummer (wird beim Befehl /quiet angezeigt)
----
@@ -936,16 +936,16 @@ target: Servername
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: vergibt an alle Nicks im Channel den voice-Status
*: vergibt an alle Nicks im Kanal den voice-Status
----
[[command_irc_wallchops]]
* `+wallchops+`: Nachricht an Channel-Operator verschicken
* `+wallchops+`: Nachricht an Kanal-Operator verschicken
----
/wallchops [<channel>] <text>
channel: Name des Channel
channel: Name des Kanals
text: Text der versendet werden soll
----
@@ -978,7 +978,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/Channel Buffer handelt
- den eigenen Nick, falls es sich um einen Server/Kanal-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.
@@ -1341,26 +1341,28 @@ 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. eine evaluierte Teilzeichenkette (Format: "eval:xxx")
2. eine evaluierte Bedingung (Format: "eval_cond:xxx")
3. eine Zeichenkette mit Escapesequenzen (Format: "esc:xxx" oder "\xxx")
4. Zeichen, die in einer Zeichenkette nicht dargestellt werden sollen (Format: "hide:Zeichen,Zeichenkette")
5. eine Zeichenkette mit einer maximalen Anzahl an Zeichen (Format: "cut:+Max,Suffix,Zeichenkette")
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")
oder maximale Anzahl an Zeichen die auf dem Bildschirm angezeigt werden sollen (Format: "cutscr:Max,Suffix,Zeichenkette oder "cutscr:+Max,Suffix,Zeichenkette")
6. eine Zeichenkette umkehren (Format: "rev:xxx" oder "revscr:xxx")
7. eine Zeichenkette wiederholen (Format: "repeat:Anzahl,Zeichenkette")
8. Länge einer Zeichenkette (Format: "length:xxx" oder "lengthscr:xxx")
9. eine Farbe (Format: "color:xxx", siehe "Anleitung für API Erweiterung", Funktion "color")
10. ein Modifizierer (Format: "info:Name,Argumente", Argumente sind optional)
11. eine Info (Format: "Info:Name,Argumente", Argumente sind optional)
12. eine Basis 16/32/64 kodierte / dekodierte Zeichenfolge (Format: "base_encode:base,xxx" oder "base_decode:base,xxx")
13. aktuelles Datum/Uhrzeit (Format: "date" oder "date:format")
14. eine Umgebungsvariable (Format: "env:XXX")
15. ein Dreifachoperand (Format: "if:Bedingung?Wert_falls_wahr:Wert_falls_unwahr")
16. Ergebnis eines Ausdrucks mit Klammern und Operatoren + - * / // % ** (Format: "calc:xxx")
17. eine Option (Format: "file.section.option")
18. eine lokale Variable eines Buffers
19. 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.
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.
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:
@@ -1368,14 +1370,16 @@ 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.freenode_password} ==> geheim
/eval -n ${sec.data.password} ==> geheim
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
@@ -1392,6 +1396,7 @@ 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
@@ -1429,7 +1434,7 @@ addreplace: erzeugt neuen Filter oder ersetzt einen schon existierenden Filter
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.freenode.#weechat" oder "irc.server.freenode")
- ist der vollständige Name eines Buffer inklusive seiner Erweiterung (Beispiel: "irc.libera.#weechat" oder "irc.server.libera")
- "*" bedeutet, alle Buffer
- beginnt ein Name mit '!' wird für diesen Buffer kein Filter genutzt
- Platzhalter "*" kann verwendet werden
@@ -1464,11 +1469,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.freenode.#weechat nick_toto *
/filter add toto irc.libera.#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.freenode.#weechat * weechat sucks
/filter add sucks irc.libera.#weechat * weechat sucks
filter Zeilen die exakt "WeeChat sucks" lauten und das in allen Buffern:
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -1670,7 +1675,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.freenode", "irc.freenode.#weechat")
name: vollständiger Buffername (Beispiel: "irc.server.libera", "irc.libera.#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.
@@ -1678,10 +1683,10 @@ Wird kein Buffer ausgewählt (-core, -current oder -buffer), dann wird die Texta
Beispiele:
Speichern der Konfiguration:
/mute save
Nachricht in den aktuellen Channel senden:
Nachricht in den aktuellen Kanal senden:
/mute -current msg * hi!
Nachricht an den #weechat Channel senden:
/mute -buffer irc.freenode.#weechat msg #weechat hi!
Nachricht an den #weechat Kanal senden:
/mute -buffer irc.libera.#weechat msg #weechat hi!
----
[[command_weechat_plugin]]
@@ -1749,7 +1754,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.freenode.#weechat Nachricht an #weechat
/print -buffer irc.libera.#weechat Nachricht an #weechat
gibt einen Schneemann aus (U+2603):
/print -escape \u2603
verschickt Alarm (BEL):
@@ -1871,7 +1876,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 in der Option sec.crypt.passphrase_file eine Datei anzugeben die die Passphrase beinhaltet (siehe /help sec.crypt.passphrase_file)
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 )
schutzwürdige Daten mit dem Format ${sec.data.xxx} können wie folgt genutzt werden:
- Befehl /eval.
@@ -1882,14 +1887,16 @@ 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
verschlüsselt freenode SASL Passwort:
/secure set freenode meinPasswort
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
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 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 freenode nickserv ghost meinNick ${sec.data.freenode}
/alias add ghost /eval /msg -server libera nickserv ghost meinNick ${sec.data.libera}
----
[[command_weechat_set]]
@@ -1976,7 +1983,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 Rechner wiederherzustellen, sofern man den Inhalt des "~/.weechat" Verzeichnisses dorthin kopiert.
Es ist möglich, die WeeChat-Sitzung auf einem anderen Computer wiederherzustellen, wenn Sie den Inhalt der WeeChat Verzeichnisse kopieren (siehe / debug dirs).
----
[[command_weechat_uptime]]
@@ -2018,7 +2025,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 Channel #test:
Betritt nach 10 Sekunden den Kanal #test:
/wait 10 /join #test
Setzt nach 15 Minuten eine globale Abwesenheit:
/wait 15m /away -all Bin dann mal eben weg
@@ -2141,7 +2148,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 Channeldaten, ausschließlich genutzt bei einem IRC Channel Buffer (siehe hdata "irc_channel" in API Dokumentation)
- irc_channel: IRC Kanaldaten, ausschließlich genutzt bei einem IRC Kanal-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}?...:...}
@@ -2161,6 +2168,7 @@ 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[]
@@ -2267,14 +2275,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 ist die FIFO-Pipe in ~/.weechat/weechat_fifo
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).
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 freenode zu ändern:
echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo
Beispiel um den eigenen Nick auf dem Server libera zu ändern:
echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
Bitte lese die Benutzeranleitung für weitere Informationen und Beispiele.
@@ -2523,7 +2531,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 Channel)
1: Nachrichten von Usern (private und öffentliche Nachrichten) , notice (Server und Kanal)
2: Wechsel von Nicks (/nick)
3: Nachrichten vom Server
4: join/part/quit Nachrichten
@@ -2538,7 +2546,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 Channel:
Für jeden IRC-Server wird ein separates Verzeichnis erstellt und darin eine eigene Protokoll-Datei, für jeden Kanal:
/set logger.mask.irc "$server/$channel.weechatlog"
----
// end::logger_commands[]
@@ -2711,7 +2719,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); "%h" wird durch das WeeChat Verzeichnis ersetzt, Standardverzeichnis: ("~/.weechat"), Inhalt ist evaluiert (siehe /help eval)
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
raw: öffnet einen Buffer mit Relay-Rohdaten
sslcertkey: setzt SSL Zertifikat/Schlüssel mittels Pfad in Einstellung relay.network.ssl_cert_key
@@ -2730,10 +2738,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 "freenode":
/relay add irc.freenode 8000
IRC Proxy, für Server "freenode", mit SSL:
/relay add ssl.irc.freenode 8001
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 alle Server (Client wählt aus), mit SSL:
/relay add ssl.irc 8002
WeeChat Protokoll:
@@ -2747,7 +2755,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 %h/relay_socket
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
----
// end::relay_commands[]
+148 -70
View File
@@ -16,8 +16,8 @@
** Werte: sha224, sha256, sha384, sha512
** Standardwert: `+sha256+`
* [[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"]
* [[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"]
** 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 Channel-Namen]
** Beschreibung: pass:none[Farbe für den Kanalnamen]
** 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 Channels in der Statuszeile]
** Beschreibung: pass:none[Farbe des aktuellen Kanals 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,6 +846,12 @@
** 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
@@ -1140,6 +1146,12 @@
** 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
@@ -1248,11 +1260,17 @@
** Werte: 1 .. 2147483647
** Standardwert: `+60+`
* [[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")]
* [[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)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"/etc/ssl/certs/ca-certificates.crt"+`
** Standardwert: `+""+`
* [[option_weechat.network.gnutls_handshake_timeout]] *weechat.network.gnutls_handshake_timeout*
** Beschreibung: pass:none[Zeitüberschreitung für gnutls Handshake (in Sekunden)]
@@ -1285,10 +1303,10 @@
** Standardwert: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
** Beschreibung: pass:none[Suchpfad für Erweiterungen ("%h"' wird durch das WeeChat-Basisverzeichnis ersetzt, voreingestellt ist "~/.weechat")]
** Beschreibung: pass:none[Pfad für die Suche nach Erweiterungen (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%h/plugins"+`
** Standardwert: `+"${weechat_data_dir}/plugins"+`
* [[option_weechat.plugin.save_config_on_unload]] *weechat.plugin.save_config_on_unload*
** Beschreibung: pass:none[speichert Konfigurationen, falls Erweiterungen beendet werden]
@@ -1296,14 +1314,44 @@
** 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[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)]
** 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)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
* [[option_weechat.startup.command_before_plugins]] *weechat.startup.command_before_plugins*
** 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)]
** 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)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -1409,10 +1457,10 @@
** Standardwert: `+""+`
* [[option_logger.file.path]] *logger.file.path*
** 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)]
** 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)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%h/logs/"+`
** Standardwert: `+"${weechat_data_dir}/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 "/")]
@@ -1675,7 +1723,7 @@
** Standardwert: `+"${color:default},"+`
* [[option_buflist.format.indent]] *buflist.format.indent*
** Beschreibung: pass:none[Zeichenkette die beim Einrücken von Channel und privaten Buffern angezeigt wird (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Beschreibung: pass:none[Zeichenkette die beim Einrücken von Kanal und privaten Buffern angezeigt wird (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+" "+`
@@ -1693,7 +1741,7 @@
** Standardwert: `+"${name}"+`
* [[option_buflist.format.nick_prefix]] *buflist.format.nick_prefix*
** Beschreibung: pass:none[Format des Nick-Präfix für einen Channel (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Beschreibung: pass:none[Format des Nick-Präfix für einen Kanal (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"${color_nick_prefix}${nick_prefix}"+`
@@ -1704,6 +1752,12 @@
** 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
@@ -1765,10 +1819,16 @@
** 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 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")]
** 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}")]
** 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[]
@@ -1779,10 +1839,10 @@
** Standardwert: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
** 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)]
** 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)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%h/weechat_fifo"+`
** Standardwert: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1853,7 +1913,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: "freenode.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: "libera.FlashCode,andrew"]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -1883,10 +1943,10 @@
** Standardwert: `+on+`
* [[option_xfer.file.download_path]] *xfer.file.download_path*
** Beschreibung: pass:none[Pfad für eingehende Dateien: "%h" wird durch das WeeChat Verzeichnis ersetzt (Standardpfad: "~/.weechat") (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Beschreibung: pass:none[Pfad zum Schreiben eingehender Dateien (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%h/xfer"+`
** Standardwert: `+"${weechat_data_dir}/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]
@@ -1895,7 +1955,7 @@
** Standardwert: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
** 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)]
** Beschreibung: pass:none[Pfad zum Lesen von Dateien beim Senden (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"~"+`
@@ -1981,7 +2041,7 @@
** Standardwert: `+lightcyan+`
* [[option_irc.color.item_channel_modes]] *irc.color.item_channel_modes*
** Beschreibung: pass:none[Farbe der Channel-Modes (neben dem Channelnamen)]
** Beschreibung: pass:none[Farbe der Kanal-Modes (neben des Kanalnamens)]
** 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+`
@@ -2004,6 +2064,24 @@
** 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
@@ -2017,7 +2095,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 Channels angezeigt werden soll]
** Beschreibung: pass:none[Textfarbe in der die Meldungen für das Betreten eines Kanals 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+`
@@ -2029,7 +2107,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 Channels angezeigt werden soll]
** Beschreibung: pass:none[Textfarbe in der die Meldungen für das Verlassen/Beenden eines Kanals 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+`
@@ -2065,49 +2143,49 @@
** Standardwert: `+default+`
* [[option_irc.color.topic_current]] *irc.color.topic_current*
** Beschreibung: pass:none[Farbe in dem das aktuelle Thema des Channels dargestellt werden soll (wenn ein Channel betreten oder der Befehl /topic genutzt wird)]
** Beschreibung: pass:none[Farbe in dem das aktuelle Thema des Kanals dargestellt werden soll (wenn ein Kanal 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 Channels dargestellt werden soll, falls das Thema des Channels geändert wurde]
** Beschreibung: pass:none[Farbe in dem das neue Thema des Kanals dargestellt werden soll, falls das Thema des Kanals 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 Channels dargestellt werden soll, falls das Thema des Channels geändert wurde]
** Beschreibung: pass:none[Farbe in dem das alte Thema des Kanals dargestellt werden soll, falls das Thema des Kanals 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 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]
** 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]
** 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 Channel 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 Kanal 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 Channel-Buffer falls dieser automatisch betreten wurde (mittels der Serveroption "autojoin")]
** Beschreibung: pass:none[wechselt automatisch zum Kanal-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 Channel-Buffer falls dieser manuell betreten wurde (mittels dem /join Befehl)]
** Beschreibung: pass:none[wechselt automatisch zum Kanal-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 Channel betritt)]
** 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)]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
@@ -2125,7 +2203,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 Channel wie auch im privaten Buffer]
** Beschreibung: pass:none[nutzt die selbe Farbe für die Darstellung des Nicks im Kanal wie auch im privaten Buffer]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
@@ -2137,7 +2215,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 Channels)]
** 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)]
** Typ: integer
** Werte: off, local, channel
** Standardwert: `+local+`
@@ -2179,13 +2257,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 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]
** 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]
** 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 Channels geändert wurde]
** Beschreibung: pass:none[zeige das alte Thema an, falls das Thema des Kanals geändert wurde]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
@@ -2209,7 +2287,7 @@
** Standardwert: `+off+`
* [[option_irc.look.highlight_channel]] *irc.look.highlight_channel*
** 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"]
** 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"]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"$nick"+`
@@ -2233,7 +2311,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 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]
** 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]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"k"+`
@@ -2257,7 +2335,7 @@
** Standardwert: `+on+`
* [[option_irc.look.join_auto_add_chantype]] *irc.look.join_auto_add_chantype*
** 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]
** 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]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
@@ -2269,13 +2347,13 @@
** Standardwert: `+current+`
* [[option_irc.look.new_channel_position]] *irc.look.new_channel_position*
** 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)]
** 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)]
** 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 Channel/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 Kanal/privaten Buffer des jeweiligen Servers)]
** Typ: integer
** Werte: none, next, near_server
** Standardwert: `+none+`
@@ -2311,13 +2389,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 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 ..."]
** 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 ..."]
** 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 Channel umgeleitet werden. Zum Beispiel: "notify_private"]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Schlagwörtern für Willkommen-Nachrichten die in einen Kanal umgeleitet werden. Zum Beispiel: "notify_private"]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2335,7 +2413,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 Channel ausgeführt wird]
** Beschreibung: pass:none[schließt den Buffer wenn "/part" im Kanal ausgeführt wird]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
@@ -2365,7 +2443,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 Channel 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 Kanal 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+`
@@ -2395,7 +2473,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 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)]
** 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)]
** Typ: integer
** Werte: 0 .. 10080
** Standardwert: `+30+`
@@ -2425,7 +2503,7 @@
** Standardwert: `+off+`
* [[option_irc.look.topic_strip_colors]] *irc.look.topic_strip_colors*
** Beschreibung: pass:none[Farben werden im Channel-Thema entfernt (wird nur genutzt wenn der Buffer-Titel angezeigt wird)]
** Beschreibung: pass:none[Farben werden im Kanalthema entfernt (wird nur genutzt wenn der Buffer-Titel angezeigt wird)]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
@@ -2545,7 +2623,7 @@
** Standardwert: `+off+`
* [[option_irc.server_default.autojoin]] *irc.server_default.autojoin*
** 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)]
** 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)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2563,13 +2641,13 @@
** Standardwert: `+10+`
* [[option_irc.server_default.autorejoin]] *irc.server_default.autorejoin*
** 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")]
** 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")]
** 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 Channel automatisch erneut betritt (nachdem man rausgeworfen wurde)]
** Beschreibung: pass:none[Wartezeit, in Sekunden, die verstreichen soll bevor man den Kanal automatisch erneut betritt (nachdem man rausgeworfen wurde)]
** Typ: integer
** Werte: 0 .. 86400
** Standardwert: `+30+`
@@ -2581,7 +2659,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 Channels wird nicht überprüft wenn die Anzahl der Nutzer höher ist, als der angegebene Wert (0 = unbegrenzte Anzahl an Nutzern im Channel)]
** 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)]
** Typ: integer
** Werte: 0 .. 1000000
** Standardwert: `+25+`
@@ -2593,19 +2671,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 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)]
** 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)]
** 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 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)]
** 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)]
** 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 Channels 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 Kanäle automatisch betreten werden (Beispiel: es wird eine gewisse Zeit gewartet, um eine Authentifizierung zu ermöglichen)]
** Typ: integer
** Werte: 0 .. 3600
** Standardwert: `+0+`
@@ -2617,7 +2695,7 @@
** Standardwert: `+60+`
* [[option_irc.server_default.default_chantypes]] *irc.server_default.default_chantypes*
** Beschreibung: pass:none[channel type prefixes to use if the server does not send them in message 005 (default is "#&")]
** 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: `+"#&"+`
@@ -2635,7 +2713,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; Variablen die genutzt werden können: ${nick}, ${channel} und ${server})]
** 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)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2695,15 +2773,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 "ecdsa-nist256p-challenge" Mechanismus ("%h" wird durch das WeeChat Verzeichnis ersetzt, standardmäßig "~/.weechat")]
** 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)]
** 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, "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, "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)]
** Typ: integer
** Werte: plain, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** Werte: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** Standardwert: `+plain+`
* [[option_irc.server_default.sasl_password]] *irc.server_default.sasl_password*
@@ -2737,7 +2815,7 @@
** Standardwert: `+off+`
* [[option_irc.server_default.ssl_cert]] *irc.server_default.ssl_cert*
** Beschreibung: pass:none[Datei für SSL Zertifikat um automatisch den eigenen Nick zu identifizieren ("%h" wird durch das WeeChat Verzeichnis ersetzt, Standardverzeichnis: "~/.weechat")]
** Beschreibung: pass:none[SSL-Zertifikatdatei zur automatischen Identifizierung Ihres Nick (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2773,7 +2851,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 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)]
** 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)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2841,13 +2919,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 Channel 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 Kanal 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 Channel (0: keine Zeilenbegrenzung)]
** Beschreibung: pass:none[maximale Anzahl an Zeilen im Verlaufsspeicher. Dies gilt für jeden IRC Kanal (0: keine Zeilenbegrenzung)]
** Typ: integer
** Werte: 0 .. 2147483647
** Standardwert: `+1024+`
@@ -2865,7 +2943,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 Channels 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 Kanälen 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"+`
@@ -2961,10 +3039,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 (zur Nutzung von Clients mit SSL)]
** 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)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%h/ssl/relay.pem"+`
** Standardwert: `+"${weechat_config_dir}/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")]
@@ -3267,7 +3345,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=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=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)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%s %n %V %v %u | %d | %t"+`
@@ -3345,10 +3423,10 @@
** Standardwert: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
** 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)]
** Beschreibung: pass:none[lokales Cache-Verzeichnis für Skripten (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%h/script"+`
** Standardwert: `+"${weechat_cache_dir}/script"+`
* [[option_script.scripts.url]] *script.scripts.url*
** Beschreibung: pass:none[URL für Datei mit der Auflistung aller Skripten]
+2 -3
View File
@@ -16,9 +16,8 @@
"--daemon").
*-d*, *--dir* _<path>_::
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.
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).
Wird diese Option nicht genutzt, wird die Umgebungsvariable WEECHAT_HOME genutzt
(sofern diese vorhanden ist).
+26 -26
View File
@@ -9,7 +9,7 @@ indem man eine URL verwendet:
Um dem WeeChat IRC Support-Channel, mit dem Nick "mynick", beizutreten:
irc://mynick@chat.freenode.net/#weechat
irc://mynick@irc.libera.chat/#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/.weechat/weechat.conf::
$HOME/.config/weechat/weechat.conf::
WeeChats Konfigurationsdatei
$HOME/.weechat/plugins.conf::
$HOME/.config/weechat/plugins.conf::
Konfigurationsdatei für Erweiterungen
$HOME/.weechat/sec.conf::
$HOME/.config/weechat/sec.conf::
Konfigurationsdatei mit schutzwürdigen Daten
$HOME/.weechat/alias.conf::
$HOME/.config/weechat/alias.conf::
Konfigurationsdatei für _alias_ Erweiterung
$HOME/.weechat/buflist.conf::
$HOME/.config/weechat/buflist.conf::
Konfigurationsdatei für _buflist_ Erweiterung
$HOME/.weechat/charset.conf::
$HOME/.config/weechat/charset.conf::
Konfigurationsdatei für _charset_ Erweiterung
$HOME/.weechat/exec.conf::
$HOME/.config/weechat/exec.conf::
Konfigurationsdatei für _exec_ Erweiterung
$HOME/.weechat/fifo.conf::
$HOME/.config/weechat/fifo.conf::
Konfigurationsdatei für _fifo_ Erweiterung
$HOME/.weechat/fset.conf::
$HOME/.config/weechat/fset.conf::
Konfigurationsdatei für _fset_ Erweiterung
$HOME/.weechat/guile.conf::
$HOME/.config/weechat/guile.conf::
Konfigurationsdatei für _guile_ Erweiterung
$HOME/.weechat/irc.conf::
$HOME/.config/weechat/irc.conf::
Konfigurationsdatei für _irc_ Erweiterung
$HOME/.weechat/javascript.conf::
$HOME/.config/weechat/javascript.conf::
Konfigurationsdatei für _javascript_ Erweiterung
$HOME/.weechat/logger.conf::
$HOME/.config/weechat/logger.conf::
Konfigurationsdatei für _logger_ Erweiterung
$HOME/.weechat/lua.conf::
$HOME/.config/weechat/lua.conf::
Konfigurationsdatei für _lua_ Erweiterung
$HOME/.weechat/perl.conf::
$HOME/.config/weechat/perl.conf::
Konfigurationsdatei für _perl_ Erweiterung
$HOME/.weechat/php.conf::
$HOME/.config/weechat/php.conf::
Konfigurationsdatei für _php_ Erweiterung
$HOME/.weechat/python.conf::
$HOME/.config/weechat/python.conf::
Konfigurationsdatei für _python_ Erweiterung
$HOME/.weechat/relay.conf::
$HOME/.config/weechat/relay.conf::
Konfigurationsdatei für _relay_ Erweiterung
$HOME/.weechat/ruby.conf::
$HOME/.config/weechat/ruby.conf::
Konfigurationsdatei für _ruby_ Erweiterung
$HOME/.weechat/script.conf::
$HOME/.config/weechat/script.conf::
Konfigurationsdatei für _script_ Erweiterung
$HOME/.weechat/spell.conf::
$HOME/.config/weechat/spell.conf::
Konfigurationsdatei für _spell_ Erweiterung
$HOME/.weechat/tcl.conf::
$HOME/.config/weechat/tcl.conf::
Konfigurationsdatei für _tcl_ Erweiterung
$HOME/.weechat/trigger.conf::
$HOME/.config/weechat/trigger.conf::
Konfigurationsdatei für _trigger_ Erweiterung
$HOME/.weechat/xfer.conf::
$HOME/.config/weechat/xfer.conf::
Konfigurationsdatei für _xfer_ Erweiterung
$HOME/.weechat/weechat.log::
$HOME/.local/share/weechat/weechat.log::
WeeChat Protokolldatei
// end::files[]
+34 -31
View File
@@ -775,7 +775,8 @@ 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.
Der Pfad zu den Zertifikaten kann in WeeChat eingestellt werden:
Ab WeeChat ≤ 3.1 können Sie den Pfad zu Systemzertifikaten festlegen:
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@@ -817,10 +818,11 @@ 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_freenode]]
=== Wie kann ich eine SSL gesicherte Verbindung zum freenode Server herstellen?
[[irc_ssl_libera]]
=== Wie kann ich eine SSL gesicherte Verbindung zum libera Server herstellen?
Die Option _weechat.network.gnutls_ca_file_ sollte auf die Zertifikationsdatei zeigen:
Ab WeeChat ≤ 3.1 kann mit der Option _weechat.network.gnutls_ca_file_ eine Datei mit
Zertifikaten ausgewählt werden:
----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
@@ -840,9 +842,9 @@ dass die Zertifikate in einer anderen Datei bereitgestellt werden:
Konfiguration des Servers, Port angeben, SSL aktivieren und Verbindung herstellen:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
/set irc.server.libera.addresses "irc.libera.chat/6697"
/set irc.server.libera.ssl on
/connect libera
----
[[irc_oauth]]
@@ -869,8 +871,8 @@ ist es ratsam auf diese Funktion zurückzugreifen
und sich nicht mittels "nickserv" zu authentifizieren:
----
/set irc.server.freenode.sasl_username "meinNick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "meinNick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
Unterstützt der Server keine SASL Authentifizierung,
@@ -878,7 +880,7 @@ kann eine Verzögerung aktiviert werden,
um sich vor dem Betreten von Channels bei "nickserv" zu identifizieren:
----
/set irc.server.freenode.command_delay 5
/set irc.server.libera.command_delay 5
----
[[edit_autojoin]]
@@ -886,10 +888,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 "freenode"-Server angepasst:
In folgendem Beispiel wird der "libera"-Server angepasst:
----
/set irc.server.freenode.autojoin [TAB]
/set irc.server.libera.autojoin [TAB]
----
[NOTE]
@@ -1089,16 +1091,16 @@ das Skript _buffer_autoset.py_ nutzen:
----
Um zum Beispiel Highlights (Hervorhebungen) von Nick "mike" im Channel
#weechat auf dem IRC Server freenode zu deaktivieren:
#weechat auf dem IRC Server libera zu deaktivieren:
----
/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera.#weechat hotlist_max_level_nicks_add mike:2
----
Um dies auf den kompletten freenode Server anzuwenden:
Um dies auf den kompletten libera Server anzuwenden:
----
/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera hotlist_max_level_nicks_add mike:2
----
Für weitere Beispiele, siehe `+/help buffer_autoset+`.
@@ -1136,16 +1138,18 @@ 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
(besonders über die Option _weechat.network.gnutls_ca_file_).
Als erstes sollte das Kapitel über SSL Verbindungen in dieser FAQ gelesen werden.
Wenn das nicht hilft, sollte die Skriptliste von Hand gelöscht werden. Dazu
folgenden Befehl in der Shell ausführen:
----
$ rm ~/.weechat/script/plugins.xml.gz
$ rm ~/.cache/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:
----
@@ -1165,7 +1169,7 @@ Das bedeutet aber auch, dass die Skripten von Hand aktuell gehalten werden müss
* und in der Shell, mit installiertem curl:
----
$ cd ~/.weechat/script
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
----
@@ -1217,9 +1221,8 @@ 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
* 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_
* Laden Sie keine Systemzertifikate, wenn SSL *NICHT* verwendet wird: Deaktivieren Sie diese Option:
_weechat.network.gnutls_ca_system_.
* 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.
@@ -1278,18 +1281,17 @@ Beispiel:
----
/secure passphrase xxxxxxxxxx
/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}"
/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}"
----
[[sharing_config_files]]
=== Ich möchte meine WeeChat Konfiguration teilen. Welche Dateien kann ich weitergeben und welche sollte ich behalten?
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.
Sie können Ihre _*.conf_ Konfigurationsdateien teilen, mit Ausnahme der Datei _sec.conf_, die Ihre mit
Ihrer Passphrase verschlüsselten Kennwörter enthält.
Einige andere Dateien enthalten möglicherweise vertrauliche Informationen wie
Kennwörter (sofern sie nicht mit dem Befehl `/secure` in _sec.conf_ gesichert werden).
@@ -1328,7 +1330,8 @@ $ 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?
Eine vollständige Liste der Portierungen findest Du unter: https://weechat.org/download.
WeeChat läuft auf den meisten Linux/BSD-Distributionen, GNU/Hurd, Mac OS und
Windows (Cygwin und Windows Subsystem für Linux) einwandfrei.
Wir geben unser Bestes, WeeChat auf möglichst viele Plattformen zu portieren.
Deshalb ist jede Hilfe gerne gesehen, die es uns ermöglicht,
+25 -32
View File
@@ -123,13 +123,13 @@ Um eine Verbindung zu einem IRC Server herzustellen, wird der
`/server` Befehl verwendet. Beispiel:
----
/server add freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
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.
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.
Verwende die Hilfe, falls noch Fragen offen sind:
@@ -149,31 +149,24 @@ 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 freenode-Server andere Nicks genutzt werden,
Sollen speziell für den libera-Server andere Nicks genutzt werden,
können diese mit folgendem Befehl angepasst werden:
----
/set irc.server.freenode.nicks "meinNick,meinNick2,meinNick3,meinNick4,meinNick5"
/set irc.server.libera.nicks "meinNick,meinNick2,meinNick3,meinNick4,meinNick5"
----
Benutzernamen und wirklichen Namen (realname) anpassen:
----
/set irc.server.freenode.username "Mein Benutzername"
/set irc.server.freenode.realname "Mein wirklicher Name"
/set irc.server.libera.username "Mein Benutzername"
/set irc.server.libera.realname "Mein wirklicher Name"
----
Beim Start von WeeChat automatisch die Verbindung zu einem Server herstellen:
----
/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
/set irc.server.libera.autoconnect on
----
Wenn der Server SASL unterstützt,
@@ -182,8 +175,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.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
Wenn der Server keine SASL-Authentifizierung unterstützt,
@@ -191,7 +184,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.freenode.command "/msg nickserv identify xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -207,19 +200,19 @@ Zuerst sollte die Passphrase gesetzt werden:
----
Jetzt wird das Passwort (`xxxxxx`)
für den Zugang zum Freenode-Server verschlüsselt
und mit dem Bezeichner `freenode_password` verknüpft:
für den Zugang zum Libera-Server verschlüsselt
und mit dem Bezeichner `libera_password` verknüpft:
----
/secure set freenode_password xxxxxx
/secure set libera_password xxxxxx
----
Das geschützte Freenode-Passwort kann nun in anderen Optionen genutzt werden.
Das geschützte Libera-Passwort kann nun in anderen Optionen genutzt werden.
Dazu wird anstelle des Klartext-Passwortes die Variable
`+${sec.data.freenode_password}+` eingesetzt:
`+${sec.data.libera_password}+` eingesetzt:
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
Das automatische Betreten (auto-join) von Channels (Chaträume) direkt nach dem
@@ -227,7 +220,7 @@ Verbindungsaufbau zum IRC-Server kann durch den Eintrag der gewünschten Channel
in folgender Option erreicht werden:
----
/set irc.server.freenode.autojoin "#channel1,#channel2"
/set irc.server.libera.autojoin "#channel1,#channel2"
----
[TIP]
@@ -239,28 +232,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 Freenode-Nicks, diese Server-Option _automatisch_ den Wert
nach dem Rücksetzen der Libera-Nicks, diese Server-Option _automatisch_ den Wert
der entsprechenden fall-back-Option `irc.server_default.nicks` an:
----
/unset irc.server.freenode.nicks
/unset irc.server.libera.nicks
----
*Andere Optionen:*
Werte anderer Server-Optionen (`xxx`) können festgelegt werden mit:
----
/set irc.server.freenode.xxx Wert
/set irc.server.libera.xxx Wert
----
[[connect_to_irc_server]]
== Verbinden mit dem IRC-Server
----
/connect freenode
/connect libera
----
Mittels obigem Befehl stellt WeeChat eine Verbindung zum freenode Server
Mittels obigem Befehl stellt WeeChat eine Verbindung zum libera Server
her und betritt automatisch die Kanäle die in der "autojoin" Server-Option
aufgeführt sind.
+90 -66
View File
@@ -72,13 +72,18 @@ 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.
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].
[[python_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+weechat.xxx(arg1, arg2, ...)+`.
@@ -86,6 +91,7 @@ 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
@@ -142,18 +148,23 @@ 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, ...)+`.
@@ -178,20 +189,26 @@ 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 ...)+`.
@@ -204,14 +221,18 @@ 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, ...);+`.
@@ -222,11 +243,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:
Prototyp (Python):
[source,python]
----
weechat.register(Name, Author, Version, Lizenz, Beschreibung, Shutdown_Funktion, Zeichensatz)
def register(name: str, author: str, version: str, license: str, description: str, shutdown_function: str, charset: str) -> int: ...
----
Argumente:
@@ -349,7 +370,7 @@ anlegen, der in das Verzeichnis _Skriptsprache/autoload_ zeigt.
Ein Beispiel für ein Python-Skript:
----
$ cd ~/.weechat/python/autoload
$ cd ~/.local/share/weechat/python/autoload
$ ln -s ../script.py
----
@@ -792,58 +813,58 @@ Liste der Konstanten in Skript API:
| Kategorie | Konstanten
| return codes |
WEECHAT_RC_OK +
WEECHAT_RC_OK_EAT +
WEECHAT_RC_ERROR
`WEECHAT_RC_OK` (integer) +
`WEECHAT_RC_OK_EAT` (integer) +
`WEECHAT_RC_ERROR` (integer)
| Konfigurationsdatei |
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
`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)
| sortierte Listen |
WEECHAT_LIST_POS_SORT +
WEECHAT_LIST_POS_BEGINNING +
WEECHAT_LIST_POS_END
`WEECHAT_LIST_POS_SORT` (string) +
`WEECHAT_LIST_POS_BEGINNING` (string) +
`WEECHAT_LIST_POS_END` (string)
| Hotlist |
WEECHAT_HOTLIST_LOW +
WEECHAT_HOTLIST_MESSAGE +
WEECHAT_HOTLIST_PRIVATE +
WEECHAT_HOTLIST_HIGHLIGHT
`WEECHAT_HOTLIST_LOW` (string) +
`WEECHAT_HOTLIST_MESSAGE` (string) +
`WEECHAT_HOTLIST_PRIVATE` (string) +
`WEECHAT_HOTLIST_HIGHLIGHT` (string)
| hook Prozesse |
WEECHAT_HOOK_PROCESS_RUNNING +
WEECHAT_HOOK_PROCESS_ERROR
`WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
`WEECHAT_HOOK_PROCESS_ERROR` (integer)
| hook Connect |
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
`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)
| hook Signal |
WEECHAT_HOOK_SIGNAL_STRING +
WEECHAT_HOOK_SIGNAL_INT +
WEECHAT_HOOK_SIGNAL_POINTER
`WEECHAT_HOOK_SIGNAL_STRING` (string) +
`WEECHAT_HOOK_SIGNAL_INT` (string) +
`WEECHAT_HOOK_SIGNAL_POINTER` (string)
|===
[[common_tasks]]
@@ -886,13 +907,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.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
# (der Name des Buffers muss folgendes Format besitzen Erweiterung.Name, Beispiel: "irc.libera.#weechat")
buffer = weechat.buffer_search("irc", "libera.#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", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.prnt(buffer, "Nachricht im #weechat Channel")
----
@@ -914,7 +935,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", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.command(buffer, "Hallo")
----
@@ -1221,7 +1242,7 @@ xxx,irc_raw_in2_yyy::
[source,python]
----
def join_cb(data, signal, signal_data):
# Das Signal lautet: "freenode,irc_in2_join"
# Das Signal lautet: "libera,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})
@@ -1275,63 +1296,66 @@ 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="1,^2,10,8",options="header"]
[width="100%",cols="3,^2,10,7",options="header"]
|===
| Schlüssel | WeeChat version | Beschreibung | Beispiel
| Schlüssel | Seit WeeChat ^(1)^ | 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(
@@ -1393,8 +1417,8 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[source,python]
----
# WeeChat Hauptverzeichnis, zum Beispiel: "/home/xxxx/.weechat"
weechat.prnt("", "WeeChat Hauptverzeichnis: %s" % weechat.info_get("weechat_dir", ""))
# Zum Beispiel, das WeeChat-Konfigurationsverzeichnis: "/home/user/.config/weechat"
weechat.prnt("", "WeeChat config dir: %s" % weechat.info_get("weechat_config_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 _chat.freenode.net_ (A.d.Ü.: englischsprachig) und
in den Channel _#weechat_ auf _irc.libera.chat_ (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
+2 -2
View File
@@ -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'])
args_desc = translate(_inh['args_description']) or '-'
output_desc = translate(_inh['output_description']) or '-'
self.write('| %s | %s | %s | %s | %s\n',
escape(plugin), escape(info), escape(desc),
@@ -233,6 +233,10 @@ _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) +
+15 -3
View File
@@ -20,6 +20,8 @@
| 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
@@ -58,7 +60,7 @@
| php | php_version | version of the interpreter used | -
| python | python2_bin | path to python 2.x interpreter | -
| python | python2_bin | path to Python 2.x interpreter (*deprecated* since version 2.6, scripts must use Python 3 only) | -
| python | python_eval | evaluation of source code | source code to execute
@@ -74,7 +76,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.freenode.#weechat")
| spell | spell_dict | comma-separated list of dictionaries used in buffer | buffer pointer ("0x12345678") or buffer full name ("irc.libera.#weechat")
| tcl | tcl_eval | evaluation of source code | source code to execute
@@ -132,7 +134,15 @@
| weechat | version_number | WeeChat version (as number) | -
| weechat | weechat_dir | WeeChat directory | -
| 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_headless | 1 if WeeChat is running headless | -
@@ -140,6 +150,8 @@
| 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,5 +14,7 @@
| 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[]
+71 -63
View File
@@ -161,7 +161,7 @@ Examples:
To disconnect from a server or stop any connection attempt, use command /disconnect.
Examples:
/connect freenode
/connect libera
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
@@ -301,10 +301,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 freenode server:
/ignore add toto@domain.com freenode
ignore host "toto*@*.domain.com" on freenode/#weechat:
/ignore add toto*@*.domain.com freenode #weechat
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
----
[[command_irc_info]]
@@ -349,7 +349,7 @@ nick: nick
Examples:
/join #weechat
/join #protectedchan,#weechat key
/join -server freenode #weechat
/join -server libera #weechat
/join -noswitch #weechat
----
@@ -361,7 +361,7 @@ Examples:
channel: channel name
nick: nick
reason: reason (special variables $nick, $channel and $server are replaced by their value)
reason: reason (evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)
----
[[command_irc_kickban]]
@@ -372,7 +372,7 @@ channel: channel name
channel: channel name
nick: nick
reason: reason (special variables $nick, $channel and $server are replaced by their value)
reason: reason (evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)
It is possible to kick/ban with a mask, nick will be extracted from mask and replaced by "*".
@@ -402,7 +402,7 @@ server_mask: list of servers must match this mask
----
[[command_irc_list]]
* `+list+`: list channels and their topic
* `+list+`: list channels and their topics
----
/list [-server <server>] [-re <regex>] [<channel>[,<channel>...]] [<target>]
@@ -552,10 +552,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 freenode server:
/notify add toto freenode
notify when "toto" is away or back on freenode server:
/notify add toto freenode -away
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
----
[[command_irc_op]]
@@ -673,7 +673,7 @@ option: extra option, for some servers
channel: channel name
nick: nick
reason: reason (special variables $nick, $channel and $server are replaced by their value)
reason: reason (special variables $nick, $channel and $server are replaced by their values)
----
[[command_irc_restart]]
@@ -775,16 +775,16 @@ nooption: set boolean option to 'off' (for example: -nossl)
Examples:
/server listfull
/server add freenode chat.freenode.net
/server add freenode chat.freenode.net/6697 -ssl -autoconnect
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy freenode freenode-test
/server rename freenode-test freenode2
/server reorder freenode2 freenode
/server del freenode
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server deloutq
/server raw
/server raw s:freenode
/server raw s:libera
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
@@ -1341,41 +1341,45 @@ 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. an evaluated sub-string (format: "eval:xxx")
2. an evaluated condition (format: "eval_cond:xxx")
3. a string with escaped chars (format: "esc:xxx" or "\xxx")
4. a string with chars to hide (format: "hide:char,string")
5. a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
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")
or max chars displayed on screen (format: "cutscr:max,suffix,string" or "cutscr:+max,suffix,string")
6. a reversed string (format: "rev:xxx" or "revscr:xxx")
7. a repeated string (format: "repeat:count,string")
8. length of a string (format: "length:xxx" or "lengthscr:xxx")
9. a color (format: "color:xxx", see "Plugin API reference", function "color")
10. a modifier (format: "modifier:name,data,string")
11. an info (format: "info:name,arguments", arguments are optional)
12. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
13. current date/time (format: "date" or "date:format")
14. an environment variable (format: "env:XXX")
15. a ternary operator (format: "if:condition?value_if_true:value_if_false")
16. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
17. an option (format: "file.section.option")
18. a local variable in buffer
19. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
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.
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, for example:
hdata[list].var1.var2...: start with a hdata using a list/pointer/pointer name, 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.freenode_password} ==> secret
/eval -n ${sec.data.password} ==> secret
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
@@ -1392,6 +1396,7 @@ 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
@@ -1429,7 +1434,7 @@ addreplace: add or replace an existing 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.freenode.#weechat" or "irc.server.freenode")
- this is full name including plugin (example: "irc.libera.#weechat" or "irc.server.libera")
- "*" means all buffers
- a name starting with '!' is excluded
- wildcard "*" is allowed
@@ -1464,11 +1469,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.freenode.#weechat nick_toto *
/filter add toto irc.libera.#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.freenode.#weechat * weechat sucks
/filter add sucks irc.libera.#weechat * weechat sucks
filter lines that are strictly equal to "WeeChat sucks" on all buffers:
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -1670,7 +1675,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.freenode", "irc.freenode.#weechat")
name: full buffer name (examples: "irc.server.libera", "irc.libera.#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.
@@ -1681,7 +1686,7 @@ Examples:
message to current IRC channel:
/mute -current msg * hi!
message to #weechat channel:
/mute -buffer irc.freenode.#weechat msg #weechat hi!
/mute -buffer irc.libera.#weechat msg #weechat hi!
----
[[command_weechat_plugin]]
@@ -1749,7 +1754,7 @@ Examples:
display message on core buffer with prefix "abc":
/print -core abc\tThe message
display a message on channel #weechat:
/print -buffer irc.freenode.#weechat Message on #weechat
/print -buffer irc.libera.#weechat Message on #weechat
display a snowman (U+2603):
/print -escape \u2603
send alert (BEL):
@@ -1871,7 +1876,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_file to read the passphrase from a file (see /help sec.crypt.passphrase_file).
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).
Secured data with format ${sec.data.xxx} can be used in:
- command /eval
@@ -1882,14 +1887,16 @@ Secured data with format ${sec.data.xxx} can be used in:
Examples:
set a passphrase:
/secure passphrase this is my passphrase
encrypt freenode SASL password:
/secure set freenode mypassword
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
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 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 freenode nickserv ghost mynick ${sec.data.freenode}
/alias add ghost /eval /msg -server libera nickserv ghost mynick ${sec.data.libera}
----
[[command_weechat_set]]
@@ -1976,7 +1983,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 directory "~/.weechat".
It is possible to restore WeeChat session on another machine if you copy the content of WeeChat home directories (see /debug dirs).
----
[[command_weechat_uptime]]
@@ -2161,6 +2168,7 @@ 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[]
@@ -2267,14 +2275,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 in ~/.weechat/weechat_fifo
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).
The expected format is one of:
plugin.buffer *text or command here
*text or command here
For example to change your freenode nick:
echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo
For example to change your libera nick:
echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
Please read the user's guide for more info and examples.
@@ -2711,7 +2719,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); "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default), content is evaluated (see /help eval)
path: path used for relay (for UNIX domain socket only); path is evaluated (see function string_eval_path_home in plugin API reference)
raw: open buffer with raw Relay data
sslcertkey: set SSL certificate/key using path in option relay.network.ssl_cert_key
@@ -2730,10 +2738,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 "freenode":
/relay add irc.freenode 8000
irc proxy, for server "freenode", with SSL:
/relay add ssl.irc.freenode 8001
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 all servers (client will choose), with SSL:
/relay add ssl.irc 8002
weechat protocol:
@@ -2747,7 +2755,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 %h/relay_socket
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
----
// end::relay_commands[]
+112 -34
View File
@@ -16,8 +16,8 @@
** values: sha224, sha256, sha384, sha512
** default value: `+sha256+`
* [[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"]
* [[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"]
** type: string
** values: any string
** default value: `+""+`
@@ -846,6 +846,12 @@
** 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
@@ -1140,6 +1146,12 @@
** 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
@@ -1248,11 +1260,17 @@
** values: 1 .. 2147483647
** default value: `+60+`
* [[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)]
* [[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)]
** type: string
** values: any string
** default value: `+"/etc/ssl/certs/ca-certificates.crt"+`
** default value: `+""+`
* [[option_weechat.network.gnutls_handshake_timeout]] *weechat.network.gnutls_handshake_timeout*
** description: pass:none[timeout (in seconds) for gnutls handshake]
@@ -1285,10 +1303,10 @@
** default value: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
** description: pass:none[path for searching plugins ("%h" will be replaced by WeeChat home, "~/.weechat" by default)]
** description: pass:none[path for searching plugins (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+"%h/plugins"+`
** default value: `+"${weechat_data_dir}/plugins"+`
* [[option_weechat.plugin.save_config_on_unload]] *weechat.plugin.save_config_on_unload*
** description: pass:none[save configuration files when unloading plugins]
@@ -1296,14 +1314,44 @@
** 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 (note: content is evaluated, see /help eval)]
** 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)]
** 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 (note: content is evaluated, see /help eval)]
** 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)]
** type: string
** values: any string
** default value: `+""+`
@@ -1409,10 +1457,10 @@
** default value: `+""+`
* [[option_logger.file.path]] *logger.file.path*
** 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)]
** 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)]
** type: string
** values: any string
** default value: `+"%h/logs/"+`
** default value: `+"${weechat_data_dir}/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)]
@@ -1704,6 +1752,12 @@
** 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
@@ -1765,10 +1819,16 @@
** 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: content is evaluated, only the pointer to bar_item can be used, 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: 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}")]
** 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[]
@@ -1779,10 +1839,10 @@
** default value: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
** 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)]
** 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)]
** type: string
** values: any string
** default value: `+"%h/weechat_fifo"+`
** default value: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1853,7 +1913,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: "freenode.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: "libera.FlashCode,andrew"]
** type: string
** values: any string
** default value: `+""+`
@@ -1883,10 +1943,10 @@
** default value: `+on+`
* [[option_xfer.file.download_path]] *xfer.file.download_path*
** 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)]
** description: pass:none[path for writing incoming files (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+"%h/xfer"+`
** default value: `+"${weechat_data_dir}/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]
@@ -1895,7 +1955,7 @@
** default value: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
** 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)]
** description: pass:none[path for reading files when sending (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+"~"+`
@@ -2004,6 +2064,24 @@
** 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
@@ -2209,19 +2287,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 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"]
** 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"]
** 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 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"]
** 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"]
** 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 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"]
** 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"]
** type: string
** values: any string
** default value: `+"$nick"+`
@@ -2599,7 +2677,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 value) (note: content is 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 values) (note: commands are 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: `+""+`
@@ -2635,19 +2713,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}, ${channel} and ${server} are replaced by their value)]
** 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)]
** 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 value; "%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 values; "%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 value; "%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 values; "%v" is replaced by WeeChat version if there is no ${...} in string)]
** type: string
** values: any string
** default value: `+"WeeChat ${info:version}"+`
@@ -2695,15 +2773,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" ("%h" will be replaced by WeeChat home, "~/.weechat" by default)]
** 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)]
** 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, "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, "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)]
** type: integer
** values: plain, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** values: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** default value: `+plain+`
* [[option_irc.server_default.sasl_password]] *irc.server_default.sasl_password*
@@ -2737,7 +2815,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 ("%h" will be replaced by WeeChat home, "~/.weechat" by default)]
** 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)]
** type: string
** values: any string
** default value: `+""+`
@@ -2961,10 +3039,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)]
** 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)]
** type: string
** values: any string
** default value: `+"%h/ssl/relay.pem"+`
** default value: `+"${weechat_config_dir}/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")]
@@ -3267,7 +3345,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 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)]
** 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)]
** type: string
** values: any string
** default value: `+"%s %n %V %v %u | %d | %t"+`
@@ -3345,10 +3423,10 @@
** default value: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
** 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)]
** description: pass:none[local cache directory for scripts (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+"%h/script"+`
** default value: `+"${weechat_cache_dir}/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>_::
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).
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).
If this option is not given, the environment variable WEECHAT_HOME is used
(if not empty).
+26 -26
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@chat.freenode.net/#weechat
irc://mynick@irc.libera.chat/#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/.weechat/weechat.conf::
$HOME/.config/weechat/weechat.conf::
main WeeChat configuration file
$HOME/.weechat/plugins.conf::
$HOME/.config/weechat/plugins.conf::
plugins configuration file
$HOME/.weechat/sec.conf::
$HOME/.config/weechat/sec.conf::
configuration file with secured data
$HOME/.weechat/alias.conf::
$HOME/.config/weechat/alias.conf::
configuration file for _alias_ plugin
$HOME/.weechat/buflist.conf::
$HOME/.config/weechat/buflist.conf::
configuration file for _buflist_ plugin
$HOME/.weechat/charset.conf::
$HOME/.config/weechat/charset.conf::
configuration file for _charset_ plugin
$HOME/.weechat/exec.conf::
$HOME/.config/weechat/exec.conf::
configuration file for _exec_ plugin
$HOME/.weechat/fifo.conf::
$HOME/.config/weechat/fifo.conf::
configuration file for _fifo_ plugin
$HOME/.weechat/fset.conf::
$HOME/.config/weechat/fset.conf::
configuration file for _fset_ plugin
$HOME/.weechat/guile.conf::
$HOME/.config/weechat/guile.conf::
configuration file for _guile_ plugin
$HOME/.weechat/irc.conf::
$HOME/.config/weechat/irc.conf::
configuration file for _irc_ plugin
$HOME/.weechat/javascript.conf::
$HOME/.config/weechat/javascript.conf::
configuration file for _javascript_ plugin
$HOME/.weechat/logger.conf::
$HOME/.config/weechat/logger.conf::
configuration file for _logger_ plugin
$HOME/.weechat/lua.conf::
$HOME/.config/weechat/lua.conf::
configuration file for _lua_ plugin
$HOME/.weechat/perl.conf::
$HOME/.config/weechat/perl.conf::
configuration file for _perl_ plugin
$HOME/.weechat/php.conf::
$HOME/.config/weechat/php.conf::
configuration file for _php_ plugin
$HOME/.weechat/python.conf::
$HOME/.config/weechat/python.conf::
configuration file for _python_ plugin
$HOME/.weechat/relay.conf::
$HOME/.config/weechat/relay.conf::
configuration file for _relay_ plugin
$HOME/.weechat/ruby.conf::
$HOME/.config/weechat/ruby.conf::
configuration file for _ruby_ plugin
$HOME/.weechat/script.conf::
$HOME/.config/weechat/script.conf::
configuration file for _script_ plugin
$HOME/.weechat/spell.conf::
$HOME/.config/weechat/spell.conf::
configuration file for _spell_ plugin
$HOME/.weechat/tcl.conf::
$HOME/.config/weechat/tcl.conf::
configuration file for _tcl_ plugin
$HOME/.weechat/trigger.conf::
$HOME/.config/weechat/trigger.conf::
configuration file for _trigger_ plugin
$HOME/.weechat/xfer.conf::
$HOME/.config/weechat/xfer.conf::
configuration file for _xfer_ plugin
$HOME/.weechat/weechat.log::
$HOME/.local/share/weechat/weechat.log::
WeeChat log file
// end::files[]
+14 -15
View File
@@ -98,6 +98,7 @@ 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.
@@ -127,6 +128,7 @@ 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).
@@ -140,6 +142,7 @@ 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, ...).
@@ -394,13 +397,16 @@ 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.
@@ -420,6 +426,8 @@ 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.
@@ -1090,18 +1098,12 @@ 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 (to close a GitHub issue):
Format of commit message is the following (with automatic close of 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/_,
@@ -1114,20 +1116,17 @@ Some rules to follow:
* Use only English.
* Use infinitive form of verb.
* 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
* 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.
Examples of commit messages:
----
irc: add command /unquiet (closes #36)
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
core: update Japanese translations
irc: add command /unquiet (closes #36)
python: fix crash when unloading a script without pointer to interpreter
core: update Japanese translations (patch #7783)
ruby: add detection of ruby version 1.9.3 in CMake
----
[[translations]]
+33 -28
View File
@@ -727,7 +727,8 @@ 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.
You can then set the path to certificates in WeeChat:
With WeeChat ≤ 3.1, you can then set the path to system certificates:
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@@ -764,10 +765,11 @@ by your server name:
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
----
[[irc_ssl_freenode]]
=== How can I connect to freenode server using SSL?
[[irc_ssl_libera]]
=== How can I connect to libera server using SSL?
Set option _weechat.network.gnutls_ca_file_ to file with certificates:
With WeeChat ≤ 3.1, set option _weechat.network.gnutls_ca_file_ to file with
certificates:
----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
@@ -786,9 +788,9 @@ Check that you have this file on your system (commonly brought by package
Setup server port, SSL, then connect:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
/set irc.server.libera.addresses "irc.libera.chat/6697"
/set irc.server.libera.ssl on
/connect libera
----
[[irc_oauth]]
@@ -813,25 +815,25 @@ If the server supports SASL, you should use that instead of sending the
command for nickserv authentication, for example:
----
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
If the server does not support SASL, you can add a delay (between command and
join of channels):
----
/set irc.server.freenode.command_delay 5
/set irc.server.libera.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 "freenode" server:
for example for the "libera" server:
----
/set irc.server.freenode.autojoin [TAB]
/set irc.server.libera.autojoin [TAB]
----
[NOTE]
@@ -1002,16 +1004,16 @@ _buffer_autoset.py_ script:
----
For example, to permanently disable highlights from "mike" on #weechat
on the IRC server freenode:
on the IRC server libera:
----
/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera.#weechat hotlist_max_level_nicks_add mike:2
----
To apply it to the entire freenode server instead:
To apply it to the entire libera server instead:
----
/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera hotlist_max_level_nicks_add mike:2
----
For more examples, see `+/help buffer_autoset+`.
@@ -1047,15 +1049,17 @@ 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
(especially the option _weechat.network.gnutls_ca_file_).
First check questions about SSL connection in this FAQ.
If still not working, try to manually delete the scripts file (in your shell):
----
$ rm ~/.weechat/script/plugins.xml.gz
$ rm ~/.cache/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:
----
@@ -1075,7 +1079,7 @@ have to update manually the file yourself to get updates):
* in your shell, with curl installed:
----
$ cd ~/.weechat/script
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
----
@@ -1125,8 +1129,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 certificates if SSL is *NOT* used: set empty string in option
_weechat.network.gnutls_ca_file_.
* Do not load system certificates if SSL is *NOT* used: turn off this option:
_weechat.network.gnutls_ca_system_.
* 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_.
@@ -1182,16 +1186,16 @@ For example:
----
/secure passphrase xxxxxxxxxx
/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}"
/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}"
----
[[sharing_config_files]]
=== I want to share my WeeChat configuration, what files should I share and what should I keep private?
You can share files _~/.weechat/*.conf_ except the file _sec.conf_ which
You can share configuration files _*.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
@@ -1231,7 +1235,8 @@ $ 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?
The full list is on this page: https://weechat.org/download
WeeChat runs fine on most Linux/BSD distributions, GNU/Hurd, Mac OS and Windows
(Cygwin and Windows Subsystem for Linux).
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
+21 -28
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 freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
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_.
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_.
As usual, help is available if you're lost:
@@ -129,45 +129,38 @@ 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 freenode server with following command:
override them for the libera server with following command:
----
/set irc.server.freenode.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
/set irc.server.libera.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
----
To set the user and real names:
----
/set irc.server.freenode.username "My user name"
/set irc.server.freenode.realname "My real name"
/set irc.server.libera.username "My user name"
/set irc.server.libera.realname "My real name"
----
To enable auto-connect to server at startup:
----
/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
/set irc.server.libera.autoconnect 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.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.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.freenode.command "/msg nickserv identify xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -182,23 +175,23 @@ First setup a passphrase:
/secure passphrase this is my secret passphrase
----
Then add a secured data with your freenode password:
Then add a secured data with your libera password:
----
/secure set freenode_password xxxxxxx
/secure set libera_password xxxxxxx
----
Then you can use `+${sec.data.freenode_password}+` instead of your password in the
Then you can use `+${sec.data.libera_password}+` instead of your password in the
IRC options mentioned above, for example:
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
To auto-join some channels when connecting to server:
----
/set irc.server.freenode.autojoin "#channel1,#channel2"
/set irc.server.libera.autojoin "#channel1,#channel2"
----
[TIP]
@@ -210,24 +203,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.freenode.nicks
/unset irc.server.libera.nicks
----
Other options: you can setup other options with the following command ("xxx" is
option name):
----
/set irc.server.freenode.xxx value
/set irc.server.libera.xxx value
----
[[connect_to_irc_server]]
== Connect to IRC server
----
/connect freenode
/connect libera
----
With this command, WeeChat connects to the freenode server and auto-joins the
With this command, WeeChat connects to the libera 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.freenode'
full_name: 'irc.server.libera'
item 3:
__path: ['0x558d62a9cea0']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
----
* Request all lines of first buffer:
@@ -588,15 +588,15 @@ inf: ('version_number', '34144256')
* Request WeeChat directory:
----
(info_weechat_dir) info weechat_dir
(info_weechat_config_dir) info weechat_config_dir
----
Response:
[source,python]
----
id: 'info_weechat_dir'
inf: ('weechat_dir', '/home/xxx/.weechat')
id: 'info_weechat_config_dir'
inf: ('weechat_config_dir', '/home/user/.config/weechat')
----
[[command_infolist]]
@@ -747,7 +747,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.freenode.#weechat_)
_core.weechat_ or _irc.libera.#weechat_)
Examples:
@@ -856,10 +856,10 @@ hda:
prefix_color: None
----
* Request nicklist for buffer "irc.freenode.#weechat":
* Request nicklist for buffer "irc.libera.#weechat":
----
(nicklist_weechat) nicklist irc.freenode.#weechat
(nicklist_weechat) nicklist irc.libera.#weechat
----
Response:
@@ -948,7 +948,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.freenode.#weechat_)
_core.weechat_ or _irc.libera.#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.freenode.#weechat hello!
input irc.libera.#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.freenode.#weechat_)
_core.weechat_ or _irc.libera.#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.freenode.#weechat_); name "*" can be used to
_core.weechat_ or _irc.libera.#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.freenode.#weechat buffer
sync irc.libera.#weechat buffer
----
* Get general signals + all signals for #weechat channel:
----
sync * buffers,upgrade
sync irc.freenode.#weechat
sync irc.libera.#weechat
----
[[command_desync]]
@@ -1209,7 +1209,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.freenode.#weechat_); name "*" can be used to
_core.weechat_ or _irc.libera.#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.freenode.#weechat", then "desync *",
So if you send: "sync *", then "sync irc.libera.#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.freenode.#weechat nicklist
desync irc.libera.#weechat nicklist
----
* Desynchronize #weechat channel:
----
desync irc.freenode.#weechat
desync irc.libera.#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.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#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 freenode, new buffer
_irc.freenode.#weechat_:
Example: channel _#weechat_ joined on libera, new buffer
_irc.libera.#weechat_:
[source,python]
----
@@ -1511,13 +1511,13 @@ hda:
item 1:
__path: ['0x35a8a60']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
short_name: None
nicklist: 0
title: None
local_variables: {
'plugin': 'irc',
'name': 'freenode.#weechat',
'name': 'libera.#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.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.freenode.#weechat_ moved to number 2:
Example: buffer _irc.libera.#weechat_ moved to number 2:
[source,python]
----
@@ -1556,7 +1556,7 @@ hda:
item 1:
__path: ['0x34588c0']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.freenode.#weechat_ merged with buffer #2:
Example: buffer _irc.libera.#weechat_ merged with buffer #2:
[source,python]
----
@@ -1594,7 +1594,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.freenode.#weechat_ unmerged:
Example: buffer _irc.libera.#weechat_ unmerged:
[source,python]
----
@@ -1632,7 +1632,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.freenode.#weechat_ hidden:
Example: buffer _irc.libera.#weechat_ hidden:
[source,python]
----
@@ -1672,7 +1672,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.freenode.#weechat_ unhidden:
Example: buffer _irc.libera.#weechat_ unhidden:
[source,python]
----
@@ -1712,7 +1712,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#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.freenode.Flash2'
full_name: 'irc.libera.Flash2'
short_name: 'Flash2'
local_variables: {
'server': 'freenode',
'server': 'libera',
'plugin': 'irc',
'type': 'private',
'channel': 'FlashCode',
'nick': 'test',
'name': 'freenode.Flash2',
'name': 'libera.Flash2',
}
----
@@ -1774,7 +1774,7 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| title | string | Buffer title.
|===
@@ -1793,7 +1793,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
|===
Example: buffer _irc.freenode.#weechat_ has been cleared:
Example: buffer _irc.libera.#weechat_ has been cleared:
[source,python]
----
@@ -1828,7 +1828,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#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.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| local_variables | hashtable | Local variables.
|===
Example: local variable _test_ added in buffer _irc.freenode.#weechat_:
Example: local variable _test_ added in buffer _irc.libera.#weechat_:
[source,python]
----
@@ -1898,15 +1898,15 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
local_variables: {
'server': 'freenode',
'server': 'libera',
'test': 'value',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -1922,11 +1922,11 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| local_variables | hashtable | Local variables.
|===
Example: local variable _test_ updated in buffer _irc.freenode.#weechat_:
Example: local variable _test_ updated in buffer _irc.libera.#weechat_:
[source,python]
----
@@ -1941,7 +1941,7 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
local_variables: {
'server': 'local',
'test': 'value2',
@@ -1949,7 +1949,7 @@ hda:
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -1965,11 +1965,11 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| local_variables | hashtable | Local variables.
|===
Example: local variable _test_ removed from buffer _irc.freenode.#weechat_:
Example: local variable _test_ removed from buffer _irc.libera.#weechat_:
[source,python]
----
@@ -1984,14 +1984,14 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#prout'
full_name: 'irc.libera.#prout'
local_variables: {
'server': 'local',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -2017,7 +2017,7 @@ Data sent as hdata:
| message | string | Message.
|===
Example: new message _hello!_ from nick _FlashCode_ on buffer _irc.freenode.#weechat_:
Example: new message _hello!_ from nick _FlashCode_ on buffer _irc.libera.#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.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
|===
Example: buffer _irc.freenode.#weechat_ is being closed by WeeChat:
Example: buffer _irc.libera.#weechat_ is being closed by WeeChat:
[source,python]
----
@@ -2083,7 +2083,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_:
Example: nicklist for buffer _irc.libera.#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 freenode server) and two
Example of hdata with two buffers (weechat core and libera 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.freenode
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴─────────────────────
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └─────────────────────────────────
┌────────┬──────────────────────────┬───╥─────────┬───┬──────────────╥─────────┬───┬───────────────────┐
│ buffer │ number:int,full_name:str │ 2 ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │ irc.server.libera
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴───────────────────┘
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └───────────────────────────────┘
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 freenode server):
Example of infolist with two buffers (weechat core and libera server):
....
# command
+90 -66
View File
@@ -66,12 +66,17 @@ 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`.
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].
[[python_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...)+`.
@@ -79,6 +84,7 @@ 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
@@ -132,18 +138,23 @@ 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, ...)+`.
@@ -168,20 +179,26 @@ 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 ...)+`.
@@ -194,14 +211,18 @@ 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, ...);+`.
@@ -212,11 +233,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:
Prototype (Python):
[source,python]
----
weechat.register(name, author, version, license, description, shutdown_function, charset)
def register(name: str, author: str, version: str, license: str, description: str, shutdown_function: str, charset: str) -> int: ...
----
Arguments:
@@ -337,7 +358,7 @@ WeeChat is starting.
For example with Python:
----
$ cd ~/.weechat/python/autoload
$ cd ~/.local/share/weechat/python/autoload
$ ln -s ../script.py
----
@@ -776,58 +797,58 @@ List of constants in script API:
| Category | Constants
| return codes |
WEECHAT_RC_OK +
WEECHAT_RC_OK_EAT +
WEECHAT_RC_ERROR
`WEECHAT_RC_OK` (integer) +
`WEECHAT_RC_OK_EAT` (integer) +
`WEECHAT_RC_ERROR` (integer)
| configuration files |
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
`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)
| sorted lists |
WEECHAT_LIST_POS_SORT +
WEECHAT_LIST_POS_BEGINNING +
WEECHAT_LIST_POS_END
`WEECHAT_LIST_POS_SORT` (string) +
`WEECHAT_LIST_POS_BEGINNING` (string) +
`WEECHAT_LIST_POS_END` (string)
| hotlist |
WEECHAT_HOTLIST_LOW +
WEECHAT_HOTLIST_MESSAGE +
WEECHAT_HOTLIST_PRIVATE +
WEECHAT_HOTLIST_HIGHLIGHT
`WEECHAT_HOTLIST_LOW` (string) +
`WEECHAT_HOTLIST_MESSAGE` (string) +
`WEECHAT_HOTLIST_PRIVATE` (string) +
`WEECHAT_HOTLIST_HIGHLIGHT` (string)
| hook process |
WEECHAT_HOOK_PROCESS_RUNNING +
WEECHAT_HOOK_PROCESS_ERROR
`WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
`WEECHAT_HOOK_PROCESS_ERROR` (integer)
| hook connect |
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
`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)
| hook signal |
WEECHAT_HOOK_SIGNAL_STRING +
WEECHAT_HOOK_SIGNAL_INT +
WEECHAT_HOOK_SIGNAL_POINTER
`WEECHAT_HOOK_SIGNAL_STRING` (string) +
`WEECHAT_HOOK_SIGNAL_INT` (string) +
`WEECHAT_HOOK_SIGNAL_POINTER` (string)
|===
[[common_tasks]]
@@ -868,13 +889,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.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
# (full name of buffer is plugin.name, for example: "irc.libera.#weechat")
buffer = weechat.buffer_search("irc", "libera.#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", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.prnt(buffer, "message on #weechat channel")
----
@@ -895,7 +916,7 @@ Examples:
weechat.command("", "/help")
# send "hello" to #weechat IRC channel (users on channel will see message)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.command(buffer, "hello")
----
@@ -1196,7 +1217,7 @@ xxx,irc_raw_in2_yyy::
[source,python]
----
def join_cb(data, signal, signal_data):
# signal is for example: "freenode,irc_in2_join"
# signal is for example: "libera,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})
@@ -1248,63 +1269,66 @@ 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="1,^2,10,8",options="header"]
[width="100%",cols="3,^2,10,7",options="header"]
|===
| Key | WeeChat version | Description | Example
| Key | Since WeeChat ^(1)^ | 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(
@@ -1365,8 +1389,8 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[source,python]
----
# WeeChat home directory, for example: "/home/xxxx/.weechat"
weechat.prnt("", "WeeChat home dir: %s" % weechat.info_get("weechat_dir", ""))
# WeeChat config directory, for example: "/home/user/.config/weechat"
weechat.prnt("", "WeeChat config dir: %s" % weechat.info_get("weechat_config_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 _chat.freenode.net_ and tell us.
your beer) don't hesitate to join _#weechat_ at _irc.libera.chat_ 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
+103 -141
View File
@@ -1,4 +1,4 @@
= WeeChat Quick Start Guide
= WeeChat guía rápida
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: es
@@ -7,57 +7,54 @@
:docinfo1:
// TRANSLATION MISSING
Translators:
Traductores:
* Lázaro A. <uranio-235@myopera.com>, 2012
* Victorhck <victorhck@mailbox.org>, 2021
[[start]]
== Iniciar WeeChat
Es recomendable una terminal emulada para X (pero no indispensable)
Es recomendable un emulador de terminal para X (pero no indispensable)
rxvt-unicode: tiene un buen soporte para UTF-8, y no da problemas con
los atajas de teclados predeterminados.
los atajos de teclado predeterminados.
// TRANSLATION MISSING
Run from your shell:
Ejecuta desde una consola:
----
$ weechat
----
[[help]]
== Ayuda en linea
== Ayuda en línea
WeeChat tiene ayuda para todos los comandos, solo teclee:
WeeChat tiene ayuda para todos los comandos, simplemente escriba:
----
/help
----
Para obtener ayuda específicamente de un comando, teclee:
Para obtener ayuda específica de un comando, escriba:
----
/help comando
----
// TRANSLATION MISSING
Help is available for options as well:
También hay ayuda disponible para las opciones:
----
/help config.section.option
----
(donde `config` es el nombre de la configuración del núcleo o del
plugin que desea configurar, `section`, la sección de esa configuración
complemento que desea configurar, `section`, la sección de esa configuración
y `option` el nombre de la opción).
// TRANSLATION MISSING
[[options]]
== Set options
== Configurar las opciones
Para configurar una opción, use:
Para configurar una opción, utilice:
----
/set config.section.option valor
@@ -66,75 +63,66 @@ Para configurar una opción, use:
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 salvarán de manera automática cuando cierre
WeeChat o usando el comando `/save` para forzar la forzar a WeeChat a
Todas las opciones se guardarán de manera automática cuando cierre
WeeChat o usando el comando `/save` para forzar a WeeChat a
guardar todos los archivos de configuración.
// TRANSLATION MISSING
[IMPORTANT]
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.
*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.
// TRANSLATION MISSING
The plugin _fset_ allows you to easily browse options and change them.
El complemento _fset_ le permite navegar fácilmente por las opciones y cambiarlas.
// TRANSLATION MISSING
For example to display WeeChat options:
Por ejemplo para mostrar las opciones de WeeChat:
----
/fset weechat.*
----
// TRANSLATION MISSING
IRC options:
Opciones de IRC:
----
/fset irc.*
----
// 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.
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
For more information about `/fset` command and keys, see `/help fset`.
Para más información sobre el comando `/fset` y las teclas, vea `/help fset`.
[[core_vs_plugins]]
== Núcleo vs Plugins
== Núcleo vs Complementos
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 plugins. (para los
único que hace el núcleo de WeeChat sin no tiene complementos. (para los
fieles seguidores: IRC fue parte del núcleo para las versiones ≤
0.2.6).
Todos los protocolos de red como IRC, provienen en plugins separados.
Todos los protocolos de red como IRC, provienen de complementos separados.
Use el comando `/plugin` para ver una lista de los plugins cargados,
Use el comando `/plugin` para ver una lista de los complementos cargados,
seguramente vera irc y otros.
// TRANSLATION MISSING
[[add_irc_server]]
== Add an IRC server
== Añadir un servidor IRC
// TRANSLATION MISSING
You can add an IRC server with `/server` command, for example:
Puede añadir un servidor IRC mediante el comando `/server`, por ejemplo:
----
/server add freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
// 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_.
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_.
La ayuda está disponible; si te pierdes:
Si se encuentra perdido, puede consultar la ayuda disponible:
----
/help server
@@ -143,9 +131,9 @@ La ayuda está disponible; si te pierdes:
[[irc_server_options]]
== Personalizar las opciones de un servidor IRC
WeeChat usa las opciones por defecto para todos los servidores
WeeChat usa las opciones predeterminadas para todos los servidores
("predeterminado") si no le especifica un valor individual a un servidor
en específico. Esas opciones por defectos son las que se muestran en
en específico. Esas opciones predeterminadas son las que se muestran en
"irc.server_default.*"
Para cada opción de "server", WeeChat usa estos valores previamente
@@ -153,123 +141,105 @@ 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 freenode
usted puedes sobreescribirlo para el servidor identificado como libera
de la siguiente manera:
----
/set irc.server.freenode.nicks "nick,nick2,nick3,nick4,nick5"
/set irc.server.libera.nicks "nick,nick2,nick3,nick4,nick5"
----
También para configurar el nombre de usuario y el nombre real:
----
/set irc.server.freenode.username "Mi nombre de usuario"
/set irc.server.freenode.realname "Mi nombre real"
/set irc.server.libera.username "Mi nombre de usuario"
/set irc.server.libera.realname "Mi nombre real"
----
Para que el servidor se conecte cuando WeeChat inicie:
----
/set irc.server.freenode.autoconnect on
/set irc.server.libera.autoconnect on
----
// TRANSLATION MISSING
To connect with SSL:
Si la opción SASL está disponible en el servidor, puede utilizarla para autentificarse (será
identificado o identificada antes de unirse a los canales):
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/set irc.server.libera.sasl_username "nick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
// TRANSLATION MISSING
If SASL is available on server, you can use it for authentication (you will be
identified before you join channels):
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):
----
/set irc.server.freenode.sasl_username "nick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify 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]
Many commands in option _command_ can be separated by `;` (semi-colon).
Muchos comandos en la opción _command_ pueden ser separados por `;` (punto y coma).
// TRANSLATION MISSING
If you want to protect your password in configuration files, you can use
secured data.
Si quiere proteger su contraseña en los archivos de configuración, puede utilizar
una securización de los datos.
// TRANSLATION MISSING
First setup a passphrase:
Primero configure una frase de contraseña
----
/secure passphrase this is my secret passphrase
----
// TRANSLATION MISSING
Then add a secured data with your freenode password:
Después añada un dato securizado con su contraseña de libera:
----
/secure set freenode_password xxxxxxx
/secure set libera_password xxxxxxx
----
// TRANSLATION MISSING
Then you can use `+${sec.data.freenode_password}+` instead of your password in
IRC options mentioned above, for example:
Después puede utilizar `+${sec.data.libera_password}+` en vez de su contraseña en
las opciones de IRC mencionadas anteriormente, por ejemplo:
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
Para unirse automáticamente a canales cuando el servidor se conecte:
----
/set irc.server.freenode.autojoin "#uncanal,#otrocanal"
/set irc.server.libera.autojoin "#uncanal,#otrocanal"
----
// TRANSLATION MISSING
[TIP]
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).
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).
Para eliminar un valor asignado a una opción de servidor y usar los
valores por defecto en su lugar, por ejemplo, usar el nick por defecto
valores predeterminados en su lugar, por ejemplo, usar el nick predeterminado
(irc.server_default.nicks):
----
/unset irc.server.freenode.nicks
/unset irc.server.libera.nicks
----
Otras opciones: pude configurar otras opciones con el siguiente comando,
Otras opciones: puede configurar otras opciones con el siguiente comando,
donde "xxx" es el nombre de la opción.
----
/set irc.server.freenode.xxx valor
/set irc.server.libera.xxx valor
----
[[connect_to_irc_server]]
== Conectarse a un servidor IRC
----
/connect freenode
/connect libera
----
// TRANSLATION MISSING
With this command, WeeChat connects to the freenode server and auto-joins the
channels configured in the "autojoin" server option.
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
[NOTE]
Este comando también puede usarse para crear y conectarse a un nuevo
servidor sin usar el comando `/server` (see `/help connect`).
servidor sin usar el comando `/server` (vea `/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
@@ -297,36 +267,32 @@ Sale de un canal (mantiene el buffer abierto):
/part [mensaje de partida]
----
// TRANSLATION MISSING
Close a server, channel or private buffer (`/close` is an alias for
Cierra un servidor, canal o buffer privado (`/close` es un alias para
`/buffer close`):
----
/close
----
// TRANSLATION MISSING
[WARNING]
Closing the server buffer will close all channel/private buffers.
Al cerrar el buffer del servidor cerrará todos los buffer de canales/privados
// TRANSLATION MISSING
Disconnect from server, on the server buffer:
Para desconectar del servidor, en el buffer del servidor ejecute:
----
/disconnect
----
// TRANSLATION MISSING
[[irc_private_messages]]
== IRC private messages
== Mensajes privados en IRC
Open a buffer and send a message to another user (nick _foo_):
Abre un buffer y envíe un mensaje a otra persona (nick _foo_):
----
/query foo this is a message
/query foo esto es un mensaje
----
Close the private buffer:
Cierra el buffer privado:
----
/close
@@ -335,11 +301,11 @@ Close the private buffer:
[[buffer_window]]
== Manipulando buffer/ventana
Un buffer, es un componente vinculado a un plugin con un número, una
Un buffer, es un componente vinculado a un complemento 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. Por defecto, una sola ventana
Una ventana es una vista de un buffer. De manera predeterminada, una sola ventana
muestra un solo buffer. Si divide la pantalla, podrá ver muchas
ventanas conteniendo varios buffer al mismo tiempo.
@@ -357,8 +323,7 @@ junto a otras mas grande (2/3) use el comando
/window splitv 33
----
// TRANSLATION MISSING
To remove the split:
Para eliminar esa división:
----
/window merge
@@ -367,19 +332,19 @@ To remove the split:
[[key_bindings]]
== Atajos de teclado
WeeChat usa muchas teclas por defecto. Las mismas, están bien
WeeChat usa muchas teclas por defecto. Éstas, 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]: Cambiara al buffer
- kbd:[Alt+←] / kbd:[Alt+→] o kbd:[F5] / kbd:[F6]: Cambiará al buffer
siguiente/anterior
// TRANSLATION MISSING
- kbd:[F1] / kbd:[F2]: scroll bar with list of buffers ("buflist")
- kbd:[F7] / kbd:[F8]: Cambiara a la siguiente/anterior ventana (cuando la pantalla
- 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
este dividida)
- 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:[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:[PgUp] / kbd:[PgDn]: desplazamiento del texto en el buffer
- kbd:[Alt+a]: salta al siguiente buffer con actividad reciente
@@ -391,10 +356,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 se vera mas o menos así:
El comando tendrá un aspecto similar a esto:
----
/key bind meta-! /buffer close
@@ -407,28 +372,25 @@ Para eliminar una combinación:
----
[[plugins_scripts]]
== Plugins/scripts
== Complementos/scripts
En algunas distribuciones como Debian, los plugins están disponibles en
En algunas distribuciones como Debian, los complementos están disponibles en
un paquete separado (como weechat-plugin).
Los plugins se cargan de manera automática cuando son encontrados por WeeChat
Los complementos 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
plugins y scripts).
complementos y scripts).
// 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:
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:
----
/script install go.py
----
// TRANSLATION MISSING
See `/help script` for more info.
Vea `/help script` para obtener más información.
// TRANSLATION MISSING
A list of scripts is available in WeeChat with `/script` or at this URL:
Hay una lista de scripts disponibles en WeeChat mediante el comando `/script` o en este enlace:
https://weechat.org/scripts
[[more_doc]]
@@ -437,4 +399,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!
@@ -233,6 +233,10 @@ _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) +
+15 -3
View File
@@ -20,6 +20,8 @@
| 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
@@ -58,7 +60,7 @@
| php | php_version | version de l'interpréteur utilisé | -
| python | python2_bin | chemin vers l'interpréteur python 2.x | -
| 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 | python_eval | évaluation de code source | code source à exécuter
@@ -74,7 +76,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.freenode.#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.libera.#weechat")
| tcl | tcl_eval | évaluation de code source | code source à exécuter
@@ -132,7 +134,15 @@
| weechat | version_number | version de WeeChat (sous forme de nombre) | -
| weechat | weechat_dir | répertoire de WeeChat | -
| 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_headless | 1 si WeeChat tourne sans interface | -
@@ -140,6 +150,8 @@
| 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,5 +14,7 @@
| 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[]
+71 -63
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 freenode
/connect libera
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
@@ -301,10 +301,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 freenode :
/ignore add toto@domain.com freenode
ignorer le hôte "toto*@*.domain.com" sur freenode/#weechat :
/ignore add toto*@*.domain.com freenode #weechat
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
----
[[command_irc_info]]
@@ -349,7 +349,7 @@ pseudo : pseudo
Exemples :
/join #weechat
/join #protectedchan,#weechat key
/join -server freenode #weechat
/join -server libera #weechat
/join -noswitch #weechat
----
@@ -361,7 +361,7 @@ Exemples :
canal : nom du canal
pseudo : pseudo
raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leur valeur)
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)
----
[[command_irc_kickban]]
@@ -372,7 +372,7 @@ raison : raison (les variables spéciales $nick, $channel et $server sont rempl
canal : nom du canal
pseudo : pseudo
raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leur valeur)
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)
Il est possible d'éjecter/bannir avec un masque, le pseudo sera extrait du masque et remplacé par "*".
@@ -402,7 +402,7 @@ masque_serveur : liste des serveurs correspondant au masque
----
[[command_irc_list]]
* `+list+`: lister les canaux et leur titre
* `+list+`: lister les canaux et leurs titres
----
/list [-server <serveur>] [-re <regex>] [<canal>[,<canal>...]] [<cible>]
@@ -552,10 +552,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 freenode :
/notify add toto freenode
notifier quand "toto" est absent ou de retour sur le serveur freenode :
/notify add toto freenode -away
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
----
[[command_irc_op]]
@@ -673,7 +673,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 leur valeur)
raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leurs valeurs)
----
[[command_irc_restart]]
@@ -775,16 +775,16 @@ nom_machine : nom ou adresse IP du serveur avec port en option (défaut : 6667
Exemples :
/server listfull
/server add freenode chat.freenode.net
/server add freenode chat.freenode.net/6697 -ssl -autoconnect
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy freenode freenode-test
/server rename freenode-test freenode2
/server reorder freenode2 freenode
/server del freenode
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server deloutq
/server raw
/server raw s:freenode
/server raw s:libera
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
@@ -1341,41 +1341,45 @@ 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. une sous-chaîne évaluée (format : "eval:xxx")
2. une condition évaluée (format : "eval_cond:xxx")
3. une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx")
4. une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne")
5. une chaîne avec un maximum de caractères (format : "cut:max,suffixe,chaîne" ou "cut:+max,suffixe,chaîne")
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")
ou un maximum de caractères affichés à l'écran (format : "cutscr:max,suffixe,chaîne" ou "cutscr:+max,suffixe,chaîne")
6. une chaîne inversée (format : "rev:xxx" ou "revscr:xxx")
7. une chaîne répétée (format : "repeat:nombre,chaîne")
8. longueur d'une chaîne (format : "length:xxx" ou "lengthscr:xxx")
9. une couleur (format : "color:xxx", voir la "Référence API extension", fonction "color")
10. un modificateur (format : "modifier:nom,données,chaîne")
11. une info (format : "info:nom,paramètres", les paramètres sont optionnels)
12. une chaîne encodée/decodée en base 16, 32 ou 64 (format : "base_encode:base,xxx" ou "base_decode:base,xxx")
13. la date/heure courante (format : "date" ou "date:format")
14. une variable d'environnement (format : "env:XXX")
15. un opérateur ternaire (format : "if:condition?valeur_si_vrai:valeur_si_faux")
16. le résultat d'une expression avec parenthèses et les opérateurs + - * / // % ** (format: "calc:xxx")
17. une option (format : "fichier.section.option")
18. une variable locale du tampon
19. 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.
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.
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, par exemple :
hdata[liste].var1.var2... : démarrer avec un hdata en utilisant une liste/pointeur/nom de pointeur, 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.freenode_password} ==> secret
/eval -n ${sec.data.password} ==> secret
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
@@ -1392,6 +1396,7 @@ 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
@@ -1429,7 +1434,7 @@ addreplace : ajouter ou remplacer un filtre existant
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.freenode.#weechat" ou "irc.server.freenode")
- il s'agit du nom complet incluant l'extension (exemple : "irc.libera.#weechat" ou "irc.server.libera")
- "*" signifie tous les tampons
- un nom commençant par '!' est exclu
- le caractère joker "*" est autorisé
@@ -1464,11 +1469,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.freenode.#weechat nick_toto *
/filter add toto irc.libera.#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.freenode.#weechat * weechat sucks
/filter add sucks irc.libera.#weechat * weechat sucks
filtrer les lignes qui sont strictement égales à "WeeChat sucks" sur tous les tampons :
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -1670,7 +1675,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.freenode", "irc.freenode.#weechat")
nom : nom complet du tampon (exemples : "irc.server.libera", "irc.libera.#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.
@@ -1681,7 +1686,7 @@ Exemples :
message au canal IRC courant :
/mute -current msg * bonjour !
message au canal #weechat :
/mute -buffer irc.freenode.#weechat msg #weechat bonjour !
/mute -buffer irc.libera.#weechat msg #weechat bonjour !
----
[[command_weechat_plugin]]
@@ -1749,7 +1754,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.freenode.#weechat Message sur #weechat
/print -buffer irc.libera.#weechat Message sur #weechat
afficher un bonhomme de neige (U+2603) :
/print -escape \u2603
envoyer une alerte (BEL) :
@@ -1871,7 +1876,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_file pour lire la phrase de chiffrement depuis un fichier (voir /help sec.crypt.passphrase_file).
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).
Les données sécurisées avec le format ${sec.data.xxx} peuvent être utilisées dans :
- la commande /eval
@@ -1882,14 +1887,16 @@ 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
chiffrer le mot de passe freenode SASL :
/secure set freenode motdepasse
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
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 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 freenode nickserv ghost pseudo ${sec.data.freenode}
/alias add ghost /eval /msg -server libera nickserv ghost pseudo ${sec.data.libera}
----
[[command_weechat_set]]
@@ -1976,7 +1983,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 du répertoire "~/.weechat".
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).
----
[[command_weechat_uptime]]
@@ -2161,6 +2168,7 @@ 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[]
@@ -2267,14 +2275,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 est dans ~/.weechat/weechat_fifo
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).
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 freenode :
echo 'irc.server.freenode */nick autrepseudo' >~/.weechat/weechat_fifo
Par exemple pour changer votre pseudo sur libera :
echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345
Merci de lire le guide utilisateur pour plus d'information et des exemples.
@@ -2711,7 +2719,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) ; "%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)
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)
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
@@ -2730,10 +2738,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 "freenode" :
/relay add irc.freenode 8000
proxy irc, pour le serveur "freenode", avec SSL :
/relay add ssl.irc.freenode 8001
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 tous les serveurs (le client choisira), avec SSL :
/relay add ssl.irc 8002
protocole weechat :
@@ -2747,7 +2755,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 %h/relay_socket
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
----
// end::relay_commands[]
+109 -31
View File
@@ -16,8 +16,8 @@
** valeurs: sha224, sha256, sha384, sha512
** valeur par défaut: `+sha256+`
* [[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"]
* [[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"]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -846,6 +846,12 @@
** 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
@@ -1140,6 +1146,12 @@
** 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
@@ -1248,11 +1260,17 @@
** valeurs: 1 .. 2147483647
** valeur par défaut: `+60+`
* [[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")]
* [[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)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"/etc/ssl/certs/ca-certificates.crt"+`
** valeur par défaut: `+""+`
* [[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]
@@ -1285,10 +1303,10 @@
** valeur par défaut: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
** description: pass:none[chemin de recherche des extensions ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")]
** 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)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%h/plugins"+`
** valeur par défaut: `+"${weechat_data_dir}/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]
@@ -1296,14 +1314,44 @@
** 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 (note : le contenu est évalué, voir /help eval)]
** 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)]
** 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 (note : le contenu est évalué, voir /help eval)]
** 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)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -1409,10 +1457,10 @@
** valeur par défaut: `+""+`
* [[option_logger.file.path]] *logger.file.path*
** 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)]
** 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)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%h/logs/"+`
** valeur par défaut: `+"${weechat_data_dir}/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)]
@@ -1704,6 +1752,12 @@
** 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
@@ -1765,10 +1819,16 @@
** 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é, seul le pointeur vers bar_item peut être utilisé, 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é, 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}")]
** 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[]
@@ -1779,10 +1839,10 @@
** valeur par défaut: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
** 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)]
** 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)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%h/weechat_fifo"+`
** valeur par défaut: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1853,7 +1913,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 : "freenode.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 : "libera.FlashCode,andrew"]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -1883,10 +1943,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 : "%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)]
** 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)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%h/xfer"+`
** valeur par défaut: `+"${weechat_data_dir}/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]
@@ -1895,7 +1955,7 @@
** valeur par défaut: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
** 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)]
** 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)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"~"+`
@@ -2004,6 +2064,24 @@
** 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
@@ -2599,7 +2677,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 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)]
** 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)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -2635,19 +2713,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}, ${channel} et ${server} sont remplacées par leur valeur)]
** 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)]
** 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 valeur ; "%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 valeurs ; "%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 leur valeur ; "%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 leurs valeurs ; "%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}"+`
@@ -2695,15 +2773,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" ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")]
** 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)]
** 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, "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, "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é)]
** type: entier
** valeurs: plain, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** valeurs: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** valeur par défaut: `+plain+`
* [[option_irc.server_default.sasl_password]] *irc.server_default.sasl_password*
@@ -2737,7 +2815,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 ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")]
** 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)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -2961,10 +3039,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)]
** 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)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%h/ssl/relay.pem"+`
** valeur par défaut: `+"${weechat_config_dir}/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")]
@@ -3267,7 +3345,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 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]
** 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]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%s %n %V %v %u | %d | %t"+`
@@ -3345,10 +3423,10 @@
** valeur par défaut: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
** 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)]
** 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)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%h/script"+`
** valeur par défaut: `+"${weechat_cache_dir}/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>_::
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).
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).
Si cette option n'est pas donnée, la variable d'environnement WEECHAT_HOME
est utilisée (si non vide).
+26 -26
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@chat.freenode.net/#weechat
irc://monpseudo@irc.libera.chat/#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/.weechat/weechat.conf::
$HOME/.config/weechat/weechat.conf::
fichier de configuration principal de WeeChat
$HOME/.weechat/plugins.conf::
$HOME/.config/weechat/plugins.conf::
fichier de configuration des extensions
$HOME/.weechat/sec.conf::
$HOME/.config/weechat/sec.conf::
fichier de configuration avec les données sécurisées
$HOME/.weechat/alias.conf::
$HOME/.config/weechat/alias.conf::
fichier de configuration pour l'extension _alias_
$HOME/.weechat/buflist.conf::
$HOME/.config/weechat/buflist.conf::
fichier de configuration pour l'extension _buflist_
$HOME/.weechat/charset.conf::
$HOME/.config/weechat/charset.conf::
fichier de configuration pour l'extension _charset_
$HOME/.weechat/exec.conf::
$HOME/.config/weechat/exec.conf::
fichier de configuration pour l'extension _exec_
$HOME/.weechat/fifo.conf::
$HOME/.config/weechat/fifo.conf::
fichier de configuration pour l'extension _fifo_
$HOME/.weechat/fset.conf::
$HOME/.config/weechat/fset.conf::
fichier de configuration pour l'extension _fset_
$HOME/.weechat/guile.conf::
$HOME/.config/weechat/guile.conf::
fichier de configuration pour l'extension _guile_
$HOME/.weechat/irc.conf::
$HOME/.config/weechat/irc.conf::
fichier de configuration pour l'extension _irc_
$HOME/.weechat/javascript.conf::
$HOME/.config/weechat/javascript.conf::
fichier de configuration pour l'extension _javascript_
$HOME/.weechat/logger.conf::
$HOME/.config/weechat/logger.conf::
fichier de configuration pour l'extension _logger_
$HOME/.weechat/lua.conf::
$HOME/.config/weechat/lua.conf::
fichier de configuration pour l'extension _lua_
$HOME/.weechat/perl.conf::
$HOME/.config/weechat/perl.conf::
fichier de configuration pour l'extension _perl_
$HOME/.weechat/php.conf::
$HOME/.config/weechat/php.conf::
fichier de configuration pour l'extension _php_
$HOME/.weechat/python.conf::
$HOME/.config/weechat/python.conf::
fichier de configuration pour l'extension _python_
$HOME/.weechat/relay.conf::
$HOME/.config/weechat/relay.conf::
fichier de configuration pour l'extension _relay_
$HOME/.weechat/ruby.conf::
$HOME/.config/weechat/ruby.conf::
fichier de configuration pour l'extension _ruby_
$HOME/.weechat/script.conf::
$HOME/.config/weechat/script.conf::
fichier de configuration pour l'extension _script_
$HOME/.weechat/spell.conf::
$HOME/.config/weechat/spell.conf::
fichier de configuration pour l'extension _spell_
$HOME/.weechat/tcl.conf::
$HOME/.config/weechat/tcl.conf::
fichier de configuration pour l'extension _tcl_
$HOME/.weechat/trigger.conf::
$HOME/.config/weechat/trigger.conf::
fichier de configuration pour l'extension _trigger_
$HOME/.weechat/xfer.conf::
$HOME/.config/weechat/xfer.conf::
fichier de configuration pour l'extension _xfer_
$HOME/.weechat/weechat.log::
$HOME/.local/share/weechat/weechat.log::
fichier de log de WeeChat
// end::files[]
+15 -15
View File
@@ -100,6 +100,7 @@ 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.
@@ -129,6 +130,7 @@ 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).
@@ -142,6 +144,7 @@ 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, ...).
@@ -396,13 +399,16 @@ 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.
@@ -422,6 +428,8 @@ 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.
|===
@@ -1108,18 +1116,13 @@ 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 (pour fermer un bug GitHub) :
Le format du message de commit est le suivant (avec fermeture automatique
du 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/_
@@ -1132,20 +1135,17 @@ Quelques règles à suivre :
* Utilisez seulement l'anglais.
* Utilisez des verbes à l'infinitif.
* 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
* 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.
Exemples de messages de commit :
----
irc: add command /unquiet (closes #36)
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
core: update Japanese translations
irc: add command /unquiet (closes #36)
python: fix crash when unloading a script without pointer to interpreter
core: update Japanese translations (patch #7783)
ruby: add detection of ruby version 1.9.3 in CMake
----
[[translations]]
+34 -30
View File
@@ -750,8 +750,9 @@ 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. Vous pouvez alors
définie le chemin vers les certificats sous WeeChat :
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 :
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@@ -789,11 +790,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_freenode]]
=== Comment puis-je me connecter à freenode avec SSL ?
[[irc_ssl_libera]]
=== Comment puis-je me connecter à libera avec SSL ?
Positionnez l'option _weechat.network.gnutls_ca_file_ avec le fichier des
certificats :
Avec WeeChat ≤ 3.1, 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"
@@ -813,9 +814,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.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
/set irc.server.libera.addresses "irc.libera.chat/6697"
/set irc.server.libera.ssl on
/connect libera
----
[[irc_oauth]]
@@ -840,25 +841,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.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.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.freenode.command_delay 5
/set irc.server.libera.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 freenode :
l'autojoin, par exemple pour le serveur libera :
----
/set irc.server.freenode.autojoin [TAB]
/set irc.server.libera.autojoin [TAB]
----
[NOTE]
@@ -1038,16 +1039,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 freenode :
#weechat sur le serveur IRC libera :
----
/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera.#weechat hotlist_max_level_nicks_add mike:2
----
Pour l'appliquer à l'ensemble du serveur freenode :
Pour l'appliquer à l'ensemble du serveur libera :
----
/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera hotlist_max_level_nicks_add mike:2
----
Pour plus d'exemples, voir `+/help buffer_autoset+`.
@@ -1086,16 +1087,18 @@ 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
(en particulier l'option _weechat.network.gnutls_ca_file_).
Consultez d'abord les questions à propos des connexions SSL dans cette FAQ.
Si cela ne fonctionne toujours pas, essayez de supprimer manuellement le fichier
avec les scripts (dans votre shell) :
----
$ rm ~/.weechat/script/plugins.xml.gz
$ rm ~/.cache/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 :
----
@@ -1116,7 +1119,7 @@ vous-même pour obtenir les mises à jour) :
* dans votre shell, avec curl installé :
----
$ cd ~/.weechat/script
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
----
@@ -1170,8 +1173,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é : affecter une
chaîne vide pour l'option _weechat.network.gnutls_ca_file_.
* Ne pas charger les certificats si SSL n'est *PAS* utilisé : désactiver
l'option _weechat.network.gnutls_ca_system_.
* 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_.
@@ -1230,16 +1233,16 @@ Par exemple :
----
/secure passphrase xxxxxxxxxx
/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}"
/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}"
----
[[sharing_config_files]]
=== Je souhaite partager ma configuration de WeeChat, quels fichiers dois-je partager et que dois-je garder privé ?
Vous pouvez partager les fichiers _~/.weechat/*.conf_ sauf le fichier
Vous pouvez partager les fichiers de configuration _*.conf_ sauf le fichier
_sec.conf_ qui contient vos mots de passes chiffrés avec votre phrase
de chiffrement.
@@ -1281,7 +1284,8 @@ $ 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 ?
La liste complète est sur cette page : https://weechat.org/download
WeeChat tourne bien sur la plupart des distributions Linux/BSD, GNU/Hurd, Mac OS
et Windows (Cygwin et Windows Subsystem for Linux).
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
+21 -28
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 freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
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_.
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_.
Comme d'habitude, de l'aide est disponible si vous êtes perdus :
@@ -135,38 +135,31 @@ 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 freenode avec la commande suivante :
vous pouvez les écraser pour le serveur libera avec la commande suivante :
----
/set irc.server.freenode.nicks "pseudo,pseudo2,pseudo3,pseudo4,pseudo5"
/set irc.server.libera.nicks "pseudo,pseudo2,pseudo3,pseudo4,pseudo5"
----
Pour modifier le nom d'utilisateur et nom réel :
----
/set irc.server.freenode.username "Mon nom d'utilisateur"
/set irc.server.freenode.realname "Mon nom réel"
/set irc.server.libera.username "Mon nom d'utilisateur"
/set irc.server.libera.realname "Mon nom réel"
----
Pour activer la connexion automatique au serveur lors du démarrage :
----
/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
/set irc.server.libera.autoconnect 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.freenode.sasl_username "pseudo"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "pseudo"
/set irc.server.libera.sasl_password "xxxxxxx"
----
Pour lancer une commande après connexion au serveur, par exemple pour
@@ -174,7 +167,7 @@ s'authentifier auprès de nickserv (seulement si vous n'utilisez pas SASL pour
l'authentification) :
----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -190,23 +183,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 freenode :
Puis ajoutez une donnée sécurisée avec votre mot de passe libera :
----
/secure set freenode_password xxxxxxx
/secure set libera_password xxxxxxx
----
Vous pouvez alors utiliser `+${sec.data.freenode_password}+` au lieu de votre
Vous pouvez alors utiliser `+${sec.data.libera_password}+` au lieu de votre
mot de passe dans les options IRC mentionnées ci-dessus, par exemple :
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
Pour rejoindre automatiquement des canaux lors de la connexion au serveur :
----
/set irc.server.freenode.autojoin "#canal1,#canal2"
/set irc.server.libera.autojoin "#canal1,#canal2"
----
[TIP]
@@ -219,24 +212,24 @@ défaut à la place, par exemple pour utiliser les pseudos par défaut
(irc.server_default.nicks) :
----
/unset irc.server.freenode.nicks
/unset irc.server.libera.nicks
----
Autres options : vous pouvez modifier les autres options avec la commande
suivante ("xxx" est le nom d'une option) :
----
/set irc.server.freenode.xxx valeur
/set irc.server.libera.xxx valeur
----
[[connect_to_irc_server]]
== Se connecter au serveur IRC
----
/connect freenode
/connect libera
----
Avec cette commande, WeeChat se connecte au serveur freenode et rejoint
Avec cette commande, WeeChat se connecte au serveur libera 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.freenode'
full_name: 'irc.server.libera'
item 3:
__path: ['0x558d62a9cea0']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
----
* Demander toutes les lignes du premier tampon :
@@ -599,15 +599,15 @@ inf: ('version_number', '34144256')
* Demander le répertoire de WeeChat :
----
(info_weechat_dir) info weechat_dir
(info_weechat_config_dir) info weechat_config_dir
----
Réponse :
[source,python]
----
id: 'info_weechat_dir'
inf: ('weechat_dir', '/home/xxx/.weechat')
id: 'info_weechat_config_dir'
inf: ('weechat_config_dir', '/home/user/.config/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.freenode.#weechat_)
_core.weechat_ ou _irc.libera.#weechat_)
Exemples :
@@ -868,10 +868,10 @@ hda:
prefix_color: None
----
* Demander la liste de pseudos pour le tampon "irc.freenode.#weechat" :
* Demander la liste de pseudos pour le tampon "irc.libera.#weechat" :
----
(nicklist_weechat) nicklist irc.freenode.#weechat
(nicklist_weechat) nicklist irc.libera.#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.freenode.#weechat_)
_core.weechat_ ou _irc.libera.#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.freenode.#weechat bonjour !
input irc.libera.#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.freenode.#weechat_)
_core.weechat_ ou _irc.libera.#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.freenode.#weechat_); le nom "*" peut être utilisé pour
_core.weechat_ ou _irc.libera.#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.freenode.#weechat buffer
sync irc.libera.#weechat buffer
----
* Obtenir les signaux généraux + tous les signaux pour le canal #weechat :
----
sync * buffers,upgrade
sync irc.freenode.#weechat
sync irc.libera.#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.freenode.#weechat_); le nom "*" peut être utilisé pour
_core.weechat_ ou _irc.libera.#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.freenode.#weechat", puis
Donc si vous envoyez : "sync *", puis "sync irc.libera.#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.freenode.#weechat nicklist
desync irc.libera.#weechat nicklist
----
* Désynchroniser le canal #weechat :
----
desync irc.freenode.#weechat
desync irc.libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#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 freenode, nouveau tampon
_irc.freenode.#weechat_ :
Exemple : canal _#weechat_ rejoint sur libera, nouveau tampon
_irc.libera.#weechat_ :
[source,python]
----
@@ -1534,13 +1534,13 @@ hda:
item 1:
__path: ['0x35a8a60']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
short_name: None
nicklist: 0
title: None
local_variables: {
'plugin': 'irc',
'name': 'freenode.#weechat',
'name': 'libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.freenode.#weechat_ déplacé vers le numéro 2 :
Exemple : tampon _irc.libera.#weechat_ déplacé vers le numéro 2 :
[source,python]
----
@@ -1579,7 +1579,7 @@ hda:
item 1:
__path: ['0x34588c0']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.freenode.#weechat_ mélangé avec le tampon n°2 :
Exemple : tampon _irc.libera.#weechat_ mélangé avec le tampon n°2 :
[source,python]
----
@@ -1617,7 +1617,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.freenode.#weechat_ sorti du mélange :
Exemple : tampon _irc.libera.#weechat_ sorti du mélange :
[source,python]
----
@@ -1655,7 +1655,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.freenode.#weechat_ masqué :
Exemple : tampon _irc.libera.#weechat_ masqué :
[source,python]
----
@@ -1695,7 +1695,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.freenode.#weechat_ démasqué :
Exemple : tampon _irc.libera.#weechat_ démasqué :
[source,python]
----
@@ -1735,7 +1735,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#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.freenode.Flash2'
full_name: 'irc.libera.Flash2'
short_name: 'Flash2'
local_variables: {
'server': 'freenode',
'server': 'libera',
'plugin': 'irc',
'type': 'private',
'channel': 'FlashCode',
'nick': 'test',
'name': 'freenode.Flash2',
'name': 'libera.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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| title | chaîne | Titre du tampon.
|===
@@ -1816,7 +1816,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
|===
Exemple : tampon _irc.freenode.#weechat_ vidé :
Exemple : tampon _irc.libera.#weechat_ vidé :
[source,python]
----
@@ -1851,7 +1851,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| local_variables | table de hachage | Variables locales.
|===
Exemple : variable locale _test_ ajoutée dans le tampon
_irc.freenode.#weechat_ :
_irc.libera.#weechat_ :
[source,python]
----
@@ -1922,15 +1922,15 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
local_variables: {
'server': 'freenode',
'server': 'libera',
'test': 'value',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| local_variables | table de hachage | Variables locales.
|===
Exemple : variable locale _test_ mise à jour dans le tampon
_irc.freenode.#weechat_ :
_irc.libera.#weechat_ :
[source,python]
----
@@ -1966,7 +1966,7 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
local_variables: {
'server': 'local',
'test': 'value2',
@@ -1974,7 +1974,7 @@ hda:
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| local_variables | table de hachage | Variables locales.
|===
Exemple : variable locale _test_ supprimée du tampon _irc.freenode.#weechat_ :
Exemple : variable locale _test_ supprimée du tampon _irc.libera.#weechat_ :
[source,python]
----
@@ -2009,14 +2009,14 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#prout'
full_name: 'irc.libera.#prout'
local_variables: {
'server': 'local',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -2043,7 +2043,7 @@ Données envoyées dans le hdata :
|===
Exemple : nouveau message _hello!_ du pseudo _FlashCode_ sur le tampon
_irc.freenode.#weechat_ :
_irc.libera.#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.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
|===
Exemple : tampon _irc.freenode.#weechat_ en cours de fermeture par WeeChat :
Exemple : tampon _irc.libera.#weechat_ en cours de fermeture par WeeChat :
[source,python]
----
@@ -2109,7 +2109,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#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.freenode.#weechat_ :
Exemple : liste de pseudos pour le tampon _irc.libera.#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
freenode) et deux clés (_number_ et _full_name_) :
libera) 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.freenode
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴─────────────────────
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └───────────────────────────────
┌────────┬──────────────────────────┬───╥─────────┬───┬──────────────╥─────────┬───┬───────────────────┐
│ buffer │ number:int,full_name:str │ 2 ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │ irc.server.libera
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴───────────────────┘
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └───────────────────────────────┘
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
freenode) :
libera) :
....
# commande
+90 -66
View File
@@ -72,12 +72,17 @@ 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`.
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].
[[python_functions]]
===== Fonctions
Les fonctions sont appelées avec `+weechat.xxx(arg1, arg2, ...)+`.
@@ -85,6 +90,7 @@ 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
@@ -141,18 +147,23 @@ 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, ...)+`.
@@ -178,20 +189,26 @@ 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 ...)+`.
@@ -204,14 +221,18 @@ 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, ...);+`.
@@ -222,11 +243,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 :
Prototype (Python) :
[source,python]
----
weechat.register(name, author, version, license, description, shutdown_function, charset)
def register(name: str, author: str, version: str, license: str, description: str, shutdown_function: str, charset: str) -> int: ...
----
Paramètres :
@@ -349,7 +370,7 @@ automatiquement le script quand WeeChat démarre.
Par exemple en Python :
----
$ cd ~/.weechat/python/autoload
$ cd ~/.local/share/weechat/python/autoload
$ ln -s ../script.py
----
@@ -796,58 +817,58 @@ Liste des constantes de l'API script :
| Catégorie | Constantes
| codes retour |
WEECHAT_RC_OK +
WEECHAT_RC_OK_EAT +
WEECHAT_RC_ERROR
`WEECHAT_RC_OK` (entier) +
`WEECHAT_RC_OK_EAT` (entier) +
`WEECHAT_RC_ERROR` (entier)
| fichiers de configuration |
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
`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)
| listes triées |
WEECHAT_LIST_POS_SORT +
WEECHAT_LIST_POS_BEGINNING +
WEECHAT_LIST_POS_END
`WEECHAT_LIST_POS_SORT` (chaîne) +
`WEECHAT_LIST_POS_BEGINNING` (chaîne) +
`WEECHAT_LIST_POS_END` (chaîne)
| hotlist |
WEECHAT_HOTLIST_LOW +
WEECHAT_HOTLIST_MESSAGE +
WEECHAT_HOTLIST_PRIVATE +
WEECHAT_HOTLIST_HIGHLIGHT
`WEECHAT_HOTLIST_LOW` (chaîne) +
`WEECHAT_HOTLIST_MESSAGE` (chaîne) +
`WEECHAT_HOTLIST_PRIVATE` (chaîne) +
`WEECHAT_HOTLIST_HIGHLIGHT` (chaîne)
| hook process |
WEECHAT_HOOK_PROCESS_RUNNING +
WEECHAT_HOOK_PROCESS_ERROR
`WEECHAT_HOOK_PROCESS_RUNNING` (entier) +
`WEECHAT_HOOK_PROCESS_ERROR` (entier)
| hook connect |
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
`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)
| hook signal |
WEECHAT_HOOK_SIGNAL_STRING +
WEECHAT_HOOK_SIGNAL_INT +
WEECHAT_HOOK_SIGNAL_POINTER
`WEECHAT_HOOK_SIGNAL_STRING` (chaîne) +
`WEECHAT_HOOK_SIGNAL_INT` (chaîne) +
`WEECHAT_HOOK_SIGNAL_POINTER` (chaîne)
|===
[[common_tasks]]
@@ -889,13 +910,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.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
# (le nom complet d'un tampon est extension.nom, par exemple : "irc.libera.#weechat")
buffer = weechat.buffer_search("irc", "libera.#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", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.prnt(buffer, "message sur le canal #weechat")
----
@@ -917,7 +938,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", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.command(buffer, "bonjour")
----
@@ -1230,7 +1251,7 @@ xxx,irc_raw_in2_yyy::
[source,python]
----
def join_cb(data, signal, signal_data):
# signal est par exemple : "freenode,irc_in2_join"
# signal est par exemple : "libera,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})
@@ -1285,64 +1306,67 @@ 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="1,^2,10,8",options="header"]
[width="100%",cols="3,^2,10,7",options="header"]
|===
| Clé | Version de WeeChat | Description | Exemple
| Clé | Depuis WeeChat ^(1)^ | 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(
@@ -1405,8 +1429,8 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[source,python]
----
# répertoire de WeeChat, par exemple : "/home/xxxx/.weechat"
weechat.prnt("", "Répertoire WeeChat : %s" % weechat.info_get("weechat_dir", ""))
# 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", ""))
# 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 _chat.freenode.net_.
pas à nous en avertir sur _#weechat_, serveur _irc.libera.chat_.
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
@@ -233,6 +233,10 @@ _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) +
+15 -3
View File
@@ -20,6 +20,8 @@
| irc | irc_is_channel | 1 se la stringa è il nome di un canale IRC valido per il server | server,canale (server è opzionale)
| 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 se la stringa è un nick IRC valido | server,nickname (server is optional)
| irc | irc_nick | ottiene nick corrente su un server | nome server
@@ -58,7 +60,7 @@
| php | php_version | version of the interpreter used | -
| python | python2_bin | path per l'interprete python 2.x | -
| python | python2_bin | path to Python 2.x interpreter (*deprecated* since version 2.6, scripts must use Python 3 only) | -
| python | python_eval | evaluation of source code | source code to execute
@@ -74,7 +76,7 @@
| ruby | ruby_version | version of the interpreter used | -
| spell | spell_dict | elenco separato da virgole di dizionari usati nel buffer | puntatore al buffer ("0x12345678") o buffer con il nome completo ("irc.freenode.weechat")
| spell | spell_dict | elenco separato da virgole di dizionari usati nel buffer | buffer pointer ("0x12345678") or buffer full name ("irc.libera.#weechat")
| tcl | tcl_eval | evaluation of source code | source code to execute
@@ -132,7 +134,15 @@
| weechat | version_number | versione di WeeChat (come numero) | -
| weechat | weechat_dir | directory WeeChat | -
| 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_headless | 1 if WeeChat is running headless | -
@@ -140,6 +150,8 @@
| weechat | weechat_localedir | directory "locale" di WeeChat | -
| weechat | weechat_runtime_dir | WeeChat runtime directory | -
| weechat | weechat_sharedir | directory "share" di WeeChat | -
| weechat | weechat_site | sito di WeeChat | -
@@ -14,5 +14,7 @@
| 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[]
+86 -78
View File
@@ -161,7 +161,7 @@ Examples:
To disconnect from a server or stop any connection attempt, use command /disconnect.
Examples:
/connect freenode
/connect libera
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
@@ -301,10 +301,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 freenode server:
/ignore add toto@domain.com freenode
ignore host "toto*@*.domain.com" on freenode/#weechat:
/ignore add toto*@*.domain.com freenode #weechat
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
----
[[command_irc_info]]
@@ -341,15 +341,15 @@ nick: nick
----
/join [-noswitch] [-server <server>] [<canale1>[,<canale2>...]] [<chiave1>[,<chiave2>...]]
-noswitch: non passare al nuovo buffer
server: invia a questo server (nome interno)
canale: nome del canale in cui entrare
chiave: chiave per entrare nel canale (i canali con una chiave devono essere primi nella lista)
-noswitch: do not switch to new buffer
server: send to this server (internal name)
channel: channel name to join
key: key to join the channel (channels with a key must be the first in list)
Esempi:
Examples:
/join #weechat
/join #canaleprotetto,#weechat chiave
/join -server freenode #weechat
/join #protectedchan,#weechat key
/join -server libera #weechat
/join -noswitch #weechat
----
@@ -361,7 +361,7 @@ Esempi:
channel: channel name
nick: nick
reason: reason (special variables $nick, $channel and $server are replaced by their value)
reason: reason (evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)
----
[[command_irc_kickban]]
@@ -372,7 +372,7 @@ channel: channel name
channel: channel name
nick: nick
reason: reason (special variables $nick, $channel and $server are replaced by their value)
reason: reason (evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)
It is possible to kick/ban with a mask, nick will be extracted from mask and replaced by "*".
@@ -402,7 +402,7 @@ server_mask: list of servers must match this mask
----
[[command_irc_list]]
* `+list+`: elenca i canali ed i loro argomenti
* `+list+`: list channels and their topics
----
/list [-server <server>] [-re <regex>] [<channel>[,<channel>...]] [<target>]
@@ -540,22 +540,22 @@ target: nick or channel name
/notify add <nick> [<server> [-away]]
del <nick>|-all [<server>]
add: aggiunge una notifica
add: add a notification
nick: nick
server: nome interno del server (server corrente è il predefinito)
-away: notifica quando il messaggio di assenza viene cambiato (effettuando il whois sul nick)
del: elimina una notifica
-all: elimina tutte le notifiche
server: internal server name (by default current server)
-away: notify when away message is changed (by doing whois on nick)
del: delete a notification
-all: delete all notifications
Senza argomenti, questo comando mostra le notifiche per il server corrente (oppure tutti i server se il comando viene digitato sul buffer core).
Without argument, this command displays notifications for current server (or all servers if command is issued on core buffer).
Esempi:
notifica quando "tizio" entra/esce dal server corrente:
/notify add tizio
notifica quando "tizio" entra/esce dal server freenode:
/notify add toto freenode
notifica quando "tizio" è assente o presente sul server freenode:
/notify add toto freenode -away
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
----
[[command_irc_op]]
@@ -673,7 +673,7 @@ opzione: opzione extra, per alcuni server
channel: channel name
nick: nick
reason: reason (special variables $nick, $channel and $server are replaced by their value)
reason: reason (special variables $nick, $channel and $server are replaced by their values)
----
[[command_irc_restart]]
@@ -775,16 +775,16 @@ nooption: set boolean option to 'off' (for example: -nossl)
Examples:
/server listfull
/server add freenode chat.freenode.net
/server add freenode chat.freenode.net/6697 -ssl -autoconnect
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy freenode freenode-test
/server rename freenode-test freenode2
/server reorder freenode2 freenode
/server del freenode
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server deloutq
/server raw
/server raw s:freenode
/server raw s:libera
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
@@ -1341,41 +1341,45 @@ 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. an evaluated sub-string (format: "eval:xxx")
2. an evaluated condition (format: "eval_cond:xxx")
3. a string with escaped chars (format: "esc:xxx" or "\xxx")
4. a string with chars to hide (format: "hide:char,string")
5. a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
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")
or max chars displayed on screen (format: "cutscr:max,suffix,string" or "cutscr:+max,suffix,string")
6. a reversed string (format: "rev:xxx" or "revscr:xxx")
7. a repeated string (format: "repeat:count,string")
8. length of a string (format: "length:xxx" or "lengthscr:xxx")
9. a color (format: "color:xxx", see "Plugin API reference", function "color")
10. a modifier (format: "modifier:name,data,string")
11. an info (format: "info:name,arguments", arguments are optional)
12. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
13. current date/time (format: "date" or "date:format")
14. an environment variable (format: "env:XXX")
15. a ternary operator (format: "if:condition?value_if_true:value_if_false")
16. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
17. an option (format: "file.section.option")
18. a local variable in buffer
19. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
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.
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, for example:
hdata[list].var1.var2...: start with a hdata using a list/pointer/pointer name, 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.freenode_password} ==> secret
/eval -n ${sec.data.password} ==> secret
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
@@ -1392,6 +1396,7 @@ 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
@@ -1429,7 +1434,7 @@ addreplace: add or replace an existing 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.freenode.#weechat" or "irc.server.freenode")
- this is full name including plugin (example: "irc.libera.#weechat" or "irc.server.libera")
- "*" means all buffers
- a name starting with '!' is excluded
- wildcard "*" is allowed
@@ -1464,11 +1469,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.freenode.#weechat nick_toto *
/filter add toto irc.libera.#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.freenode.#weechat * weechat sucks
/filter add sucks irc.libera.#weechat * weechat sucks
filter lines that are strictly equal to "WeeChat sucks" on all buffers:
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -1670,7 +1675,7 @@ Esempi:
-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.freenode", "irc.freenode.#weechat")
name: full buffer name (examples: "irc.server.libera", "irc.libera.#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.
@@ -1681,7 +1686,7 @@ Examples:
message to current IRC channel:
/mute -current msg * hi!
message to #weechat channel:
/mute -buffer irc.freenode.#weechat msg #weechat hi!
/mute -buffer irc.libera.#weechat msg #weechat hi!
----
[[command_weechat_plugin]]
@@ -1749,7 +1754,7 @@ Examples:
display message on core buffer with prefix "abc":
/print -core abc\tThe message
display a message on channel #weechat:
/print -buffer irc.freenode.#weechat Message on #weechat
/print -buffer irc.libera.#weechat Message on #weechat
display a snowman (U+2603):
/print -escape \u2603
send alert (BEL):
@@ -1871,7 +1876,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_file to read the passphrase from a file (see /help sec.crypt.passphrase_file).
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).
Secured data with format ${sec.data.xxx} can be used in:
- command /eval
@@ -1882,14 +1887,16 @@ Secured data with format ${sec.data.xxx} can be used in:
Examples:
set a passphrase:
/secure passphrase this is my passphrase
encrypt freenode SASL password:
/secure set freenode mypassword
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
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 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 freenode nickserv ghost mynick ${sec.data.freenode}
/alias add ghost /eval /msg -server libera nickserv ghost mynick ${sec.data.libera}
----
[[command_weechat_set]]
@@ -1976,7 +1983,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 directory "~/.weechat".
It is possible to restore WeeChat session on another machine if you copy the content of WeeChat home directories (see /debug dirs).
----
[[command_weechat_uptime]]
@@ -2161,6 +2168,7 @@ 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[]
@@ -2267,14 +2275,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 in ~/.weechat/weechat_fifo
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).
The expected format is one of:
plugin.buffer *text or command here
*text or command here
For example to change your freenode nick:
echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo
For example to change your libera nick:
echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
Please read the user's guide for more info and examples.
@@ -2711,7 +2719,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); "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default), content is evaluated (see /help eval)
path: path used for relay (for UNIX domain socket only); path is evaluated (see function string_eval_path_home in plugin API reference)
raw: open buffer with raw Relay data
sslcertkey: set SSL certificate/key using path in option relay.network.ssl_cert_key
@@ -2730,10 +2738,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 "freenode":
/relay add irc.freenode 8000
irc proxy, for server "freenode", with SSL:
/relay add ssl.irc.freenode 8001
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 all servers (client will choose), with SSL:
/relay add ssl.irc 8002
weechat protocol:
@@ -2747,7 +2755,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 %h/relay_socket
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
----
// end::relay_commands[]
+112 -34
View File
@@ -16,8 +16,8 @@
** valori: sha224, sha256, sha384, sha512
** valore predefinito: `+sha256+`
* [[option_sec.crypt.passphrase_file]] *sec.crypt.passphrase_file*
** descrizione: 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"]
* [[option_sec.crypt.passphrase_command]] *sec.crypt.passphrase_command*
** descrizione: 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"]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+""+`
@@ -846,6 +846,12 @@
** valori: on, off
** valore predefinito: `+on+`
* [[option_weechat.look.hotlist_update_on_buffer_switch]] *weechat.look.hotlist_update_on_buffer_switch*
** descrizione: pass:none[update the hotlist when switching buffers]
** tipo: bool
** valori: on, off
** valore predefinito: `+on+`
* [[option_weechat.look.input_cursor_scroll]] *weechat.look.input_cursor_scroll*
** descrizione: pass:none[numero di caratteri mostrati dopo la fine della riga di input quando si scorre per mostrare la fine riga]
** tipo: intero
@@ -1140,6 +1146,12 @@
** valori: qualsiasi stringa
** valore predefinito: `+"- "+`
* [[option_weechat.look.read_marker_update_on_buffer_switch]] *weechat.look.read_marker_update_on_buffer_switch*
** descrizione: pass:none[update the read marker when switching buffers]
** tipo: bool
** valori: on, off
** valore predefinito: `+on+`
* [[option_weechat.look.save_config_on_exit]] *weechat.look.save_config_on_exit*
** descrizione: pass:none[salva file di configurazione all'uscita]
** tipo: bool
@@ -1248,11 +1260,17 @@
** valori: 1 .. 2147483647
** valore predefinito: `+60+`
* [[option_weechat.network.gnutls_ca_file]] *weechat.network.gnutls_ca_file*
** descrizione: pass:none[file contenente le autorità certificative ("%h" sarà sostituito dalla home di WeeChat, predefinita: "~/.weechat)]
* [[option_weechat.network.gnutls_ca_system]] *weechat.network.gnutls_ca_system*
** descrizione: 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]
** tipo: bool
** valori: on, off
** valore predefinito: `+on+`
* [[option_weechat.network.gnutls_ca_user]] *weechat.network.gnutls_ca_user*
** descrizione: 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)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"/etc/ssl/certs/ca-certificates.crt"+`
** valore predefinito: `+""+`
* [[option_weechat.network.gnutls_handshake_timeout]] *weechat.network.gnutls_handshake_timeout*
** descrizione: pass:none[timeout (in secondi) per l'handshake di gnutls]
@@ -1285,10 +1303,10 @@
** valore predefinito: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
** descrizione: pass:none[path per la ricerca dei plugin ("%h" sarà sostituito dalla home di WeeChat, "~/.weechat come predefinita)]
** descrizione: pass:none[path for searching plugins (path is evaluated, see function string_eval_path_home in plugin API reference)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"%h/plugins"+`
** valore predefinito: `+"${weechat_data_dir}/plugins"+`
* [[option_weechat.plugin.save_config_on_unload]] *weechat.plugin.save_config_on_unload*
** descrizione: pass:none[salva i file di configurazione allo scaricamento dei plugin]
@@ -1296,14 +1314,44 @@
** valori: on, off
** valore predefinito: `+on+`
* [[option_weechat.signal.sighup]] *weechat.signal.sighup*
** descrizione: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"${if:${info:weechat_headless}?/reload:/quit -yes}"+`
* [[option_weechat.signal.sigquit]] *weechat.signal.sigquit*
** descrizione: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"/quit -yes"+`
* [[option_weechat.signal.sigterm]] *weechat.signal.sigterm*
** descrizione: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"/quit -yes"+`
* [[option_weechat.signal.sigusr1]] *weechat.signal.sigusr1*
** descrizione: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+""+`
* [[option_weechat.signal.sigusr2]] *weechat.signal.sigusr2*
** descrizione: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+""+`
* [[option_weechat.startup.command_after_plugins]] *weechat.startup.command_after_plugins*
** descrizione: pass:none[comando eseguito all'avvio di WeeChat, dopo il caricamento dei plugin (nota: il contenuto viene valutato, consultare /help eval)]
** descrizione: pass:none[command executed when WeeChat starts, after loading plugins; multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+""+`
* [[option_weechat.startup.command_before_plugins]] *weechat.startup.command_before_plugins*
** descrizione: pass:none[comando eseguito all'avvio di WeeChat, prima del caricamento dei plugin (nota: il contenuto viene valutato, consultare /help eval)]
** descrizione: pass:none[command executed when WeeChat starts, before loading plugins; multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+""+`
@@ -1409,10 +1457,10 @@
** valore predefinito: `+""+`
* [[option_logger.file.path]] *logger.file.path*
** descrizione: 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)]
** descrizione: 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)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"%h/logs/"+`
** valore predefinito: `+"${weechat_data_dir}/logs"+`
* [[option_logger.file.replacement_char]] *logger.file.replacement_char*
** descrizione: pass:none[carattere di sostituzione per i caratteri speciali nei nomi dei file salvati con la mask (come il delimitatore di directory)]
@@ -1704,6 +1752,12 @@
** valori: qualsiasi stringa
** valore predefinito: `+"${color:green}${number}${if:${number_displayed}?.: }"+`
* [[option_buflist.format.tls_version]] *buflist.format.tls_version*
** descrizione: pass:none[format for TLS version on an IRC server buffer (note: content is evaluated, see /help buflist)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+" ${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*
** descrizione: 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]
** tipo: bool
@@ -1765,10 +1819,16 @@
** valore predefinito: `+""+`
* [[option_buflist.look.sort]] *buflist.look.sort*
** descrizione: 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")]
** descrizione: 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}")]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"number,-active"+`
* [[option_buflist.look.use_items]] *buflist.look.use_items*
** descrizione: 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]
** tipo: intero
** valori: 1 .. 3
** valore predefinito: `+1+`
// end::buflist_options[]
// tag::fifo_options[]
@@ -1779,10 +1839,10 @@
** valore predefinito: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
** descrizione: 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)]
** descrizione: 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)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"%h/weechat_fifo"+`
** valore predefinito: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1853,7 +1913,7 @@
** valore predefinito: `+off+`
* [[option_xfer.file.auto_accept_nicks]] *xfer.file.auto_accept_nicks*
** descrizione: 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"]
** descrizione: 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"]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+""+`
@@ -1883,10 +1943,10 @@
** valore predefinito: `+on+`
* [[option_xfer.file.download_path]] *xfer.file.download_path*
** descrizione: 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)]
** descrizione: pass:none[path for writing incoming files (path is evaluated, see function string_eval_path_home in plugin API reference)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"%h/xfer"+`
** valore predefinito: `+"${weechat_data_dir}/xfer"+`
* [[option_xfer.file.download_temporary_suffix]] *xfer.file.download_temporary_suffix*
** descrizione: 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]
@@ -1895,7 +1955,7 @@
** valore predefinito: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
** descrizione: 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)]
** descrizione: pass:none[path for reading files when sending (path is evaluated, see function string_eval_path_home in plugin API reference)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"~"+`
@@ -2004,6 +2064,24 @@
** valori: 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
** valore predefinito: `+default+`
* [[option_irc.color.item_tls_version_deprecated]] *irc.color.item_tls_version_deprecated*
** descrizione: pass:none[color for deprecated TLS versions in bar item "tls_version"]
** tipo: colore
** valori: 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
** valore predefinito: `+yellow+`
* [[option_irc.color.item_tls_version_insecure]] *irc.color.item_tls_version_insecure*
** descrizione: pass:none[color for insecure TLS versions in bar item "tls_version"]
** tipo: colore
** valori: 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
** valore predefinito: `+red+`
* [[option_irc.color.item_tls_version_ok]] *irc.color.item_tls_version_ok*
** descrizione: pass:none[color for higher supported TLS version in bar item "tls_version"]
** tipo: colore
** valori: 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
** valore predefinito: `+green+`
* [[option_irc.color.message_account]] *irc.color.message_account*
** descrizione: pass:none[color for text in account messages]
** tipo: colore
@@ -2209,19 +2287,19 @@
** valore predefinito: `+off+`
* [[option_irc.look.highlight_channel]] *irc.look.highlight_channel*
** descrizione: 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"]
** descrizione: 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"]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"$nick"+`
* [[option_irc.look.highlight_pv]] *irc.look.highlight_pv*
** descrizione: 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"]
** descrizione: 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"]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"$nick"+`
* [[option_irc.look.highlight_server]] *irc.look.highlight_server*
** descrizione: 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"]
** descrizione: 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"]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"$nick"+`
@@ -2599,7 +2677,7 @@
** valore predefinito: `+message+`
* [[option_irc.server_default.command]] *irc.server_default.command*
** descrizione: 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)]
** descrizione: 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)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+""+`
@@ -2635,19 +2713,19 @@
** valore predefinito: `+""+`
* [[option_irc.server_default.msg_kick]] *irc.server_default.msg_kick*
** descrizione: 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)]
** descrizione: 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)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+""+`
* [[option_irc.server_default.msg_part]] *irc.server_default.msg_part*
** descrizione: 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)]
** descrizione: 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)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"WeeChat ${info:version}"+`
* [[option_irc.server_default.msg_quit]] *irc.server_default.msg_quit*
** descrizione: 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)]
** descrizione: 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)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"WeeChat ${info:version}"+`
@@ -2695,15 +2773,15 @@
** valore predefinito: `+continue+`
* [[option_irc.server_default.sasl_key]] *irc.server_default.sasl_key*
** descrizione: pass:none[file with ECC private key for mechanism "ecdsa-nist256p-challenge" ("%h" will be replaced by WeeChat home, "~/.weechat" by default)]
** descrizione: 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)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+""+`
* [[option_irc.server_default.sasl_mechanism]] *irc.server_default.sasl_mechanism*
** descrizione: 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)]
** descrizione: 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)]
** tipo: intero
** valori: plain, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** valori: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** valore predefinito: `+plain+`
* [[option_irc.server_default.sasl_password]] *irc.server_default.sasl_password*
@@ -2737,7 +2815,7 @@
** valore predefinito: `+off+`
* [[option_irc.server_default.ssl_cert]] *irc.server_default.ssl_cert*
** descrizione: pass:none[file del certificato SSL usato per identificare automaticamente il proprio nick ("%h" sarà sostituito dalla home di WeeChat, "~/.weechat come predefinita)]
** descrizione: pass:none[SSL certificate file used to automatically identify your nick (path is evaluated, see function string_eval_path_home in plugin API reference)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+""+`
@@ -2961,10 +3039,10 @@
** valore predefinito: `+100000+`
* [[option_relay.network.ssl_cert_key]] *relay.network.ssl_cert_key*
** descrizione: pass:none[file con il certificato SSL e la chiave privata (per servire i client con SSL)]
** descrizione: 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)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"%h/ssl/relay.pem"+`
** valore predefinito: `+"${weechat_config_dir}/ssl/relay.pem"+`
* [[option_relay.network.ssl_priorities]] *relay.network.ssl_priorities*
** descrizione: pass:none[stringa con le priorità per gnutls (per la sintassi, consultare la documentazione per la funzione gnutls_priority_init nel manuale di gnutls, stringhe comuni sono: "PERFORMANCE", "NORMAL", "SECURE128", "SECURE256", "EXPORT", "NONE")]
@@ -3267,7 +3345,7 @@
** valore predefinito: `+lightmagenta+`
* [[option_script.look.columns]] *script.look.columns*
** descrizione: 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)]
** descrizione: 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)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"%s %n %V %v %u | %d | %t"+`
@@ -3345,10 +3423,10 @@
** valore predefinito: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
** descrizione: 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)]
** descrizione: pass:none[local cache directory for scripts (path is evaluated, see function string_eval_path_home in plugin API reference)]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"%h/script"+`
** valore predefinito: `+"${weechat_cache_dir}/script"+`
* [[option_script.scripts.url]] *script.scripts.url*
** descrizione: pass:none[URL for file with list of scripts]
+3 -3
View File
@@ -18,9 +18,9 @@
// TRANSLATION MISSING
*-d*, *--dir* _<path>_::
Imposta una directory come home per WeeChat (utilizzata per i file di
configurazione, log, plugin e script dell'utente), il valore predefinito
è "~/.weechat" (nota: directory viene creata se non trovata da WeeChat).
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).
If this option is not given, the environment variable WEECHAT_HOME is used
(if not empty).
+26 -26
View File
@@ -9,7 +9,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@chat.freenode.net/#weechat
irc://mynick@irc.libera.chat/#weechat
IPv6 address can be enclosed in brackets to add a port after address, for
example:
@@ -19,79 +19,79 @@ example:
// tag::files[]
// TRANSLATION MISSING
$HOME/.weechat/weechat.conf::
$HOME/.config/weechat/weechat.conf::
main WeeChat configuration file
$HOME/.weechat/plugins.conf::
$HOME/.config/weechat/plugins.conf::
plugins configuration file
$HOME/.weechat/sec.conf::
$HOME/.config/weechat/sec.conf::
configuration file with secured data
$HOME/.weechat/alias.conf::
$HOME/.config/weechat/alias.conf::
configuration file for _alias_ plugin
$HOME/.weechat/buflist.conf::
$HOME/.config/weechat/buflist.conf::
configuration file for _buflist_ plugin
$HOME/.weechat/charset.conf::
$HOME/.config/weechat/charset.conf::
configuration file for _charset_ plugin
$HOME/.weechat/exec.conf::
$HOME/.config/weechat/exec.conf::
configuration file for _exec_ plugin
$HOME/.weechat/fifo.conf::
$HOME/.config/weechat/fifo.conf::
configuration file for _fifo_ plugin
$HOME/.weechat/fset.conf::
$HOME/.config/weechat/fset.conf::
configuration file for _fset_ plugin
$HOME/.weechat/guile.conf::
$HOME/.config/weechat/guile.conf::
configuration file for _guile_ plugin
$HOME/.weechat/irc.conf::
$HOME/.config/weechat/irc.conf::
configuration file for _irc_ plugin
$HOME/.weechat/javascript.conf::
$HOME/.config/weechat/javascript.conf::
configuration file for _javascript_ plugin
$HOME/.weechat/logger.conf::
$HOME/.config/weechat/logger.conf::
configuration file for _logger_ plugin
$HOME/.weechat/lua.conf::
$HOME/.config/weechat/lua.conf::
configuration file for _lua_ plugin
$HOME/.weechat/perl.conf::
$HOME/.config/weechat/perl.conf::
configuration file for _perl_ plugin
$HOME/.weechat/php.conf::
$HOME/.config/weechat/php.conf::
configuration file for _php_ plugin
$HOME/.weechat/python.conf::
$HOME/.config/weechat/python.conf::
configuration file for _python_ plugin
$HOME/.weechat/relay.conf::
$HOME/.config/weechat/relay.conf::
configuration file for _relay_ plugin
$HOME/.weechat/ruby.conf::
$HOME/.config/weechat/ruby.conf::
configuration file for _ruby_ plugin
$HOME/.weechat/script.conf::
$HOME/.config/weechat/script.conf::
configuration file for _script_ plugin
$HOME/.weechat/spell.conf::
$HOME/.config/weechat/spell.conf::
configuration file for _spell_ plugin
$HOME/.weechat/tcl.conf::
$HOME/.config/weechat/tcl.conf::
configuration file for _tcl_ plugin
$HOME/.weechat/trigger.conf::
$HOME/.config/weechat/trigger.conf::
configuration file for _trigger_ plugin
$HOME/.weechat/xfer.conf::
$HOME/.config/weechat/xfer.conf::
configuration file for _xfer_ plugin
$HOME/.weechat/weechat.log::
$HOME/.local/share/weechat/weechat.log::
WeeChat log file
// end::files[]
+37 -29
View File
@@ -791,7 +791,9 @@ kbd:[Shift]).
// TRANSLATION MISSING
If you are using macOS, you must install `openssl` from Homebrew.
A CA file will be bootstrapped using certificates from the system keychain.
You can then set the path to certificates in WeeChat:
// TRANSLATION MISSING
With WeeChat ≤ 3.1, you can set the path to system certificates:
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@@ -829,10 +831,12 @@ Provare una stringa di priorità diversa (solo WeeChat ≥ 0.3.5), sostituendo
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
----
[[irc_ssl_freenode]]
=== Come ci si può connettere al server freenode via SSL?
[[irc_ssl_libera]]
=== Come ci si può connettere al server libera via SSL?
Impostare l'opzione _weechat.network.gnutls_ca_file_ con il file dei certificati:
// TRANSLATION MISSING
With WeeChat ≤ 3.1, set option _weechat.network.gnutls_ca_file_ to file with
certificates:
----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
@@ -852,9 +856,9 @@ pacchetto "ca-certificates").
Impostare la porta del server, SSL, poi riconnettersi:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
/set irc.server.libera.addresses "irc.libera.chat/6697"
/set irc.server.libera.ssl on
/connect libera
----
// TRANSLATION MISSING
@@ -880,15 +884,15 @@ Se il server supporta SASL, dovrebbe essere utilizzato invece di inviare il
comando di autenticazione con nickserv, ad esempio:
----
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
Se il server non supporta SASL, è possibile aggiungere un ritardo (tra il
comando e l'ingresso nei canali):
----
/set irc.server.freenode.command_delay 5
/set irc.server.libera.command_delay 5
----
// TRANSLATION MISSING
@@ -897,10 +901,10 @@ comando e l'ingresso nei canali):
// TRANSLATION MISSING
You can use the `/set` command to edit the list of autojoin channels,
for example for the "freenode" server:
for example for the "libera" server:
----
/set irc.server.freenode.autojoin [TAB]
/set irc.server.libera.autojoin [TAB]
----
// TRANSLATION MISSING
@@ -1087,16 +1091,16 @@ _buffer_autoset.py_ script:
----
For example, to permanently disable highlights from "mike" on #weechat
on the IRC server freenode:
on the IRC server libera:
----
/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera.#weechat hotlist_max_level_nicks_add mike:2
----
To apply it to the entire freenode server instead:
To apply it to the entire libera server instead:
----
/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera hotlist_max_level_nicks_add mike:2
----
For more examples, see `+/help buffer_autoset+`.
@@ -1135,15 +1139,17 @@ Gli script non sono compatibili con altri client IRC.
[[scripts_update]]
=== The command "/script update" can not read scripts, how to fix that?
First check questions about SSL connection in this FAQ
(especially the option _weechat.network.gnutls_ca_file_).
First check questions about SSL connection in this FAQ.
If still not working, try to manually delete the scripts file (in your shell):
----
$ rm ~/.weechat/script/plugins.xml.gz
$ rm ~/.cache/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:
----
@@ -1163,7 +1169,7 @@ have to update manually the file yourself to get updates):
* in your shell, with curl installed:
----
$ cd ~/.weechat/script
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
----
@@ -1219,8 +1225,9 @@ Esistono diversi trucchi per ottimizzare l'uso della memoria:
fifo, logger, perl, python, ruby, lua, tcl, guile, javascript, php, spell, xfer (usato per DCC).
See `/help weechat.plugin.autoload`.
* caricare solo gli script veramente necessari
* non caricare i certificati se SSL *NON* viene usato: usare una stringa vuota nell'opzione
_weechat.network.gnutls_ca_file_
// TRANSLATION MISSING
* Do not load system certificates if SSL is *NOT* used: turn off this option:
_weechat.network.gnutls_ca_system_.
* ridurre il valore dell'opzione _weechat.history.max_buffer_lines_number_ oppure
impostare il valore dell'opzione _weechat.history.max_buffer_lines_minutes_
* ridurre il valore dell'opzione _weechat.history.max_commands_
@@ -1284,20 +1291,19 @@ For example:
----
/secure passphrase xxxxxxxxxx
/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}"
/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}"
----
// TRANSLATION MISSING
[[sharing_config_files]]
=== I want to share my WeeChat configuration, what files should I share and what should I keep private?
You can share files _~/.weechat/*.conf_ except the file _sec.conf_ which
You can share configuration files _*.conf_ except the file _sec.conf_ which
contains your passwords ciphered with your passphrase.
// TRANSLATION MISSING
Some other files may contain sensitive info like passwords (if they are not
stored in _sec.conf_ with the `/secure` command).
@@ -1337,7 +1343,9 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
[[supported_os]]
=== Qual è la lista delle piattaforme supportate da WeeChat? Verrà effettuato il port su altri sistemi operativi?
La lista completa è su questa pagina: https://weechat.org/download
// TRANSLATION MISSING
WeeChat runs fine on most Linux/BSD distributions, GNU/Hurd, Mac OS and Windows
(Cygwin and Windows Subsystem for Linux).
Facciamo del nostro meglio per portarlo su più piattaforme possibili. L'aiuto
per gli OS che non abbiamo, e su cui testare WeeChat, è ben accetto.
File diff suppressed because it is too large Load Diff
+21 -29
View File
@@ -124,13 +124,13 @@ vedere "irc" ed altri plugin nella lista.
You can add an IRC server with `/server` command, for example:
----
/server add freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
// 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_.
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_.
Come al solito, è disponibile l'aiuto se c'è qualche problema:
@@ -150,46 +150,38 @@ Per ogni opzione del server, WeeChat usa il proprio valore se definito
("irc.server_default.xxx").
Per esempio ci sono dei nick predefiniti (basati sul proprio login un*x), ed
è possibile sovrascriverli per il server freenode con il seguente comando:
è possibile sovrascriverli per il server libera con il seguente comando:
----
/set irc.server.freenode.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
/set irc.server.libera.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
----
Per impostare il nome utente ed il nome reale:
----
/set irc.server.freenode.username "Mio nome utente"
/set irc.server.freenode.realname "Mio nome reale"
/set irc.server.libera.username "Mio nome utente"
/set irc.server.libera.realname "Mio nome reale"
----
Per impostare la connessione automatica al server all'avvio:
----
/set irc.server.freenode.autoconnect on
----
// TRANSLATION MISSING
To connect with SSL:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/set irc.server.libera.autoconnect on
----
Se SASL è disponibile sul server, è possibile usarlo per l'autenticazione
(l'autenticazione avviene prima dell'ingresso nei canali):
----
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
Per eseguire un comando dopo la connessione al server, ad esempio per
autenticarsi con nickserv (solo se non viene usato SASL per l'autenticazione):
----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
----
// TRANSLATION MISSING
@@ -208,25 +200,25 @@ First setup a passphrase:
----
// TRANSLATION MISSING
Then add a secured data with your freenode password:
Then add a secured data with your libera password:
----
/secure set freenode_password xxxxxxx
/secure set libera_password xxxxxxx
----
// TRANSLATION MISSING
Then you can use `+${sec.data.freenode_password}+` instead of your password in
Then you can use `+${sec.data.libera_password}+` instead of your password in
IRC options mentioned above, for example:
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
Per entrare automaticamente in alcuni canali quando ci si connette
al server:
----
/set irc.server.freenode.autojoin "#canale1,#canale2"
/set irc.server.libera.autojoin "#canale1,#canale2"
----
// TRANSLATION MISSING
@@ -240,25 +232,25 @@ predefinito, per esempio per utilizzare i nick predefiniti
(irc.server_default.nicks):
----
/unset irc.server.freenode.nicks
/unset irc.server.libera.nicks
----
Altre opzioni: è possibile impostare altre opzioni con il seguente comando
("xxx" è il nome dell'opzione):
----
/set irc.server.freenode.xxx value
/set irc.server.libera.xxx value
----
[[connect_to_irc_server]]
== Connessione al server IRC
----
/connect freenode
/connect libera
----
// TRANSLATION MISSING
With this command, WeeChat connects to the freenode server and auto-joins the
With this command, WeeChat connects to the libera server and auto-joins the
channels configured in the "autojoin" server option.
// TRANSLATION MISSING
+99 -66
View File
@@ -75,14 +75,19 @@ link:weechat_plugin_api.it.html#_hook_process[WeeChat plugin API reference].
[[languages_specificities]]
=== Specifiche per i linguaggi
[[language_python]]
==== Python
// TRANSLATION MISSING
[[python_module]]
===== Module
WeeChat defines a `weechat` module which must be imported with `import weechat`.
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].
// TRANSLATION MISSING
[[python_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...)+`.
@@ -91,6 +96,7 @@ Functions `+print*+` are called `+prnt*+` in python (because `print` was a
reserved keyword in Python 2).
// TRANSLATION MISSING
[[python_strings]]
===== Strings received in callbacks
In Python 3 and with WeeChat ≥ 2.7, the strings received in callbacks have type
@@ -144,21 +150,26 @@ 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
// TRANSLATION MISSING
[[perl_functions]]
===== Functions
Functions are called with `+weechat::xxx(arg1, arg2, ...);+`.
[[language_ruby]]
==== Ruby
// TRANSLATION MISSING
[[ruby_init]]
===== Initialization
You have to define _weechat_init_ and call _register_ inside.
// TRANSLATION MISSING
[[ruby_functions]]
===== Functions
Functions are called with `+Weechat.xxx(arg1, arg2, ...)+`.
@@ -184,23 +195,29 @@ Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical"
["default", "default", "default", "default"], "0", "items")
----
[[language_lua]]
==== Lua
// TRANSLATION MISSING
[[lua_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...)+`.
[[language_tcl]]
==== Tcl
// TRANSLATION MISSING
[[tcl_functions]]
===== Functions
Functions are called with `+weechat::xxx arg1 arg2 ...+`.
[[language_guile]]
==== Guile (Scheme)
// TRANSLATION MISSING
[[guile_functions]]
===== Functions
Functions are called with `+(weechat:xxx arg1 arg2 ...)+`.
@@ -213,16 +230,20 @@ arguments in Guile:
* config_new_option
* bar_new
[[language_javascript]]
==== JavaScript
// TRANSLATION MISSING
[[javascript_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...);+`.
[[language_php]]
==== PHP
// TRANSLATION MISSING
[[php_functions]]
===== Functions
Functions are called with `+weechat_xxx(arg1, arg2, ...);+`.
@@ -233,11 +254,11 @@ Functions are called with `+weechat_xxx(arg1, arg2, ...);+`.
Tutti gli script WeeChat devono "registrare" loro stessi in WeeChat, e questo
deve essere la prima funzione chiamata nello script di WeeChat.
Prototipo:
Prototipo (Python):
[source,python]
----
weechat.register(name, author, version, license, description, shutdown_function, charset)
def register(name: str, author: str, version: str, license: str, description: str, shutdown_function: str, charset: str) -> int: ...
----
Argomenti:
@@ -358,7 +379,7 @@ automaticamente gli script all'avvio di WeeChat.
Ad esempio con Python:
----
$ cd ~/.weechat/python/autoload
$ cd ~/.local/share/weechat/python/autoload
$ ln -s ../script.py
----
@@ -808,59 +829,66 @@ Elenco di costanti nelle API per gli script:
|===
| Categoria | Costanti
// TRANSLATION MISSING
| codici restituiti |
WEECHAT_RC_OK +
WEECHAT_RC_OK_EAT +
WEECHAT_RC_ERROR
`WEECHAT_RC_OK` (integer) +
`WEECHAT_RC_OK_EAT` (integer) +
`WEECHAT_RC_ERROR` (integer)
// TRANSLATION MISSING
| file di configurazione |
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
`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)
// TRANSLATION MISSING
| liste ordinate |
WEECHAT_LIST_POS_SORT +
WEECHAT_LIST_POS_BEGINNING +
WEECHAT_LIST_POS_END
`WEECHAT_LIST_POS_SORT` (string) +
`WEECHAT_LIST_POS_BEGINNING` (string) +
`WEECHAT_LIST_POS_END` (string)
// TRANSLATION MISSING
| hotlist |
WEECHAT_HOTLIST_LOW +
WEECHAT_HOTLIST_MESSAGE +
WEECHAT_HOTLIST_PRIVATE +
WEECHAT_HOTLIST_HIGHLIGHT
`WEECHAT_HOTLIST_LOW` (string) +
`WEECHAT_HOTLIST_MESSAGE` (string) +
`WEECHAT_HOTLIST_PRIVATE` (string) +
`WEECHAT_HOTLIST_HIGHLIGHT` (string)
// TRANSLATION MISSING
| hook su processo |
WEECHAT_HOOK_PROCESS_RUNNING +
WEECHAT_HOOK_PROCESS_ERROR
`WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
`WEECHAT_HOOK_PROCESS_ERROR` (integer)
// TRANSLATION MISSING
| hook su connessione |
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
`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)
// TRANSLATION MISSING
| hook su segnale |
WEECHAT_HOOK_SIGNAL_STRING +
WEECHAT_HOOK_SIGNAL_INT +
WEECHAT_HOOK_SIGNAL_POINTER
`WEECHAT_HOOK_SIGNAL_STRING` (string) +
`WEECHAT_HOOK_SIGNAL_INT` (string) +
`WEECHAT_HOOK_SIGNAL_POINTER` (string)
|===
[[common_tasks]]
@@ -903,13 +931,13 @@ weechat.prnt("", "%swrong arguments" % weechat.prefix("error"))
weechat.prnt("", "text %syellow on blue" % weechat.color("yellow,blue"))
# cerca buffer e visualizza messaggiosearch buffer and display message
# (il nome completo del buffer è plugin.nome, ad esempio: "irc.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
# (il nome completo del buffer è plugin.nome, ad esempio: "irc.libera.#weechat")
buffer = weechat.buffer_search("irc", "libera.#weechat")
weechat.prnt(buffer, "message on #weechat channel")
# altra soluzione per cercare un buffer IRC (migliore)
# (nota: server e canale sono separati da virgola)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.prnt(buffer, "message on #weechat channel")
----
@@ -932,7 +960,7 @@ Esempi:
weechat.command("", "/help")
# invia "hello" sul canale IRC #weechat (gli utenti sul canale vedranno il messaggio)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.command(buffer, "hello")
----
@@ -1246,7 +1274,7 @@ xxx,irc_raw_in2_yyy::
[source,python]
----
def join_cb(data, signal, signal_data):
# signal è per esempio: "freenode,irc_in2_join"
# signal è per esempio: "libera,irc_in2_join"
# signal_data è il messaggio IRC message, ad esempio: ":nick!user@host JOIN :#channel"
server = signal.split(",")[0]
msg = weechat.info_get_hashtable("irc_message_parse", {"message": signal_data})
@@ -1304,64 +1332,68 @@ 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="1,^2,10,8",options="header"]
[width="100%",cols="3,^2,10,7",options="header"]
|===
| Key | WeeChat version | Description | Example
| Key | Since WeeChat ^(1)^ | 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+`
// TRANSLATION MISSING
| 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+`
|===
// TRANSLATION MISSING
[NOTE]
^(1)^ The key has been introduced in this WeeChat version.
[source,python]
----
dict = weechat.info_get_hashtable(
@@ -1421,10 +1453,11 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[[infos_other]]
==== Altre informazioni
// TRANSLATION MISSING
[source,python]
----
# la directory home di WeeChat, ad esempio: "/home/xxxx/.weechat"
weechat.prnt("", "WeeChat home dir: %s" % weechat.info_get("weechat_dir", ""))
# WeeChat config directory, for example: "/home/user/.config/weechat"
weechat.prnt("", "WeeChat config dir: %s" % weechat.info_get("weechat_config_dir", ""))
# inattività della tastiera
weechat.prnt("", "Inactivity since %s seconds" % weechat.info_get("inactivity", ""))
+1 -1
View File
@@ -138,7 +138,7 @@ fatto di avere la versione più nuova possibile di WeeChat. ;)
Se si dovessero verificare strani comportamenti (potrebbe andare in crash
o far bollire la vostra birra) non esitate ad entrare in _#weechat_ su
_chat.freenode.net_ e farcelo sapere.
_irc.libera.chat_ e farcelo sapere.
Se non dovesse andare in crash - ditelo comunque, abbiamo bisogno dei vostri
commenti!
File diff suppressed because it is too large Load Diff
@@ -233,6 +233,10 @@ _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) +
+15 -3
View File
@@ -20,6 +20,8 @@
| irc | irc_is_channel | 文字列がサーバの有効な IRC チャンネル名なら 1 | サーバ、チャンネル (サーバは任意)
| 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 | 文字列が有効な IRC ニックネームなら 1 | server,nickname (server is optional)
| irc | irc_nick | あるサーバの現在のニックネームを取得 | サーバ名
@@ -58,7 +60,7 @@
| php | php_version | 使用中のインタプリタのバージョン | -
| python | python2_bin | python 2.x インタプリタへのパス | -
| python | python2_bin | path to Python 2.x interpreter (*deprecated* since version 2.6, scripts must use Python 3 only) | -
| python | python_eval | ソースコードの評価 | 実行するソースコード
@@ -74,7 +76,7 @@
| ruby | ruby_version | 使用中のインタプリタのバージョン | -
| spell | spell_dict | バッファで使用中の辞書のコンマ区切りリスト | バッファポインタ ("0x12345678") またはバッファのフルネーム ("irc.freenode.#weechat")
| spell | spell_dict | バッファで使用中の辞書のコンマ区切りリスト | buffer pointer ("0x12345678") or buffer full name ("irc.libera.#weechat")
| tcl | tcl_eval | ソースコードの評価 | 実行するソースコード
@@ -132,7 +134,15 @@
| weechat | version_number | WeeChat のバージョン (数字) | -
| weechat | weechat_dir | WeeChat ディレクトリ | -
| 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_headless | 1 if WeeChat is running headless | -
@@ -140,6 +150,8 @@
| weechat | weechat_localedir | WeeChat "locale" ディレクトリ | -
| weechat | weechat_runtime_dir | WeeChat runtime directory | -
| weechat | weechat_sharedir | WeeChat "share" ディレクトリ | -
| weechat | weechat_site | WeeChat サイト | -
@@ -14,5 +14,7 @@
| 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[]
+235 -227
View File
@@ -145,23 +145,23 @@ WeeChat がサポートする機能: account-notify、away-notify、cap-notify
/connect [<server> [<server>...]] [-<option>[=<value>]] [-no<option>] [-nojoin] [-switch]
-all|-auto|-open [-nojoin] [-switch]
server: サーバ名、これは:
- 内部サーバ名 (/server add で追加されたもの、利用推奨)
- ホスト名/ポート番号または IP アドレス/ポート番号、デフォルトのポート番号は 6667
- 次の書式に従う URL: irc[6][s]://[nickname[:password]@]irc.example.org[:port][/#channel1][,#channel2[...]]
注意: アドレス/IP/URL を指定した場合、サーバを一時的に追加します (保存しません)、/help irc.look.temporary_servers を参照してください。
option: サーバに関するオプション (ブール型オプションでは、value は無視される)
nooption: ブール型オプションを 'off' にする (例: -nossl)
-all: 設定された全てのサーバに接続
-auto: 自動接続を有効化してサーバに接続
-open: 現在接続されていないがオープンされているサーバに接続
-nojoin: チャンネルに入らない (autojoin が有効化されていても)
-switch: 次のサーバアドレスに移動
server: server name, which can be:
- internal server name (added by /server add, recommended usage)
- hostname/port or IP/port, port is 6667 by default
- URL with format: irc[6][s]://[nickname[:password]@]irc.example.org[:port][/#channel1][,#channel2[...]]
Note: for an address/IP/URL, a temporary server is added (NOT SAVED), see /help irc.look.temporary_servers
option: set option for server (for boolean option, value can be omitted)
nooption: set boolean option to 'off' (for example: -nossl)
-all: connect to all servers defined in configuration
-auto: connect to servers with autoconnect enabled
-open: connect to all opened servers that are not currently connected
-nojoin: do not join any channel (even if autojoin is enabled on server)
-switch: switch to next server address
サーバとの接続を切断するか、接続試行を中止するには /disconnect コマンドを使ってください。
To disconnect from a server or stop any connection attempt, use command /disconnect.
:
/connect freenode
Examples:
/connect libera
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
@@ -287,24 +287,24 @@ nick: ニックネームまたはマスク (ワイルドカード "*" を使う
add [re:]<nick> [<server> [<channel>]]
del <number>|-all
list: 無視エントリをリストアップ
add: 無視エントリを追加
nick: ニックネームまたはホスト名 ("re:" を付けることで POSIX 拡張正規表現を使えます、"*" は 0 個以上の文字にマッチします)
del: 無視エントリの削除
number: 削除する無視エントリ番号 (番号はリストを参照してください)
-all: 全ての無視エントリを削除
server: 無視設定を有効にする内部サーバ名
channel: 無視設定を有効にするチャンネル名
list: list all ignores
add: add an ignore
nick: nick or hostname (can be a POSIX extended regular expression if "re:" is given or a mask using "*" to replace zero or more chars)
del: delete an ignore
number: number of ignore to delete (look at list to find it)
-all: delete all ignores
server: internal server name where ignore is working
channel: channel name where ignore is working
注意: 正規表現で大文字小文字を区別するには "(?-i)" を最初につけてください。
Note: the regular expression can start with "(?-i)" to become case sensitive.
:
全てのサーバ上のニックネーム "toto" を無視:
Examples:
ignore nick "toto" everywhere:
/ignore add toto
freenode サーバ上のホスト名 "toto@domain.com" を無視:
/ignore add toto@domain.com freenode
freenode サーバの #weechat チャンネル上のホスト名 "toto*@*.domain.com" を無視:
/ignore add toto*@*.domain.com freenode #weechat
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
----
[[command_irc_info]]
@@ -341,15 +341,15 @@ nick: ニックネーム
----
/join [-noswitch] [-server <server>] [<channel1>[,<channel2>...]] [<key1>[,<key2>...]]
-noswitch: 新しいバッファに移動しない
server: 送信先サーバ (内部サーバ名)
channel: 参加するチャンネルの名前
key: チャンネルに参加するためのキー (キーが必要なチャンネルは最初に置くこと)
-noswitch: do not switch to new buffer
server: send to this server (internal name)
channel: channel name to join
key: key to join the channel (channels with a key must be the first in list)
:
Examples:
/join #weechat
/join #protectedchan,#weechat key
/join -server freenode #weechat
/join -server libera #weechat
/join -noswitch #weechat
----
@@ -359,9 +359,9 @@ nick: ニックネーム
----
/kick [<channel>] <nick> [<reason>]
channel: チャンネル名
nick: ニックネーム
reason: 理由 (特殊変数 $nick、$channel、$server はそれぞれの値に置換されます)
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)
----
[[command_irc_kickban]]
@@ -370,14 +370,14 @@ channel: チャンネル名
----
/kickban [<channel>] <nick> [<reason>]
channel: チャンネル名
nick: ニックネーム
reason: 理由 (特殊変数 $nick、$channel、$server はそれぞれの値に置換されます)
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)
キックと参加禁止にマスクを使うことが可能で、"*" のマスク展開後にマッチするニックネームがこれらの対象になります。
It is possible to kick/ban with a mask, nick will be extracted from mask and replaced by "*".
:
"*!*@host.com" を参加禁止して "toto" をキック:
Example:
ban "*!*@host.com" and then kick "toto":
/kickban toto!*@host.com
----
@@ -402,7 +402,7 @@ server_mask: このマスクにマッチするサーバのリスト
----
[[command_irc_list]]
* `+list+`: チャンネルとトピックをリストアップ
* `+list+`: list channels and their topics
----
/list [-server <server>] [-re <regex>] [<channel>[,<channel>...]] [<target>]
@@ -540,22 +540,22 @@ target: ニックネームまたはチャンネル名
/notify add <nick> [<server> [-away]]
del <nick>|-all [<server>]
add: 通知の追加
nick: ニックネーム
server: 内部サーバ名 (デフォルトでは現在のサーバ)
-away: 離席メッセージが変更されたときに通知 (ニックネームの whois を行う)
del: 通知を削除
-all: 全ての通知を削除
add: add a notification
nick: nick
server: internal server name (by default current server)
-away: notify when away message is changed (by doing whois on nick)
del: delete a notification
-all: delete all notifications
引数無しの場合は、現在のサーバに関する通知設定を表示します (コアバッファで実行された場合は全てのサーバに関する設定)。
Without argument, this command displays notifications for current server (or all servers if command is issued on core buffer).
:
"toto" が現在のサーバに接続/切断した場合に通知:
Examples:
notify when "toto" joins/quits current server:
/notify add toto
"toto" が freenode サーバに接続/切断した場合に通知:
/notify add toto freenode
"toto" が freenode サーバに戻るか離席状態になった場合に通知:
/notify add toto freenode -away
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
----
[[command_irc_op]]
@@ -671,9 +671,9 @@ option: 追加オプション、いくつかのサーバ用
----
/remove [<channel>] <nick> [<reason>]
channel: チャンネル名
nick: ニックネーム
reason: 理由 (特殊変数 $nick$channel$server はそれぞれの値に置換されます)
channel: channel name
nick: nick
reason: reason (special variables $nick, $channel and $server are replaced by their values)
----
[[command_irc_restart]]
@@ -775,16 +775,16 @@ nooption: set boolean option to 'off' (for example: -nossl)
Examples:
/server listfull
/server add freenode chat.freenode.net
/server add freenode chat.freenode.net/6697 -ssl -autoconnect
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy freenode freenode-test
/server rename freenode-test freenode2
/server reorder freenode2 freenode
/server del freenode
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server deloutq
/server raw
/server raw s:freenode
/server raw s:libera
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
@@ -1341,41 +1341,45 @@ 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. an evaluated sub-string (format: "eval:xxx")
2. an evaluated condition (format: "eval_cond:xxx")
3. a string with escaped chars (format: "esc:xxx" or "\xxx")
4. a string with chars to hide (format: "hide:char,string")
5. a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
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")
or max chars displayed on screen (format: "cutscr:max,suffix,string" or "cutscr:+max,suffix,string")
6. a reversed string (format: "rev:xxx" or "revscr:xxx")
7. a repeated string (format: "repeat:count,string")
8. length of a string (format: "length:xxx" or "lengthscr:xxx")
9. a color (format: "color:xxx", see "Plugin API reference", function "color")
10. a modifier (format: "modifier:name,data,string")
11. an info (format: "info:name,arguments", arguments are optional)
12. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
13. current date/time (format: "date" or "date:format")
14. an environment variable (format: "env:XXX")
15. a ternary operator (format: "if:condition?value_if_true:value_if_false")
16. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
17. an option (format: "file.section.option")
18. a local variable in buffer
19. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
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.
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, for example:
hdata[list].var1.var2...: start with a hdata using a list/pointer/pointer name, 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.freenode_password} ==> secret
/eval -n ${sec.data.password} ==> secret
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
@@ -1392,6 +1396,7 @@ 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
@@ -1429,7 +1434,7 @@ addreplace: add or replace an existing 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.freenode.#weechat" or "irc.server.freenode")
- this is full name including plugin (example: "irc.libera.#weechat" or "irc.server.libera")
- "*" means all buffers
- a name starting with '!' is excluded
- wildcard "*" is allowed
@@ -1464,11 +1469,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.freenode.#weechat nick_toto *
/filter add toto irc.libera.#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.freenode.#weechat * weechat sucks
/filter add sucks irc.libera.#weechat * weechat sucks
filter lines that are strictly equal to "WeeChat sucks" on all buffers:
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -1667,21 +1672,21 @@ disable: マウスの無効化
----
/mute [-core | -current | -buffer <name>] <command>
-core: WeeChat コアバッファへの出力を抑制
-current: 現在のバッファへの出力を抑制
-buffer: 指定したバッファへの出力を抑制
name: 完全なバッファの名前 (例: "irc.server.freenode"、"irc.freenode.#weechat")
command: 静かに実行するコマンド (最初に '/' が無い場合は自動的に追加されます)
-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")
command: command to execute silently (a '/' is automatically added if not found at beginning of command)
ターゲット (-core-current-buffer) が指定されなかった場合、デフォルトでは全ての出力を抑制します。
If no target is specified (-core, -current or -buffer), then default is to mute all buffers.
:
save を行う:
Examples:
config save:
/mute save
現在の IRC チャンネルへのメッセージ:
message to current IRC channel:
/mute -current msg * hi!
#weechat チャンネルへのメッセージ:
/mute -buffer irc.freenode.#weechat msg #weechat hi!
message to #weechat channel:
/mute -buffer irc.libera.#weechat msg #weechat hi!
----
[[command_weechat_plugin]]
@@ -1715,44 +1720,44 @@ arguments: ロードするプラグインに与える引数
-stdout|-stderr [<text>]
-beep
-buffer: 指定したバッファにテキストを表示 (デフォルト: コマンドを実行したバッファ)
-newbuffer: 新しいバッファの作成、そのバッファ内にテキストの表示
-free: 自由内容バッファの作成 (-newbuffer と共に使用)
-switch: 指定したバッファに切り替え
-core: "-buffer core.weechat" のエイリアス
-current: 現在のバッファにテキストを表示
-y: 指定した行番号に表示 (自由内容バッファ専用)
line: 自由内容バッファの行番号 (1 行目は 0、負数は最後の行から数えた行: -1 = 最終行から数えて 1 行目、-2 = 最終行から数えて 2 行目、など)
-escape: エスケープ文字を解釈 (例えば \a\07\x07)
-date: メッセージの日付、書式:
-n: 今から 'n' 秒前
+n: 今から 'n' 秒後
n: エポックから 'n' 秒目 (man time を参照してください)
日付/時間 (ISO 8601): yyyy-mm-ddThh:mm:ss、例: 2014-01-19T04:32:55
時間: hh:mm:ss (example: 04:32:55)
-tags: タグのコンマ区切りリスト (よく使うタグのリストは /help filter を参照してください)
text: 表示するテキスト (プレフィックスとメッセージは必ず \t で区切ってください、"-" で始まるテキストは "\" を前置してください)
-stdout: 標準出力にテキストを表示 (エスケープ文字を解釈)
-stderr: 標準エラー出力にテキストを表示 (エスケープ文字を解釈)
-beep: "-stderr \a" の別名
-buffer: display text in this buffer (default: buffer where command is executed)
-newbuffer: create a new buffer and display text in this buffer
-free: create a buffer with free content (with -newbuffer only)
-switch: switch to the buffer
-core: alias of "-buffer core.weechat"
-current: display text on current buffer
-y: display on a custom line (for buffer with free content only)
line: line number for buffer with free content (first line is 0, a negative number displays after last line: -1 = after last line, -2 = two lines after last line, etc.)
-escape: interpret escaped chars (for example \a, \07, \x07)
-date: message date, format can be:
-n: 'n' seconds before now
+n: 'n' seconds in the future
n: 'n' seconds since the Epoch (see man time)
date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
time: hh:mm:ss (example: 04:32:55)
-tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
text: text to display (prefix and message must be separated by "\t", if text starts with "-", then add a "\" before)
-stdout: display text on stdout (escaped chars are interpreted)
-stderr: display text on stderr (escaped chars are interpreted)
-beep: alias of "-stderr \a"
オプション -action ... -quit をつけた場合、プレフィックスは "weechat.look.prefix_*" で定義されているものになります。
The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".
以下のエスケープ文字を使うことができます:
Following escaped chars are supported:
\" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh
:
コアバッファにハイライトを付けてリマインダを表示:
Examples:
display a reminder on core buffer with a highlight:
/print -core -tags notify_highlight Reminder: buy milk
コアバッファにエラーを表示:
display an error on core buffer:
/print -core -error Some error here
コアバッファにプレフィックス "abc" を付けてメッセージを表示:
display message on core buffer with prefix "abc":
/print -core abc\tThe message
チャンネル #weechat にメッセージを表示:
/print -buffer irc.freenode.#weechat Message on #weechat
雪だるまを表示 (U+2603):
display a message on channel #weechat:
/print -buffer irc.libera.#weechat Message on #weechat
display a snowman (U+2603):
/print -escape \u2603
警告を送信 (BEL):
send alert (BEL):
/print -beep
----
@@ -1858,38 +1863,40 @@ file: 保存する設定ファイル (拡張子 ".conf" は不要)
set <name> <value>
del <name>
passphrase: パスフレーズを変更 (パスフレーズがない場合、sec.conf ファイルに平文でデータを保存します)
-delete: パスフレーズを削除
decrypt: 暗号化されているデータを復号化 (起動時にパスフレーズが設定されていない場合に起きます)
-discard: 全ての暗号化データを破棄
set: 保護データを追加または変更
del: 保護データを削除
passphrase: change the passphrase (without passphrase, data is stored as plain text in file sec.conf)
-delete: delete passphrase
decrypt: decrypt data still encrypted (it happens only if passphrase was not given on startup)
-discard: discard all data still encrypted
set: add or change secured data
del: delete secured data
引数がない場合、新しいバッファに保護データを表示します。
Without argument, this command displays secured data in a new buffer.
保護バッファ内で利用可能なキー:
alt+v 値を切り替えます
Keys on secure buffer:
alt+v toggle values
パスフレーズを利用する場合 (データが暗号化されている場合)、WeeChat は起動時にパスフレーズを尋ねます。
入力を回避するには、環境変数 "WEECHAT_PASSPHRASE" を利用するか (WeeChat /upgrade の時に同じ変数を利用します)、sec.crypt.passphrase_file オプションを設定してファイルからパスフレーズを読み込みます (/help sec.crypt.passphrase_file を参照してください)。
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).
${sec.data.xxx} の形で書かれた保護データは以下の様に利用できます:
- /eval コマンド
- コマンドライン引数 "--run-command"
- weechat.startup.command_{before|after}_plugins オプション
- パスワードや機密データを含むと思われるその他のオプション (例えば、プロキシ、irc サーバ、リレー); 保護データが評価されるかを確認するには各オプションの /help を参照してください。
Secured data with format ${sec.data.xxx} can be used in:
- command /eval
- command line argument "--run-command"
- options weechat.startup.command_{before|after}_plugins
- other options that may contain a password or sensitive data (for example proxy, irc server and relay); see /help on the options to check if they are evaluated.
:
パスフレーズを設定:
Examples:
set a passphrase:
/secure passphrase this is my passphrase
freenode の SASL パスワードを暗号化:
/secure set freenode mypassword
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
oftc の nickserv 用パスワードを暗号化:
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 oftc password for nickserv:
/secure set oftc mypassword
/set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}"
ニックネーム "mynick" を取り戻すためのエイリアス ghost を設定
/alias add ghost /eval /msg -server freenode nickserv ghost mynick ${sec.data.freenode}
alias to ghost the nick "mynick":
/alias add ghost /eval /msg -server libera nickserv ghost mynick ${sec.data.libera}
----
[[command_weechat_set]]
@@ -1953,30 +1960,30 @@ option: オプションの名前
----
/upgrade [-yes] [<path_to_binary>|-quit]
-yes: "weechat.look.confirm_upgrade" オプションが有効化されていた場合、このオプションは必須です。
path_to_binary: WeeChat バイナリへのパス (デフォルトは現在のバイナリ)
-dummy: 何もしない (補完された "-quit" オプションを不用意に使わないためのオプション)
-quit: *すべての* 接続を閉じ、セッションを保存して WeeChat を終了。遅延復帰 (詳しくは後述) が可能になります。
-yes: required if option "weechat.look.confirm_upgrade" is enabled
path_to_binary: path to WeeChat binary (default is current binary)
-dummy: do nothing (option used to prevent accidental completion with "-quit")
-quit: close *ALL* connections, save session and quit WeeChat, which makes possible a delayed restoration (see below)
このコマンドは起動中の WeeChat セッションのアップグレードとリロードを行います。このコマンドを実行する前に、新しい WeeChat バイナリをコンパイルするか、パッケージマネージャでインストールしなければいけません。
This command upgrades and reloads a running WeeChat session. The new WeeChat binary must have been compiled or installed with a package manager before running this command.
注意: SSL 接続はアップグレード中に破棄されます、これは今のところ GnuTLS では SSL セッションのリロードができないからです。アップグレードの後に自動的に再接続されます。
Note: SSL connections are lost during upgrade, because reload of SSL sessions is currently not possible with GnuTLS. There is automatic reconnection after upgrade.
アップグレードは 4 つの手順を踏みます:
1. コアとプラグイン (バッファ、履歴、...) のセッションをファイルに保存
2. 全てのプラグインをアンロード (設定ファイル (*.conf) はディスクに書き込まれます)
3. WeeChat 設定を保存 (weechat.conf)
4. 新しい WeeChat バイナリを実行してセッションをリロード。
Upgrade process has 4 steps:
1. save session into files for core and plugins (buffers, history, ..)
2. unload all plugins (configuration files (*.conf) are written on disk)
3. save WeeChat configuration (weechat.conf)
4. execute new WeeChat binary and reload session.
オプション "-quit" を使うと、上の挙動が少し変わります:
1. *すべての* 接続を閉じる (ircxferrelay...)
2. すべてのセッションをファイルに保存 (*.upgrade)
3. すべてのプラグインをアンロード
4. WeeChat 設定を保存
5. WeeChat を終了
この後、セッションを回復させるには weechat --upgrade を使ってください。
重要: 完全に同一の設定で (*.conf ファイルで) セッションを回復させてください。
"~/.weechat" ディレクトリの内容をコピーすれば異なるマシンで WeeChat のセッションを回復することも可能です。
With option "-quit", the process is slightly different:
1. close *ALL* connections (irc, xfer, relay, ...)
2. save session into files (*.upgrade)
3. unload all plugins
4. save WeeChat configuration
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).
----
[[command_weechat_uptime]]
@@ -2161,6 +2168,7 @@ 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[]
@@ -2262,23 +2270,23 @@ Examples:
----
/fifo enable|disable|toggle
enable: FIFO パイプを有効化します
disable: FIFO パイプを無効化します
toggle: FIFO パイプの有効無効を切り替えます
enable: enable FIFO pipe
disable: disable FIFO pipe
toggle: toggle FIFO pipe
FIFO パイプは WeeChat をリモート操作する際に使われます: FIFO パイプを通じてシェルからコマンドやテキストを送信できます。
デフォルトの場合 FIFO パイプは ~/.weechat/weechat_fifo です。
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).
書式は次のうちのどれか 1 つを使ってください:
plugin.buffer *テキストまたはコマンド
*テキストまたはコマンド
The expected format is one of:
plugin.buffer *text or command here
*text or command here
freenode のニックネームを変更する例:
echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo
For example to change your libera nick:
echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
詳しい情報と例はユーザーズガイドを参照してください。
Please read the user's guide for more info and examples.
:
Examples:
/fifo toggle
----
// end::fifo_commands[]
@@ -2701,53 +2709,53 @@ filename: ロードするスクリプト (ファイル)
raw
sslcertkey
list: リレーするクライアントをリストアップ (アクティブなもののみ)
listfull: リレーするクライアントをリストアップ (詳細、全てのリレー)
listrelay: リレーをリストアップ (名前とポート番号)
add: リレーを追加 (ポート/パスで接続を待ち受ける)
del: リレーを削除 (クライアントとの接続は保持)
start: ポートリッスンを開始する
restart: サーバソケットを閉じて同じポートで接続を待つ (クライアントとの接続は保持)
stop: サーバソケットを閉じる (クライアントとの接続は保持)
name: リレー名 (以下の書式を参照してください)
port: リレーが使うポート
path: リレーが使うパス (UNIX ドメインソケット); 文字列先頭の "%h" は WeeChat ホーム (デフォルトは "~/.weechat") で置き換えられ、内容は評価されます (/help eval を参照してください)
raw: 生リレーデータを表示するバッファを開く
sslcertkey: オプション relay.network.ssl_cert_key のパスを使って SSL 証明書/鍵を指定
list: list relay clients (only active relays)
listfull: list relay clients (verbose, all relays)
listrelay: list relays (name and port)
add: add a relay (listen on a port/path)
del: remove a relay (clients remain connected)
start: listen on port
restart: close the server socket and listen again on port (clients remain connected)
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)
raw: open buffer with raw Relay data
sslcertkey: set SSL certificate/key using path in option relay.network.ssl_cert_key
リレー名の書式: [ipv4.][ipv6.][ssl.]<protocol.name> または unix.[ssl.]<protocol.name>
ipv4: IPv4 を強制的に利用
ipv6: IPv6 を強制的に利用
ssl: SSL を有効化
unix: UNIX ドメインソケットを利用
protocol.name: リレーするプロトコルと名前:
- "irc" プロトコル: name は共有するサーバ名 (任意指定、指定しない場合、サーバ名は "PASS" コマンドでクライアントが送信するものと同じでなければいけません、"PASS" コマンドの書式は "PASS server:password")
- "weechat" プロトコル (name は使われません)
Relay name is: [ipv4.][ipv6.][ssl.]<protocol.name> or unix.[ssl.]<protocol.name>
ipv4: force use of IPv4
ipv6: force use of IPv6
ssl: enable SSL
unix: use UNIX domain socket
protocol.name: protocol and name to relay:
- protocol "irc": name is the server to share (optional, if not given, the server name must be sent by client in command "PASS", with format: "PASS server:password")
- protocol "weechat" (name is not used)
"irc" プロトコルを指定した場合、どんな IRC クライアント (WeeChat 自身を含めて) でもポートに接続することができます。
"weechat" プロトコルを指定した場合、リモートインターフェースを使ってポートに接続することができます、参照: https://weechat.org/about/interfaces
The "irc" protocol allows any IRC client (including WeeChat itself) to connect on the port.
The "weechat" protocol allows a remote interface to connect on the port, see the list here: https://weechat.org/about/interfaces
引数無しの場合、リレークライアントのリストを含むバッファを開く
Without argument, this command opens buffer with list of relay clients.
:
サーバ "freenode" に対する irc プロキシを設定:
/relay add irc.freenode 8000
サーバ "freenode" に対する SSL を有効化した irc プロキシを設定:
/relay add ssl.irc.freenode 8001
SSL を有効化してすべてのサーバに対する irc プロキシを設定 (クライアントがサーバを選ぶ):
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 all servers (client will choose), with SSL:
/relay add ssl.irc 8002
weechat プロトコル:
weechat protocol:
/relay add weechat 9000
SSL を有効化した weechat プロトコル:
weechat protocol with SSL:
/relay add ssl.weechat 9001
SSL を有効にした weechat プロトコル、IPv4 だけを利用:
weechat protocol with SSL, using only IPv4:
/relay add ipv4.ssl.weechat 9001
SSL を有効にした weechat プロトコル、IPv6 だけを利用:
weechat protocol with SSL, using only IPv6:
/relay add ipv6.ssl.weechat 9001
SSL を有効にした weechat プロトコル、IPv4 IPv6 を利用:
weechat protocol with SSL, using IPv4 + IPv6:
/relay add ipv4.ipv6.ssl.weechat 9001
UNIX ドメインソケットを介した weechat プロトコル:
/relay add unix.weechat %h/relay_socket
weechat protocol over UNIX domain socket:
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
----
// end::relay_commands[]
+112 -34
View File
@@ -16,8 +16,8 @@
** 値: sha224, sha256, sha384, sha512
** デフォルト値: `+sha256+`
* [[option_sec.crypt.passphrase_file]] *sec.crypt.passphrase_file*
** 説明: pass:none[保護データを暗号化/複合化するためのパスフレーズを保存したファイルパス; このオプションは sec.conf ファイルを読むときだけに利用されます; ファイルの 1 行目だけが利用されます; このファイルは環境変数 "WEECHAT_PASSPHRASE" が設定されていないときだけに利用されます (環境変数のほうが優先順位が高いです); セキュリティ上の注意: このファイルを自分だけが読み込める状態にし、WeeChat ホームの外 (例えば自分のホームディレクトリ) に保存しておくことを推奨します; 例: "~/.weechat-passphrase"]
* [[option_sec.crypt.passphrase_command]] *sec.crypt.passphrase_command*
** 説明: 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"]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+""+`
@@ -846,6 +846,12 @@
** 値: on, off
** デフォルト値: `+on+`
* [[option_weechat.look.hotlist_update_on_buffer_switch]] *weechat.look.hotlist_update_on_buffer_switch*
** 説明: pass:none[update the hotlist when switching buffers]
** タイプ: ブール
** 値: on, off
** デフォルト値: `+on+`
* [[option_weechat.look.input_cursor_scroll]] *weechat.look.input_cursor_scroll*
** 説明: pass:none[行の最後までスクロールする際に入力行の最後に続けて表示される文字の数]
** タイプ: 整数
@@ -1140,6 +1146,12 @@
** 値: 未制約文字列
** デフォルト値: `+"- "+`
* [[option_weechat.look.read_marker_update_on_buffer_switch]] *weechat.look.read_marker_update_on_buffer_switch*
** 説明: pass:none[update the read marker when switching buffers]
** タイプ: ブール
** 値: on, off
** デフォルト値: `+on+`
* [[option_weechat.look.save_config_on_exit]] *weechat.look.save_config_on_exit*
** 説明: pass:none[終了時に設定ファイルを保存]
** タイプ: ブール
@@ -1248,11 +1260,17 @@
** 値: 1 .. 2147483647
** デフォルト値: `+60+`
* [[option_weechat.network.gnutls_ca_file]] *weechat.network.gnutls_ca_file*
** 説明: pass:none[認証局を含むファイル ("%h" は WeeChat ホームに置換されます、デフォルトでは "~/.weechat" です)]
* [[option_weechat.network.gnutls_ca_system]] *weechat.network.gnutls_ca_system*
** 説明: 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]
** タイプ: ブール
** 値: on, off
** デフォルト値: `+on+`
* [[option_weechat.network.gnutls_ca_user]] *weechat.network.gnutls_ca_user*
** 説明: 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)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"/etc/ssl/certs/ca-certificates.crt"+`
** デフォルト値: `+""+`
* [[option_weechat.network.gnutls_handshake_timeout]] *weechat.network.gnutls_handshake_timeout*
** 説明: pass:none[gnutls ハンドシェイクのタイムアウト (秒単位)]
@@ -1285,10 +1303,10 @@
** デフォルト値: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
** 説明: pass:none[プラグイン検索パス ("%h" は WeeChat ホームに置換されます、デフォルトでは "~/.weechat" です)]
** 説明: pass:none[path for searching plugins (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"%h/plugins"+`
** デフォルト値: `+"${weechat_data_dir}/plugins"+`
* [[option_weechat.plugin.save_config_on_unload]] *weechat.plugin.save_config_on_unload*
** 説明: pass:none[プラグインをアンロードする際に設定ファイルをセーブ]
@@ -1296,14 +1314,44 @@
** 値: on, off
** デフォルト値: `+on+`
* [[option_weechat.signal.sighup]] *weechat.signal.sighup*
** 説明: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"${if:${info:weechat_headless}?/reload:/quit -yes}"+`
* [[option_weechat.signal.sigquit]] *weechat.signal.sigquit*
** 説明: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"/quit -yes"+`
* [[option_weechat.signal.sigterm]] *weechat.signal.sigterm*
** 説明: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"/quit -yes"+`
* [[option_weechat.signal.sigusr1]] *weechat.signal.sigusr1*
** 説明: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+""+`
* [[option_weechat.signal.sigusr2]] *weechat.signal.sigusr2*
** 説明: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+""+`
* [[option_weechat.startup.command_after_plugins]] *weechat.startup.command_after_plugins*
** 説明: pass:none[WeeChat が実行され、プラグインのロード後に実行されるコマンド (注意: 値は評価されます、/help eval を参照してください)]
** 説明: pass:none[command executed when WeeChat starts, after loading plugins; multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+""+`
* [[option_weechat.startup.command_before_plugins]] *weechat.startup.command_before_plugins*
** 説明: pass:none[WeeChat が実行され、プラグインのロード前に実行されるコマンド (注意: 値は評価されます、/help eval を参照してください)]
** 説明: pass:none[command executed when WeeChat starts, before loading plugins; multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+""+`
@@ -1409,10 +1457,10 @@
** デフォルト値: `+""+`
* [[option_logger.file.path]] *logger.file.path*
** 説明: pass:none[WeeChat ログファイルのパス; 文字列最初の "%h" は WeeChat ホームに置換 (デフォルトでは "~/.weechat" に置換); 日付指定子を使える (strftime の man を参照してください) (注意: 内容は評価されます、/help eval 参照)]
** 説明: 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)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"%h/logs/"+`
** デフォルト値: `+"${weechat_data_dir}/logs"+`
* [[option_logger.file.replacement_char]] *logger.file.replacement_char*
** 説明: pass:none[マスクと一緒に使われたときのファイル名に含まれる特殊文字に対応する置換文字 (ディレクトリ区切りのようなもの)]
@@ -1704,6 +1752,12 @@
** 値: 未制約文字列
** デフォルト値: `+"${color:green}${number}${if:${number_displayed}?.: }"+`
* [[option_buflist.format.tls_version]] *buflist.format.tls_version*
** 説明: pass:none[format for TLS version on an IRC server buffer (note: content is evaluated, see /help buflist)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+" ${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*
** 説明: pass:none[バッファリスト内に表示されたバッファ同士の間に改行を追加します。こうすることで、各バッファが 1 行ごとに表示されます (推奨); これを無効化する場合には、表示書式に改行 "${\n}" を追加しなければいけません。さらに、マウス操作はできなくなります]
** タイプ: ブール
@@ -1765,10 +1819,16 @@
** デフォルト値: `+""+`
* [[option_buflist.look.sort]] *buflist.look.sort*
** 説明: 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")]
** 説明: 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}")]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"number,-active"+`
* [[option_buflist.look.use_items]] *buflist.look.use_items*
** 説明: 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]
** タイプ: 整数
** 値: 1 .. 3
** デフォルト値: `+1+`
// end::buflist_options[]
// tag::fifo_options[]
@@ -1779,10 +1839,10 @@
** デフォルト値: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
** 説明: pass:none[FIFO ファイルのパス; 文字列最初の "%h" は WeeChat ホーム に置換されます (デフォルトでは "~/.weechat" に置換されます); ${info:pid} を使えば WeeChat の PID を設定することも可能です (注意: 内容は評価されます、/help eval 参照)]
** 説明: 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)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"%h/weechat_fifo"+`
** デフォルト値: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1853,7 +1913,7 @@
** デフォルト値: `+off+`
* [[option_xfer.file.auto_accept_nicks]] *xfer.file.auto_accept_nicks*
** 説明: pass:none[ファイルやチャットの受け入れを自動的に許可するニックネームのコンマ区切りリスト; 書式は "server.nick" (サーバを特定する場合) または "nick" (すべてのサーバ); 例: "freenode.FlashCode,andrew"]
** 説明: 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"]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+""+`
@@ -1883,10 +1943,10 @@
** デフォルト値: `+on+`
* [[option_xfer.file.download_path]] *xfer.file.download_path*
** 説明: pass:none[受信ファイルのパス: 文字列最初の "%h" は WeeChat ホーム に置換されます (デフォルトでは "~/.weechat" に置換されます) (注意: 内容は評価されます、/help eval 参照)]
** 説明: pass:none[path for writing incoming files (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"%h/xfer"+`
** デフォルト値: `+"${weechat_data_dir}/xfer"+`
* [[option_xfer.file.download_temporary_suffix]] *xfer.file.download_temporary_suffix*
** 説明: 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]
@@ -1895,7 +1955,7 @@
** デフォルト値: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
** 説明: pass:none[送信時に読み込むファイルのパス (ユーザがパスを指定しなかった場合に使われます): 文字列最初の "%h" は WeeChat ホームに置換されます (デフォルトでは "~/.weechat" に置換されます) (注意: 内容は評価されます、/help eval 参照)]
** 説明: pass:none[path for reading files when sending (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"~"+`
@@ -2004,6 +2064,24 @@
** 値: WeeChat の色名 (default、black、(dark)gray、white、(light)red、(light)green、brown、yellow、(light)blue、(light)magenta、(light)cyan) 、端末色番号またはその別名; 色の前に属性を置くことができます (テキスト前景色のみ、背景色は出来ません): 太字は "*"、反転は "!"、イタリックは "/"、下線は "_"
** デフォルト値: `+default+`
* [[option_irc.color.item_tls_version_deprecated]] *irc.color.item_tls_version_deprecated*
** 説明: pass:none[color for deprecated TLS versions in bar item "tls_version"]
** タイプ: 色
** 値: WeeChat の色名 (default、black、(dark)gray、white、(light)red、(light)green、brown、yellow、(light)blue、(light)magenta、(light)cyan) 、端末色番号またはその別名; 色の前に属性を置くことができます (テキスト前景色のみ、背景色は出来ません): 太字は "*"、反転は "!"、イタリックは "/"、下線は "_"
** デフォルト値: `+yellow+`
* [[option_irc.color.item_tls_version_insecure]] *irc.color.item_tls_version_insecure*
** 説明: pass:none[color for insecure TLS versions in bar item "tls_version"]
** タイプ: 色
** 値: WeeChat の色名 (default、black、(dark)gray、white、(light)red、(light)green、brown、yellow、(light)blue、(light)magenta、(light)cyan) 、端末色番号またはその別名; 色の前に属性を置くことができます (テキスト前景色のみ、背景色は出来ません): 太字は "*"、反転は "!"、イタリックは "/"、下線は "_"
** デフォルト値: `+red+`
* [[option_irc.color.item_tls_version_ok]] *irc.color.item_tls_version_ok*
** 説明: pass:none[color for higher supported TLS version in bar item "tls_version"]
** タイプ: 色
** 値: WeeChat の色名 (default、black、(dark)gray、white、(light)red、(light)green、brown、yellow、(light)blue、(light)magenta、(light)cyan) 、端末色番号またはその別名; 色の前に属性を置くことができます (テキスト前景色のみ、背景色は出来ません): 太字は "*"、反転は "!"、イタリックは "/"、下線は "_"
** デフォルト値: `+green+`
* [[option_irc.color.message_account]] *irc.color.message_account*
** 説明: pass:none[color for text in account messages]
** タイプ: 色
@@ -2209,19 +2287,19 @@
** デフォルト値: `+off+`
* [[option_irc.look.highlight_channel]] *irc.look.highlight_channel*
** 説明: pass:none[現在のバッファでハイライトする単語のコンマ区切りリスト (大文字小文字を区別しない、"(?-i)" を単語の最初につければ大文字小文字を区別する; 特殊変数 $nick$channel$server はそれぞれの値に置換される)、これらの単語は、バッファの作成時にバッファプロパティ "highlight_words" に追加される (既存のバッファには影響なし)、空文字列はニックネームに関するデフォルトのハイライトを無効にする、例: "$nick", "(?-i)$nick"]
** 説明: 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"]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"$nick"+`
* [[option_irc.look.highlight_pv]] *irc.look.highlight_pv*
** 説明: pass:none[プライベートバッファでハイライトする単語のコンマ区切りリスト (大文字小文字を区別しない、"(?-i)" を単語の最初につければ大文字小文字を区別する; 特殊変数 $nick$channel$server はそれぞれの値に置換される)、これらの単語は、バッファの作成時にバッファプロパティ "highlight_words" に追加される (既存のバッファには影響なし)、空文字列はニックネームに関するデフォルトのハイライトを無効にする、例: "$nick", "(?-i)$nick"]
** 説明: 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"]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"$nick"+`
* [[option_irc.look.highlight_server]] *irc.look.highlight_server*
** 説明: pass:none[サーババッファでハイライトする単語のコンマ区切りリスト (大文字小文字を区別しない、"(?-i)" を単語の最初につければ大文字小文字を区別する; 特殊変数 $nick$channel$server はそれぞれの値に置換される)、これらの単語は、バッファの作成時にバッファプロパティ "highlight_words" に追加される (既存のバッファには影響なし)、空文字列はニックネームに関するデフォルトのハイライトを無効にする、例: "$nick", "(?-i)$nick"]
** 説明: 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"]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"$nick"+`
@@ -2599,7 +2677,7 @@
** デフォルト値: `+message+`
* [[option_irc.server_default.command]] *irc.server_default.command*
** 説明: pass:none[サーバに接続した後、チャンネルに自動参加する前に実行するコマンド (";" で分けて 複数のコマンドを列挙できます、セミコロンは "\;" のように使ってください、特殊変数 $nick$channel$server はそれぞれの値に置換されます) (注意: 値は評価されます、/help eval を参照してください; ここで ${irc_server.xxx} はサーバオプション、${server} はサーバ名を意味します)]
** 説明: 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)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+""+`
@@ -2635,19 +2713,19 @@
** デフォルト値: `+""+`
* [[option_irc.server_default.msg_kick]] *irc.server_default.msg_kick*
** 説明: pass:none["/kick" "/kickban" コマンドが使うデフォルトのキックメッセージ (注意: 値は評価されます、/help eval を参照してください。特殊変数 ${nick}、${channel}${server} はそれぞれの値に置換されます)]
** 説明: 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)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+""+`
* [[option_irc.server_default.msg_part]] *irc.server_default.msg_part*
** 説明: pass:none[デフォルトの退出メッセージ (チャンネルから退出する際に送信されるメッセージ) (注意: 値は評価されます、/help eval を参照してください。特殊変数 ${nick}${channel}${server} はそれぞれの値に置換されます。${...} が文字列に含まれない場合、"%v" は WeeChat バージョン番号に置換されます)]
** 説明: 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)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"WeeChat ${info:version}"+`
* [[option_irc.server_default.msg_quit]] *irc.server_default.msg_quit*
** 説明: pass:none[デフォルトの終了メッセージ (サーバから切断する際に送信されるメッセージ) (注意: 値は評価されます、/help eval を参照してください。特殊変数 ${nick}${channel}${server} はそれぞれの値に置換されます。${...} が文字列に含まれない場合、"%v" は WeeChat バージョン番号に置換されます)]
** 説明: 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)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"WeeChat ${info:version}"+`
@@ -2695,15 +2773,15 @@
** デフォルト値: `+continue+`
* [[option_irc.server_default.sasl_key]] *irc.server_default.sasl_key*
** 説明: pass:none["ecdsa-nist256p-challenge" メカニズム用の ECC 秘密鍵を含むファイル ("%h" は WeeChat ホームに置換されます、デフォルトでは "~/.weechat" です)]
** 説明: 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)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+""+`
* [[option_irc.server_default.sasl_mechanism]] *irc.server_default.sasl_mechanism*
** 説明: pass:none[SASL 認証メカニズム: "plain" は平文パスワード、"ecdsa-nist256p-challenge" は鍵を使ったチャレンジ認証、"external" はクライアント側の SSL 証明書を利用した認証<、"dh-blowfish" blowfish 暗号化パスワード (危険、非推奨)、"dh-aes" AES 暗号化パスワード (危険、非推奨)]
** 説明: 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)]
** タイプ: 整数
** 値: plain, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** 値: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** デフォルト値: `+plain+`
* [[option_irc.server_default.sasl_password]] *irc.server_default.sasl_password*
@@ -2737,7 +2815,7 @@
** デフォルト値: `+off+`
* [[option_irc.server_default.ssl_cert]] *irc.server_default.ssl_cert*
** 説明: pass:none[自動的にニックネームの身元確認を行うために使われる SSL 証明書ファイル ("%h" は WeeChat ホームで置換、デフォルトは "~/.weechat" です)]
** 説明: pass:none[SSL certificate file used to automatically identify your nick (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+""+`
@@ -2961,10 +3039,10 @@
** デフォルト値: `+100000+`
* [[option_relay.network.ssl_cert_key]] *relay.network.ssl_cert_key*
** 説明: pass:none[SSL 証明書と秘密鍵のファイル (SSL 接続を利用するクライアント用)]
** 説明: 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)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"%h/ssl/relay.pem"+`
** デフォルト値: `+"${weechat_config_dir}/ssl/relay.pem"+`
* [[option_relay.network.ssl_priorities]] *relay.network.ssl_priorities*
** 説明: pass:none[gnutls の優先度を示した文字列 (構文は、gnutls マニュアルの gnutls_priority_init 関数のドキュメントを参照してください、通例: "PERFORMANCE", "NORMAL", "SECURE128", "SECURE256", "EXPORT", "NONE")]
@@ -3267,7 +3345,7 @@
** デフォルト値: `+lightmagenta+`
* [[option_script.look.columns]] *script.look.columns*
** 説明: pass:none[スクリプトバッファでの表示列の書式: 以下の列識別子がそれぞれの値で置き換えられます: %a=作者、%d=説明、%D=追加日、%e=拡張子、%l=言語、%L=ライセンス、%n=拡張子を含む名前、%N=名前、%r=依存、%s=状態、%t=タグ、%u=アップデート日、%v=バージョン、%V=ロード済みバージョン、%w=min_weechat%W=max_weechat)]
** 説明: 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)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"%s %n %V %v %u | %d | %t"+`
@@ -3345,10 +3423,10 @@
** デフォルト値: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
** 説明: pass:none[スクリプト用のローカルキャッシュディレクトリ; 文字列最初の "%h" は WeeChat ホーム に置換されます (デフォルトでは "~/.weechat" に置換されます) (注意: 内容は評価されます、/help eval 参照)]
** 説明: pass:none[local cache directory for scripts (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"%h/script"+`
** デフォルト値: `+"${weechat_cache_dir}/script"+`
* [[option_script.scripts.url]] *script.scripts.url*
** 説明: pass:none[スクリプトのリストを含むファイルの URL]
+4 -3
View File
@@ -15,10 +15,11 @@
(works only with the command *weechat-headless*, not compatible with option
"--daemon").
// TRANSLATION MISSING
*-d*, *--dir* _<path>_::
WeeChat のホームディレクトリを path に設定 (設定ファイル、ログ、
ユーザプラグイン、スクリプトに利用される)、初期値は "~/.weechat"。
(注意: パスが存在しない場合は WeeChat がディレクトリを作成します)
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).
このオプションを指定しなかった場合、環境変数 WEECHAT_HOME を使います
(空でない限り)。
+26 -26
View File
@@ -8,7 +8,7 @@ irc プラグインでは以下の様な URL で一時的なサーバに接続
"mynick" というニックネームで WeeChat IRC チャンネルサポートに参加するには:
irc://mynick@chat.freenode.net/#weechat
irc://mynick@irc.libera.chat/#weechat
IPv6 アドレスの後にポートを指定するには IPv6
アドレスを括弧に入れてください、例えば:
@@ -17,79 +17,79 @@ IPv6 アドレスの後にポートを指定するには IPv6
// end::plugin_options[]
// tag::files[]
$HOME/.weechat/weechat.conf::
$HOME/.config/weechat/weechat.conf::
WeeChat の主要設定ファイル
$HOME/.weechat/plugins.conf::
$HOME/.config/weechat/plugins.conf::
プラグイン設定ファイル
$HOME/.weechat/sec.conf::
$HOME/.config/weechat/sec.conf::
保護されたデータを含む設定ファイル
$HOME/.weechat/alias.conf::
$HOME/.config/weechat/alias.conf::
_alias_ プラグイン用の設定ファイル
$HOME/.weechat/buflist.conf::
$HOME/.config/weechat/buflist.conf::
_buflist_ プラグイン用の設定ファイル
$HOME/.weechat/charset.conf::
$HOME/.config/weechat/charset.conf::
_charset_ プラグイン用の設定ファイル
$HOME/.weechat/exec.conf::
$HOME/.config/weechat/exec.conf::
_exec_ プラグイン用の設定ファイル
$HOME/.weechat/fifo.conf::
$HOME/.config/weechat/fifo.conf::
_fifo_ プラグイン用の設定ファイル
$HOME/.weechat/fset.conf::
$HOME/.config/weechat/fset.conf::
_fset_ プラグイン用の設定ファイル
$HOME/.weechat/guile.conf::
$HOME/.config/weechat/guile.conf::
_guile_ プラグイン用の設定ファイル
$HOME/.weechat/irc.conf::
$HOME/.config/weechat/irc.conf::
_irc_ プラグイン用の設定ファイル
$HOME/.weechat/javascript.conf::
$HOME/.config/weechat/javascript.conf::
_javascript_ プラグイン用の設定ファイル
$HOME/.weechat/logger.conf::
$HOME/.config/weechat/logger.conf::
_logger_ プラグイン用の設定ファイル
$HOME/.weechat/lua.conf::
$HOME/.config/weechat/lua.conf::
_lua_ プラグイン用の設定ファイル
$HOME/.weechat/perl.conf::
$HOME/.config/weechat/perl.conf::
_perl_ プラグイン用の設定ファイル
$HOME/.weechat/php.conf::
$HOME/.config/weechat/php.conf::
_php_ プラグイン用の設定ファイル
$HOME/.weechat/python.conf::
$HOME/.config/weechat/python.conf::
_python_ プラグイン用の設定ファイル
$HOME/.weechat/relay.conf::
$HOME/.config/weechat/relay.conf::
_relay_ プラグイン用の設定ファイル
$HOME/.weechat/ruby.conf::
$HOME/.config/weechat/ruby.conf::
_ruby_ プラグイン用の設定ファイル
$HOME/.weechat/script.conf::
$HOME/.config/weechat/script.conf::
_script_ プラグイン用の設定ファイル
$HOME/.weechat/spell.conf::
$HOME/.config/weechat/spell.conf::
_spell_ プラグイン用の設定ファイル
$HOME/.weechat/tcl.conf::
$HOME/.config/weechat/tcl.conf::
_tcl_ プラグイン用の設定ファイル
$HOME/.weechat/trigger.conf::
$HOME/.config/weechat/trigger.conf::
_trigger_ プラグイン用の設定ファイル
$HOME/.weechat/xfer.conf::
$HOME/.config/weechat/xfer.conf::
_xfer_ プラグイン用の設定ファイル
$HOME/.weechat/weechat.log::
$HOME/.local/share/weechat/weechat.log::
WeeChat ログファイル
// end::files[]
+24 -14
View File
@@ -104,6 +104,8 @@ qweechat::
|       gui/ | インターフェース関数の単体テスト
|       plugins/ | プラグインの単体テスト
|          irc/ | IRC プラグインの単体テスト
// TRANSLATION MISSING
|          trigger/ | Unit tests for trigger plugin.
| doc/ | 文書
| po/ | 翻訳ファイル (gettext)
| debian/ | Debian パッケージ用
@@ -135,6 +137,8 @@ WeeChat "core" は以下のディレクトリに配置されています:
// TRANSLATION MISSING
|    wee-crypto.c | Cryptographic functions.
|    wee-debug.c | デバッグ用関数
// TRANSLATION MISSING
|    wee-dir.c | Directory/file functions.
|    wee-eval.c | 内部変数へのリファレンスを含む式を評価
|    wee-hashtable.c | ハッシュテーブル
|    wee-hdata.c | hdata (ハッシュテーブルを用いて直接データを読む)
@@ -148,6 +152,8 @@ WeeChat "core" は以下のディレクトリに配置されています:
|    wee-secure.c | データ保護用の関数
|    wee-secure-buffer.c | データ保護用のバッファ
|    wee-secure-config.c | 安全なデータオプション (sec.conf ファイル)
// TRANSLATION MISSING
|    wee-signal.c | Signal functions.
|    wee-string.c | 文字列関数
|    wee-upgrade-file.c | 内部アップグレードシステム
|    wee-upgrade.c | WeeChat コアのアップグレード (バッファ、行、履歴、...)
@@ -406,13 +412,19 @@ WeeChat "core" は以下のディレクトリに配置されています:
|          test-core-calc.cpp | Tests: calculation of expressions.
// TRANSLATION MISSING
|          test-core-crypto.cpp | Tests: cryptographic functions.
// TRANSLATION MISSING
|          test-core-dir.cpp | Tests: directory/file functions.
|          test-core-eval.cpp | テスト: 式の評価
|          test-core-hashtble.cpp | テスト: ハッシュテーブル
|          test-core-hdata.cpp | テスト: hdata
|          test-core-hook.cpp | テスト: フック
|          test-core-infolist.cpp | テスト: インフォリスト
|          test-core-list.cpp | テスト: リスト
// TRANSLATION MISSING
|          test-core-network.cpp | Tests: network functions.
|          test-core-secure.cpp | テスト: データ保護
// TRANSLATION MISSING
|          test-core-signal.cpp | テスト: signals.
|          test-core-string.cpp | テスト: 文字列
|          test-core-url.cpp | テスト: URL
|          test-core-utf8.cpp | テスト: UTF-8
@@ -441,6 +453,10 @@ WeeChat "core" は以下のディレクトリに配置されています:
// TRANSLATION MISSING
|             test-irc-server.cpp | Tests: IRC server.
// TRANSLATION MISSING
|          trigger/ | Root of unit tests for trigger plugin.
// TRANSLATION MISSING
|             test-trigger.cpp | Tests: triggers.
// TRANSLATION MISSING
|          relay/ | Root of unit tests for Relay plugin.
// TRANSLATION MISSING
|             test-relay-auth.cpp | Tests: clients authentication.
@@ -1111,18 +1127,13 @@ Git リポジトリはこの URL にあります: https://github.com/weechat/wee
リクエストを使って提出することを推奨します。パッチは電子メールで送信することも可能です
(`git diff` または `git format-patch` で作成してください)。
コミットメッセージは以下の書式に従ってください (GitHub の issue を閉じる場合):
// TRANSLATION MISSING
Format of commit message is the following (with automatic close of a GitHub issue):
----
component: fix a problem (closes #123)
----
Savannah のバグを閉じる場合:
----
component: fix a problem (bug #12345)
----
_component_ には以下から 1 つ選んで記入してください:
* WeeChat コア: _core_ (ルートディレクトリ、_po/_ ディレクトリ、_src/_
@@ -1134,19 +1145,18 @@ _component_ には以下から 1 つ選んで記入してください:
* 英語を使ってください
* 動詞の原形を使ってください
* コミットの内容がトラッカーに関するものである場合には、コミットメッセージの後にカッコで括ってその旨記載してください、書式は以下のようにしてください:
** GitHub: closes #123
** Savannah: bug #12345, task #12345, patch #12345
// TRANSLATION MISSING
* 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.
コミットメッセージの例:
----
irc: add command /unquiet (closes #36)
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
core: update Japanese translations
irc: add command /unquiet (closes #36)
python: fix crash when unloading a script without pointer to interpreter
core: update Japanese translations (patch #7783)
ruby: add detection of ruby version 1.9.3 in CMake
----
[[translations]]
+40 -29
View File
@@ -730,7 +730,9 @@ WeeChat でマウスが利用可能な場合、kbd:[Shift]
macOS をお使いの場合、必ず Homebrew から `openssl`
をインストールしてください。こうすることでシステムの鍵束に含まれる証明書を使いつつ、CA
ファイルを起動時に読み込ませることが可能になります。その後、WeeChat で証明書へのパスを設定してください:
// TRANSLATION MISSING
With WeeChat ≤ 3.1, you can set the path to system certificates:
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@@ -767,10 +769,12 @@ gnutls ハンドシェイクに関するエラーの場合、Diffie-Hellman キ
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
----
[[irc_ssl_freenode]]
=== どうすれば SSL を使って freenode サーバに接続できますか。
[[irc_ssl_libera]]
=== どうすれば SSL を使って libera サーバに接続できますか。
オプション _weechat.network.gnutls_ca_file_ に証明書ファイルへのパスを設定してください。
// TRANSLATION MISSING
With WeeChat ≤ 3.1, set option _weechat.network.gnutls_ca_file_ to file with
certificates:
----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
@@ -789,9 +793,9 @@ gnutls ハンドシェイクに関するエラーの場合、Diffie-Hellman キ
サーバポート、SSL を設定の後に接続してください:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
/set irc.server.libera.addresses "irc.libera.chat/6697"
/set irc.server.libera.ssl on
/connect libera
----
[[irc_oauth]]
@@ -816,25 +820,25 @@ oauth を使うにはパスワードを "oauth:XXXX" のように指定してく
SASL を利用する方が良いです。例えば:
----
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
対象のサーバが SASL
をサポートしない場合、コマンドとチャンネル参加の間に遅延時間を入れることもできます:
----
/set irc.server.freenode.command_delay 5
/set irc.server.libera.command_delay 5
----
[[edit_autojoin]]
=== どうすれば自動参加オプションにチャンネルを追加/削除できますか。
`/set` コマンドを使って、自動参加チャンネルのリストを編集してください。"freenode"
`/set` コマンドを使って、自動参加チャンネルのリストを編集してください。"libera"
サーバに対してこれを実行するには以下のようにします:
----
/set irc.server.freenode.autojoin [TAB]
/set irc.server.libera.autojoin [TAB]
----
[NOTE]
@@ -1002,17 +1006,17 @@ WeeChat バージョン 0.3.4 以上の場合、link:weechat_user.en.html#max_ho
/script install buffer_autoset.py
----
例えば、IRC サーバ freenode のチャンネル #weechat に参加している "mike"
例えば、IRC サーバ libera のチャンネル #weechat に参加している "mike"
の発言に対してハイライトを永久的に無効化するには以下のように設定します:
----
/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera.#weechat hotlist_max_level_nicks_add mike:2
----
この設定をすべての freenode サーバのバッファに対して適用するには以下のように設定します:
この設定をすべての libera サーバのバッファに対して適用するには以下のように設定します:
----
/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera hotlist_max_level_nicks_add mike:2
----
これ以外の例は `+/help buffer_autoset+` を参照してください。
@@ -1050,15 +1054,18 @@ weeget.py と script.pl を使ってください。
[[scripts_update]]
=== コマンド "/script update" でスクリプトを読み込むことができません。どうすればいいですか。
手始めに、この FAQ の SSL 接続に関する質問を確認してください
(特にオプション _weechat.network.gnutls_ca_file_ に関する質問)。
手始めに、この FAQ の SSL 接続に関する質問を確認してください
それでもだめなら、手作業で (シェルから) スクリプトリストファイルを削除してください:
----
$ rm ~/.weechat/script/plugins.xml.gz
$ rm ~/.cache/weechat/script/plugins.xml.gz
----
// TRANSLATION MISSING
[NOTE]
With WeeChat ≤ 3.1, the path should be: _~/.weechat/script/plugins.xml.gz_.
その後、WeeChat からスクリプトリストを更新してください:
----
@@ -1078,7 +1085,7 @@ $ rm ~/.weechat/script/plugins.xml.gz
* シェルからスクリプトリストファイルをダウンロードします (必要なら curl をインストールしてください):
----
$ cd ~/.weechat/script
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
----
@@ -1128,8 +1135,9 @@ WeeChat バージョン 2.4 以下では "spell" プラグインは "aspell" と
buflist、fifo、logger、perl、python、ruby、lua、tcl、guile、javascript、php、spell、xfer (DCC で使用)。
`/help weechat.plugin.autoload` を参照してください。
* 本当に必要なスクリプトだけをロード
* SSL を *使わない* なら、証明書を読み込まないでください: オプション
_weechat.network.gnutls_ca_file_ に空文字列を設定してください。
// TRANSLATION MISSING
* Do not load system certificates if SSL is *NOT* used: turn off this option:
_weechat.network.gnutls_ca_system_.
* _weechat.history.max_buffer_lines_number_
オプションの値を減らすか、_weechat.history.max_buffer_lines_minutes_ オプションに値を設定してください。
* _weechat.history.max_commands_ オプションの値を減らしてください。
@@ -1185,17 +1193,18 @@ link:weechat_user.ja.html#secured_data[ユーザーズガイド / 暗号化デ
----
/secure passphrase xxxxxxxxxx
/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}"
/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}"
----
[[sharing_config_files]]
=== WeeChat の設定を共有したいのですが、公開しても良いファイルと秘密にしておくべきファイルを教えてください。
_~/.weechat/*.conf_ ファイルは公開しても問題ありませんが、
パスフレーズで暗号化されたパスワードが含まれる _sec.conf_ ファイルは秘密にしてください。
// TRANSLATION MISSING
You can share configuration files _*.conf_ except the file _sec.conf_ which
contains your passwords ciphered with your passphrase.
// TRANSLATION MISSING
Some other files may contain sensitive info like passwords (if they are not
@@ -1234,7 +1243,9 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
[[supported_os]]
=== WeeChat をサポートするプラットフォームのリストを教えてください。他のオペレーティングシステムへの移植予定はありますか。
完全なリストはこのページにあります: https://weechat.org/download
// TRANSLATION MISSING
WeeChat runs fine on most Linux/BSD distributions, GNU/Hurd, Mac OS and Windows
(Cygwin and Windows Subsystem for Linux).
我々は可能な限り多くのプラットフォームに移植することに最善を尽くしています。我々が持っていない
OS で WeeChat をテストすることを歓迎します。
File diff suppressed because it is too large Load Diff
+21 -28
View File
@@ -112,12 +112,12 @@ IRC 等全てのネットワークプロトコルはそれぞれ異なるプラ
IRC サーバを追加するには `/server` コマンドを使ってください、例:
----
/server add freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
このコマンドにおいて、`freenode` は WeeChat が使う内部サーバ名です:
接続時には `/connect freenode` を使うことが可能で、このサーバに関するオプションは
_irc.server.freenode.xxx_ になります。
このコマンドにおいて、`libera` は WeeChat が使う内部サーバ名です:
接続時には `/connect libera` を使うことが可能で、このサーバに関するオプションは
_irc.server.libera.xxx_ になります。
書式が思い出せない場合はヘルプを利用してください:
@@ -136,45 +136,38 @@ _irc.server.freenode.xxx_ になります。
はデフォルト設定を使用します ("irc.server_default.xxx")。
例えばデフォルトでは (un*x ログイン名をベースにした)
ニックネームが設定されますが、以下のコマンドで freenode サーバ用の設定として上書きすることが可能です:
ニックネームが設定されますが、以下のコマンドで libera サーバ用の設定として上書きすることが可能です:
----
/set irc.server.freenode.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
/set irc.server.libera.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
----
ユーザ名と実名を設定する場合:
----
/set irc.server.freenode.username "My user name"
/set irc.server.freenode.realname "My real name"
/set irc.server.libera.username "My user name"
/set irc.server.libera.realname "My real name"
----
サーバへの自動接続を設定する場合:
----
/set irc.server.freenode.autoconnect on
----
SSL を使って接続する場合:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/set irc.server.libera.autoconnect on
----
サーバで SASL を利用可能な場合、SASL を利用してニックネーム認証することができます
(チャンネル参加前にニックネーム認証が行われるでしょう):
----
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
例えば nickserv との認証などを行うためにサーバ接続後にコマンドを実行するには
(SASL を利用して認証を行わない場合):
----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -188,23 +181,23 @@ _command_ オプションに複数のコマンドを含める場合は `;` (セ
/secure passphrase this is my secret passphrase
----
その後に freenode のパスワードを含む保護データを追加します:
その後に libera のパスワードを含む保護データを追加します:
----
/secure set freenode_password xxxxxxx
/secure set libera_password xxxxxxx
----
こうすることで前述したようにパスワードを IRC オプションに直接書くのではなく
`+${sec.data.freenode_password}+` を指定可能になります。例えば以下のように設定します:
`+${sec.data.libera_password}+` を指定可能になります。例えば以下のように設定します:
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
チャンネルへの自動参加を設定する場合:
----
/set irc.server.freenode.autojoin "#channel1,#channel2"
/set irc.server.libera.autojoin "#channel1,#channel2"
----
[TIP]
@@ -216,14 +209,14 @@ kbd:[Shift+Tab] キーを使えば部分的に補完することも可能です
(irc.server_default.nicks) を使用する場合:
----
/unset irc.server.freenode.nicks
/unset irc.server.libera.nicks
----
その他設定: その他のオプションも以下のコマンドで設定できます
("xxx" は設定名です):
----
/set irc.server.freenode.xxx value
/set irc.server.libera.xxx value
----
// TRANSLATION MISSING
@@ -231,11 +224,11 @@ kbd:[Shift+Tab] キーを使えば部分的に補完することも可能です
== Connect to IRC server
----
/connect freenode
/connect libera
----
// TRANSLATION MISSING
With this command, WeeChat connects to the freenode server and auto-joins the
With this command, WeeChat connects to the libera server and auto-joins the
channels configured in the "autojoin" server option.
[NOTE]
+72 -72
View File
@@ -453,11 +453,11 @@ hda:
item 2:
__path: ['0x558d62840ea0']
number: 1
full_name: 'irc.server.freenode'
full_name: 'irc.server.libera'
item 3:
__path: ['0x558d62a9cea0']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
----
* Request all lines of first buffer:
@@ -606,15 +606,15 @@ inf: ('version_number', '34144256')
* Request WeeChat directory:
----
(info_weechat_dir) info weechat_dir
(info_weechat_config_dir) info weechat_config_dir
----
Response:
[source,python]
----
id: 'info_weechat_dir'
inf: ('weechat_dir', '/home/xxx/.weechat')
id: 'info_weechat_config_dir'
inf: ('weechat_config_dir', '/home/user/.config/weechat')
----
[[command_infolist]]
@@ -767,7 +767,7 @@ inl:
// TRANSLATION MISSING
* _buffer_: ポインタ (eg: "0x1234abcd") またはバッファの完全な名前 (例:
_core.weechat_ または _irc.freenode.#weechat_)
_core.weechat_ または _irc.libera.#weechat_)
// TRANSLATION MISSING
Examples:
@@ -877,10 +877,10 @@ hda:
prefix_color: None
----
* Request nicklist for buffer "irc.freenode.#weechat":
* Request nicklist for buffer "irc.libera.#weechat":
----
(nicklist_weechat) nicklist irc.freenode.#weechat
(nicklist_weechat) nicklist irc.libera.#weechat
----
Response:
@@ -970,7 +970,7 @@ hda:
// TRANSLATION MISSING
* _buffer_: ポインタ (eg: "0x1234abcd") またはバッファの完全な名前 (例:
_core.weechat_ または _irc.freenode.#weechat_)
_core.weechat_ または _irc.libera.#weechat_)
* _data_: バッファに送信するデータ: `/`
で始まる場合、バッファ内でコマンドとして実行されます、それ以外の場合、テキストはバッファの入力として送信されます。
@@ -985,7 +985,7 @@ input core.weechat /help filter
* Send message "hello!" to #weechat channel:
----
input irc.freenode.#weechat hello!
input irc.libera.#weechat hello!
----
// TRANSLATION MISSING
@@ -1007,7 +1007,7 @@ a string for a given buffer.
// TRANSLATION MISSING
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.freenode.#weechat_)
_core.weechat_ or _irc.libera.#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_)
@@ -1169,7 +1169,7 @@ _WeeChat バージョン 0.4.1 で更新。_
// TRANSLATION MISSING
* _buffer_: ポインタ (eg: "0x1234abcd") またはバッファの完全な名前 (例:
_core.weechat_ または _irc.freenode.#weechat_);
_core.weechat_ または _irc.libera.#weechat_);
全てのバッファを指定するには "*" を使ってください
* _options_: 以下に挙げるキーワード、コンマ区切り ("*" に対するデフォルトは
_buffers,upgrade,buffer,nicklist_、バッファに対するデフォルトは _buffer,nicklist_):
@@ -1205,14 +1205,14 @@ sync core.buffer
* Synchronize #weechat channel, without nicklist:
----
sync irc.freenode.#weechat buffer
sync irc.libera.#weechat buffer
----
* Get general signals + all signals for #weechat channel:
----
sync * buffers,upgrade
sync irc.freenode.#weechat
sync irc.libera.#weechat
----
[[command_desync]]
@@ -1236,7 +1236,7 @@ _WeeChat バージョン 0.4.1 で更新。_
// TRANSLATION MISSING
* _buffer_: ポインタ (eg: "0x1234abcd") またはバッファの完全な名前 (例:
_core.weechat_ または _irc.freenode.#weechat_);
_core.weechat_ または _irc.libera.#weechat_);
全てのバッファを指定するには "*" を使ってください
* _options_: 以下に挙げるキーワード、コンマ区切り ("*" に対するデフォルトは
_buffers,upgrade,buffer,nicklist_、バッファに対するデフォルトは _buffer,nicklist_):
@@ -1244,7 +1244,7 @@ _WeeChat バージョン 0.4.1 で更新。_
[NOTE]
buffer に "*" を指定した場合、(名前を使って) 同期されている他のバッファは同期状態が保存されます。 +
このため "sync *"、"sync irc.freenode.#weechat"、"desync *" の順に送信した場合、WeeChat
このため "sync *"、"sync irc.libera.#weechat"、"desync *" の順に送信した場合、WeeChat
は #weechat チャンネルに対するアップデートを送信し続けます
(アップデートを止めるには、明示してこれを中止しなければいけません)。
@@ -1263,13 +1263,13 @@ desync * buffers,upgrade,buffer,nicklist
* Desynchronize nicklist for #weechat channel (keep buffer updates):
----
desync irc.freenode.#weechat nicklist
desync irc.libera.#weechat nicklist
----
* Desynchronize #weechat channel:
----
desync irc.freenode.#weechat
desync irc.libera.#weechat
----
[[command_test]]
@@ -1511,7 +1511,7 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
| short_name | string | 短い名前 (例: _#weechat_)
| nicklist | integer | バッファがニックネームリストを持つ場合 1、それ以外は 0
| title | string | バッファのタイトル
@@ -1520,8 +1520,8 @@ hdata として送られるデータ:
| next_buffer | pointer | 次のバッファへのポインタ
|===
例: freenode の _#weechat_ チャンネルに参加、新しいバッファは
_irc.freenode.#weechat_:
例: libera の _#weechat_ チャンネルに参加、新しいバッファは
_irc.libera.#weechat_:
[source,python]
----
@@ -1541,13 +1541,13 @@ hda:
item 1:
__path: ['0x35a8a60']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
short_name: None
nicklist: 0
title: None
local_variables: {
'plugin': 'irc',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
prev_buffer: '0x34e7400'
next_buffer: '0x0'
@@ -1565,12 +1565,12 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
| prev_buffer | pointer | 前のバッファへのポインタ
| next_buffer | pointer | 次のバッファへのポインタ
|===
例: バッファ _irc.freenode.#weechat_ を番号 2 に移動:
例: バッファ _irc.libera.#weechat_ を番号 2 に移動:
[source,python]
----
@@ -1586,7 +1586,7 @@ hda:
item 1:
__path: ['0x34588c0']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x347b9f0'
next_buffer: '0x3471bc0'
----
@@ -1603,12 +1603,12 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
| prev_buffer | pointer | 前のバッファへのポインタ
| next_buffer | pointer | 次のバッファへのポインタ
|===
例: バッファ _irc.freenode.#weechat_ をバッファ #2 とマージ:
例: バッファ _irc.libera.#weechat_ をバッファ #2 とマージ:
[source,python]
----
@@ -1624,7 +1624,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1641,12 +1641,12 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
| prev_buffer | pointer | 前のバッファへのポインタ
| next_buffer | pointer | 次のバッファへのポインタ
|===
例: バッファ _irc.freenode.#weechat_ をアンマージ:
例: バッファ _irc.libera.#weechat_ をアンマージ:
[source,python]
----
@@ -1662,7 +1662,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1681,12 +1681,12 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
| prev_buffer | pointer | 前のバッファへのポインタ
| next_buffer | pointer | 次のバッファへのポインタ
|===
例: バッファ _irc.freenode.#weechat_ を隠す:
例: バッファ _irc.libera.#weechat_ を隠す:
[source,python]
----
@@ -1702,7 +1702,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1721,12 +1721,12 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
| prev_buffer | pointer | 前のバッファへのポインタ
| next_buffer | pointer | 次のバッファへのポインタ
|===
例: バッファ _irc.freenode.#weechat_ を隠すことを止める:
例: バッファ _irc.libera.#weechat_ を隠すことを止める:
[source,python]
----
@@ -1742,7 +1742,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1759,7 +1759,7 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
| short_name | string | 短い名前 (例: _#weechat_)
| local_variables | hashtable | ローカル変数
|===
@@ -1780,15 +1780,15 @@ hda:
item 1:
__path: ['0x4df7b80']
number: 5
full_name: 'irc.freenode.Flash2'
full_name: 'irc.libera.Flash2'
short_name: 'Flash2'
local_variables: {
'server': 'freenode',
'server': 'libera',
'plugin': 'irc',
'type': 'private',
'channel': 'FlashCode',
'nick': 'test',
'name': 'freenode.Flash2',
'name': 'libera.Flash2',
}
----
@@ -1804,7 +1804,7 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
| title | string | バッファのタイトル
|===
@@ -1823,7 +1823,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
title: 'Welcome on #weechat! https://weechat.org/'
----
@@ -1841,10 +1841,10 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
|===
例: バッファ _irc.freenode.#weechat_ をクリア:
例: バッファ _irc.libera.#weechat_ をクリア:
[source,python]
----
@@ -1858,7 +1858,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
----
[[message_buffer_type_changed]]
@@ -1873,7 +1873,7 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
| type | integer | バッファの種類: 0 = 書式あり (デフォルト)、1 = 自由内容
|===
@@ -1909,11 +1909,11 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
| local_variables | hashtable | ローカル変数
|===
例: _irc.freenode.#weechat_ にローカル変数 _test_ を追加:
例: _irc.libera.#weechat_ にローカル変数 _test_ を追加:
[source,python]
----
@@ -1928,15 +1928,15 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
local_variables: {
'server': 'freenode',
'server': 'libera',
'test': 'value',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -1952,11 +1952,11 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
| local_variables | hashtable | ローカル変数
|===
例: _irc.freenode.#weechat_ に含まれるローカル変数 _test_ を更新:
例: _irc.libera.#weechat_ に含まれるローカル変数 _test_ を更新:
[source,python]
----
@@ -1971,7 +1971,7 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
local_variables: {
'server': 'local',
'test': 'value2',
@@ -1979,7 +1979,7 @@ hda:
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -1995,11 +1995,11 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
| local_variables | hashtable | ローカル変数
|===
例: _irc.freenode.#weechat_ からローカル変数 _test_ を削除:
例: _irc.libera.#weechat_ からローカル変数 _test_ を削除:
[source,python]
----
@@ -2014,14 +2014,14 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#prout'
full_name: 'irc.libera.#prout'
local_variables: {
'server': 'local',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -2048,7 +2048,7 @@ hdata として送られるデータ:
| message | string | メッセージ
|===
例: バッファ _irc.freenode.#weechat_ でニックネーム _FlashCode_ からの新しいメッセージ _hello!_:
例: バッファ _irc.libera.#weechat_ でニックネーム _FlashCode_ からの新しいメッセージ _hello!_:
[source,python]
----
@@ -2097,10 +2097,10 @@ hdata として送られるデータ:
|===
| 名前 | 型 | 説明
| number | integer | バッファ番号 (1 以上)
| full_name | string | 完全な名前 (例: _irc.freenode.#weechat_)
| full_name | string | 完全な名前 (例: _irc.libera.#weechat_)
|===
例: WeeChat がバッファ _irc.freenode.#weechat_ を閉じる:
例: WeeChat がバッファ _irc.libera.#weechat_ を閉じる:
[source,python]
----
@@ -2114,7 +2114,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
----
[[message_nicklist]]
@@ -2140,7 +2140,7 @@ hdata として送られるデータ:
| prefix_color | string | プレフィックスの色 (ニックネーム専用)
|===
例: バッファ _irc.freenode.#weechat_ のニックネームリスト:
例: バッファ _irc.libera.#weechat_ のニックネームリスト:
[source,python]
----
@@ -2559,7 +2559,7 @@ length '1' '3' '2' '1' '9' '9' '3' '4' '5' '6'
* _values_: 値のリスト (値の数は hdata
で返されるキーの数)
2 つのバッファ (weechat コアと freenode サーバ) と
2 つのバッファ (weechat コアと libera サーバ) と
2 つのキー (_number_ と _full_name_) を持つ hdata の例:
....
@@ -2567,10 +2567,10 @@ length '1' '3' '2' '1' '9' '9' '3' '4' '5' '6'
hdata buffer:gui_buffers(*) number,full_name
# 応答
┌────────┬──────────────────────────┬───╥─────────┬───┬──────────────╥─────────┬───┬─────────────────────
│ buffer │ number:int,full_name:str │ 2 ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │ irc.server.freenode
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴─────────────────────
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └─────────────────────────────────
┌────────┬──────────────────────────┬───╥─────────┬───┬──────────────╥─────────┬───┬───────────────────┐
│ buffer │ number:int,full_name:str │ 2 ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │ irc.server.libera
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴───────────────────┘
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └───────────────────────────────┘
h-path keys count buffer 1 buffer 2
....
@@ -2712,7 +2712,7 @@ _version_ インフォの例:
** _type_: 変数の型 (_int_、_str_、...)
** _value_: 変数の値
2 つのバッファ (weechat コアと freenode サーバ) を持つインフォリストの例:
2 つのバッファ (weechat コアと libera サーバ) を持つインフォリストの例:
....
# コマンド
+101 -67
View File
@@ -72,14 +72,19 @@ link:weechat_plugin_api.ja.html#_hook_process[WeeChat プラグイン API リフ
[[languages_specificities]]
=== 言語仕様
[[language_python]]
==== Python
// TRANSLATION MISSING
[[python_module]]
===== Module
WeeChat defines a `weechat` module which must be imported with `import weechat`.
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].
// TRANSLATION MISSING
[[python_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...)+`.
@@ -88,6 +93,7 @@ Functions `+print*+` are called `+prnt*+` in python (because `print` was a
reserved keyword in Python 2).
// TRANSLATION MISSING
[[python_strings]]
===== Strings received in callbacks
In Python 3 and with WeeChat ≥ 2.7, the strings received in callbacks have type
@@ -141,21 +147,26 @@ 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
// TRANSLATION MISSING
[[perl_functions]]
===== Functions
Functions are called with `+weechat::xxx(arg1, arg2, ...);+`.
[[language_ruby]]
==== Ruby
// TRANSLATION MISSING
[[ruby_init]]
===== Initialization
You have to define _weechat_init_ and call _register_ inside.
// TRANSLATION MISSING
[[ruby_functions]]
===== Functions
Functions are called with `+Weechat.xxx(arg1, arg2, ...)+`.
@@ -181,23 +192,29 @@ Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical"
["default", "default", "default", "default"], "0", "items")
----
[[language_lua]]
==== Lua
// TRANSLATION MISSING
[[lua_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...)+`.
[[language_tcl]]
==== Tcl
// TRANSLATION MISSING
[[tcl_functions]]
===== Functions
Functions are called with `+weechat::xxx arg1 arg2 ...+`.
[[language_guile]]
==== Guile (Scheme)
// TRANSLATION MISSING
[[guile_functions]]
===== Functions
Functions are called with `+(weechat:xxx arg1 arg2 ...)+`.
@@ -210,16 +227,20 @@ arguments in Guile:
* config_new_option
* bar_new
[[language_javascript]]
==== JavaScript
// TRANSLATION MISSING
[[javascript_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...);+`.
[[language_php]]
==== PHP
// TRANSLATION MISSING
[[php_functions]]
===== Functions
Functions are called with `+weechat_xxx(arg1, arg2, ...);+`.
@@ -230,11 +251,11 @@ Functions are called with `+weechat_xxx(arg1, arg2, ...);+`.
全ての WeeChat スクリプトは WeeChat
に自分自身を「登録」し、登録はスクリプトの最初で行われなければいけません。
プロトタイプ:
プロトタイプ (Python):
[source,python]
----
weechat.register(name, author, version, license, description, shutdown_function, charset)
def register(name: str, author: str, version: str, license: str, description: str, shutdown_function: str, charset: str) -> int: ...
----
引数:
@@ -355,7 +376,7 @@ _language/autoload_ ディレクトリ内にリンクを作ってください。
例えば Python の場合:
----
$ cd ~/.weechat/python/autoload
$ cd ~/.local/share/weechat/python/autoload
$ ln -s ../script.py
----
@@ -795,61 +816,68 @@ link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス]
[width="100%",cols="1,3",options="header"]
|===
| カテゴリ | 定数
| カテゴリ | 定数
// TRANSLATION MISSING
| リターンコード |
WEECHAT_RC_OK +
WEECHAT_RC_OK_EAT +
WEECHAT_RC_ERROR
`WEECHAT_RC_OK` (integer) +
`WEECHAT_RC_OK_EAT` (integer) +
`WEECHAT_RC_ERROR` (integer)
// TRANSLATION MISSING
| 設定ファイル |
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
`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)
// TRANSLATION MISSING
| ソート済みリスト |
WEECHAT_LIST_POS_SORT +
WEECHAT_LIST_POS_BEGINNING +
WEECHAT_LIST_POS_END
`WEECHAT_LIST_POS_SORT` (string) +
`WEECHAT_LIST_POS_BEGINNING` (string) +
`WEECHAT_LIST_POS_END` (string)
// TRANSLATION MISSING
| ホットリスト |
WEECHAT_HOTLIST_LOW +
WEECHAT_HOTLIST_MESSAGE +
WEECHAT_HOTLIST_PRIVATE +
WEECHAT_HOTLIST_HIGHLIGHT
`WEECHAT_HOTLIST_LOW` (string) +
`WEECHAT_HOTLIST_MESSAGE` (string) +
`WEECHAT_HOTLIST_PRIVATE` (string) +
`WEECHAT_HOTLIST_HIGHLIGHT` (string)
// TRANSLATION MISSING
| プロセスのフック |
WEECHAT_HOOK_PROCESS_RUNNING +
WEECHAT_HOOK_PROCESS_ERROR
`WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
`WEECHAT_HOOK_PROCESS_ERROR` (integer)
// TRANSLATION MISSING
| 接続のフック |
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
`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)
// TRANSLATION MISSING
| シグナルのフック |
WEECHAT_HOOK_SIGNAL_STRING +
WEECHAT_HOOK_SIGNAL_INT +
WEECHAT_HOOK_SIGNAL_POINTER
`WEECHAT_HOOK_SIGNAL_STRING` (string) +
`WEECHAT_HOOK_SIGNAL_INT` (string) +
`WEECHAT_HOOK_SIGNAL_POINTER` (string)
|===
[[common_tasks]]
@@ -890,13 +918,13 @@ weechat.prnt("", "%swrong arguments" % weechat.prefix("error"))
weechat.prnt("", "text %syellow on blue" % weechat.color("yellow,blue"))
# バッファを検索してメッセージを表示
# (バッファの完全な名前は plugin.name のような形です、例えば: "irc.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
# (バッファの完全な名前は plugin.name のような形です、例えば: "irc.libera.#weechat")
buffer = weechat.buffer_search("irc", "libera.#weechat")
weechat.prnt(buffer, "message on #weechat channel")
# ある IRC バッファを見つける他の方法 (推奨)
# (サーバとチャンネルはコンマで区切ってください。)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.prnt(buffer, "message on #weechat channel")
----
@@ -917,7 +945,7 @@ Print 関数は Python では `prnt`、その他の言語では `print` と呼
weechat.command("", "/help")
# テキスト "hello" を #weechat IRC チャンネルに送信 (このチャンネルにいるユーザにはメッセージが見えます。)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.command(buffer, "hello")
----
@@ -1223,7 +1251,7 @@ xxx,irc_raw_in2_yyy::
[source,python]
----
def join_cb(data, signal, signal_data):
# シグナル、例えば: "freenode,irc_in2_join"
# シグナル、例えば: "libera,irc_in2_join"
# signal_data は IRC メッセージ、例えば: ":nick!user@host JOIN :#channel"
server = signal.split(",")[0]
msg = weechat.info_get_hashtable("irc_message_parse", {"message": signal_data})
@@ -1278,64 +1306,69 @@ _WeeChat バージョン 0.3.4 以上で利用可。_
(例の値は以下のメッセージから作られました:
`+@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!+`):
[width="100%",cols="1,^2,10,8",options="header"]
[width="100%",cols="3,^2,10,7",options="header"]
|===
| キー | WeeChat バージョン | 説明 | 例
// TRANSLATION MISSING
| キー | Since WeeChat ^(1)^ | 説明 | 例
| tags | 0.4.0 以上 |
| tags | 0.4.0 |
メッセージに付けられたタグ (空にすることも可) |
`+time=2015-06-27T16:40:35.000Z+`
| message_without_tags | 0.4.0 以上 |
| message_without_tags | 0.4.0 |
タグを除いたメッセージ (タグが付けられていなければメッセージと同じ) |
`+:nick!user@host PRIVMSG #weechat :hello!+`
| nick | 0.3.4 以上 |
| nick | 0.3.4 |
発信者のニックネーム |
`+nick+`
// TRANSLATION MISSING
| user | 2.7 |
| user | 2.7 |
The origin user. |
`+user+`
| host | 0.3.4 以上 |
| host | 0.3.4 |
発信者のホスト (ニックネームを含む) |
`+nick!user@host+`
| command | 0.3.4 以上 |
| command | 0.3.4 |
コマンド (_PRIVMSG_、_NOTICE_、...) |
`+PRIVMSG+`
| channel | 0.3.4 以上 |
| channel | 0.3.4 |
送信先チャンネル |
`+#weechat+`
| arguments | 0.3.4 以上 |
| arguments | 0.3.4 |
コマンド引数 (チャンネルを含む) |
`+#weechat :hello!+`
| text | 1.3 以上 |
| text | 1.3 |
テキスト (ユーザメッセージなど) |
`+hello!+`
| pos_command | 1.3 以上 |
| pos_command | 1.3 |
メッセージ内における _command_ のインデックス (_command_ が見つからない場合 "-1") |
`+47+`
| pos_arguments | 1.3 以上 |
| pos_arguments | 1.3 |
メッセージ内における _arguments_ のインデックス (_arguments_ が見つからない場合 "-1") |
`+55+`
| pos_channel | 1.3 以上 |
| pos_channel | 1.3 |
メッセージ内における _channel_ のインデックス (_channel_ が見つからない場合 "-1") |
`+55+`
| pos_text | 1.3 以上 |
| pos_text | 1.3 |
メッセージ内における _text_ のインデックス (_text_ が見つからない場合 "-1") |
`+65+`
|===
// TRANSLATION MISSING
[NOTE]
^(1)^ The key has been introduced in this WeeChat version.
[source,python]
----
dict = weechat.info_get_hashtable(
@@ -1394,10 +1427,11 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[[infos_other]]
==== その他の情報
// TRANSLATION MISSING
[source,python]
----
# WeeChat ホームディレクトリ、例えば: "/home/xxxx/.weechat"
weechat.prnt("", "WeeChat home dir: %s" % weechat.info_get("weechat_dir", ""))
# WeeChat config directory, for example: "/home/user/.config/weechat"
weechat.prnt("", "WeeChat config dir: %s" % weechat.info_get("weechat_config_dir", ""))
# キーボードの不使用時間
weechat.prnt("", "Inactivity since %s seconds" % weechat.info_get("inactivity", ""))
+1 -1
View File
@@ -130,6 +130,6 @@ $ ~/weechat-git/bin/weechat
の最新バージョンを使っていることを確認するべきです ;)
おかしな (問題を引き起こしたり、クラッシュしたり、あなたを怒らせるような) 挙動を見つけたら
_chat.freenode.net_ の _#weechat_ に参加して、開発チームにこの挙動を教えてください。
_irc.libera.chat_ の _#weechat_ に参加して、開発チームにこの挙動を教えてください。
クラッシュしなかったとしても教えてください。開発チームはあなたからのフィードバックをお待ちしています!
File diff suppressed because it is too large Load Diff
@@ -233,6 +233,10 @@ _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) +
+15 -3
View File
@@ -20,6 +20,8 @@
| irc | irc_is_channel | 1 jeśli ciąg jest poprawną nazwą kanału IRC dla serwera | serwer,kanał (serwer jest opcjonalny)
| irc | irc_is_message_ignored | 1 jeśli nick jest ignorowany (wiadomość nie jest wyświetlana) | serwer,wiadomość (wiadomość to nieprzetworzona wiadomość IRC)
| irc | irc_is_nick | 1 jeśli ciąg jest poprawną nazwą użytkownika IRC | serwer,nick (serwer jest opcjonalny)
| irc | irc_nick | pobiera aktualny nick z serwera | nazwa serwera
@@ -58,7 +60,7 @@
| php | php_version | wersja użytego interpretera | -
| python | python2_bin | ścieżka do interpretera pythona 2.x | -
| python | python2_bin | ścieżka do interpretera Pythona 2.x (*przestarzałe* od wersji 2.6 skrypty muszą używać tylko Pythona 3) | -
| python | python_eval | wykonywanie kodu źródłowego | kod źródłowy do wykonania
@@ -74,7 +76,7 @@
| ruby | ruby_version | wersja użytego interpretera | -
| spell | spell_dict | oddzielona przecinkami lista słowników używanych w buforze | wskaźnik na bufor ("0x12345678") lub jego pełna nazwa ("irc.freenode.#weechat")
| spell | spell_dict | oddzielona przecinkami lista słowników używanych w buforze | wskaźnik na bufor ("0x12345678") lub jego pełna nazwa ("irc.libera.#weechat")
| tcl | tcl_eval | wykonywanie kodu źródłowego | kod źródłowy do wykonania
@@ -132,7 +134,15 @@
| weechat | version_number | Wersja WeeChat (jako liczba) | -
| weechat | weechat_dir | Katalog WeeChat | -
| weechat | weechat_cache_dir | Katalog z cache WeeChata | -
| weechat | weechat_config_dir | Katalog z konfiguracją WeeChat | -
| weechat | weechat_daemon | 1 jeśli WeeChat działa w trybie daemona (bez GUI, w tle) | -
| weechat | weechat_data_dir | Katalog danych WeeChat | -
| weechat | weechat_dir | Katalog WeeChat (*przestarzałe* od wersji 3.2, zastąpione przez "weechat_config_dir", "weechat_data_dir", "weechat_cache_dir" i "weechat_runtime_dir") | -
| weechat | weechat_headless | 1 jeśli WeeChat działa w trybie bez interfejsu | -
@@ -140,6 +150,8 @@
| weechat | weechat_localedir | Katalog "locale" WeeChata | -
| weechat | weechat_runtime_dir | Katalog uruchomieniowy WeeChat | -
| weechat | weechat_sharedir | Katalog "share" WeeChata | -
| weechat | weechat_site | Strona WeeChat | -
@@ -14,5 +14,7 @@
| weechat | focus_info | pobierz informacje o focusie | "x": współrzędne w osi x (ciąg z liczbą >= 0), "y": y współrzędne w osi y (ciąg z liczbą >= 0) | zobacz funkcję „hook_focus” w opisie API wtyczek
| weechat | secured_data | zabezpieczone dane | - | zabezpieczone dane: nazwy i wartości (uważaj: to są wrażliwe dane: NIE wyświetlaj/zapisuj ich nigdzie)
|===
// end::infos_hashtable[]
+71 -63
View File
@@ -161,7 +161,7 @@ Przykłady:
W celu rozłączenia z serwerem lub przerwania próby połączenia, użyj komendy /disconnect.
Przykłady:
/connect freenode
/connect libera
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
@@ -301,10 +301,10 @@ Uwaga: wyrażenie regularne może zaczynać się od "(?-i)" jeśli wielkość zn
Przykłady:
ignoruje wszędzie nick "toto":
/ignore add toto
ignoruje host "toto@domain.com" na serwerze freenode:
/ignore add toto@domain.com freenode
ignoruje host "toto*@*.domain.com" na freenode/#weechat:
/ignore add toto*@*.domain.com freenode #weechat
ignoruje host "toto@domain.com" na serwerze libera:
/ignore add toto@domain.com libera
ignoruje host "toto*@*.domain.com" na libera/#weechat:
/ignore add toto*@*.domain.com libera #weechat
----
[[command_irc_info]]
@@ -349,7 +349,7 @@ nick: nazwa użytkownika
Przykłady:
/join #weechat
/join #tajnykanał,#weechat klucz
/join -server freenode #weechat
/join -server libera #weechat
/join -noswitch #weechat
----
@@ -361,7 +361,7 @@ Przykłady:
kanał: nazwa kanału
nick: nick
powód: powód(specjalne zmienne jak $nick, $channel i $server są podmieniane na odpowiednie wartości)
powód: powód (przetwarzane, zobacz /help eval; specjalne zmienne jak ${nick} (własny nick), ${target} (docelowy nick), ${channel} i ${server} są podmieniane na odpowiednie wartości)
----
[[command_irc_kickban]]
@@ -372,7 +372,7 @@ kanał: nazwa kanału
kanał: nazwa kanału
nick: nick
powód: powód (specjalne zmienne jak $nick, $channel i $server są podmieniane na odpowiednie wartości)
powód: powód (przetwarzane, zobacz /help eval; specjalne zmienne jak ${nick} (własny nick), ${target} (docelowy nick), ${channel} i ${server} są podmieniane na odpowiednie wartości)
Możliwe jest kopanie/banowanie za pomocą maski, nick zostanie wyciągnięty z maski i zastąpiony "*".
@@ -552,10 +552,10 @@ Bez argumentu, komenda wyświetla powiadomienia dla obecnego serwera (lub wszyst
Przykłady:
powiadom, kiedy "toto" wejdzie/wyjdzie z obecnego serwera:
/notify add toto
powiadom, kiedy "toto" wejdzie/wyjdzie z serwera freenode:
/notify add toto freenode
powiadom, kiedy "toto" jest niedostępny lub powróci na serwerze freenode:
/notify add toto freenode -away
powiadom, kiedy "toto" wejdzie/wyjdzie z serwera libera:
/notify add toto libera
powiadom, kiedy "toto" jest niedostępny lub powróci na serwerze libera:
/notify add toto libera -away
----
[[command_irc_op]]
@@ -673,7 +673,7 @@ opcje: dodatkowe opcje, dla niektórych serwerów
kanał: nazwa kanału
nick: nick
powód: powód(specjalne zmienne jak $nick, $channel i $server są podmieniane na odpowiednie wartości)
powód: powód (przetwarzane, zobacz /help eval; specjalne zmienne jak ${nick} (własny nick), ${target} (docelowy nick), ${channel} i ${server} są podmieniane na odpowiednie wartości)
----
[[command_irc_restart]]
@@ -774,16 +774,16 @@ noopcja: ustawia opcje boolowskie na 'off' (na przykład: -nossl)
Przykłady:
/server listfull
/server add freenode chat.freenode.net
/server add freenode chat.freenode.net/6697 -ssl -autoconnect
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy freenode freenode-test
/server rename freenode-test freenode2
/server reorder freenode2 freenode
/server del freenode
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server deloutq
/server raw
/server raw s:freenode
/server raw s:libera
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
@@ -1305,7 +1305,7 @@ infolists: wyświetla informacje o infolistach
-n: wyświetla wynik bez wysyłania go do buforu (tryb debugowania)
-s: podziel wyrażenie przed przetworzeniem go (wiele komend może być oddzielonych średnikami)
-d: wyświetl wyjście debugowe po ewaluacji
-d: wyświetl wyjście debugowe po ewaluacji (drugie -d wyświetli więcej informacji)
-c: przetwarza jako warunek: użyj operatorów i nawiasów, zwraca wartość logiczną ("0" lub "1")
wyrażenie: wyrażenie do przetworzenia, zmienne o formacie ${zmienna} są zastępowane (zobacz niżej); wiele komend można oddzielić średnikami
operator: operator logiczny lub porównania:
@@ -1340,26 +1340,28 @@ W celu wymuszenia porównywania ciągów, należy umieścić każde wyrażenie w
"50" > "100" ==> 1
Niektóre zmienne w wyrażeniach są zamieniane, poprzez zastosowanie formatu ${zmienna}, według priorytetu zmienną może być:
1. przetworzony ciąg (format: "eval:xxx")
2. przetworzone wyrażenie (format: "eval_cond:xxx")
3. ciąg z wyescapowanymi znakami (format: "esc:xxx" lub "\xxx")
4. ciąg ze znakami do ukrycia (format: "hide:char,string")
5. ciąg o maksymalnej długości (format: "cut:max,suffix,string" lub "cut:+max,suffix,string")
1. nieprzetworzony ciąg (format: "raw:xxx")
2. przetworzony ciąg (format: "eval:xxx")
3. przetworzony warunek (format: "eval_cond:xxx")
4. ciąg z wyescapowanymi znakami (format: "esc:xxx" lub "\xxx")
5. ciąg ze znakami do ukrycia (format: "hide:char,string")
6. ciąg o maksymalnej długości (format: "cut:max,suffix,string" lub "cut:+max,suffix,string")
lub maksymalna ilość znaków wyświetlanych na ekranie (format: "cutscr:max,suffix,string" lub "cutscr:+max,suffix,string")
6. odwrócony ciąg (format: "rev:xxx")
7. powtórzony ciąg (format: "repeat:ilość,ciąg")
8. długość ciągu (format: "length:xxx" or "lengthscr:xxx")
9. kolor (format "color:xxx", zobacz „Opis API wtyczek”, funkcja "color")
10. modyfikator (format: "modifier:name,data,string")
11. informacja (format: "info:nazwa,argumenty", argumenty są opcjonalne)
12. ciąg zakodowany/zdekodowany z base 16/32/64 (format: "base_encode:base,xxx" lub "base_decode:base,xxx")
13. obecna data/czas (format: "date" lub "date:format")
14. zmienna środowiskowa (format: "env:XXX")
15. wyrażenie warunkowe (format: "if:condition?value_if_true:value_if_false")
16. wynik wyrażenia z nawiasami i operatorami + - * / // % ** (format: "calc:xxx")
17. opcja (format: plik.sekcja.opcja)
18 zmienna lokalna w buforze
19. nazwa hdatay/zmiennej (wartość jest automatycznie konwertowana na ciąg znaków), domyślnie „window” i „buffer” wskazują na aktualne okno/bufor.
7. odwrócony ciąg (format: "rev:xxx")
8. powtórzony ciąg (format: "repeat:ilość,ciąg")
9. długość ciągu (format: "length:xxx" or "lengthscr:xxx")
10. kolor (format "color:xxx", zobacz „Opis API wtyczek”, funkcja "color")
11. modyfikator (format: "modifier:name,data,string")
12. informacja (format: "info:nazwa,argumenty", argumenty są opcjonalne)
13. ciąg zakodowany/zdekodowany z base 16/32/64 (format: "base_encode:base,xxx" lub "base_decode:base,xxx")
14. obecna data/czas (format: "date" lub "date:format")
15. zmienna środowiskowa (format: "env:XXX")
16. wyrażenie warunkowe (format: "if:condition?value_if_true:value_if_false")
17. wynik wyrażenia z nawiasami i operatorami + - * / // % ** (format: "calc:xxx")
18. przetłumaczony ciąg (format: "translate:xxx")
19. opcja (format: plik.sekcja.opcja)
20. zmienna lokalna w buforze
21. nazwa hdatay/zmiennej (wartość jest automatycznie konwertowana na ciąg znaków), domyślnie „window” i „buffer” wskazują na aktualne okno/bufor.
Format dla hdata może być jednym z poniższych:
hdata.zmienna1.zmienna2...: inicjuje hdata (wskaźnik musi być znany), następnie wypytuje zmienne jedna po drugiej (inne hdata mogą być następne)
hdata[list].zmienna1.zmienna2...: inicjuje hdata z wykorzystaniem listy, na przykład:
@@ -1367,14 +1369,16 @@ Format dla hdata może być jednym z poniższych:
${plugin[weechat_plugins].name}: nazwa pierwszej wtyczki w połączonej liście wtyczek
hdata[wskaźnik].zmienna1.zmienna2...: zacznij z hdata używając wskaźnika, na przykład:
${buffer[0x1234abcd].full_name}: pełna nazwa buforu z tym wskaźnikiem (może zostać użyte w triggerach)
Nazwy hdata i zmiennych, można znaleźć w „Opisie API wtyczek”, funkcja "weechat_hdata_get".
${buffer[my_pointer].full_name}: pełna nazwa buforu z jego wskaźnikiem (może zostać użyte w triggerach)
Nazwy hdata i zmiennych, można znaleźć w „Opisie API wtyczek”, funkcja "weechat_hdata_get".
Przykłady (proste ciągi):
/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.freenode_password} ==> secret
/eval -n ${sec.data.password} ==> secret
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
@@ -1391,6 +1395,7 @@ Przykłady (proste ciągi):
/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} ==> Wtyczka
Przykłady (warunki):
/eval -n -c ${window.buffer.number} > 2 ==> 0
@@ -1428,7 +1433,7 @@ addreplace: dodaje lub nadpisuje istniejący filtr
del: usuwa filtr
-all: usuwa wszystkie filtry
bufor: oddzielona przecinkami lisa buforów, dla których filtr jest aktywny:
- jest to pełna nazwa zawierająca wtyczkę (przykład: "irc.freenode.#weechat" lub "irc.server.freenode")
- jest to pełna nazwa zawierająca wtyczkę (przykład: "irc.libera.#weechat" lub "irc.server.libera")
- "*" oznacza wszystkie bufory
- nazwa zaczynająca się od '!' jest wykluczana
- dozwolony jest znak "*"
@@ -1463,11 +1468,11 @@ Przykłady:
filtruj nicki wyświetlane przy wejściu na kanał albo za pomocą /names:
/filter add nicks * irc_366 *
filtruj nick "toto" na kanale IRC #weechat:
/filter add toto irc.freenode.#weechat nick_toto *
/filter add toto irc.libera.#weechat nick_toto *
filtruj wejścia/akcje IRC od użytkownika "toto":
/filter add toto * nick_toto+irc_join,nick_toto+irc_action *
filtruj linie zawierające frazę "weechat sucks" na kanale IRC #weechat:
/filter add sucks irc.freenode.#weechat * weechat sucks
/filter add sucks irc.libera.#weechat * weechat sucks
filtruj linie "WeeChat sucks" we wszystkich buforach:
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -1669,7 +1674,7 @@ Przykłady:
-core: bez wyświetlania wyjścia w głównym buforze WeeChat
-current: bez wyświetlania wyjścia na obecnym kanale
-buffer: bez wyświetlania wyjścia w podanym buforze
nazwa: pełna nazwa bufora (przykłady: "irc.server.freenode", "irc.freenode.#weechat")
nazwa: pełna nazwa bufora (przykłady: "irc.server.libera", "irc.libera.#weechat")
komenda: komenda do cichego wykonania ( '/' jest dodawane automatycznie jeśli nie znalezione na początku komendy)
Jeżeli nie podano celu (-core, -current lub -buffer), wtedy domyślnie jest wyciszane są wszystkie bufory.
@@ -1680,7 +1685,7 @@ Przykłady:
wiadomość do obecnego kanału IRC:
/mute -current msg * hej!
wiadomość na kanał #weechat:
/mute -buffer irc.freenode.#weechat msg #weechat hej!
/mute -buffer irc.libera.#weechat msg #weechat hej!
----
[[command_weechat_plugin]]
@@ -1748,7 +1753,7 @@ Przykłady:
wyświetla wiadomość w głównym buforze z prefiksem "abc":
/print -core abc\tWiadomość
wyświetla wiadomość na kanale #weechat:
/print -buffer irc.freenode.#weechat Message on #weechat
/print -buffer irc.libera.#weechat Message on #weechat
wyświetla bałwana (U+2603):
/print -escape \u2603
wysyła alert (BEL):
@@ -1870,7 +1875,7 @@ Kombinacje klawiszy w bezpiecznym buforze:
alt+v przełącza wartości
Jeśli używane jest hasło (dane zaszyfrowane), należy je podać podczas startu WeeChat.
Jest możliwe ustawienie zmiennej środowiskowej "WEECHAT_PASSPHRASE", aby nie podawać hasła przy uruchomieniu (ta sama zmienna jest używana przez WeeChat podczas wykonywania /upgrade).
Jest możliwe ustawienie zmiennej środowiskowej "WEECHAT_PASSPHRASE", aby nie podawać hasła przy uruchomieniu (ta sama zmienna jest używana przez WeeChat podczas wykonywania /upgrade), lub ustawienie opcji sec.crypt.passphrase_command żeby odczytać hasło z wyjścia zewnętrznego polecenia jak managera haseł (zobacz /help sec.crypt.passphrase_command).
Zabezpieczone dane w formacie ${sec.data.xxx} można użyć w:
- komendzie /eval
@@ -1881,14 +1886,16 @@ Zabezpieczone dane w formacie ${sec.data.xxx} można użyć w:
Przykłady:
ustawienie hasła:
/secure passphrase to jest moje hasło
zaszyfrowanie hasła dla freenode SASL:
/secure set freenode mojehasło
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
użyj programu "pass" do odczytania hasła przy uruchomieniu:
/set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"
zaszyfrowanie hasła dla libera SASL:
/secure set libera mojehasło
/set irc.server.libera.sasl_password "${sec.data.libera}"
zaszyfrowanie hasła dla nickserva na serwerze oftc:
/secure set oftc mojehasło
/set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}"
alias dla polecenia ghost dla nicka "mójnick":
/alias ghost /eval /msg -server freenode nickserv ghost mójnick ${sec.data.freenode}
/alias ghost /eval /msg -server libera nickserv ghost mójnick ${sec.data.libera}
----
[[command_weechat_set]]
@@ -1957,7 +1964,7 @@ Przykłady:
-dummy: nic nie rób (opcja użyta w celu zapobiegnięcia przypadkowego dopełnienia za pomocą"-quit")
-quit: zamyka *WSZYSTKIE* połączenia, zapisuje sesję i wyłącza WeeChat, umożliwia to późniejsze przywrócenie (zobacz niżej)
Ta komenda uaktualnia i przeładowuje działającą sesję WeeChat. Nowy plik binarny WeeChat powinien zostać skompilowany lub zainstalowany za pomocą managera pakietów przed uruchomieniem tej komendy.
Ta komenda uaktualnia i przeładowuje działającą sesję WeeChat. Nowy plik binarny WeeChat powinien zostać skompilowany lub zainstalowany za pomocą managera pakietów przed uruchomieniem tej komendy.
Uwaga: połączenia SSL są przerywane podczas uaktualniania, ponieważ przeładowanie sesji SSL nie jest obecnie możliwe za pomocą GnuTLS. Po uaktualnieniu nastąpi ponowne ich połączenie.
@@ -1975,7 +1982,7 @@ Z opcją "-quit", proces przebiega inaczej:
5. wyłączenie WeeChat
Następnie można przywrócić sesję za pomocą komendy: weechat --upgrade
WAŻNE: należy przywracać sesję z identyczną konfiguracją (pliki *.conf).
Jest możliwe przywrócenie sesji WeeChat na innej maszynie, jeśli skopiujemy zawartość katalogu "~/.weechat".
Jest możliwe przywrócenie sesji WeeChat na innej maszynie, jeśli skopiujemy zawartość katalogów domowych WeeChat (zobacz /debug dirs).
----
[[command_weechat_uptime]]
@@ -2160,6 +2167,7 @@ Następujące zmienne mogą być użyte w powyższych opcjach:
- ${hotlist}: niesformatowana hotlista
- ${hotlist_priority}: "none", "low", "message", "private" lub "highlight"
- ${format_lag}: opóźnienie buforu serwera IRC, puste jeśli nie ma opóźnienia (przetworzona opcja buflist.format.lag)
- ${format_tls_version}: wskaźnik wersji TLS w buforze serwera, pusty dla kanałów (wynik przetworzenia opcji buflist.format.tls_version)
----
// end::buflist_commands[]
@@ -2266,14 +2274,14 @@ disable: wyłącza strumień FIFO
toggle: przełącza stan strumienia FIFO
Strumień FIFO jest używany do zdalnej kontroli nad WeeChat: możesz wysyłać komendy albo tekst do strumienia z konsoli.
Domyślnie strumień FIFO jest tworzony w ~/.weechat/weechat_fifo
Domyślnie strumień FIFO jest nazwany weechat_fifo_xxx (gdzie xxx to id procesu WeeChat) i zlokalizowany w katalogu uruchomieniowym WeeChat (zobacz /debug dirs).
Spodziewane formaty:
plugin.buffer *tekst albo komenda
*tekst albo komenda
Na przykład zmiana nicka w sieci freenode:
echo 'irc.server.freenode */nick nowynick' >~/.weechat/weechat_fifo
Na przykład zmiana nicka w sieci libera:
echo 'irc.server.libera */nick nowynick' >/run/user/1000/weechat/weechat_fifo_12345
Więcej informacji i przykładów można znaleźć w poradniku użytkownika.
@@ -2729,10 +2737,10 @@ Protokół "weechat" pozwala na połączenie się zdalnym interfejsem, lista dos
Bez argumentu komenda otwiera bufor z listą klientów.
Przykłady:
pośrednik irc dla serwera "freenode":
/relay add irc.freenode 8000
pośrednik irc dla serwera "freenode", z SSL:
/relay add ssl.irc.freenode 8001
pośrednik irc dla serwera "libera":
/relay add irc.libera 8000
pośrednik irc dla serwera "libera", z SSL:
/relay add ssl.irc.libera 8001
pośrednik irc dla wszystkich serwerów (klient wybiera) z SSL:
/relay add ssl.irc 8002
protokół weechat:
@@ -2746,7 +2754,7 @@ Przykłady:
protokół weechat z SSL, używający IPv4 + IPv6:
/relay add ipv4.ipv6.ssl.weechat 9001
protokół weechat po sockecie UNIXowym:
/relay add unix.weechat %h/relay_socket
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
----
// end::relay_commands[]
+112 -34
View File
@@ -16,8 +16,8 @@
** wartości: sha224, sha256, sha384, sha512
** domyślna wartość: `+sha256+`
* [[option_sec.crypt.passphrase_file]] *sec.crypt.passphrase_file*
** opis: pass:none[ścieżka do pliku zawierającego hasło do szyfrowania/rozszyfrowywania zabezpieczonych danych; opcja ta jest używana tylko podczas odczytu pliku sec.conf; używana jest tylko pierwsza linia z tego pliku; plik jest używany tylko jeśli zmienna środowiskowa "WEECHAT_PASSPHRASE" nie została ustawiona (zmienna środowiskowa ma najwyższy priorytet); uwaga bezpieczeństwa: zaleca się trzymanie tego pliku poza katalogiem domowym WeeChat (np. w katalogu domowym) i nadanie mu praw do odczytu tylko przez siebie; przykład: "~/.weechat-passphrase"]
* [[option_sec.crypt.passphrase_command]] *sec.crypt.passphrase_command*
** opis: pass:none[czyta hasło z wyjścia komendy systemowej (tylko pierwsza linia jest używana i nie może zawierać żadnych dodatkowych znaków); ta opcja jest używana tylko podczas odczytu pliku sec.conf i jeśli zmienna środowiskowa "WEECHAT_PASSPHRASE" nie jest ustawiona (zmienna środowiskowa ma wyższy priorytet); przykład z magazynem haseł: "/usr/bin/pass show weechat/passphrase"]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+""+`
@@ -846,6 +846,12 @@
** wartości: on, off
** domyślna wartość: `+on+`
* [[option_weechat.look.hotlist_update_on_buffer_switch]] *weechat.look.hotlist_update_on_buffer_switch*
** opis: pass:none[aktualizuj hotlistę podczas przełączania buforów]
** typ: bool
** wartości: on, off
** domyślna wartość: `+on+`
* [[option_weechat.look.input_cursor_scroll]] *weechat.look.input_cursor_scroll*
** opis: pass:none[ilość znaków wyświetlanych po końcu linii wejściowej, kiedy przewijamy do wyświetlenia końca linii]
** typ: liczba
@@ -1140,6 +1146,12 @@
** wartości: dowolny ciąg
** domyślna wartość: `+"- "+`
* [[option_weechat.look.read_marker_update_on_buffer_switch]] *weechat.look.read_marker_update_on_buffer_switch*
** opis: pass:none[aktualizuj wskaźnik przeczytania podczas przełączania buforów]
** typ: bool
** wartości: on, off
** domyślna wartość: `+on+`
* [[option_weechat.look.save_config_on_exit]] *weechat.look.save_config_on_exit*
** opis: pass:none[zapisz plik konfiguracyjny przy wyjściu]
** typ: bool
@@ -1248,11 +1260,17 @@
** wartości: 1 .. 2147483647
** domyślna wartość: `+60+`
* [[option_weechat.network.gnutls_ca_file]] *weechat.network.gnutls_ca_file*
** opis: pass:none[plik zawierający CA ("%h" zostanie zastąpione katalogiem domowym WeeChat - domyślnie "~/.weechat")]
* [[option_weechat.network.gnutls_ca_system]] *weechat.network.gnutls_ca_system*
** opis: pass:none[ładuje zaufane, systemowe urzędy certyfikacyjne podczas uruchomienia; można to wyłączyć w celu oszczędzenia pamięci tylko jeśli połączenia SSL nie są używane]
** typ: bool
** wartości: on, off
** domyślna wartość: `+on+`
* [[option_weechat.network.gnutls_ca_user]] *weechat.network.gnutls_ca_user*
** opis: pass:none[dodatkowy plik(i) z urzędami certyfikacji; wiele plików można oddzielić dwukropkiem (każda ścieżka jest przetwarzana, zobacz funkcję string_eval_path_home w opisie API wtyczek)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"/etc/ssl/certs/ca-certificates.crt"+`
** domyślna wartość: `+""+`
* [[option_weechat.network.gnutls_handshake_timeout]] *weechat.network.gnutls_handshake_timeout*
** opis: pass:none[czas oczekiwania (w sekundach) na uwierzytelnienie gnutls]
@@ -1285,10 +1303,10 @@
** domyślna wartość: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
** opis: pass:none[ścieżka wyszukiwania wtyczek ("%h" zostanie zastąpione katalogiem domowym WeeChat - domyślnie "~/.weechat")]
** opis: pass:none[ścieżka do wtyczek (ścieżka jest przetwarzana, zobacz funkcje string_eval_path_home w opisie API wtyczek)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"%h/plugins"+`
** domyślna wartość: `+"${weechat_data_dir}/plugins"+`
* [[option_weechat.plugin.save_config_on_unload]] *weechat.plugin.save_config_on_unload*
** opis: pass:none[zapisuj pliki konfiguracyjne przy wyładowywaniu wtyczek]
@@ -1296,14 +1314,44 @@
** wartości: on, off
** domyślna wartość: `+on+`
* [[option_weechat.signal.sighup]] *weechat.signal.sighup*
** opis: pass:none[komenda wykonana po otrzymaniu sygnału, wiele komend można oddzielić średnikiem (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"${if:${info:weechat_headless}?/reload:/quit -yes}"+`
* [[option_weechat.signal.sigquit]] *weechat.signal.sigquit*
** opis: pass:none[komenda wykonana po otrzymaniu sygnału, wiele komend można oddzielić średnikiem (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"/quit -yes"+`
* [[option_weechat.signal.sigterm]] *weechat.signal.sigterm*
** opis: pass:none[komenda wykonana po otrzymaniu sygnału, wiele komend można oddzielić średnikiem (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"/quit -yes"+`
* [[option_weechat.signal.sigusr1]] *weechat.signal.sigusr1*
** opis: pass:none[komenda wykonana po otrzymaniu sygnału, wiele komend można oddzielić średnikiem (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+""+`
* [[option_weechat.signal.sigusr2]] *weechat.signal.sigusr2*
** opis: pass:none[komenda wykonana po otrzymaniu sygnału, wiele komend można oddzielić średnikiem (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+""+`
* [[option_weechat.startup.command_after_plugins]] *weechat.startup.command_after_plugins*
** opis: pass:none[komenda wykonana kiedy WeeChat jest uruchamiany, po załadowaniu wtyczek (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** opis: pass:none[komenda wykonana kiedy WeeChat jest uruchamiany, po załadowaniu wtyczek; wiele komend można oddzielić średnikami (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+""+`
* [[option_weechat.startup.command_before_plugins]] *weechat.startup.command_before_plugins*
** opis: pass:none[komenda wykonana kiedy WeeChat jest uruchamiany, przed załadowaniem wtyczek (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** opis: pass:none[komenda wykonana kiedy WeeChat jest uruchamiany, przed załadowaniem wtyczek; wiele komend można oddzielić średnikami (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+""+`
@@ -1409,10 +1457,10 @@
** domyślna wartość: `+""+`
* [[option_logger.file.path]] *logger.file.path*
** opis: pass:none[ścieżka do plików z logami WeeChat; "%h" na początku ciągu zostanie zastąpione przez katalog domowy WeeChat (domyślnie "~/.weechat"); określenia dla daty są dozwolone (zobacz man strftime) (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** opis: pass:none[ścieżka do plików z logami WeeChat; specyfikatory daty są dozwolone (zobacz man strftime) (ścieżka jest przetwarzana, zobacz funkcje string_eval_path_home w opisie API wtyczek)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"%h/logs/"+`
** domyślna wartość: `+"${weechat_data_dir}/logs"+`
* [[option_logger.file.replacement_char]] *logger.file.replacement_char*
** opis: pass:none[znak zastępczy dla znaków specjalnych w plikach stworzonych przy użyciu maski (jak separator katalogów)]
@@ -1704,6 +1752,12 @@
** wartości: dowolny ciąg
** domyślna wartość: `+"${color:green}${number}${if:${number_displayed}?.: }"+`
* [[option_buflist.format.tls_version]] *buflist.format.tls_version*
** opis: pass:none[format dla wersji TLS w buforze serwera IRC (uwaga: zawartość jest przetwarzana, zobacz /help buflist)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+" ${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*
** opis: pass:none[dodaje pustą linię pomiędzy wyświetlanymi buforami, każdy bufor jest wyświetlany w oddzielnej linii (zalecane); jeśli wyłączone, nowe linie muszą być manualnie dodawane w formatach za pomocą "${\n}", oraz akcje myszy przestają być możliwe]
** typ: bool
@@ -1765,10 +1819,16 @@
** domyślna wartość: `+""+`
* [[option_buflist.look.sort]] *buflist.look.sort*
** opis: pass:none[oddzielona przecinkami lista pól do sortowania buforów; każde pole to zmienna hdata bufora ("var"), zmienna hdata serwera IRC ("irc_server.var") lub zmienna hdata kanału IRC ("irc_channel.var"); znak "-" użyty przed nazwą pola odwraca kolejność, znak "~" może zostać użyty do porównań niewrażliwych na wielkość liter; przykład: "-~short_name" dla sortowania odwrotnego, niewrażliwego na wielkość liter po skróconej nazwie bufora (uwaga: zawartość jest przetwarzana, tylko wskaźnik na bar_item może zostać użyty, na przykład "bar_item.name")]
** opis: pass:none[oddzielona przecinkami lista pól do sortowania buforów; każde pole to zmienna hdata bufora ("var"), zmienna hdata serwera IRC ("irc_server.var") lub zmienna hdata kanału IRC ("irc_channel.var"); znak "-" użyty przed nazwą pola odwraca kolejność, znak "~" może zostać użyty do porównań niewrażliwych na wielkość liter; przykład: "-~short_name" dla sortowania odwrotnego, niewrażliwego na wielkość liter po skróconej nazwie bufora (uwaga: zawartość jest przetwarzana zanim zostanie podzielona na pola, "bar_item" to jedyna zmienna, jaka może zostać użyta w celu rozróżnienia buforów, na przykład "${bar_item.name}")]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"number,-active"+`
* [[option_buflist.look.use_items]] *buflist.look.use_items*
** opis: pass:none[ilość elementów „buflist” na pasku, które mogą zostać użyte; nazwy tych elementów to: "buflist", "buflist2", "buflist3"; używanie więcej niż jednego elementu paska spowalnia wyświetlanie listy buforów]
** typ: liczba
** wartości: 1 .. 3
** domyślna wartość: `+1+`
// end::buflist_options[]
// tag::fifo_options[]
@@ -1779,10 +1839,10 @@
** domyślna wartość: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
** opis: pass:none[ścieżka dla pliku FIFO; "%h" na początku ciągu zostanie zastąpione przez katalog domowy WeeChat (domyślnie "~/.weechat"); PID WeeChat możezostać użyty poprzez ${info:pid} (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** opis: pass:none[ścieżka do pliku FIFO; PID WeeChat może zostać w ścieżce za pomocą ${info:pid} (ścieżka jest przetwarzana, zobacz funkcje string_eval_path_home w opisie API wtyczek)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"%h/weechat_fifo"+`
** domyślna wartość: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1853,7 +1913,7 @@
** domyślna wartość: `+off+`
* [[option_xfer.file.auto_accept_nicks]] *xfer.file.auto_accept_nicks*
** opis: pass:none[oddzielona przecinkami lista nicków, od których przychodzące pliki i rozmowy są automatycznie akceptowane; format to "serwer.nick" (dla konkretnego serwera) lub "nick" (dla wszystkich serwerów; przykład "freenode.FlashCode,andrew"]
** opis: pass:none[oddzielona przecinkami lista nicków, od których przychodzące pliki i rozmowy są automatycznie akceptowane; format to "serwer.nick" (dla konkretnego serwera) lub "nick" (dla wszystkich serwerów; przykład "libera.FlashCode,andrew"]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+""+`
@@ -1883,10 +1943,10 @@
** domyślna wartość: `+on+`
* [[option_xfer.file.download_path]] *xfer.file.download_path*
** opis: pass:none[ścieżka, do której zapisywane będą pliki przychodzące; "%h" na początku ciągu zostanie zastąpione przez katalog domowy WeeChat (domyślnie "~/.weechat") (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** opis: pass:none[ścieżka do zapisania przychodzących plików (ścieżka jest przetwarzana, zobacz funkcje string_eval_path_home w opisie API wtyczek)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"%h/xfer"+`
** domyślna wartość: `+"${weechat_data_dir}/xfer"+`
* [[option_xfer.file.download_temporary_suffix]] *xfer.file.download_temporary_suffix*
** opis: pass:none[sufiks tymczasowego pliku użyty podczas pobierania pliku, zostanie usunięty po pomyślnym transferze; pusty ciąg oznacza, że nie zostanie użyty żaden przyrostek podczas transferu pliku]
@@ -1895,7 +1955,7 @@
** domyślna wartość: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
** opis: pass:none[ścieżka do wysyłanych plików (jeśli nie zostanie ona podana przez użykownika); "%h" na początku ciągu zostanie zastąpione przez katalog domowy WeeChat (domyślnie "~/.weechat") (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** opis: pass:none[ścieżka do wczytywania plików podczas wysyłania (ścieżka jest przetwarzana, zobacz funkcje string_eval_path_home zobacz w opisie API wtyczek)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"~"+`
@@ -2004,6 +2064,24 @@
** wartości: nazwa koloru WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), numer koloru terminala albo alias; atrybuty dozwolone przed kolorem (tylko dla kolorów testu, nie tła): "*" pogrubienie, "!" odwrócenie, "/" pochylenie, "_" podkreślenie
** domyślna wartość: `+default+`
* [[option_irc.color.item_tls_version_deprecated]] *irc.color.item_tls_version_deprecated*
** opis: pass:none[kolor dla przestarzałych wersji TLS w lemencie paska "tls_version"]
** typ: kolor
** wartości: nazwa koloru WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), numer koloru terminala albo alias; atrybuty dozwolone przed kolorem (tylko dla kolorów testu, nie tła): "*" pogrubienie, "!" odwrócenie, "/" pochylenie, "_" podkreślenie
** domyślna wartość: `+yellow+`
* [[option_irc.color.item_tls_version_insecure]] *irc.color.item_tls_version_insecure*
** opis: pass:none[kolor dla niebezpiecznej wersji TLS w elemencie paska "tls_version"]
** typ: kolor
** wartości: nazwa koloru WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), numer koloru terminala albo alias; atrybuty dozwolone przed kolorem (tylko dla kolorów testu, nie tła): "*" pogrubienie, "!" odwrócenie, "/" pochylenie, "_" podkreślenie
** domyślna wartość: `+red+`
* [[option_irc.color.item_tls_version_ok]] *irc.color.item_tls_version_ok*
** opis: pass:none[kolor dla wyższej wspieranej wersji TLS w elemencie paska "tls_version"]
** typ: kolor
** wartości: nazwa koloru WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), numer koloru terminala albo alias; atrybuty dozwolone przed kolorem (tylko dla kolorów testu, nie tła): "*" pogrubienie, "!" odwrócenie, "/" pochylenie, "_" podkreślenie
** domyślna wartość: `+green+`
* [[option_irc.color.message_account]] *irc.color.message_account*
** opis: pass:none[kolor tekstu w wiadomościach konta]
** typ: kolor
@@ -2209,19 +2287,19 @@
** domyślna wartość: `+off+`
* [[option_irc.look.highlight_channel]] *irc.look.highlight_channel*
** opis: pass:none[oddzielona przecinkami lista słów do podświetleń w buforach kanałów (wielkość liter nie ma znaczenia, użyj "(?-i)" na początku słów, dla których wielkość liter ma znaczenie; zmienne specjalne $nick, $channel i $server są zastępowane odpowiednimi wartościami), słowa te są dodawane do zmiennej lokalnej bufora "highlight_words" tylko kiedy bufor jest tworzony (nie ma wpływu na obecne bufory), pusty ciąg wyłącza domyślne podświetlenia nicka, przykłady: "$nick", "(?-i)$nick"]
** opis: pass:none[oddzielona przecinkami lista słów do podświetleń w buforach kanałów (wielkość liter nie ma znaczenia, użyj "(?-i)" na początku słów, dla których wielkość liter ma znaczenie; zmienne specjalne $nick, $channel i $server są zastępowane odpowiednimi wartościami), słowa te są dodawane do zmiennej lokalnej bufora "highlight_words" tylko kiedy bufor jest tworzony (nie ma wpływu na obecne bufory), pusty ciąg wyłącza domyślne podświetlenia nicka, przykłady: "$nick", "(?-i)$nick"]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"$nick"+`
* [[option_irc.look.highlight_pv]] *irc.look.highlight_pv*
** opis: pass:none[oddzielona przecinkami lista słów do podświetleń w prywatnych buforach (wielkość liter nie ma znaczenia, użyj "(?-i)" na początku słów, dla których wielkość liter ma znaczenie; zmienne specjalne $nick, $channel i $server są zastępowane odpowiednimi wartościami), słowa te są dodawane do zmiennej lokalnej bufora "highlight_words" tylko kiedy bufor jest tworzony (nie ma wpływu na obecne bufory), pusty ciąg wyłącza domyślne podświetlenia nicka, przykłady: "$nick", "(?-i)$nick"]
** opis: pass:none[oddzielona przecinkami lista słów do podświetleń w prywatnych buforach (wielkość liter nie ma znaczenia, użyj "(?-i)" na początku słów, dla których wielkość liter ma znaczenie; zmienne specjalne $nick, $channel i $server są zastępowane odpowiednimi wartościami), słowa te są dodawane do zmiennej lokalnej bufora "highlight_words" tylko kiedy bufor jest tworzony (nie ma wpływu na obecne bufory), pusty ciąg wyłącza domyślne podświetlenia nicka, przykłady: "$nick", "(?-i)$nick"]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"$nick"+`
* [[option_irc.look.highlight_server]] *irc.look.highlight_server*
** opis: pass:none[oddzielona przecinkami lista słów do podświetleń w buforach serwera (wielkość liter nie ma znaczenia, użyj "(?-i)" na początku słów, dla których wielkość liter ma znaczenie; zmienne specjalne $nick, $channel i $server są zastępowane odpowiednimi wartościami), słowa te są dodawane do zmiennej lokalnej bufora "highlight_words" tylko kiedy bufor jest tworzony (nie ma wpływu na obecne bufory), pusty ciąg wyłącza domyślne podświetlenia nicka, przykłady: "$nick", "(?-i)$nick"]
** opis: pass:none[oddzielona przecinkami lista słów do podświetleń w buforach serwera (wielkość liter nie ma znaczenia, użyj "(?-i)" na początku słów, dla których wielkość liter ma znaczenie; zmienne specjalne $nick, $channel i $server są zastępowane odpowiednimi wartościami), słowa te są dodawane do zmiennej lokalnej bufora "highlight_words" tylko kiedy bufor jest tworzony (nie ma wpływu na obecne bufory), pusty ciąg wyłącza domyślne podświetlenia nicka, przykłady: "$nick", "(?-i)$nick"]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"$nick"+`
@@ -2617,7 +2695,7 @@
** domyślna wartość: `+60+`
* [[option_irc.server_default.default_chantypes]] *irc.server_default.default_chantypes*
** opis: pass:none[channel type prefixes to use if the server does not send them in message 005 (default is "#&")]
** opis: pass:none[prefiks typu kanału jeśli serwer nie wyśle jego w wiadomości 005 (domyślnie „#&)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"#&"+`
@@ -2635,19 +2713,19 @@
** domyślna wartość: `+""+`
* [[option_irc.server_default.msg_kick]] *irc.server_default.msg_kick*
** opis: pass:none[domyślna wiadomość dla wykopania z kanału używana przez komendy "/kick" i "/kickban" (uwaga: zawartość jest przetwarzana zobacz /help eval; specjalne zmienne jak ${nick}, ${channel} i ${server} są zamieniane na odpowiednie wartości)]
** opis: pass:none[domyślna wiadomość dla wykopania z kanału używana przez komendy "/kick" i "/kickban" (uwaga: zawartość jest przetwarzana zobacz /help eval; specjalne zmienne jak ${nick} (własny nick), ${target} (docelowy nick), ${channel} i ${server} są zamieniane na odpowiednie wartości)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+""+`
* [[option_irc.server_default.msg_part]] *irc.server_default.msg_part*
** opis: pass:none[domyślna wiadomość przy wyjściu z kanału (uwaga: zawartość jest przetwarzana zobacz /help eval; specjalne zmienne jak ${nick}, ${channel} i ${server} są zamieniane na odpowiednie wartości); "%v" jest zamieniane na wersję WeeChat jeśli w ciągu nie ma ${...})]
** opis: pass:none[domyślna wiadomość przy wyjściu z kanału (uwaga: zawartość jest przetwarzana zobacz /help eval; specjalne zmienne jak ${nick}, ${channel} i ${server} są zamieniane na odpowiednie wartości; "%v" jest zamieniane na wersję WeeChat jeśli w ciągu nie ma ${...})]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"WeeChat ${info:version}"+`
* [[option_irc.server_default.msg_quit]] *irc.server_default.msg_quit*
** opis: pass:none[domyślna wiadomość przy odłączeniu od serwera (uwaga: zawartość jest przetwarzana zobacz /help eval; specjalne zmienne jak ${nick}, ${channel} i ${server} są zamieniane na odpowiednie wartości); "%v" jest zamieniane na wersję WeeChat jeśli w ciągu nie ma ${...})]
** opis: pass:none[domyślna wiadomość przy odłączeniu od serwera (uwaga: zawartość jest przetwarzana zobacz /help eval; specjalne zmienne jak ${nick}, ${channel} i ${server} są zamieniane na odpowiednie wartości; "%v" jest zamieniane na wersję WeeChat jeśli w ciągu nie ma ${...})]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"WeeChat ${info:version}"+`
@@ -2695,15 +2773,15 @@
** domyślna wartość: `+continue+`
* [[option_irc.server_default.sasl_key]] *irc.server_default.sasl_key*
** opis: pass:none[plik z kluczem prywatnym ECC dla mechanizmu "ecdsa-nist256p-challenge" ("%h" zostanie zastąpione katalogiem domowym WeeChat, domyślnie "~/.weechat")]
** opis: pass:none[plik z kluczem prywatnym ECC dla mechanizmu "ecdsa-nist256p-challenge" (ścieżka jest przetwarzana, zobacz funkcję string_eval_path_home w opisie API wtyczek)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+""+`
* [[option_irc.server_default.sasl_mechanism]] *irc.server_default.sasl_mechanism*
** opis: pass:none[mechanizm autentykacji SASL: "plain" dla hasła w czystym tekście, "ecdsa-nist256p-challenge" uwierzytelnianie na podstawie pary kluczy, "external" dla uwierzytelnienia za pomocą certyfikatu SSL po stronie klienta", "dh-blowfish" dla hasła szyfrowanego za pomocą blowfish (mało bezpieczne, niepolecane), "dh-aes" dla hasła szyfrowanego za pomocą AES (mało bezpieczne, niepolecane)]
** opis: pass:none[mechanizm autentykacji SASL: "plain" dla hasła w czystym tekście, "scram-sha-1" dla uwierzytelnienia SCRAM za pomocą algorytmu SHA-1, "scram-sha-256" dla uwierzytelnienia SCRAM za pomocą algorytmu SHA-256, "scram-sha-512" dla uwierzytelnienia SCRAM za pomocą algorytmu SHA-512, "ecdsa-nist256p-challenge" uwierzytelnianie na podstawie pary kluczy, "external" dla uwierzytelnienia za pomocą certyfikatu SSL po stronie klienta, "dh-blowfish" dla hasła szyfrowanego za pomocą blowfish (mało bezpieczne, niepolecane), "dh-aes" dla hasła szyfrowanego za pomocą AES (mało bezpieczne, niepolecane)]
** typ: liczba
** wartości: plain, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** wartości: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** domyślna wartość: `+plain+`
* [[option_irc.server_default.sasl_password]] *irc.server_default.sasl_password*
@@ -2737,7 +2815,7 @@
** domyślna wartość: `+off+`
* [[option_irc.server_default.ssl_cert]] *irc.server_default.ssl_cert*
** opis: pass:none[Plik certyfikatu SSL używany do automatycznego uwierzytelnienia nicka ("%h" zostanie zastąpione katalogiem domowym WeeChat, domyślnie "~/.weechat")]
** opis: pass:none[Plik certyfikatu SSL używany do automatycznego uwierzytelnienia nicka (ścieżka jest przetwarzana, zobacz funkcję string_eval_path_home w opisie API wtyczek)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+""+`
@@ -2961,10 +3039,10 @@
** domyślna wartość: `+100000+`
* [[option_relay.network.ssl_cert_key]] *relay.network.ssl_cert_key*
** opis: pass:none[plik z certyfikatem SSL i kluczem prywatnym (dla obsługi klientów poprzez SSL)]
** opis: pass:none[plik z certyfikatem SSL i kluczem prywatnym (dla obsługi klientów poprzez SSL) (ścieżka jest przetwarzana, zobacz funkcję string_eval_path_home w opisie API wtyczek)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"%h/ssl/relay.pem"+`
** domyślna wartość: `+"${weechat_config_dir}/ssl/relay.pem"+`
* [[option_relay.network.ssl_priorities]] *relay.network.ssl_priorities*
** opis: pass:none[ciąg z priorytetami dla gnutls (składnię można znaleźć w dokumentacji gnutls dla funkcji gnutls_priority_init, często używane ciągi to: "PERFORMANCE", "NORMAL", "SECURE128", "SECURE256", "EXPORT", "NONE")]
@@ -3267,7 +3345,7 @@
** domyślna wartość: `+lightmagenta+`
* [[option_script.look.columns]] *script.look.columns*
** opis: pass:none[format kolumn wyświetlanych w buforze skryptów: następujące identyfikatory kolumn są zastępowane przez ich wartość: %a=autor, %d=opis, %D=data dodania, %e=rozszerzenie, %l=język, %L=licencja, %n=nazwa z rozszerzeniem, %N=nazwa, %r=wymagania, %s=status, %t=tagi, %u=data wgrania, %v=wersja, %V=załadowana wersja, %w=min_weechat, %W=max_weechat)]
** opis: pass:none[format kolumn wyświetlanych w buforze skryptów: następujące identyfikatory kolumn są zastępowane przez ich wartość: %a=autor, %d=opis, %D=data dodania, %e=rozszerzenie, %l=język, %L=licencja, %n=nazwa z rozszerzeniem, %N=nazwa, %r=wymagania, %s=status, %t=tagi, %u=data aktualizacji, %v=wersja, %V=załadowana wersja, %w=min_weechat, %W=max_weechat)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"%s %n %V %v %u | %d | %t"+`
@@ -3345,10 +3423,10 @@
** domyślna wartość: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
** opis: pass:none[lokalny katalog z cache skryptów; "%h" na początku ciągu zostanie zastąpione przez katalog domowy WeeChat (domyślnie "~/.weechat") (uwaga: zawartość jest przetwarzana, zobacz /help eval)]
** opis: pass:none[katalog z lokalnym cache dla skryptów (ścieżka jest przetwarzana, zobacz funkcje string_eval_path_home w opisie API wtyczek)]
** typ: ciąg
** wartości: dowolny ciąg
** domyślna wartość: `+"%h/script"+`
** domyślna wartość: `+"${weechat_cache_dir}/script"+`
* [[option_script.scripts.url]] *script.scripts.url*
** opis: pass:none[Adres URL pliku z listą skryptów]
+7 -6
View File
@@ -14,21 +14,22 @@
(works only with the command *weechat-headless*, not compatible with option
"--daemon").
// TRANSLATION MISSING
*-d*, *--dir* _<ścieżka>_::
Ustawia ścieżkę jako katalog domowy WeeChat (używany dla plików
konfiguracyjnych, logów, wtyczek użytkownika i skryptów), domyślna wartość
to "~/.weechat" (katalog zostanie utworzony jeśli nie istnieje).
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).
Jeśli ta opcja nie zostanie podada, użyta zostanie zawartość zmiennej
WEECHAT_HOME (jeśli została ustawiona).
*-t*, *--temp-dir*::
Tworzy tymczasowy katalog dla ustawień WeeChat, który jest kasowany po wyłączeniu
aplikacji (nie kompatybilne z opcją "-d"). +
Nazwa katalogu jest automatyczne tworzona według wzoru: "weechat_temp_XXXXXX"
Nazwa katalogu jest automatyczne tworzona według wzoru: "weechat_temp_XXXXXX"
(gdzie "XXXXXX" jest losowe). Katalog jest tworzony w pierwszym dostępnym miejscu
według tej listy: zmienna środowiskowa "TMPDIR", "/tmp" (może być inaczej na
według tej listy: zmienna środowiskowa "TMPDIR", "/tmp" (może być inaczej na
niektórych systemach operacyjnych), zmienna środowiskowa "HOME", obecny katalog. +
Utworony katalog ma uprawnienia 0700 (tylko właściciel może czytać, pisać i
Utworony katalog ma uprawnienia 0700 (tylko właściciel może czytać, pisać i
wykonywać).
*-h*, *--help*::
+26 -26
View File
@@ -9,7 +9,7 @@ URLi jak:
Aby wejść na kanał IRC poświęcony WeeChat pod nickiem "mójnick":
irc://mójnick@chat.freenode.net/#weechat
irc://mójnick@irc.libera.chat/#weechat
Adresy IPv6 mogą być otoczone nawiasami kwadratowymi, aby możliwe było podanie
numeru potyu po adresie, na przykład:
@@ -18,79 +18,79 @@ numeru potyu po adresie, na przykład:
// end::plugin_options[]
// tag::files[]
$HOME/.weechat/weechat.conf::
$HOME/.config/weechat/weechat.conf::
główny plik konfiguracyjny WeeChat
$HOME/.weechat/plugins.conf::
$HOME/.config/weechat/plugins.conf::
plik konfiguracyjny wtyczek
$HOME/.weechat/sec.conf::
$HOME/.config/weechat/sec.conf::
plik konfiguracyjny z zabezpieczonymi danymi
$HOME/.weechat/alias.conf::
$HOME/.config/weechat/alias.conf::
plik konfiguracyjny wtyczki _alias_
$HOME/.weechat/buflist.conf::
$HOME/.config/weechat/buflist.conf::
plik konfiguracyjny wtyczki _buflist_
$HOME/.weechat/charset.conf::
$HOME/.config/weechat/charset.conf::
plik konfiguracyjny wtyczki _charset_
$HOME/.weechat/exec.conf::
$HOME/.config/weechat/exec.conf::
plik konfiguracyjny wtyczki _exec_
$HOME/.weechat/fifo.conf::
$HOME/.config/weechat/fifo.conf::
plik konfiguracyjny wtyczki _fifo_
$HOME/.weechat/fset.conf::
$HOME/.config/weechat/fset.conf::
plik konfiguracyjny wtyczki _fset_
$HOME/.weechat/guile.conf::
$HOME/.config/weechat/guile.conf::
plik konfiguracyjny wtyczki _guile_
$HOME/.weechat/irc.conf::
$HOME/.config/weechat/irc.conf::
plik konfiguracyjny wtyczki _irc_
$HOME/.weechat/javascript.conf::
$HOME/.config/weechat/javascript.conf::
plik konfiguracyjny wtyczki _javascript_
$HOME/.weechat/logger.conf::
$HOME/.config/weechat/logger.conf::
plik konfiguracyjny wtyczki _logger_
$HOME/.weechat/lua.conf::
$HOME/.config/weechat/lua.conf::
plik konfiguracyjny wtyczki _lua_
$HOME/.weechat/perl.conf::
$HOME/.config/weechat/perl.conf::
plik konfiguracyjny wtyczki _perl_
$HOME/.weechat/php.conf::
$HOME/.config/weechat/php.conf::
plik konfiguracyjny wtyczki _php_
$HOME/.weechat/python.conf::
$HOME/.config/weechat/python.conf::
plik konfiguracyjny wtyczki _python_
$HOME/.weechat/relay.conf::
$HOME/.config/weechat/relay.conf::
plik konfiguracyjny wtyczki _relay_
$HOME/.weechat/ruby.conf::
$HOME/.config/weechat/ruby.conf::
plik konfiguracyjny wtyczki _ruby_
$HOME/.weechat/script.conf::
$HOME/.config/weechat/script.conf::
plik konfiguracyjny wtyczki _script_
$HOME/.weechat/spell.conf::
$HOME/.config/weechat/spell.conf::
plik konfiguracyjny wtyczki _spell_
$HOME/.weechat/tcl.conf::
$HOME/.config/weechat/tcl.conf::
plik konfiguracyjny wtyczki _tcl_
$HOME/.weechat/trigger.conf::
$HOME/.config/weechat/trigger.conf::
plik konfiguracyjny wtyczki _trigger_
$HOME/.weechat/xfer.conf::
$HOME/.config/weechat/xfer.conf::
plik konfiguracyjny wtyczki _xfer_
$HOME/.weechat/weechat.log::
$HOME/.local/share/weechat/weechat.log::
plik z logami WeeChat
// end::files[]
+37 -30
View File
@@ -15,7 +15,7 @@ dla najnowszej stabilnej wersji.
Tłumaczenie:
* Krzysztof Korościk <soltys1@gmail.com>, 2009-2016
* Krzysztof Korościk <soltys1@gmail.com>, 2009-2021
toc::[]
@@ -731,7 +731,8 @@ kbd:[Shift]).
Jeśli używasz Mac macOS, musisz zainstalować `openssl` z Homebrew.
Plik CA zostanie wygenerowany korzystając z systemowego keychaina.
Możez natępnie ustawić ścierzkę do certyfikatów w WeeChat:
W wersjach WeeChat ≤ 3.1, możesz ustawić ścieżkę do certyfikatów systemowych:
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@@ -768,10 +769,11 @@ nazwą serwera:
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
----
[[irc_ssl_freenode]]
=== Jak mogę połączyć się z serwerem freenode używając SSL?
[[irc_ssl_libera]]
=== Jak mogę połączyć się z serwerem libera używając SSL?
Ustaw opcję _weechat.network.gnutls_ca_file_ do pliku z certyfikatami:
W wersjach WeeChat ≤ 3.1, ustaw opcję _weechat.network.gnutls_ca_file_ na ścieżkę do pliku
z certyfikatami:
----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
@@ -790,9 +792,9 @@ przez pakiet "ca-certificates").
Ustaw port serwera, SSL, następnie się połącz:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
/set irc.server.libera.addresses "irc.libera.chat/6697"
/set irc.server.libera.ssl on
/connect libera
----
[[irc_oauth]]
@@ -817,25 +819,25 @@ Jeśli serwer wspiera SASL, możesz użyć tego zamiast wysyłać komendę do ni
na przykład:
----
/set irc.server.freenode.sasl_username "nick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "nick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
Jeśli serwer nie wspiera SASL, możesz dodać odstęp pomiędzy komendą a wejściem
na kanały):
----
/set irc.server.freenode.command_delay 5
/set irc.server.libera.command_delay 5
----
[[edit_autojoin]]
=== Jak mogę dodać/usunąć kanaly z opcji automatycznego wejścia?
Możesz użyć komendy `/set` do edytowania tej listy, na przykład dla serwera
"freenode":
"libera":
----
/set irc.server.freenode.autojoin [TAB]
/set irc.server.libera.autojoin [TAB]
----
[NOTE]
@@ -1006,17 +1008,17 @@ W celu automatycznego ustawiania tej właściwości należy użyć skryptu _buff
/script install buffer_autoset.py
----
Na przykład w celu wyłączenia powiadomień od "mike" na #weechat w sieci freenode:
on the IRC server freenode:
Na przykład w celu wyłączenia powiadomień od "mike" na #weechat w sieci libera:
on the IRC server libera:
----
/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera.#weechat hotlist_max_level_nicks_add mike:2
----
Dla całego serwera freenode:
Dla całego serwera libera:
----
/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera hotlist_max_level_nicks_add mike:2
----
Więcej przykładów można znaleźć wykonując komende `+/help buffer_autoset+`.
@@ -1053,14 +1055,17 @@ Skrypty nie są kompatybilne z innymi klientami IRC.
=== Komenda "/script update" nie może odczytać skryptów, jak to naprawić?
Najpierw zapoznaj się z zagadnieniami dotyczącymi połączeń SSL znajdującymi się
w tym dokumencie (zwłaszcza opcji _weechat.network.gnutls_ca_file_).
w tym dokumencie.
Jeśli to nie pomoże spróuj ręcznie usunąć plik z listą skryptów (z poziomu powłoki):
----
$ rm ~/.weechat/script/plugins.xml.gz
$ rm ~/.cache/weechat/script/plugins.xml.gz
----
[NOTE]
W wersjach WeeChat ≤ 3.1, ścieżka ta powinna wyglądać: _~/.weechat/script/plugins.xml.gz_.
Następnie ponownie zaktualizuj listę sktyptów w WeeChat:
----
@@ -1080,7 +1085,7 @@ have to update manually the file yourself to get updates):
* w powłoce, z zainstalowanym programem curl:
----
$ cd ~/.weechat/script
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
----
@@ -1131,8 +1136,8 @@ W celu zmniejszenia używanej pamięci możesz zastosować się do poniższych r
ruby, lua, tcl, guile, javascript, php, spell, xfer (używana do DCC).
Zobacz `/help weechat.plugin.autoload`.
* ładować tylko naprawdę używane skrypty
* nie ładuj certyfikatów jeśli SSL *NIE* jest używany: ustaw pusty ciąg w opcji
_weechat.network.gnutls_ca_file_
* nie ładuj systemowych certyfikatów jeśli SSL *nie* jest używane: wyłącz tą opcję:
_weechat.network.gnutls_ca_system_.
* zmniejsz wartość dla opcji _weechat.history.max_buffer_lines_number_ lub ustaw
wartość opcji _weechat.history.max_buffer_lines_minutes_
* zmniejszyć wartość opcji _weechat.history.max_commands_
@@ -1187,17 +1192,18 @@ Na przykład:
----
/secure passphrase xxxxxxxxxx
/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}"
/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}"
----
[[sharing_config_files]]
=== Chcę się podzielić moją konfiguracją WeeChat, które pliki powinienem pokazać, a które nie?
Możesz pokazywać pliki z _~/.weechat/*.conf_ poza plikiem _sec.conf_, który
zawiera Twoje hasla zaszywrowane Twoim kluczem.
Możesz się dzielić wszystkimi plikami konfiguracyjnymi _*.conf_ oprócz _sec.conf_, który
zawiera hasla zaszyfrowane twoim kluczem.
Niektóre inne pliki mogą zawierać poufne informacje jak hasła (jeśli nie są przetrzymywane
w _sec.conf_ za pomocą komendy `/secure`).
@@ -1236,7 +1242,8 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /ścieżka/do/weechat
[[supported_os]]
=== Jaka jest lista platform wspieranych przez WeeChat? Czy będzie przeportowany na inne systemy operacyjne?
Pełną listę można znaleźć na stronie: https://weechat.org/download
WeeChat działa dobrze na większości systemów Linux/BSD, GNU/Hurd, Mac OS i Windowsie
(Cygwin i Windows Subsystem for Linux).
Robimy co w naszej mocy, aby WeeChat działał na tylu platformach ile to tylko
możliwe. Mile widziana jest pomoc w testowaniu dla systemów, których nie mamy.
+21 -28
View File
@@ -111,12 +111,12 @@ na liście "irc" oraz inne wtyczki.
Możesz dodać serwer IRC za pomocą komendy `/server`, na przykład:
----
/server add freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
W tej komendzie `freenode` to nazwa wewnętrzna używana przez WeeChat:
będziesz mógł połączyć się za pomocą `/connect freenode`. Opcje serwera
będą miały postać _irc.server.freenode.xxx_.
W tej komendzie `libera` to nazwa wewnętrzna używana przez WeeChat:
będziesz mógł połączyć się za pomocą `/connect libera`. Opcje serwera
będą miały postać _irc.server.libera.xxx_.
Jak zawsze w razie wątpliwości dostępna jest pomoc:
@@ -135,45 +135,38 @@ Dla każdej opcji serwera WeeChat używa jej wartości jeśli jest zdefiniowana
"null"). W przeciwnym przypadku WeeChat używa wartości domyślnych ("irc.server_default.xxx").
Na przykład znajdują się tam domyślne nicki (bazujące na Twoim loginie un*x),
możesz je zmienić dla serwera freenode następującą komendą:
możesz je zmienić dla serwera libera następującą komendą:
----
/set irc.server.freenode.nicks "mójnick,mójnick2,mójnick3,mójnick4,mójnick5"
/set irc.server.libera.nicks "mójnick,mójnick2,mójnick3,mójnick4,mójnick5"
----
Ustawienie nazwy użytkownika i imienia:
----
/set irc.server.freenode.username "Moja nazwa użytkownika"
/set irc.server.freenode.realname "Moje imię"
/set irc.server.libera.username "Moja nazwa użytkownika"
/set irc.server.libera.realname "Moje imię"
----
Aby włączyć automatyczne łączenie się z serwerem przy starcie:
----
/set irc.server.freenode.autoconnect on
----
W celu połączenia z użyciem SSL:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/set irc.server.libera.autoconnect on
----
Jeśli SASL jest dostępny na serwerze, można użyć go do uwierzytelnienia (zostaniesz
zidentyfikowany przed wejściem na kanał):
----
/set irc.server.freenode.sasl_username "mójnick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mójnick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
Żeby wykonać komendę po połączeniu z serwerem, na przykład uwierzytelnienie
przez nickserv (tylko jeśli nie uwierzytelniasz się przez SASL):
----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -188,23 +181,23 @@ Najpierw ustaw hasło:
/secure passphrase to jest moje tajne hasło
----
Następnie dodaj swoje hasło, np dla sieci freenode:
Następnie dodaj swoje hasło, np dla sieci libera:
----
/secure set freenode_password xxxxxxx
/secure set libera_password xxxxxxx
----
Następnie możesz użyć `+${sec.data.freenode_password}+` zamiast swojego hasła dla
Następnie możesz użyć `+${sec.data.libera_password}+` zamiast swojego hasła dla
opcji IRC omówionych wcześniej, na przykład:
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
Aby automatycznie wejść na kanały po połączeniu z serwerem:
----
/set irc.server.freenode.autojoin "#kanał1,#kanał2"
/set irc.server.libera.autojoin "#kanał1,#kanał2"
----
[TIP]
@@ -216,24 +209,24 @@ Aby usunąć wartość dla opcji serwera, używając w zamian wartości domyśln
na przykład, aby używać domyślnych nicków (irc.server_default.nicks):
----
/unset irc.server.freenode.nicks
/unset irc.server.libera.nicks
----
Inne opcje: możesz ustawić pozostałe opcje za pomocą komendy ("xxx" to
nazwa opcji):
----
/set irc.server.freenode.xxx wartość
/set irc.server.libera.xxx wartość
----
[[connect_to_irc_server]]
== Łączenie z serwerem IRC
----
/connect freenode
/connect libera
----
Dzięki tej komendzie WeeChat łączy się z serwerem freenode i automatycznie
Dzięki tej komendzie WeeChat łączy się z serwerem libera i automatycznie
wchodzi na kanały skonfigurowane w opcji "autojoin" dla serwera.
[NOTE]
+91 -67
View File
@@ -12,7 +12,7 @@
Tłumaczenie:
* Krzysztof Korościk <soltys1@gmail.com>, 2009-2016
* Krzysztof Korościk <soltys1@gmail.com>, 2009-2021
Ten dokument opisuje klienta rozmów WeeChat, który jest częścią WeeChat.
@@ -72,12 +72,17 @@ link:weechat_plugin_api.en.html#_hook_process[Opisu API wtyczek WeeChat] (Angiel
[[languages_specificities]]
=== Specyfika języków
[[language_python]]
==== Python
[[python_module]]
===== Moduł
WeeChat definiuje moduł `weechat`, który należy zaimportowac poprzez `import weechat`.
WeeChat definiuje moduł `weechat`, który należy zaimportowac poprzez `import weechat`. +
Szkielet API WeeChat dla języka Python dostępny jest w repozytorium:
https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi].
[[python_functions]]
===== Funkcje
Funkcje są wywoływane za pomocą `+weechat.xxx(arg1, arg2, ...)+`.
@@ -85,6 +90,7 @@ Funkcje są wywoływane za pomocą `+weechat.xxx(arg1, arg2, ...)+`.
Funkcje `+print*+` nzwyają się `+prnt*+` (ponieważ `print` był zarezerwowanym
łowem kluczowym w Pythonie 2).
[[python_strings]]
===== Ciągi otrzymywane w callbackach
W Pythonie 3 i dla wersji WeeChat ≥ 2.7, ciągi te mają typ `str` jeśli ciąg
@@ -137,18 +143,23 @@ W Pytonie 2, który jest już nie wspierany i nie powinien być już używany,
ciągi wysyłane do callbacków są zawsze typu `str` i mogą zawierać niepoprawne
dane UTF-8 w przypadkach wspomnianych wyżej.
[[language_perl]]
==== Perl
[[perl_functions]]
===== Funkcje
Funkcje są wywoływane za pomocą `+weechat::xxx(arg1, arg2, ...);+`.
[[language_ruby]]
==== Ruby
[[ruby_init]]
===== Inicjalizacja
Musisz zdefiniowac _weechat_init_ i wywołać wewnątrz _register_.
[[ruby_functions]]
===== Funkcje
Funkcje wywoływane są za pomocą `+Weechat.xxx(arg1, arg2, ...)+`.
@@ -173,20 +184,26 @@ Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical"
["default", "default", "default", "default"], "0", "items")
----
[[language_lua]]
==== Lua
[[lua_functions]]
===== Funkcje
Funkcje są wywoływane za pomocą `+weechat.xxx(arg1, arg2, ...)+`.
[[language_tcl]]
==== Tcl
[[tcl_functions]]
===== Funkcje
Funkcje są wywoływane za pomocą `+weechat::xxx arg1 arg2 ...+`.
[[language_guile]]
==== Guile (Scheme)
[[guile_functions]]
===== Funkcje
Funkcje są wywoływane za pomocą `+(weechat:xxx arg1 arg2 ...)+`.
@@ -199,14 +216,18 @@ argumentów dozwolonych w Guile:
* config_new_option
* bar_new
[[language_javascript]]
==== JavaScript
[[javascript_functions]]
===== Funkcje
Funkcje są wywoływane za pomocą `+weechat.xxx(arg1, arg2, ...);+`.
[[language_php]]
==== PHP
[[php_functions]]
===== Funkcje
Funkcje są wywoływane za pomocą `+weechat_xxx(arg1, arg2, ...);+`.
@@ -217,11 +238,11 @@ Funkcje są wywoływane za pomocą `+weechat_xxx(arg1, arg2, ...);+`.
Wszystkie skrypty WeeChat muszą się "zarejestrować" w WeeChat, musi to być pierwsza
z funkcji WeeChat wywołana w skrypcie.
Prototyp:
Prototyp (Python):
[source,python]
----
weechat.register(nazwa, autor, wersja, licencja, opis, funkcja_wyłączająca, kodowanie)
def register(nazwa: str, autor: str, wersja: str, licencja: str, opis: str, funkcja_wyłączająca: str, kodowanie: str) -> int: ...
----
Argumenty:
@@ -342,7 +363,7 @@ Możesz zrobić dowiązanie w katalogu _język/autoload_ jeśli chcesz automatyc
Na przykład dla Pythona:
----
$ cd ~/.weechat/python/autoload
$ cd ~/.local/share/weechat/python/autoload
$ ln -s ../skrypt.py
----
@@ -781,58 +802,58 @@ Lista stałych w API skryptów:
| Kategoria | Stałe
| zwracane kody |
WEECHAT_RC_OK +
WEECHAT_RC_OK_EAT +
WEECHAT_RC_ERROR
`WEECHAT_RC_OK` (liczba całkowita) +
`WEECHAT_RC_OK_EAT` (liczba całkowita) +
`WEECHAT_RC_ERROR` (liczba całkowita)
| pliki konfiguracyjne |
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
`WEECHAT_CONFIG_READ_OK` (liczba całkowita) +
`WEECHAT_CONFIG_READ_MEMORY_ERROR` (liczba całkowita) +
`WEECHAT_CONFIG_READ_FILE_NOT_FOUND` (liczba całkowita) +
`WEECHAT_CONFIG_WRITE_OK` (liczba całkowita) +
`WEECHAT_CONFIG_WRITE_ERROR` (liczba całkowita) +
`WEECHAT_CONFIG_WRITE_MEMORY_ERROR` (liczba całkowita) +
`WEECHAT_CONFIG_OPTION_SET_OK_CHANGED` (liczba całkowita) +
`WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE` (liczba całkowita) +
`WEECHAT_CONFIG_OPTION_SET_ERROR` (liczba całkowita) +
`WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND` (liczba całkowita) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET` (liczba całkowita) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_RESET` (liczba całkowita) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED` (liczba całkowita) +
`WEECHAT_CONFIG_OPTION_UNSET_ERROR` (liczba całkowita)
| posortowane listy |
WEECHAT_LIST_POS_SORT +
WEECHAT_LIST_POS_BEGINNING +
WEECHAT_LIST_POS_END
`WEECHAT_LIST_POS_SORT` (ciąg) +
`WEECHAT_LIST_POS_BEGINNING` (ciąg) +
`WEECHAT_LIST_POS_END` (ciąg)
| hotlisty |
WEECHAT_HOTLIST_LOW +
WEECHAT_HOTLIST_MESSAGE +
WEECHAT_HOTLIST_PRIVATE +
WEECHAT_HOTLIST_HIGHLIGHT
`WEECHAT_HOTLIST_LOW` (ciąg) +
`WEECHAT_HOTLIST_MESSAGE` (ciąg) +
`WEECHAT_HOTLIST_PRIVATE` (ciąg) +
`WEECHAT_HOTLIST_HIGHLIGHT` (ciąg)
| hook process |
WEECHAT_HOOK_PROCESS_RUNNING +
WEECHAT_HOOK_PROCESS_ERROR
`WEECHAT_HOOK_PROCESS_RUNNING` (liczba całkowita) +
`WEECHAT_HOOK_PROCESS_ERROR` (liczba całkowita)
| hook connect |
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
`WEECHAT_HOOK_CONNECT_OK` (liczba całkowita) +
`WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND` (liczba całkowita) +
`WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND` (liczba całkowita) +
`WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED` (liczba całkowita) +
`WEECHAT_HOOK_CONNECT_PROXY_ERROR` (liczba całkowita) +
`WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR` (liczba całkowita) +
`WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR` (liczba całkowita) +
`WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR` (liczba całkowita) +
`WEECHAT_HOOK_CONNECT_MEMORY_ERROR` (liczba całkowita) +
`WEECHAT_HOOK_CONNECT_TIMEOUT` (liczba całkowita) +
`WEECHAT_HOOK_CONNECT_SOCKET_ERROR` (liczba całkowita)
| hook signal |
WEECHAT_HOOK_SIGNAL_STRING +
WEECHAT_HOOK_SIGNAL_INT +
WEECHAT_HOOK_SIGNAL_POINTER
`WEECHAT_HOOK_SIGNAL_STRING` (ciąg) +
`WEECHAT_HOOK_SIGNAL_INT` (ciąg) +
`WEECHAT_HOOK_SIGNAL_POINTER` (ciąg)
|===
[[common_tasks]]
@@ -873,13 +894,13 @@ weechat.prnt("", "%szłe argumenty" % weechat.prefix("błąd"))
weechat.prnt("", "text %sżółty na niebieskim" % weechat.color("yellow,blue"))
# przeszuka bufor i wyświetli wiadomość
# (pełna nazwa bufora to wtyczka.nazwa, na przykład: "irc.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
# (pełna nazwa bufora to wtyczka.nazwa, na przykład: "irc.libera.#weechat")
buffer = weechat.buffer_search("irc", "libera.#weechat")
weechat.prnt(buffer, "wiadomość na kanale #weechat")
# inne rozwiązanie na znalezienie bufora IRC (lepsze)
# (zauważ, że serwer i kanał są oddzielone przecinkiem)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.prnt(buffer, "wiadomość na kanale #weechat")
----
@@ -900,7 +921,7 @@ Przykłady:
weechat.command("", "/help")
# wyśle "witaj" na kanał #weechat (użytkownicy na kanale zobaczą wiadomość)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.command(buffer, "witaj")
----
@@ -1201,7 +1222,7 @@ xxx,irc_raw_in2_yyy::
[source,python]
----
def join_cb(data, sygnał, signal_data):
# sygnał to na przykład: "freenode,irc_in2_join"
# sygnał to na przykład: "libera,irc_in2_join"
# signal_data to wiadomość IRC, na przykład: ":nick!user@host JOIN :#channel"
server = signal.split(",")[0]
msg = weechat.info_get_hashtable("irc_message_parse", {"message": signal_data})
@@ -1255,63 +1276,66 @@ Wynik jest tabela hashy z następującymi kluczami
(przykładowe wartości zostały uzyskane za pomocą wiadomości:
`+@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!+`):
[width="100%",cols="1,^2,10,8",options="header"]
[width="100%",cols="3,^2,10,7",options="header"]
|===
| Klucz | Wersja WeeChat | Opis | Przykład
| Klucz | Od wersji ^(1)^ | Opis | Przykład
| tags | 0.4.0 |
| tags | 0.4.0 |
Tagi w wiadomości (mogą byc puste). |
`+time=2015-06-27T16:40:35.000Z+`
| message_without_tags | 0.4.0 |
| message_without_tags | 0.4.0 |
Wiadomość bez tagów (jeśli nie ma tagów jest to to samo co wiadomość). |
`+:nick!user@host PRIVMSG #weechat :hello!+`
| nick | 0.3.4 |
| nick | 0.3.4 |
Nick żródła. |
`+nick+`
| user | 2.7 |
| user | 2.7 |
Oryginalny użytkownik. |
`+user+`
| host | 0.3.4 |
| host | 0.3.4 |
Host żródła (zawiera nick). |
`+nick!user@host+`
| command | 0.3.4 |
| command | 0.3.4 |
Komenda (_PRIVMSG_, _NOTICE_, ...). |
`+PRIVMSG+`
| channel | 0.3.4 |
| channel | 0.3.4 |
Docelowy kanał. |
`+#weechat+`
| arguments | 0.3.4 |
| arguments | 0.3.4 |
Argumenty komendy (zawierają kanał). |
`+#weechat :hello!+`
| text | 1.3 |
| text | 1.3 |
Tekst (na przykład wiadomość użytkownika). |
`+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)^ Klucz został wprowadzony w tej wersji WeeChat.
[source,python]
----
dict = weechat.info_get_hashtable(
@@ -1372,8 +1396,8 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[source,python]
----
# katalog domowy WeeChat, na przykład: "/home/xxxx/.weechat"
weechat.prnt("", "Katalog domowy WeeChat: %s" % weechat.info_get("weechat_dir", ""))
# katalog z konfiguracją WeeChat, na przykład: "/home/user/.config/weechat"
weechat.prnt("", "Katalog z konfiguracją WeeChat: %s" % weechat.info_get("weechat_config_dir", ""))
# nieaktywność klawiatury
weechat.prnt("", "Nieaktywny od %s sekund" % weechat.info_get("inactivity", ""))

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