next_inactive up previous


Guide de l'utilisateur pour X-Chat (X-Chat 1.2)


Contents

Ce document tente de décrire l'utilisation de X-Chat et constitue une introduction générale à l'IRC. De grandes parties de la première section sont tirées de la FAQ du groupe de discussion alt.irc, je remercie et félicite les auteurs de ce document.

1 IRC

1.1 Qu'est-ce que Xchat ?

X-chat est un client IRC graphique qui tourne sur les systemes UNIX. Il utilise la librairie graphique GTK+ pourl'interface graphique. Il est sous license GPL (logiciel libre). Il tourne sur les systèmes suivants :

1.2 Introduction à l'irc

IRC signifie "Internet Relay Chat" qui a été écrit à l'origine par Jarkko Oikarinen (jto@tolsun.oulu.fi) en 1988. Depuis son début en Finlande, il a été utilisé dans plus de soixante pays dans le monde. Il a été conçu comme un remplaçcant du programme "talk" mais est devenu bien plus que cela. IRC est un système de dialogue multi utilisateur, où les gens viennent dans des "salons" (un endroit virtuel, généralement doté d'un sujet de discussion) pour discuter en groupe, ou de manière privée.

IRC évolue constamment, ce qui fait que la manière dont les choses fonctionnent à un moment donné peut etre différente de la manière dont elles fonctionnent une semaine après. Lisez le MOTD (message du jour) à chaque fois que vous utilisez IRC pour rester informés des dernières nouvelles et des mises à jour de serveur.

IRC a obtenu sa renommée internationale pendant la guerre du golfe de 1991, où des actualités venant du monde entier à travers le réseau étaient présentes, et la plupart des utilisateurs de l'IRC qui étaient connectés à ce moment là se réunirent dans un seul salon pour écouter ces rapports. L'IRC a connu des usages similaires pendant le coup d'etat contre Boris Yeltsin en Septembre 1993, où les utilisateurs de l'IRC venant de Moscou étaient en train de faire des reportages en direct sur la situation instable du lieu.

L'utilisateur lance un programme "client" qui se connecte au réseau IRC via un autre programme appelé un "serveur", qui tourne sur un autre ordinateur. Les serveurs sont utilisés pour faire passer les messages d'un utilisateur à l'autre à travers le réseau IRC. Xchat est un client doté d'une interface graphique qui tourne en utilisant GTK(www.gtk.org), il est principalement conçu pour tourner sous UNIX (par là je veux dire tous les UNIXs, comme Linux, *BSD, etc...), mais tourne également sur les sytèmes Windows 32 bits avec quelques restrictions.

1.3 Les bases de l'IRC

Tel quil est mentionné plus haut, le salon est l'unité élémentaire de la discution colective sur IRC. Chaque personne qui est "dans" un salon peut voir tous les messages écrits au salon et peuvent (en général) écrire eux-memes au salon. Toutes les commandes IRC débutent par un "/", et la majorité tiennent en un seul mot. Entrer "/help" vous donnera de l' aide etc...

Une fois connecté à un serveur la commande /join #salon vous fera rejoindre le salon dans la fenetre active, si vous rejoigniez d'autre salons alors que vous etes dejà dans un autre salon (i.e avant un /part), une nouvelle fenetre s'ouvrira. Une fois arrivé dans un salon, il ne vous reste plus qu'à écrire.

Les opérateurs de salons sont les rois/reines de leur salon. cela signifie qu'ils peuvent vous éjecter de leur salon pour n'importe qu'elle raison. Si vous n'appreciez pas cela, vous pouvez monter votre propre salon et devenir opérateur de ce dernier. Un opérateur IRC est une personne qui maintient le réseau IRC. Ils ne peuvent résoudre les problèmes liés aux salons. Ils ne peuvent pas exclure une personne de votre salon à votre place. Ils ne peuvent pas faire de "/kill" (exclure une personne de l'IRC temporairement) seulement parce que vous avez donné à votre agresseur le statut d'opérateur et que vous vous plaignez qu'ils vous ait exclu du salon.

#hottub et #initgame regorgent la plupart du temps de monde. #hottub est fait pour simuler une baignoire bouillante, et #initgame est un jeu sans fin sur les initiales. Allez y et vous verrez par vous meme !

Pour obtenir une liste des salons avec leur nom et leur sujet, faites /list -min 20 (sur ircII) qui vous montrera la liste des salons avec vingt utilisateurs ou plus. Vous pouvez aussi utiliser cette comande avec des nombres plus petits.

Beaucoup d'opérateurs IRC sont dans #Twilight_Zone ... donc si vous rejoignez ce salon, soyez prets à entendre beaucoup de conversations insensées, dans le genre de celles que vous pouvez rencontrer dans les salons sus-cités (#hottub). Ce qui était autrefois un endroit ou se trouvaient des gens qui auraient pu vous aider est devenu simplement un endroit de plus pour ceux qui n'ont rien d'autre à faire que simplement etre là. Si vous trouvez d'autres documents disant d'aller la-bas pour poser des questions, ignorez-les. Ils devraient etres considérés comme périmés.

Il n'y a pas asez de pseudonymes pour permettre la possesion de pseudonymes. Si quelqu'un prend votre pseudonyme pendant que vous n'etes pas connectés à l'IRC, vous pouvez leur demander de vous le rendre, mais vous ne pouvez ni l'exiger, ni vous attendre à ce qu'un opérateur IRC exclue une personne pour des problèmes liés aux pseudonymes. Si vous allez sur #Twilight_zone, vous trouverez des personnes qui refuseront de faire ça pour vous, bien qu'ils le feront pour eux memes ou leurs amis ou utiliseront la commande /kick pour moins que ça. Il y a ,litterallement, des millions de noms possibles de salons, donc si quelqu'un se trouve sur le salon que vous fréquentez régulièrement avec votre pseudonyme, allez tout simplement vers un autre salon. Vous pouvez utiliser /msg pour leur demander de partir de ce salon, mais vous ne pouvez en aucun cas les forcer à partir.

Les opérateurs de salon sont les propriétaires de leurs salons respectifs. Garder celà à l'esprit lorsque vous donnez les privilèges d'opérateurs de salon à d'autres personnes. (assurez vous de les donner à suffisamment de personnes de manière à ce que tous les opérateurs du salon ne quittent pas le salon en meme temps et le laissent ainsi sans un seul opérateur). D'un autre coté, ne donnez pas les privilèges d'operateur de salon à tout le monde. Cela entrainerait en effet des possibilités d'exclusions en masse, quand le salon serait sans opérateur. Il vous reste une alternative. Vous pouvez demander à tout le monde de quitter le salon et rejoindre le salon ensuite. C'est une bonne mannière pour faire revenir les opérateurs de salon. Cela ne fonctionne pas sur les grands salons ou ceux avec des robots, pour des raisons évidentes.

Sur l'IRC, vous ne pouvez pas etre banni de chaque serveur. Un banissement du serveur existe seulement pour le serveur en question (etre banni d'un serveur ne signifie pas que vous etes automatiquement banni des autres). "Les fantomes ne sont pas autorisés sur IRC" signifie que vous etes banni de ce serveur. Le banissement peut prendre une de ces trois formes :

