summaryrefslogtreecommitdiff
path: root/doc/fr
diff options
context:
space:
mode:
Diffstat (limited to 'doc/fr')
-rw-r--r--doc/fr/autogen/plugin_api/infos.adoc4
-rw-r--r--doc/fr/autogen/user/relay_options.adoc12
-rw-r--r--doc/fr/weechat_dev.fr.adoc24
-rw-r--r--doc/fr/weechat_plugin_api.fr.adoc43
-rw-r--r--doc/fr/weechat_relay_protocol.fr.adoc15
-rw-r--r--doc/fr/weechat_user.fr.adoc30
6 files changed, 109 insertions, 19 deletions
diff --git a/doc/fr/autogen/plugin_api/infos.adoc b/doc/fr/autogen/plugin_api/infos.adoc
index 6d839647c..a97df4dbc 100644
--- a/doc/fr/autogen/plugin_api/infos.adoc
+++ b/doc/fr/autogen/plugin_api/infos.adoc
@@ -112,6 +112,10 @@
| weechat | term_width | largeur du terminal | -
+| weechat | totp_generate | générer un mot de passe à usage unique basé sur le temps (TOTP) | secret (en base32), horodatage (optionnel, heure courante par défaut), nombre de chiffres (optionnal, entre 4 et 10, 6 par défaut)
+
+| weechat | totp_validate | valider un mot de passe à usage unique basé sur le temps (TOTP) : 1 si le TOTP est correct, sinon 0 | secret (en base32), mot de passe à usage unique, horodatage (optionnel, heure courante par défaut), nombre de mots de passe avant/après à tester (optionnel, 0 par défaut)
+
| weechat | uptime | Uptime de WeeChat (format : "jours:hh:mm:ss") | "days" (nombre de jours) ou "seconds" (nombre de secondes) (optionnel)
| weechat | version | version de WeeChat | -
diff --git a/doc/fr/autogen/user/relay_options.adoc b/doc/fr/autogen/user/relay_options.adoc
index 8dd0b37ee..727e562e9 100644
--- a/doc/fr/autogen/user/relay_options.adoc
+++ b/doc/fr/autogen/user/relay_options.adoc
@@ -164,6 +164,18 @@
** valeurs: toute chaîne
** valeur par défaut: `+"NORMAL:-VERS-SSL3.0"+`
+* [[option_relay.network.totp_secret]] *relay.network.totp_secret*
+** description: pass:none[secret pour la génération du mot de passe à usage unique basé sur le temps (TOTP), encodé en base32 (seulement des lettres et chiffres de 2 à 7) ; il est utilisé comme second facteur d'authentification dans le protocole weechat, en plus du mot de passe, qui ne doit pas être vide (une valeur vide signifie que le TOTP n'est pas requis) (note : le contenu est évalué, voir /help eval)]
+** type: chaîne
+** valeurs: toute chaîne
+** valeur par défaut: `+""+`
+
+* [[option_relay.network.totp_window]] *relay.network.totp_window*
+** description: pass:none[nombre de mots de passe à usage unique basés sur le temps à accepter avant et après le mot de passe courant ; 0 = accepter seulement le mot de passe courant, 1 = accepter un mot de passe avant, le courant et un après; 2 = accepter deux mots de passe avant, le courant et deux après, ... ; un nombre élevé réduit le niveau de sécurité (0 ou 1 sont les valeurs recommandées)]
+** type: entier
+** valeurs: 0 .. 256
+** valeur par défaut: `+0+`
+
* [[option_relay.network.websocket_allowed_origins]] *relay.network.websocket_allowed_origins*
** description: pass:none[expression régulière POSIX étendue avec les origines autorisées dans les websockets (insensible à la casse, utilisez "(?-i)" en début de chaîne pour la rendre sensible à la casse), exemple : "^http://(www\.)?example\.(com|org)"]
** type: chaîne
diff --git a/doc/fr/weechat_dev.fr.adoc b/doc/fr/weechat_dev.fr.adoc
index 71b88de1d..c2f518de6 100644
--- a/doc/fr/weechat_dev.fr.adoc
+++ b/doc/fr/weechat_dev.fr.adoc
@@ -134,7 +134,9 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|    wee-log.c | Écriture dans le fichier de log WeeChat (weechat.log).
|    wee-network.c | Fonctions réseau (connexion aux serveurs/proxies).
|    wee-proxy.c | Gestion des proxies.
-|    wee-secure.c | Options des données sécurisées (fichier sec.conf).
+|    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-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, ...).
@@ -208,6 +210,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
| plugins/ | Racine des extensions.
|    plugin.c | Gestion des extensions (chargement/déchargement des bibliothèques C dynamiques).
|    plugin-api.c | Fonctions supplémentaires pour l'API extension (enveloppes autour des fonctions du cœur de WeeChat).
+|    plugin-api-info.c | Fonctions supplémentaires info/infolist pour l'API extension.
|    plugin-config.c | Options de configuration des extensions (fichier plugins.conf).
|    plugin-script.c | Fonctions communes utilisés par les extensions pour les scripts.
|    plugin-script-api.c | Fonctions pour l'API script : enveloppes autour de quelques fonctions de l'API extension.
@@ -380,17 +383,22 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|          testapi.py | Script Python avec les tests API, utilisé par le script testapigen.py.
|          unparse.py | Conversion de code Python vers d'autres langages, utilisé par le script testapigen.py.
|    unit/ | Racine des tests unitaires.
+|       test-plugins.cpp | Tests : extensions.
|       core/ | Racine des tests unitaires pour le cœur.
|          test-arraylist.cpp | Tests : listes avec tableau (« arraylists »).
|          test-eval.cpp | Tests : évaluation d'expressions.
|          test-hashtble.cpp | Tests : tables de hachage.
|          test-hdata.cpp | Tests : hdata.
+|          test-hook.cpp | Tests : hooks.
|          test-infolist.cpp | Tests : infolists.
|          test-list.cpp | Tests : listes.
+|          test-secure.cpp | Tests : données sécurisées.
|          test-string.cpp | Tests : chaînes.
|          test-url.cpp | Tests : URLs.
|          test-utf8.cpp | Tests : UTF-8.
|          test-util.cpp | Tests : fonctions utiles.
+|       gui/ | Racine des tests unitaires pour la GUI.
+|          test-line.cpp | Tests : lignes.
|===
[[documentation_translations]]
@@ -703,7 +711,7 @@ Exemples :
| src/core/ | weechat.c, wee-backtrace.c, wee-command.c, ...
| src/gui/ | gui-bar.c, gui-bar-item.c, gui-bar-window.c, ...
| src/gui/curses/ | gui-curses-bar.c, gui-curses-bar-window.c, gui-curses-chat.c, ...
-| src/plugins/ | plugin.c, plugin-api.c, plugin-config.c, plugin-script.c, ...
+| src/plugins/ | plugin.c, plugin-api.c, plugin-api-info.c, plugin-config.c, plugin-script.c, ...
| src/plugins/irc/ | irc.c, irc-bar-item.c, irc-buffer.c, ...
| src/plugins/python/ | weechat-python.c, weechat-python-api.c, ...
|===
@@ -1111,6 +1119,16 @@ $ msginit -i weechat.pot -l nl_NL -o nl.po
La langue de base pour WeeChat est l'anglais, donc vous devez évidemment
comprendre parfaitement l'anglais pour traduire vers votre langue.
+Après des changements dans les sources, vous pouvez regénérer toutes les
+traductions : lancez cette commande dans le répertoire "build" de CMake :
+
+----
+$ make translations && make update-po
+----
+
+Vous pouvez alors éditer les fichiers .po (si vous pouvez traduire dans une
+langue).
+
Une fois terminé, vous *devez* vérifier votre fichier avec le script
_msgcheck.py_ (https://github.com/flashcode/msgcheck) :
@@ -1118,6 +1136,8 @@ _msgcheck.py_ (https://github.com/flashcode/msgcheck) :
$ msgcheck.py xx.po
----
+Et vous pouvez alors recompiler WeeChat pour utiliser les nouvelles traductions.
+
[[build_autogen_files]]
===== Construire les fichiers auto-générés
diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc
index c2a6815a2..942ba06bd 100644
--- a/doc/fr/weechat_plugin_api.fr.adoc
+++ b/doc/fr/weechat_plugin_api.fr.adoc
@@ -1812,68 +1812,85 @@ str = weechat.string_remove_color(string, replacement)
str = weechat.string_remove_color(ma_chaine, "?")
----
-==== string_encode_base64
+==== string_base_encode
-_WeeChat ≥ 0.3.2._
+_WeeChat ≥ 2.4._
-Encoder une chaîne en base64.
+Encoder une chaîne en base 16, 32 ou 64.
Prototype :
[source,C]
----
-void weechat_string_encode_base64 (const char *from, int length, char *to);
+int weechat_string_base_encode (int base, const char *from, int length, char *to);
----
Paramètres :
+* _base_ : 16, 32 ou 64
* _from_ : chaîne à encoder
* _length_ : longueur de chaîne à encoder (par exemple `strlen(from)`)
* _to_ : pointeur vers la chaîne pour stocker le résultat (doit être
suffisamment long, le résultat est plus long que la chaîne initiale)
+Valeur de retour :
+
+* longueur de la chaîne stockée dans _*to_ (ne compte pas le `\0` final),
+ -1 en cas d'erreur
+
Exemple en C :
[source,C]
----
char *string = "abcdefgh", result[128];
-weechat_string_encode_base64 (string, strlen (string), result);
-/* result == "YWJjZGVmZ2g=" */
+int length;
+length = weechat_string_base_encode (16, string, strlen (string), result);
+/* length == 16, result == "6162636465666768" */
+length = weechat_string_base_encode (32, string, strlen (string), result);
+/* length == 16, result == "MFRGGZDFMZTWQ===" */
+length = weechat_string_base_encode (64, string, strlen (string), result);
+/* length == 12, result == "YWJjZGVmZ2g=" */
----
[NOTE]
Cette fonction n'est pas disponible dans l'API script.
-==== string_decode_base64
+==== string_base_decode
-_WeeChat ≥ 0.3.2._
+_WeeChat ≥ 2.4._
-Décoder une chaîne base64.
+Décoder une chaîne encodée en base 16, 32 ou 64.
Prototype :
[source,C]
----
-int weechat_string_decode_base64 (const char *from, char *to);
+int weechat_string_base_decode (int base, const char *from, char *to);
----
Paramètres :
+* _base_ : 16, 32 ou 64
* _from_ : chaîne à décoder
* _to_ : pointeur vers la chaîne pour stocker le résultat (doit être
suffisamment long, le résultat est plus court que la chaîne initiale)
Valeur de retour :
-* longueur de la chaîne stockée dans _*to_ (ne compte pas le _\0_ final)
+* longueur de la chaîne stockée dans _*to_ (ne compte pas le `\0` final),
+ -1 en cas d'erreur
Exemple en C :
[source,C]
----
-char *string = "YWJjZGVmZ2g=", result[128];
+char result[128];
int length;
-length = weechat_string_decode_base64 (string, result);
+length = weechat_string_base_decode (16, "6162636465666768", result);
+/* length == 8, result == "abcdefgh" */
+length = weechat_string_base_decode (32, "MFRGGZDFMZTWQ===", result);
+/* length == 8, result == "abcdefgh" */
+length = weechat_string_base_decode (64, "YWJjZGVmZ2g=", result);
/* length == 8, result == "abcdefgh" */
----
diff --git a/doc/fr/weechat_relay_protocol.fr.adoc b/doc/fr/weechat_relay_protocol.fr.adoc
index f27b82dba..cb1800d45 100644
--- a/doc/fr/weechat_relay_protocol.fr.adoc
+++ b/doc/fr/weechat_relay_protocol.fr.adoc
@@ -119,8 +119,12 @@ init [<option>=<valeur>,[<option>=<valeur>,...]]
Paramètres :
* _option_ : une des options suivantes :
-** _password_ : mot de passe utilisé pour s'authentifier avec _relay_ (option
- _relay.network.password_ dans WeeChat)
+** _password_ : mot de passe utilisé pour s'authentifier avec _relay_
+ (option _relay.network.password_ dans WeeChat)
+** _totp_ : mot de passe à usage unique basé sur le temps (TOTP : Time-based
+ One-Time Password) utilisé comme second facteur d'authentification, en plus
+ du mot de passe (option _relay.network.totp_secret_ dans WeeChat)
+ _(WeeChat ≥ 2.4)_
** _compression_ : type de compression :
*** _zlib_ : activer la compression _zlib_ pour les messages envoyés par _relay_
(activée par défaut si _relay_ supporte la compression _zlib_)
@@ -139,6 +143,9 @@ init password=mypass
# initialiser avec des virgules dans le mot de passe (WeeChat ≥ 1.6)
init password=mypass\,avec\,virgules
+# initialiser avec le mot de passe et TOTP (WeeChat ≥ 2.4)
+init password=mypass,totp=123456
+
# initialiser et désactiver la compression
init password=mypass,compression=off
----
@@ -1365,7 +1372,7 @@ sont utilisés :
| chr | Caractère signé | 1 octet
| int | Entier signé | 4 octets
| lon | Entier long signé | 1 octet + longueur de l'entier sous forme de chaîne
-| str | Chaîne | 4 octets + longueur de la chaîne (sans le _\0_ final)
+| str | Chaîne | 4 octets + longueur de la chaîne (sans le `\0` final)
| buf | Tampon d'octets | 4 octets + longueur des données
| ptr | Pointeur | 1 octet + longueur du pointeur sous forme de chaîne
| tim | Date/heure | 1 octet + longueur de la date/heure sous forme de chaîne
@@ -1437,7 +1444,7 @@ long. '-' '1' '2' '3' '4' '5' '6' '7' '8' '9' '0'
==== Chaîne de caractères
Une chaîne de caractère est une longueur (un entier sur 4 octets) + le contenu
-de la chaîne (sans le _\0_ final).
+de la chaîne (sans le `\0` final).
Exemple :
diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc
index 9a627fbb2..45c1d1e23 100644
--- a/doc/fr/weechat_user.fr.adoc
+++ b/doc/fr/weechat_user.fr.adoc
@@ -3261,6 +3261,36 @@ commande :
Ce mot de passe sera utilisé pour les protocoles _irc_ et _weechat_.
+[[relay_totp]]
+==== TOTP
+
+TOTP (« Time-based One-Time Password » : mot de passe à usage unique basé sur le
+temps) peut être utilisé comme second facteur d'authentification pour le protocole
+_weechat_, en plus du mot de passe.
+
+Il est optionnel et augmente le niveau de sécurité.
+
+Les mots de passe à usage unique peuvent être générés avec des applications,
+par exemple :
+
+* FreeOTP :
+ https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android],
+ https://itunes.apple.com/fr/app/freeotp-authenticator/id872559395[iOS]
+ (https://freeotp.github.io/[site web])
+* Google Authenticator :
+ https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android],
+ https://itunes.apple.com/fr/app/google-authenticator/id388497605[iOS]
+
+Le « secret » TOTP doit être défini dans WeeChat et dans l'application utilisée
+pour générer les mots de passe à usage unique.
+
+Il doit être une chaîne encodée en base32, avec seulement des lettres et des
+chiffres de 2 à 7, par exemple :
+
+----
+/set relay.network.totp_secret "secretpasswordbase32"
+----
+
[[relay_ssl]]
==== SSL
generated by cgit v1.2.3 (git 2.25.1) at 2024-10-31 09:19:31 +0000