From 940409775646050ba1f4ff519b470562960abc3a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Helleu?= Date: Sat, 10 Jul 2021 18:35:57 +0200 Subject: [PATCH] doc: add chapters on IRC servers, channels, private messages (user's guide) --- doc/de/weechat_user.de.adoc | 228 ++++++++++++++++++++++++++++++++-- doc/en/weechat_user.en.adoc | 225 ++++++++++++++++++++++++++++++++-- doc/fr/weechat_user.fr.adoc | 237 ++++++++++++++++++++++++++++++++++-- doc/it/weechat_user.it.adoc | 228 ++++++++++++++++++++++++++++++++-- doc/ja/weechat_user.ja.adoc | 228 ++++++++++++++++++++++++++++++++-- doc/pl/weechat_user.pl.adoc | 228 ++++++++++++++++++++++++++++++++-- doc/sr/weechat_user.sr.adoc | 226 ++++++++++++++++++++++++++++++++-- 7 files changed, 1522 insertions(+), 78 deletions(-) diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc index 8d6df1cf0..5660d1f5f 100644 --- a/doc/de/weechat_user.de.adoc +++ b/doc/de/weechat_user.de.adoc @@ -2909,15 +2909,131 @@ Es ist möglich eine oder mehrere URL von IRC Servern zu übergeben: irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]] ---- -Beispiel: Anmelden beim Server _irc.libera.chat_ mit dem Nick _nono_ und betreten -der Channels _#weechat_ und _#toto_ (Standardport (6667) wird genutzt): +Beispiel: Anmelden beim Server _irc.libera.chat_ mit dem Nick _alice_ und betreten +der Channels _#weechat_ und _#weechat-fr_ (Standardport (6667) wird genutzt): ---- -$ weechat irc://nono@irc.libera.chat/#weechat,#toto +$ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr +---- + +// TRANSLATION MISSING +[[irc_servers]] +==== Servers + +[[irc_servers_add]] +===== Add a server + +By default no servers are defined. You can add as many servers as you want with +the <> command. + +For example to connect to https://libera.chat/[libera.chat] with SSL (encrypted trafic): + +---- +/server add libera irc.libera.chat/6697 -ssl +---- + +You can tell WeeChat to auto-connect to this server on startup: + +---- +/set irc.server.libera.autoconnect on +---- + +To authenticate, it is recommended to use SASL (if supported on the server), +with the password stored as secured data (see also chapter on +<>): + +---- +/set irc.server.libera.sasl_username "alice" +/secure set libera_password xxxxxxx +/set irc.server.libera.sasl_password "${sec.data.libera_password}" +---- + +If SASL is not supported, you can use a command to send a message to nickserv: + +---- +/set irc.server.libera.command "/msg nickserv identify ${sec.data.libera_password}" +---- + +[NOTE] +By sending a message to nickserv, you may authenticate after joining channels +which could be a problem on some channels requiring you to be authenticated +to join. In this case, you can set a command delay: +`/set irc.server.libera.command_delay 5`. + +[[irc_servers_options]] +===== Server options + +Server options are named `irc.server..