La réponse la plus courante est :"utilisez un autre serveur !", mais si cela vous ennuie, essayez d'ecrire à l'administrateur irc de ce site -> /admin nom.serveur.ici et plaidez votre cas. Cela peut eventuellement vous mener quelque part ! Le meilleur guide de l'utilisateur de l'IRC basique est le IRC Primer, disponible aux formats texte, Postcript, et LATEX de cs-pub.bu.edu:/irc/support ... Un autre bon début serait de télécharger les tutorials IRC. Le protocole IRC est entièrement documenté dans le RFC 1459.

1.4 Etiquette

Cette sous-section est ecrite par Lea Viljanen, Ari Husa et Helen Rose pour irc2.9.5, merci à vous. Le langage le plus largement compris et utilisé des langages sur IRC est l'anglais. Cependant, comme IRC est utilisé dans beaucoup de pays différents, l'anglais n'est en aucune manière le seul langage.

Si vous désirez discuter dans un autre langage que l'anglais (par exemple avec vos amis), allez dans un salon séparé et déterminez le sujet de manière à ce qu'il l'indique clairement. D'un autre coté, vous devriez toujours verifier le sujet du salon avant de le rejoindre pour verifier s'il n'y a aucune restriction sur le langage.

Dans un salon non restreint par un sujet precis, veuillez discuter dans un langage que tout le monde est succeptible de comprendre. Si vous voulez vous conduire différemment, changez de salon et changez de sujet en fonction. Bonjour/Au revoir Il n'est pas nécessaire de saluer tout le monde personnellement dans un salon. Généralement, un "bonjour" ou équivalent est suffisant. Mais n'espérez pas que tout le monde vous salue en retour. Dans un salon avec vingt personnes, cela signifirait un plein écran de "bonjour". Il est important de ne pas saluer tout le monde afin de ne pas déranger le reste du salon. Si vous devez dire bonjour, faites le avec un /msg privé. Les memes règles s'appliquent aux aurevoir.

Discussion

Quand vous entrez dans un nouveau salon, il vous est conseillé d'écouter pendant un moment pour avoir une impression sur les discussions. N'hésitez pas à entrer, mais n'essayez pas d'introduire votre sujet de discussion dans la discussion si cela ne vient pas naturellement.

2 Récupérer, compiler et lancer

2.1 Récupérer

Si vous etes paresseux, ou que vous ne voulez pas installer les librairies requises alors allez voir la page des binaires statiques de Xchat que Peter Alexandrou héberge. Le principal endroit de distribution de Xchat est le site web de Xchat. Xchat a également besoin de GTK. Il peut aussi utiliser optionellement GNOME et Perl.

2.2 Compiler

Xchat utilise le système de GNU autoconf, ce qui rend la compilation facile, et l'autodetection fonctionnera sur la plupart des systèmes :

./configure ; make ; su ; make install 
Sur certains systèmes il est possible que gmake soit requis à la place de make. On peut également passer des options au script configure

Faites attention au fait que si vous n'avez pas Perl ou GNOME d'installé, le script configure s'en rendra compte tout seul et vous n'aurez pas à passer ces options, elles sont utiles seulement si vous avez installé un de ces derniers, mais que vous ne voulez pas activer leur support dans xchat. Si vous avez des problèmes avec cette méthode, vous pouvez essayer l'ancienne :

cp Makefile.gtk Makefile ; make ; su ; make install

2.3 Lancer

La compilation construit un executable appelé xchat. Si vous l'avez installé, entrer xchat dans une console devrait le lancer, sinon allez dans le repertoire de Xchat est entrez ./xchat. Le répertoire /.xchat devrait etre créé pour vous, Xchat utilise ce repertoire pour sauvegarder les paramètres et journaux de connection personnels.

3 L'interface graphique

Quand Xchat est lancé pour la première fois il affiche une fenêtre avec cinq parties principales :

  1. La barre de menu 2. La barre d'outils.
  2. La fenêtre de chat (au milieu à gauche).
  3. La liste des utilisateurs (au milieu à droite).
Le champ de saisie (en bas) Au démarrage une fenêtre sans état est crée (elle est marquée "<none>"), si vous rejoignez un salon alors cette fenetre contient toutes les informations sur ce dernier. Si quelqu'un vous envoie un message avec /msg, une nouvelle fenetre devrait etre crée contenant tous les autres messages que cette personne vous enverra avec la commande /msg.

3.1 La barre de menu

