path: root/doc/fr/autogen/user/weechat_commands.txt

[command]*`away`* basculer le statut absent::
........................................
/away  [-all] [<message>]

   -all: basculer le statut absent sur tous les serveurs connectés
message: message pour l'absence (si pas de message donné, le statut d'absence est supprimé)
........................................

[command]*`bar`* gestion des barres::
........................................
/bar  list|listfull|listitems
      add <nom> <type>[,<cond1>[,<cond2>...]] <position> <taille> <séparateur> <objet1>[,<objet2>...]
      default
      del <nom>|-all
      set <nom> <option> <valeur>
      hide|show|toggle <nom>
      scroll <nom> <tampon> <valeur_scroll>

         list: lister toutes les barres
     listfull: lister toutes les barres (verbeux)
    listitems: lister tous les objets de barre
          add: ajouter une nouvelle barre
          nom: nom de la barre (doit être unique)
         type:   root: en dehors des fenêtres
               window: dans les fenêtres, avec condition(s) optionnelle(s) (voir ci-dessous)
    cond1,...: condition(s) pour afficher cette barre (seulement pour le type "window"):
                 active: sur la fenêtre active
               inactive: sur les fenêtres inactives
               nicklist: sur les fenêtres avec liste de pseudos
               sans condition, la barre est toujours affichée
     position: bottom (bas), top (haut), left (gauche) ou right (droite)
       taille: taille de la barre (en caractères)
   séparateur: 1 pour utiliser un séparateur (ligne), 0 ou rien signifie sans séparateur
   objet1,...: objets pour cette barre (les objets peuvent être séparés par une virgule (espace entre les objets) ou "+" (objets collés))
      default: créer les barres par défaut
          del: supprimer une barre (ou toutes les barres avec -all)
          set: changer la valeur d'une propriété de la barre
       option: option à modifier (pour la liste des options, voir /set weechat.bar.<nombarre>.*
       valeur: nouvelle valeur pour l'option
         hide: cacher la barre
         show: montrer une barre cachée
       toggle: cacher/montrer une barre
       scroll: faire défiler la barre
       tampon: catégorie et nom du tampon ('*' signifie le tampon courant, vous devez utiliser '*' pour les barres de type root)
valeur_scroll: valeur pour le défilement: 'x' ou 'y', suivi par '+', '-', 'b' (début) ou 'e' (fin), valeur (pour +/-), et un %% optionnel (pour faire défiler par %% de la largeur/hauteur, sinon la valeur est un nombre de caractères)

Exemples:
  créer une barre avec l'heure, numéro + nom de tampon, et la complétion:
    /bar add mabarre root bottom 1 0 [time],buffer_number+:+buffer_name,completion
  cacher une barre:
    /bar hide mabarre
  faire défiler la liste des pseudos de 10 lignes vers le bas sur le tampon courant:
    /bar scroll nicklist * y+10
  faire défiler la liste des pseudos d'une page vers le haut sur le tampon #weechat:
    /bar scroll nicklist #weechat y-100%
  faire défiler la liste des pseudos à la fin sur le tampon courant:
    /bar scroll nicklist * ye
........................................

[command]*`buffer`* gestion des tampons::
........................................
/buffer  list
         clear [<nombre>|-merged|-all]
         move|merge <nombre>
         unmerge [<nombre>]
         close [<n1>[-<n2>]]
         notify <niveau>
         localvar
         set <propriété> <valeur>
         get <propriété>
         <nombre>|<nom>

    list: lister les tampons ouverts (sans paramètre, cette liste est affichée)
   clear: effacer le contenu du tampon (un numéro pour un tampon, -merged pour les tampons mélangés, -all pour tous les tampons, ou rien pour le tampon courant)
    move: déplacer le tampon dans la liste (peut être relatif, par exemple -1)
   merge: mélanger le tampon courant avec un autre tampon (la zone de discussion sera un mélange des deux tampons)
          (par défaut ctrl-x bascule entre les tampons mélangés)
 unmerge: détacher le tampon courant des autres tampons portant le même numéro
   close: fermer le tampon (nombre/intervalle optionnel)
  notify: définir le niveau de notification pour le tampon courant: ce niveau détermine si le buffer doit être ajouté à la hotlist ou pas:
               none: jamais
          highlight: pour les highlights seulement
            message: pour les messages d'utilisateurs + highlights
                all: pout tous les messages
              reset: réinitialise à valeur par défaut (all)
localvar: afficher la liste des variables locales pour le tampon courant
     set: modifier une propriété du tampon courant
     get: afficher une propriété du tampon courant
  nombre: sauter au tampon qui a ce numéro, préfixe possible:
          '+': saut relatif, ajoute le numéro au courant,
          '-': saut relatif, soustrait le numéro au courant,
          '*': saut au numéro en utilisant l'option "jump_current_to_previous_buffer"
     nom: sauter au tampon par nom (partiel)

Exemples:
  effacer le tampon courant:
    /buffer clear
  déplacer le tampon vers le numéro 5:
    /buffer move 5
  mélanger avec le tampon core:
    /buffer merge 1
  détacher le tampon:
    /buffer unmerge
  fermer le tampon courant:
    /buffer close
  fermer les tampons 5 à 7:
    /buffer close 5-7
  aller sur #weechat:
    /buffer #weechat
  aller au tampon suivant:
    /buffer +1
........................................

[command]*`color`* définir des alias de couleurs et afficher la palette des couleurs::
........................................
/color  alias <couleur> <alias>
        unalias <couleur>
        reset

  alias: ajouter un alias pour une couleur
unalias: supprimer un alias pour une couleur
couleur: numéro de couleur (>= 0, le max dépend du terminal, généralement 63 ou 255)
    nom: nom d'alias pour la couleur (par exemple: "orange")
  reset: réinitialiser toutes les paires de couleurs (pratique quand il n'y a plus de paires disponibles)

Sans paramètre, cette commande affiche les couleurs dans un nouveau tampon.

Exemples:
  ajouter l'alias "orange" pour la couleur 214:
    /color alias 214 orange
  supprimer la couleur 214:
    /color unalias 214
........................................

[command]*`command`* lancer explicitement une commande WeeChat ou d'une extension::
........................................
/command  <extension> <commande>

extension: nom de l'extension ('weechat' pour une commande interne WeeChat)
 commande: commande à exécuter (un '/' est automatiquement ajouté s'il n'est pas trouvé au début de la commande)
........................................

[command]*`debug`* contrôle du debug pour le coeur/les extensions::
........................................
/debug  list
        set <extension> <niveau>
        dump [<extension>]
        buffer|color|memory|term|windows

     list: lister les extensions avec leur niveau de debug
      set: définir le niveau de debug pour l'extension
extension: nom de l'extension ("core" pour le coeur de WeeChat)
   niveau: niveau de debug pour l'extension
     dump: afficher les variables mémoire WeeChat dans le fichier log (les mêmes messages sont affichés lorsque WeeChat plante)
   buffer: afficher le contenu du tampon en valeurs hexadécimales dans le fichier log
    color: afficher des infos sur les paires de couleur courantes
   memory: afficher des infos sur l'utilisation de la mémoire
     term: afficher des infos sur le terminal
  windows: afficher l'arbre des fenêtres
........................................

[command]*`filter`* filtrer les messages dans les tampons, pour les cacher/afficher selon des tags ou expressions régulières::
........................................
/filter  list
         enable|disable|toggle [<nom>]
         add <nom> <extension.tampon> <tags> <regex>
         del <nom>|-all

            list: lister tous les filtres
          enable: activer les filtres (par défaut les filtres sont activés)
         disable: désactiver les filtres
          toggle: activer/désactiver les filtres
             nom: nom de filtre
             add: ajouter un filtre
             del: supprimer un filtre
            -all: supprimer tous les filtres
extension.tampon: extension et tampon où le filtre est actif ("*" pour tous les tampons)
            tags: liste de tags, séparés par des virgules, par exemple: "irc_join,irc_part,irc_quit"
           regex: expression régulière à rechercher dans la ligne
                  - utiliser '\t' pour séparer le préfixe du message, les caractères spéciaux comme '|' doivent être échappés: '\|'
                  - si l'expression régulière commence par '!' alors le résultat est inversé (utiliser '\!' pour démarrer par '!')
                  note: deux regex sont créées: une pour le préfixe et une pour le message

La touche par défaut alt+'=' active/désactive le filtrage.

Les tags les plus couramment utilisés:
  no_filter, no_highlight, no_log, log0..log9 (niveau de log),
  notify_message, notify_private, notify_highlight,
  nick_xxx (xxx est le pseudo dans le message),
  irc_xxx (xxx est un nom de commande ou nombre, voir /server raw),
  irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info.

Exemples:
  utiliser le filtre intelligent IRC pour les messages join/part/quit:
    /filter add irc_smart * irc_smart_filter *
  filtrer tous les messages IRC join/part/quit:
    /filter add joinquit * irc_join,irc_part,irc_quit *
  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 * toto\t
  garder uniquement le pseudo "titi" sur le canal IRC #test:
    /filter add titi irc.freenode.#test * !titi\t
  filtrer les lignes contenant le mot "spam":
    /filter add filtrespam * * spam
  filtrer les lignes contenant "weechat sucks" sur le canal IRC #weechat:
    /filter add sucks irc.freenode.#weechat * weechat sucks
........................................

[command]*`help`* afficher l'aide sur les commandes et les options::
........................................
/help  -list|-listfull [<extension> [<extension>...]]
       <commande>
       <option>

    -list: lister les commandes, par extension (sans paramètre, cette liste est affichée)
-listfull: lister les commandes avec description, par extension
extension: lister les commandes de cette extension
 commande: un nom de commande
   option: un nom d'option (utilisez /set pour voir la liste)
........................................

[command]*`history`* afficher l'historique des commandes du tampon::
........................................
/history  clear
          <valeur>

 clear: effacer l'historique
valeur: nombre d'entrées dans l'historique à afficher
........................................

[command]*`input`* fonctions pour la ligne de commande::
........................................
/input  <action> [<paramètres>]

list des actions:
  return: simuler la touche "entrée"
  complete_next: compléter le mot avec la complétion suivante
  complete_previous: compléter le mot avec la complétion précédente
  search_text: chercher du texte dans le tampon
  delete_previous_char: effacer le caractère précédent
  delete_next_char: effacer le caractère suivant
  delete_previous_word: effacer le mot précédent
  delete_next_word: effacer le mot suivant
  delete_beginning_of_line: effacer du début de la ligne jusqu'au curseur
  delete_end_of_line: effacer du curseur jusqu'à la fin de la ligne
  delete_line: effacer la ligne entière
  clipboard_paste: coller depuis le presse-papier
  transpose_chars: inverser deux caractères
  undo: défaire la dernière action de la ligne de commande
  redo: refaire la dernière action de la ligne de commande
  move_beginning_of_line: déplacer le curseur au début de la ligne
  move_end_of_line: déplacer le curseur à la fin de la ligne
  move_previous_char: déplacer le curseur sur le caractère précédent
  move_next_char: déplacer le curseur sur le caractère suivant
  move_previous_word: déplacer le curseur sur le mot précédent
  move_next_word: déplacer le curseur sur le mot suivant
  history_previous: rappeler la commande précédente dans l'historique du tampon courant
  history_next: rappeler la commande suivante dans l'historique du tampon courant
  history_global_previous: rappeler la commande précédente dans l'historique global
  history_global_next: rappeler la commande suivante dans l'historique global
  jump_smart: sauter au prochain tampon avec de l'activité
  jump_last_buffer: sauter au dernier tampon
  jump_previously_visited_buffer: sauter au tampon visité précédemment
  jump_next_visited_buffer: sauter au tampon visité après
  hotlist_clear: effacer la hotlist
  grab_key: capturer une touche
  grab_key_command: capturer une touche avec sa commande associée
  scroll_unread: faire défiler jusqu'au marqueur de données non lues
  set_unread: définir le marqueur de données non lues pour tous les tampons
  set_unread_current_buffer: définir le marqueur de données non lues pour le tampon courant
  switch_active_buffer: basculer vers le tampon mélangé suivant
  switch_active_buffer_previous: basculer vers le tampon mélangé précédent
  insert: insérer du texte dans la ligne de commande

Cette commande est utilisé par les associations de touches ou les extensions.
........................................

[command]*`key`* associer/libérer des touches::
........................................
/key  list|listdefault|listdiff
      bind <touche> [<commande> [<args>]]
      unbind <touche>
      reset <touche>
      resetall -yes
      missing

       list: afficher toutes les touches courantes (sans paramètre, cette liste est affichée)
listdefault: afficher les touches par défaut
   listdiff: afficher les différences entre les touches courantes et celles par défaut (touches ajoutées, redéfinies ou supprimées)
       bind: associer une commande à une touche ou affiche la commande associée à la touche
     unbind: supprimer l'association à une touche
      reset: réinitialiser une touche à son association par défaut
   resetall: restaurer les touches aux valeurs par défaut et supprimer TOUTES les touches personnelles (utiliser avec précaution !)
    missing: ajouter les touches manquantes (en utilisant les touches par défaut), pratique après installation d'une nouvelle version de WeeChat

Lors de l'association d'une commande à une touche, il est recommandé d'utiliser la touche alt+k (ou Echap puis k), et puis de presser la touche à associer: cela insère le code de la touche dans la ligne de commande.

Exemples:
  touche alt-x pour activer/désactiver la liste des pseudos:
    /key bind meta-x /bar toggle nicklist
  touche alt-r pour aller sur le canal IRC #weechat:
    /key bind meta-r /buffer #weechat
  restaure l'association par défaut pour la touche alt-r:
    /key reset meta-r
........................................

[command]*`layout`* sauver/appliquer/réinitialiser la disposition des tampons et fenêtres::
........................................
/layout  save [buffers|windows]
         apply [buffers|windows]
         reset [buffers|windows]

   save: sauver la disposition courante
  apply: appliquer la disposition sauvegardée
  reset: supprimer la disposition sauvegardée
buffers: sauver/appliquer seulement pour les tampons (ordre des tampons)
windows: sauver/appliquer seulement pour les fenêtres (le tampon affiché par chaque fenêtre)

Sans paramètre, cette commande affiche la disposition sauvegardée.
........................................

[command]*`mute`* exécuter une commande silencieusement::
........................................
/mute  [-current | -buffer <nom> | -all] commande

-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")
    -all: pas d'affichage sur TOUS les tampons
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 (-current, -buffer ou -all), alors par défaut seul le tampon core WeeChat sera silencieux.

Exemples:
  sauvegarde configuration:
    /mute save
  message au canal IRC courant:
    /mute -current msg * bonjour !
  message au canal #weechat:
    /mute -buffer irc.freenode.#weechat msg #weechat bonjour !
........................................

[command]*`plugin`* lister/charger/décharger des extensions::
........................................
/plugin  list|listfull [<nom>]
         load <fichier>
         autoload
         reload|unload [<nom>]

    list: lister les extensions chargées
listfull: lister les extensions chargées (verbeux)
    load: charger une extension
autoload: charger automatiquement les extensions dans un répertoire système ou utilisateur
  reload: recharger une extension (si pas de nom donné, décharger toutes les extensions, puis recharger automatiquement les extensions)
  unload: décharger une extension (si pas de nom donné, décharger toutes les extensions)

Sans paramètre, cette commande liste les extensions chargées.
........................................

[command]*`proxy`* gestion des proxies::
........................................
/proxy  list
        add <nom> <type> <addresse> <port> [<utilisateur> [<mot_de_passe>]]
        del <nom>|-all
        set <nom> <option> <valeur>

        list: lister tous les proxies
         add: ajouter un nouveau proxy
         nom: nom du proxy (doit être unique)
        type: http, socks4 ou socks5
    addresse: IP ou nom de machine
        port: port
 utilisateur: nom d'utilisateur (optionnel)
mot_de_passe: mot de passe (optionnel)
         del: supprimer un proxy (ou tous les proxies avec -all)
         set: changer la valeur d'une propriété d'un proxy
      option: option à modifier (pour la liste des options, voir /set weechat.proxy.<proxyname>.*)
      valeur: nouvelle valeur pour l'option

Exemples:
  créer un proxy http, tournant en local, port 8888:
    /proxy add local http 127.0.0.1 8888
  créer un proxy http en utilisant le protocole IPv6:
    /proxy add local http 127.0.0.1 8888
    /proxy set local ipv6 on
  créer un proxy socks5 avec un utilisateur/mot de passe:
    /proxy add myproxy socks5 sample.host.org 3128 myuser mypass
  supprimer un proxy:
    /proxy del myproxy
........................................

[command]*`quit`* quitter WeeChat::
........................................
/quit  [-yes] [<paramètres>]

      -yes: requis si l'option weechat.look.confirm_quit est activée
paramètres: texte envoyé avec le signal "quit"
            (par exemple l'extension irc utilise ce texte pour envoyer le message de quit au serveur)
........................................

[command]*`reload`* recharger les fichiers de configuration depuis le disque::
........................................
/reload  [<fichier> [<fichier>...]]

fichier: fichier de configuration à recharger (sans l'extension ".conf")

Sans paramètre, tous les fichiers (WeeChat et extensions) sont rechargés.
........................................

[command]*`save`* sauvegarder les fichiers de configuration sur disque::
........................................
/save  [<fichier> [<fichier>...]]

fichier: fichier de configuration à sauvegarder (sans l'extension ".conf")

Sans paramètre, tous les fichiers (WeeChat et extensions) sont sauvegardés.
........................................

[command]*`set`* modifier des options de configuration::
........................................
/set  [<option> [<valeur>]]

option: nom d'une option (peut démarrer ou se terminer par "*" pour lister plusieurs options)
valeur: nouvelle valeur pour l'option

La nouvelle valeur peut être, selon le type de l'option:
  booléen: on, off ou toggle
  entier : nombre, ++nombre ou --nombre
  chaîne : toute chaîne ("" pour une chaîne vide)
  couleur: nom de couleur, ++nombre ou --nombre

Pour tous les types, vous pouvez utiliser null pour supprimer la valeur de l'option (valeur non définie). Cela ne fonctionne qu'avec certaines options spéciales des extensions.

Exemples:
  afficher les options à propos du highlight:
    /set *highlight*
  ajouter un mot pour le highlight:
    /set weechat.look.highlight "mot"
........................................

[command]*`unset`* supprimer/réinitialiser des options de configuration::
........................................
/unset  <option>

option: nom d'une option (peut commencer ou se terminer par "*" pour réinitialiser plusieurs options, à utiliser avec prudence !)

Selon l'option, elle est réinitialisée (pour les options standards) ou supprimée (pour les options facultatives, comme les valeurs pour les serveurs).

Exemples:
  réinitialiser une option:
    /unset weechat.look.item_time_format
  réinitialiser toutes les options de couleur:
    /unset weechat.color.*
........................................

[command]*`upgrade`* mettre à jour WeeChat sans se déconnecter des serveurs::
........................................
/upgrade  [<chemin_vers_binaire>]

chemin_vers_binaire: chemin vers le binaire WeeChat (par défaut le binaire courant)

Cette commande lance à nouveau un binaire WeeChat, il doit donc avoir été compilé ou installé via un gestionnaire de paquet avant de lancer cette commande.

Le processus de mise à jour comporte 4 étapes :
  1. sauvegarder la session pour le coeur et les extensions (tampons, historique, ...)
  2. décharger toutes les extensions (les fichiers de configuration (*.conf) sont écrits sur disque)
  3. sauvegarder la configuration WeeChat (weechat.conf)
  4. exécuter le nouveau binaire WeeChat et recharger la session.
........................................

[command]*`uptime`* montrer l'uptime de WeeChat::
........................................
/uptime  [-o | -ol]

 -o: envoyer l'uptime sur le tampon courant comme entrée (chaîne en anglais)
-ol: envoyer l'uptime sur le tampon courant comme entrée (chaîne traduite)
........................................

[command]*`version`* afficher la version de WeeChat et la date de compilation::
........................................
/version  [-o | -ol]

 -o: envoyer la version sur le tampon courant comme entrée (chaîne en anglais)
-ol: envoyer la version sur le tampon courant comme entrée (chaîne traduite)
........................................

[command]*`wait`* planifier l'exécution d'une commande dans le futur::
........................................
/wait  <nombre>[<unité>] <commande>

  nombre: temps à attendre (nombre entier)
   unité: optionnelle, valeurs possibles:
            ms: millisecondes
             s: secondes (par défaut)
             m: minutes
             h: heures
commande: commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/')

Note: la commande est exécutée sur le tampon où /wait a été exécuté (si le tampon n'est pas trouvé, alors la commande est exécutée sur le tampon WeeChat principal).

Exemples:
  rejoindre le canal dans 10 secondes:
    /wait 10 /join #test
  passer absent dans 15 minutes:
    /wait 15m /away -all I'm away
  dire 'bonjour' dans 2 minutes:
    /wait 2m bonjour
........................................

[command]*`window`* gestion des fenêtres::
........................................
/window  list
         -1|+1|b#|up|down|left|right
         splith|splitv [<pct>]
         resize [+/-]<pct>
         merge [all]
         page_up|page_down
         refresh
         scroll|scroll_up|scroll_down|scroll_top|scroll_bottom|scroll_previous_highlight|scroll_next_highlight
         zoom

         list: lister les fenêtres ouvertes (sans paramètre, cette liste est affichée)
           -1: sauter à la fenêtre précédente
           +1: sauter à la fenêtre suivante
           b#: sauter à la fenêtre affichant le tampon #
           up: sauter à la fenêtre au dessus
         down: sauter à la fenêtre au dessous
         left: sauter à la fenêtre à gauche
        right: sauter à la fenêtre à droite
       splith: éclater la fenêtre en deux horizontalement
       splitv: éclater la fenêtre en deux verticalement
       resize: redimensionner une fenêtre, la nouvelle taille est <pct> pourcentage de la fenêtre parent
        merge: fusionner la fenêtre avec une autre
      page_up: faire défiler d'une page vers le haut
    page_down: faire défiler d'une page vers le bas
      refresh: redessiner l'écran
       scroll: faire défiler d'un nombre de lignes (+/-N) ou avec du temps: s=secondes, m=minutes, h=heures, d=jours, M=mois, y=année
    scroll_up: faire défiler de quelques lignes vers le haut
  scroll_down: faire défiler de quelques lignes vers le bas
   scroll_top: faire défiler jusqu'au début du tampon
scroll_bottom: faire défiler jusqu'en bas du tampon
scroll_previous_highlight: faire défiler jusqu'au highlight précédent
scroll_next_highlight: faire défiler jusqu'au highlight suivant
         zoom: zoomer sur la fenêtre

Pour splith et splitv, pct est un pourcentage qui représente la taille de la nouvelle fenêtre, calculée par rapport à la taille de la fenêtre courante. Par exemple 25 signifie créer une fenêtre qui a pour taille: taille_courante / 4

Exemples:
  sauter à la fenêtre affichant le tampon 1:
    /window b1
  défilement de 2 lignes vers le haut:
    /window scroll -2
  défilement de 2 jours vers le haut:
    /window scroll -2d
  défilement jusqu'au début du jour courant:
    /window scroll -d
........................................