La barre de menu possède six menus internes (le texte de ces menus peut changer si vous avez les paquetages d'internationalisation installés) :

  1. "Xchat" - Principales opérations, comme le menu Fichier.
  2. "Windows" - Chacune des fenêtres de Xchat peut etre appelée à partir de ce menu, il contient également des opérations sur le texte de la session en cours.
  3. "User Modes" - Tous les éléments de ce menu sont des interrupteurs permettant de changer l'etat de l'utilisateur IRC.
  4. "Settings" - Toutes les fenetres de configuration peuvent être appellées d'ici.
  5. "Scripts & Plugins" - Opérations concernant les Scripts et les Plugins.
  6. "Help" - Menu d'aide standard.

3.2 La barre d'outils

La barre d'outils contient les onglets de chaque fenêtre rattachée à la fenêtre principale, ces onglets possèdent le nom du salon ou du pseudonyme de la fenêtre courante (selon que vous etes sur un salon ou en train de dialoguer en privé). En cliquant sur un de ces onglets vous pouvez mettre cette fenêtre au premier plan. Si le texte dans une fenetre non visible change, alors l'onglet de cette fenêtre devient rouge.

Le bouton "X" tout à gauche ferme la fenêtre courante. Si c'est la seule fenêtre, cela fait quitter Xchat. La zone de texte contient le sujet du salon courant ou l'adresse du pseudonyme courant si vous etes en train de dialoguer en privé.

Le bouton "" (ou une flèche vers le haut si vous utilisez gnome), à coté du bouton "X", attache ou détache la fenêtre. Si vous avez une serie d'onglets et que vous cliquez sur ce bouton alors cela détachera la fenêtre et en fera une fenêtre séparée. Ensuite, cliquer une autre fois sur ce bouton rattachera la fenêtre.

Vous ne pouvez pas détacher une fenêtre si c'est la seule et si vous tentez de rattacher une fenêtre alors qu'il n'y a pas de fenêtre pour la contenir, une fenêtre sera crée à cet effet.

Les boutons à la droite de la barre d'outils changent les modes du salon, et prennent seulement effet si la fenêtre active est un salon et que vous etes opérateur de ce salon. Ils veulent dire :

Le bouton tout à droite, avec la flèche, cache/montre la liste 'utilisateurs.

3.3 La zone de texte

La zone de texte contient le texte de l'objet contenu (salon, dialogue privé etc..) et la sortie des commandes entrées dans le champ de saisie. C'est en général une zone de texte GTK, dont les options peuvent être controlées à partir de "Setting - Setup - Channel Windows". Cependant cela peut être un ZVT (GNOME seulement), et cela permet d'autres options comme les arrières plans pseudo-transparents.

3.4 La liste des utilisateurs

La liste des utilisateurs comprend tous les pseudonymes dans le salon courrant. Les pseudonymes peuvent avoir un point vert ou jaune à leur gauche.Un point vert signale un opérateur de salon et un jaune un utilisateur "voicé" (qui peut poster des messages sur un salon modéré).

En dessous de cette liste se trouve un ensemble de boutons, qui sont controlés via "Settings - user-list Buttons". Clicker sur l'un d'eux exécute une certaine commande sur le pseudonyme selectioné dans la liste des utilisateurs. Plusieurs pseudonymes peuvent etre sélectionnés en maintenant la touche shift enfoncée.

3.5 Le champ de saisie

A gauche du champ de saisie se trouve une étiquette qui contient votre pseudonyme courrant avec, peut etre, un poiunt jaune ou vert à sa gauche (voir 3.4). Entrer du texte dans ce champ de saisie et appuyer sur entré traitera le texte entré. Il peut etre traité de deux façons, il est soit envoyé à l'objet contenu par la zone de texte (salon ou utilisateur dans le cas d'un dialogue privé), soit traité comme une commande si le texte commence par un "/". A la droite de ce champ de saisie se trouve l'interrupteur de conférence. Quand il est activé, tous les messages d'arrivée/départ d'utilisateurs sur l'objet en cours (salon ou discussion privée) sont cachés, et vous pouvez de cette façon avoir une conversation ininterrompue.

4 Débuter

Premièrement, si vous ne connaissez pas l'IRC alors lisez la section 1.2. Démarrez Xchat et sélectionnez "Server List" dans le menu "Xchat". Cela fera apparaitre une liste des serveurs IRC par défaut. Si vous connaissez un serveur IRC particulier que vous aimez, alors cliquez sur "New Server" et entrez les détails à propos de ce dernier en bas.

Maintenant remplissez vos détails personnels en haut. J'admettrais que vous utilisez un serveur local (absent de la liste par defaut) à l'adresse 127.0.0.1 et mon pseudonyme "Nebulae". Si jamais vous utilisez mon pseudonyme je ne serais PAS content, alors choisissez votre propre pseudonyme ou ouvrez /usr/dict/words et choississez le parmi ceux là. Cliquez sur "connect" et (je l'espère) vous vous connecterez.

Le texte qui apparaitra se déroulera vers le bas dans la zone de texte en affichant le MOTD (Message Of The Day, message du jour). Une fois que ceci est terminé, cliquez dans le champ de saisie et entrez :

/join #dgg5ds 
Faites ce que vous voulez de "dgg5ds". Vous devriez voir une ligne disant <votre pseudonyme> (<votre adresse>) has joined #salon et votre pseudonyme devrait etre présent dans la liste d'utilisateurs avec un point vert à coté, montrant que vous etes opérateur du salon (car vous venez de créer le salon).

Etant donné que vous venez de créer le salon, vous verrez également une ligne disant que vous vous etes donné le statut d'opérateur du salon. Si vous entrez du texte normal (sans "/" au début), alors vous le verrez apparaitre sur le salon avec votre pseudonyme devant. Si quelqu'un d'autre était dans le salon, il verrait également cela.

Cliquez dans le champ de texte de la barre d'outils et entrez "Mon sujet" puis presez "entrée". Le sujet du salon est maintenant "Mon sujet", vous verrez une ligne vous le signalant. Si vous jouez avec les boutons de la barre d'outils qui sont étiquetés avec des lettres, vous pouvez changer le mode du salon (plus de renseignements à ce sujet plus tard). Si vous cliquez trop, vous constaterez un ralentissement de Xchat, cela est du au fait que si vous "floodez" (envoi de trop de données trop vite) le serveur vous déconnectera, donc Xchat limite la quantité de données qu'il enverra. Cela peut le faire paraitre lent, mais est finalement la meilleure solution.

Maintenant si vous entrez "/msg <votre pseudo> Bonjour" et que vous appuyez sur entrée dans le champ de saisie (en bas) vous vous envoyez un message privé, disant bonjour. Vous ne feriez pas cela normalement, si vous avez une si mauvaise coordination entre les mains et les yeux que vous devez lire ce que vous tapez, vous devez voir un docteur, ce n'est vraiment qu'un test. Une nouvelle fenetre sera crée sous la fenetre active, et son onglet apparaitra dans la barre d'outils, avec le texte (de l'onglet) en rouge pour vous montrer que la zone de texte correspondant à cet onglet a changé. Si vous cliquez sur ce nouvel onglet, la fenetre viendra au premier plan et vous verrez le message Bonjour venant de vous meme.

Quand vous ecrivez dans le champ de saisie de cette fenetre le texte ira à l'objet contenu par cette fenetre, dans ce dernier cas vous-meme, dans l'autre cas le salon #dgg5ds. Si vous entrez quoi que ce soit vous verrez que cela vous est revenu. Vu que vous n'etes pas tres intéressé par le fait de vous envoyer des messages (j'espère), cliquez sur le bouton "X" de la barre d'outils (en haut à gauche) et la fenetre disparaitra, et la première fenetre réaparaitra.

Maintenant, si vous selectionnez votre pseudonyme dans la liste et cliquez sur le bouton étiqueté "Whois" en bas de la liste des utilisateurs, vos information de WHOIS seront affichées dans la zone de texte. ces informations viennent du serveur et peuvent etre lues par n'importe qui sur l'IRC. Les information de WHOIS peuvent également etre accédées par une commande. Dans le champ de saisie entrez "/whois <votre pseudo>" et pressez entrée. Remarquez le préfixe "/" qui montre que c'est une commande, sans ca le texte serait envoyé au salon.

Les boutons correspondent à des commandes, cliquez sur le menu "Configuration" et sélectionnez "Boutons de la liste des utilisateurs". Une boite de dialogue vous montrant chaque bouton et la commande qu'il lance une fois pressé apparaitra, vous pouvez ajouter les votres. Remarquez que %s dans la commande est remplacé par le pseudonyme sélectionné dans la liste des utilisateurs.

Maintenant si vous cliquez avec le bouton droit sur votre pseudonyme dans la liste des utilisateurs quelques options apparaissent. Elles correspondent à des commandes comme pour les boutons, sélectionnez "Menu contextuel de liste des utilisateurs" dans le menu "Configuration". Les options CTCP (Client To Client Protocol; Protocole de Client A Client) envoient un message privé , qui est relevé par leur client IRC et géré comme un type de commande, au pseudonyme cliqué. La plupart du temps un message CTCP est renvoyé. Ces réponses peuvent etre configurées dans "Configuration - Réponses CTCP".

La réponse au CTCP VERSION est automatique et peut etre interrompue par la commande "/hidever", mais vous pouvez toujours configurer une réponse CTCP qui est lancé comme l'automatique. Si vous etes coincé, entrer "/help -l" (L minuscule) devrait vous apporter conseil.

4.1 Les listes de diffusion

Xchat possède deux listes de diffusion auxquelles vous pouvez avoir envie de vous abonner, xchat-discuss et xchat-announce (hebergée gracieusement par nl.linux.org). pour vous abonner envoyez un message sans sujet et cela dans le corps :

subscribe nom-liste
à majordomo@nl.linux.org où "nom-liste" est soit "xchat-discuss" soit "xchat-announce". On vous demandera dans une réponse de confirmer votre inscription. Xchat-discuss est une liste de discussion générale où vous pouvez demander de l'aide, lancer des idées etc..à d'autres utilisateurs de Xchat. Xchat-announce est un liste modérée (seulement zed et moi peuvent y poster) ou les annonces (telles que la sortie de nouvelles versions) sont postées. *N'esssayez pas de poster sur xchat-announce*. Si vous avez des questions à propos des listes de diffusion, ecrivez moi un mail (Adam langley) à agl@linuxpower.org.

4.2 Modes de salons

Chaque salon peut avoir une serie de modes. Seuls les opérateurs de salon peuvent changer les modes du salon. Les modes peuvent être ajustés soit par les boutons étiquetés par des lettres à la droite de la barre d'outils, soit par la commande "/mode". les modes peuvent également etre ajustés par d'autres commandes, telles que "/op", "/deop" ou "/ban". Ce qui suit est une liste des modes possibles pour un salon (elle n'est pas exhaustive) :

4.3 Scripts et plugins

Les scripts et les plugins vous permettent d'étendre xchat sans éditer le code. Pour des informations à propos de leur conception, reportez vous à la section 7.

Les scripts sont des scripts Perl et pour les utliser vous devez non seulement avoir Perl installé sur votre système mais aussi avoir activé le support de perl lors de la compilation de xchat. Les plugins sont des librairies partagées (fichiers .so) qui sont dynamiquement liées et détachés de l'image du processus de Xchat.

Au démarrage, tous les fichiers dont le nom se termine par ".pl" dans le répertoire /.xchat sont chargés automatiquement . Pour charger un script manuellement, utilisez soit la commande "/load", ou sélectionnez "Charger" puis "Script Perl" à partir du menu "Scripts & Plugins". Pour charger un plugin, utilisez soit la commande "/loaddll" ou sélectionnez "Charger" puis "Plugin..." du menu "Scripts & Plugins". Le plugin devrait aller apparaitre dans la liste de plugins produite par la commande "/listdll" ou en selectionnant "Liste des Plugins" du sous menu "Info" du menu "Scripts & Plugins". Vous pouvez décharger les plugins soit un par un avec la commande "/rmdll" ou dans la liste des plugins, soit tous en sélectionnant "Tous les plugins" du sous menu "Tuer" du menu "Scripts & Plugins".

Vous n'avez pas à décharger les scripts et plugins manuellement avant de quitter Xchat. Une liste des scripts et plugins à télécharger est disponible à la page web de Xchat (www.xchat.org).

4.4 Support DCC

DCC signifie "Direct Client Connect" (Connection Directe au Client). C'est un sytème grace auquel deux clients peuvent se connecter directement, sans passer par le serveur IRC. Xchat permet d'envoyer trois types d'informations à travers un lien DCC :

Vous pouvez envoyer un fichier en utilisant soit la command "/dcc send <pseudo> <fichier>" ou en sélectionnant le pseudo dans la liste de sutilisateurs puis en cliquant sur le bouton "envoyer". La fenetre d'envoi DCC devrait alors montrer l'état de la transmission. Lorsque quelqu'un vous enverra un fichier, la fenetre de réception DCC s'ouvrira et vous permettra d'accepter ou d'annuler le transfert.

Pour établir une ligne de discussion via DCC, utilisez soit la commande "/dcc chat nick" ou selectionnez le pseudo à partir de la liste des utilisateurs et cliquez sur "chat". Une fois la connexion DCC acceptée, les messages privés envoyés avec la commande "/msg" au pseudonyme concerné utiliseront le lien DCC au lieu du serveur.

Quand une personne vous propose un lien DCC de discussion, vous pouvez l'accepter avec la commande "/dcc chat <pseudo>", en remplacant <pseudo> par la personne qui vous propose la discussion via DCC.

4.5 Personalisation

Si vous selectionnez le menu "Configuration" puis le menu "Commandes utilisateurs" vous obtiendrez une liste des raccourcis actuels. Quand vous entrez (dans le champ de saisie habituel, en dessous de la zone de texte de xchat) un des mots se trouvant dans la colonne de gauche de cette liste comme une commande (donc précédée par "/"), alors le texte de la colonne de droite est éxécuté.

Les "%n" (n étant un nombre) sont remplacés par le n-ième argument de la commande. Les "&n" (avec n qui est un nombre) sont remplacés par le n-ième argument et tout le texte qui suit, espaces inclus. "%c" est le salon courant et "%n" est le pseudonyme en cours. Les commandes utilisateurs peuvent etre séparées par un ";" (point virgule), mais faites bien attention de ne pas mettre d'espaces après ce ";".

Les memes règles sont valables pour le menu "Réponses CTCP", "Boutons de la liste d'utilisateurs" et "Menu contextuel de la liste d'utilisateurs", avec une exception pour ce dernier. avec celui-ci vous pouvez créer des sous menus en ajoutant des lignes ayant pour nom "SEP" et comme valeur le nom du sous-menu à ajouter.

Pour clore le sous-menu, utilisez comme nom de commande "ENDSUB" et rien dans la commande correspondante.

4.6 Expansion des pseudonymes

Admettons que vous soyez dans un salon en compagnie de personnes utilisant les pseudonymes suivants :

Si vous vouliez envoyer un message à zed, vous entreriez "zed: <message>" dans le champ de saisie et presseriez entrée. Au lieu de procéder comme cela vous pouvez utiliser l'expansion automatique des pseudonymes. Entrez simplement "z" et pressez tabulation, et Xchat trouvera pour vous le premier pseudonyme dans le salon en cours qui correspond à ce que vous venez d'entrer (qui utilise un pseudo commençant par "z"). Dans ce cas, le texte dans le champ de saisie deviendrait "zed:". Maintenant, si vous aviez voulu envoyer un message à aaaaaab vous auriez entré "a" et pressé la touche tabulation. mais cela trouvera le premier pseudo correspondant, qui dans ce cas précis est aaaaaaa, le champs de saisie deviendra donc "aaaaaaa:" (ce qui n'est pas ce que vous voulez). Il suffit alors de tenir shift enfoncé et de presser la touche "page-down" et Xchat utilise le prochain pseudo dans la liste des utilisateurs (en descendant, shift + page-up utilise le pseudo juste en dessus dans la liste des utilisateurs), le champ de saisie contiendra alors "aaaaaab: ". Cependant, la prochaine fois que vous entrerez "a" et que vous presserez la touche tabulation, Xchat selectionnera "aaaaaab" parce que vous aviez utilisé page-up ou page-down précedemment pour lui dire qu'il s'etait trompé, et Xchat s'en souvient.

4.7 Remplacement automatique

Maintenant sélectionnez le menu "Configuration", puis "Fenetre de remplacement automatique". Une liste avec une série de remplacements par défaut apparaitra (à moins que vous ne les ayez déjà changé). Une des entrées devrait faire correspondre "r" à "are", si elle n'y est pas, ajoutez là. Maintenant commencez à entrer du texte dans n'importe quel champ de saisie et entrez "r" à un moment donné. Le "r" deviendra "are". Le mécanisme de remplacement automatique s'active à chaque fois que vous appuyez sur espace dans un champ de saisie et essaie de trouver une correspondance avec les dernieres syllabes (ou lettres) que vous venez d'entrer. Si une correspondance est trouvée, cette correspondance remplace le mot que aviez commencé à saisir. Si le mot (ou les syllabes) que vous venez d'entrer est(sont) entouré(e)s par des apostrophes, comme 'r', le mot n'est pas remplacé. Si le mot contient une seule apostrophe, la partie du mot avant l'apostrophe est analysée (en vue d'une éventuelle correspondance). Si une correspondance est trouvée, seule cette partie (avant l'apostrophe) est remplacée, l'apostrophe est effacée est la partie du mot après l'apostrophe est ajouté à la correspondance trouvée. par exemple si vous avez la correspondance "u" -> "you" :

4.8 Journal

Si vous allez dans le menu "Configuration" puis dans le sous-menu "Configuration" et enfin dans le sous menu "IRC", vous trouverez une entrée "Logguer" qui, si vous l'activez, vous permettra d'enregistrer toute nouvelle session de discussion. Les journaux sont conservés dans /.xchat/xchatlogs et possèdent le format de nom_du_serveur.nom_de_session.xchatlog. Par exemple, voici quelques fichiers de mon répertoire de journaux :

Vous pouvez aussi supprimer le "%s" du masque de log pour éviter d'ajouter le nom du serveur au nom des fichiers de journal de manière à ce qu'ils se nomment ainsi :

Remarquez que si vous etes sur deux salons de meme nom mais sur deux serveurs différents, les fichiers de journal se mélangeront (ce qui peut etre utile ou génant suivant les cas).

4.9 Support du panel

Lorsque le support du panel est activé, un nouveau bouton apparait à coté du bouton "Link/delink" de la barre d'outils (il possède une flèche vers la bas en tant qu'icone). Ce bouton envoit la session dans le panel. La première fois que vous cliquerez sur ce bouton, une applet apparaitra dans le panel. L'applet du panel est un label étiqueté "X-Chat" avec une série de boutons. Le sens des boutons peut etre ajustée dans la section "Panneau" du sous menu "Interface" du sous menu "Configuration" du menu "Configuration", en cochant ou décochant l'option "Agencement pour un panneau Vertical". remarquez que, pour le moment, vous devez redémarrer X-Chat" pour que cette otpion prenne effet. Chaque session "panélisée" apparait comme un bouton dans l'applet X-Chat du panel. Si l'option "Cacher le canal lorsqu'il est panélisé" est cochée, la session est cachée lorsqu'elle est panélisée. Cliquer sur le bouton fera apparaitre la session. La couleur du texte sur le bouton changera comme d'habitude (rouge ou bleu) et reviendra à sa couleur normale lorsque la session sera active. Un click droit sur sur un bouton de l'applet X-chat fera apparaitre une liste d'éléments. En haut se trouvent 3 labels avec l'etat du serveur courant, du salon courant et de l'onglet courant. Sous ces labels se trouvent d'autres boutons :

4.10 Evénements d'impression

Depuis la version 0.9.7 vous pouvez changer les ecritures produites par X-Chat. Ouvrez le sous-menu "editions des evènements textuels" du menu "Configuration" pour afficher les paramètres actuels. En haut de la fenetre se trouve une liste d'évènements et la chaine de caractère qui est affichée lorsque cet évènement apparait. Juste en-dessous se trouve un champ d'edition pour changer ce texte. Encore en dessous se trouve un champ de texte pour prévisualiser la chaine ainsi produite (cliquer sur "Test All"). Encore en-dessous se trouve une liste d'options qui sont passés à l'évènement actuellement sélectionné (plus d'informations à ce sujet plus tard). En tant qu'exemple nous editerons l'évènement généré par "Join". D'abord, sélectionnez "Join" dans la liste en haut, il devrait etre le premier élément. Si ce n'était pas dejà le cas, le texte dans le champ d'édition montrera l'évènement "Join". Au premier regard, cela semble complexe mais ce n'est vraiment pas le cas, cela ce décompose comme ceci :

%C4*%C *%C4*%C Hey! Je peux éditer les évènements textuels ! $1 a rejoint $2 (hote: $3)  
"%C4*%C *%C4*%C" correspond à une etoile rouge, une blanche et encore une rouge, ce qui est le standard qu'utilise X-Chat. Le reste est très clair. Dans la fenetre principale de X-Chat, attendez que quelqu'un rejoigne le salon dans lequel vous etes (remarquez que nous avons changé l'évènement "Join" et non pas l'évènement "Joining", donc cela ne fonctionne que lorsque d'autres personnes que vous rejoignent le salon) et vous verrez quelque chose comme :

*** Hey! Je peux éditer les évènements textuels ! Adam a rejoint "a (hote : Adam@127.0.0.1)
L'entrée correspondant au fichier de son vous permet d'y entrer le nom d'un fichier sonore qui sera joué (en utilisant les paramètres de la commande play) chaque fois que l'évènement sélectionné est déclenché. Les cinq boutons du bas effectuent les choses suivantes :

4.11 Racourcis clavier

En sélectionnant le menu "Edition de l'association des touches" du menu "Configuration", vous pouvez éditer les racourcis clavier que X-Chat utilise. Les racourcis clavier sont classés par utilisation (les plus récemment utilisés se trouvent en haut de la liste). Un racourci clavier se compose de :

Pour ajouter un nouveau raccourcis clavier, cliquez sur "Add new". Un raccourcis avec tous les champs à "<none>" apparaitra en bas de la liste des raccourcis. Quand vous le sélectionnez (ou que vous sélectionnez un autre raccourcis), les champs de texte de droite changent pour correspondre au raccourci sélectionné. Pour changer la touche sélectionnez le champ de texte étiqueté par "key" et *pressez* la touche voulue, n'essayer pas d'entrer quoique ce soit d'autre !. l'action à effectuer peut etre sélectionnée à partir de la liste déroulante du bas et de l'aide sur cette action apparaitra dans la zone de texte du bas. Les changements effectués dans cette fenetre sont toujours actifs. Quand la fenetre est fermée, l'information sur les raccourcis claviers est enregistrée dans /.xchat/keybindings.conf.

5 Réglages

5.1 Interface

5.1.1 IRC Entréé/Sortie

5.1.2 Agencement

5.1.3 Canaux & Fenetres de dialogue

Ces deux sections sont equivalentes excepté ce qu'elles affectent.

5.2 IRC

5.2.1 Addresse IP

5.2.2 Absent

5.2.3 Surbrillance

5.2.4 Logguer

5.2.5 Notification

5.3 DCC

5.3.1 Transfert de fichiers

5.4 CTCP

6 Les fenetres

Ces fenetres peuvent etre atteintes a partir du menu fenetre.

6.1 Fenetre de liste des canaux

Cette fenetre vous permet de lister tous les channels sur le serveur. Les salons sont filtré de sorte que seulement les salons avec au minimum le nombre d'utilisateurs donné dans "Minimum Users" apparaissent. "Refresh the list" efface la liste et relance une recherche. "Save the list" vous permet d'enregistrer la liste dans un fichier tandis que "Join Channel" vous permet d'entrer dans le salon selectioné dans la liste. Faites attention car il peut y avoir des milliers de salons et les lister peut flooder votre connection. Le seul moyen de stopper un listage en cours est de se deconecter.

6.2 DCC Send et DCC Recv

Ces fenetres montrent les statuts de tous les DCC Send et DCC Receive en cours. "Status" montre le statut du fichier. "File" donne le nom du fichier. "Size" donne la taille, en bits, du fichier. "Position" donne le nombre de bits recus ou envoyés. "Ack" (only in Send) donne le nombre de bits d'acknowledgment. "CPS" donne le nombre de bits recus/envoyés par secondes. "From" donne le pseudonyme de la personne qui envoit/reçoit. Si vous utilisez GNOME alors vous avez aussi une colone avec le type MIME du fichier. Le bouton "Abort" annule l'envoi ou la reception alors que "Info" donne quelques information supplementaires à propos de l'échange. Les boutons "Accept" et "Resume" sont seulement dans la fenetre DCC Recv. "Accept" permet d'accepter un fichier qu'on vous envoi, "Resume" fait la meme chose mais permet de finir un échange qui a été coupé avant la fin. Le texte des objets dans les fenetres DCC est maintenant coloré suivant l'état de la transaction.

6.3 DCC Chat

La fenetre DCC Chat liste tous les DCC chat actuellement ouverts. "To/From" donne le pseudonyme du correspondant. "Recv" donne le nombre de bits recus par le DCC et "Send" donne le nombre de bits envoyé. "StartTime" donne l'heure d'ouverture du DCC.

6.4 Fenetre de Logs Bruts

La fenetre de Logs Bruts liste les données brutes (raws) envoyées/reçues du serveur. Chaque nouvelle ligne de données est prefixée soit par "<<" ou ">>". "<<" signifie que le reste de la ligne (apres l'espace) a été envoyé depuis XChat vers le serveur, ">>" signifie que le reste de la ligne (apres l'espace) a ete envoyé du serveur vers XChat. Vous pouvez aussi tapez Alt-s pour sauvegarder le rawlog - on vous demandera un nom de fichier.

6.5 Fenetre de Capture d'URL

Quand une URL (Uniform Resource Locator) est aperçu dans nimporte quelle fenetre, elle est envoyé dans la fenetre de Capture d'URL. Ceci evite de copier/coller depuis la fenetre. Le bouton "Clear" efface la liste. "Lynx" et "Netscape" lance Lynx ou Netscape avec l'URL sélctioné.

6.6 Fenetre de Liste de Notification

La liste de notification utilise la commande ISON pour trouver n'importe quel "ami" qui pourrait etre sur IRC. Vous devez utiliser la commande /notify pour ajouter et enlever des gens de la liste (cela agit comme un interrupteur), alors la Liste de Notification montre lesquels d'entre eux sont présent, et quel serveur ils utilisent. "Remove" enleve le pseudo selectioné de la liste de notification.

6.7 Lastlog

La fenetre "rechercher dans le tampon" vous permet de rechercher une chaine de caracteres dans la fenetre en cours. Entrez vos paramètres de recherche dans le champ de texte du bas, une recherche est alors effectuée dans la fenetre en cours et toutes les lignes correspondantes sont affichées.

6.8 Fenetre d'Ignorance

Cette fenetre controle le mécanisme d'ignorance de XChat. Ceci (comme le nom l'indique) vous permet de définir les regles pour ignorer les messages de certaines personnes. Ces regles sont basées sur un masque de nom d'hote et un masque sur ce qu'il faut ignorer.. Le masque est au format pseudonyme!nom@machine, donc *!*@*.aol.com correspond a toute personne utilisant AOL et LameNick!*@* correspondra a toute personne ayant le pseudonyme LameNick. La rangée de boutons au milieu donne le masque de ce qu'il faut ignorer:

Les boites de dialogues en haut montrent le nombre de fois qu'un certain type de message a été bloqué. Unignore peut aussi etre accedé depuis la ligne de commande:

/ignore *!*@*.aol.com ALL /ignore myfriend!myfriend@*.aol.com ALL UNIGNORE 
(va ignorer toute personne sur AOL excepté myfriend).

7 Comment contribuer à XChat

7.1 En plongeant dans le code source

Le code source principal de XChat se trouve dans le répertoire /src. Dans ce dernier se trouvent tous les fichiers "*.c" et "*.h" qui constituent XChat.Si vous désirez fouiller dans le code, voci un petit plan :

La plupart des autres fichiers possèdent des noms simples à comprendre, leur role est facilement compréhensible.

7.2 En écrivant des scripts

Dagmar d'Surreal a écrit la documentation concernant l'écriture de scripts, dans xchatdoc2.html

7.3 En écrivant des plugins

Il devrait y avoir un exemple de module dans le répertoire "sample", il donne un apercu général à propos de l'écriture de modules. D'abord vous devez insérer "#define USE_PLUGIN" dans votre code avant tout "#include". Vous devez également inclure "xchat .h" et "plugin.h" qui sont situés dans le répertoire principal de XChat. Tout module doit exporter une fonction appellée module_init, à laquelle on passe le numéro de version (un int), un pointeur vers la structure module de votre module et un pointeur vers la session courante. cette fonction retourne un int :

Les attributs "name" et "desc" de la structure de module doivent contenir des chaines de caractères. Vous devez vérifier que le numéro de version est bien celui que vous pensez (2 en ce moment) avant de définir autre chose , le numéro de version courante est défini dans le fichier "plugin.h" par la constante MODULE_IFACE_VER. Le point d'ancrage basique dans XChat, pour un plugin, est un signal. A certains endroits dans le programme un signal est émis. Une chaine (un groupe) de handlers sont alors appelés, chacun appelant le suivant (de la liste des handlers). Si le premier handler (et ainsi le handler qui renvoie une valeur à la fonction qui a emis le signal) renvoie TRUE alors la fonction emettrice n'éxécute pas l'action par défaut. Comme ceci un handler peut remplacer le comportement par défaut de XChat par le sien.tout module peut intercepter un signal en utilisant la fonction hook_signal et en passant un pointeur vers un structure "xp_signal_struct", en remplissant les attributs "signal", "callback", "naddr" et "mod" de cette dernière. Ils doivent etre remplis de la manière suivante :

A la fin du callback, vous devez utiliser XP_CALLNEXT(naddrfunction, a, b, c, d, e, f) pour appeler le prochain callback, les arguments de "a" à "f" étant les arguments que vous aviez reçus précédemment. Le code qui gère les plugins de XChat met à jour la fonction pointée grace à l'attribut "naddr", de manière à ce qu'il pointe vers le prochain handler, ou NULL si c'est le dernier handler. Ne vous inquiétez pas pour cela. Si vous ne voulez pas que l'action par défaut se déclenche alors utilisez XP_CALLNEXT_ANDSET() au lieu de XP_CALLNEXT. Seuelemnt un handler dans la chaine des handlers a besoind'appeler XP_CALLNEXT_ANDSET pour annuler l'action par défaut. Soyez attentif au fait que XP_CALLNEXT[_ANDSET] s'étend pour inclure un renvoi de valeur, donc ces appels doivent etre à la fin du déroulement de votre handler. On passe cinq pointeurs sur void et un char aux handlers de signaux (ce qui semble suffisant), par convention le premier pointeur sur void pointe vers la structure "session" ou "server". Pour transtyper ceci en callback de signal utilisez la macro XP_CALLBACK comme les autres macros de transtypage GTK. La plupart des modules appellent la fonction "module_add_cmds" à un moment donné. Cela intercepte n'importe quelle commande spécifique pour vous sans etre obligé d'intercepter et d'analyser tous les signaux de commandes. Vous lui passez un pointeur vers une structure "module_cmd_set", qui doit etre renseignées comme ceci :

Examinez l'exemple de module pour un exemple de la liste de STRUCT COMMANDS. Faites attention à ce que la structure module_cmd_set soit globale car XChat l'utilise et la modifie. Quand le module est déchargé la fonction module_cleanup est appelée, on lui passe en argument la structure "module" et la session courante. Vous n'avez pas à exporter un MODULE_CLEANUP étant donné que tous les intercepteurs de signaux sont supprimés par XChat. Les plugins appellent des fonctions de XChat directement et sont ainsi plus dépendant du code de XChat que les scripts. Quelques une des fonctions communes de XChat qui sont utilisées sont listées ci-dessous :

J'ai également écris un exemple de plugin bien plus complet (et qui fonctionne), il est appelé auto et se trouve sur la page web de XChat (htttp://www.xchat.org).

Les signaux

Il y a une liste de tous les signaux actuellement disponibles dans le fichier "plugins/SIGNALS". Cela devrait y etre ajouté dans le futur. si vous pensez que vous avez de la place pour quelques signaux de plus, envoyez moi un e-mail (je suis Adam, voir la section Auteurs). NOTE : ce document n'inclue pas les signaux d'évènements textuels, regardez dans le fichier text.c pour ces détails.

8 I18n

i18n siginfie internationalisation (conmptez le nombre de lettres entre le i et le n). Depuis la version 0.9.8 de multiples langages sont supportés. Cet effort continue toujours et pour le moment seulement les menus sont en multi-langage. Pour essayer et selectioner le support pour votre langage tapez:

export LANG=xx
où xx est votre code langage a 2 lettres et non votre code pays. Si vous utilisez un shell different de bash/sh vous pourriez avoir besoin de changer la syntaxe (setenv LANG fr avec tcsh).

9 Auteurs

Beaucoup, beaucoup de gens ont aidé XChat, trop pour etre repertoriés. Ils se reconnaitront, je les remercie.

Beucoup d'autres nous ont aidé pour d'auters modifications.. Si vous avez envoyé un patch et que vous voulez que votre nom soit inclu ici, faites le savoir à zed@linuxpower.org.

Peter Zelezny (AKA: zed) rassemble tous les patchs en un seul (heureuseument). Il controle le site web et toutes les 'vraies' versions de XChat viennent de lui. Il gère également les annonces sur les listes d'applications GNOME et freshmeat. Tout ce qui est dans le ChangeLog sans nom est generalement son travail. Son adresse e-mail est zed@linuxpower.org. Adam Langley (AKA: Nebulae) gère la documentation et de gros morceaux du code, surtout les signaux et le code des plugins. Ses versions de XChat (demandez lui sur elitenet,#linux) ne sont pas de 'vraies' versions et ne sont pas toujours stables. De temps en temps, d'autres personnes font part de leur code et de leurs idées, le plus souvent à Zed, sur le salon #linux d'Elitenet. Les patchs doivent etre mailés a Peter seulement a moins que ce soit pour une des versions de Adam. Si vous avez besoins de conseils ou d'aide pour XChat regardez d'abord cette documentation puis demandez à quelqu'un sur Elitenet,#linux - mais attention les gens sur #linux ne sont pas une assistance technique, ils peuvent tout aussi bien vous rire au nez ;).

About this document ...

Guide de l'utilisateur pour X-Chat (X-Chat 1.2)

This document was generated using the LaTeX2HTML translator Version 99.2beta6 (1.42)

Copyright © 1993, 1994, 1995, 1996, Nikos Drakos, Computer Based Learning Unit, University of Leeds.
Copyright © 1997, 1998, 1999, Ross Moore, Mathematics Department, Macquarie University, Sydney.

The command line arguments were:
latex2html -no_subdir -split 0 -show_section_numbers /home/darktigrou/traducs/xchat/tous-chapitres-corrige.tex

The translation was initiated by Tigrou's debian attitude on 2000-11-19


next_inactive up previous
Tigrou's debian attitude 2000-11-19