<para>Si vous avez déjà utilisé un éditeur de texte, vous n'aurez aucune difficulté à utiliser &kate;. Dans les deux prochaines sections, <link linkend="starting-kate">Démarrer &kate; </link> et <link linkend="working-with-kate">Travailler avec &kate;</link>, nous vous montrerons tout ce dont vous aurez besoin pour l'installer et l'utiliser rapidement. </para>
<para>Ouvrez le menu des programmes &kde; en cliquant sur l'icône représentant un grand <guiicon>K</guiicon> dans la barre d'outils en bas à gauche de votre écran, ce qui affichera le <guimenu>menu des programmes</guimenu>. Déplacez votre curseur vers le haut, jusqu'à l'élément de menu <menuchoice><guimenu>Utilitaires</guimenu> <guimenuitem>Éditeurs</guimenuitem></menuchoice>. Une liste des éditeurs disponibles va apparaître. Choisissez <guimenuitem>&kate;</guimenuitem>. </para>
<para>&kate; ouvrira le dernier fichier modifié, à moins que vous configuriez &kate; pour qu'il ne le fasse pas. Consultez la section <link linkend="configure">Configurer &kate;</link> pour apprendre comment (dés)activer cette fonctionnalité. </para>
<para>Vous pouvez lancer &kate; en saisissant son nom sur la ligne de commande. Si vous lui donnez un nom de fichier, comme dans l'exemple ci-dessous, il ouvrira ou créera ce fichier. </para>
<para>Si vous avez une connexion active et les droits d'accès requis, vous pouvez profiter de la transparence réseau de &kde; pour ouvrir des fichiers sur l'Internet. </para>
<para>Démarre kate avec le <parameter>nom</parameter> de la session. La session est créée si elle n'existe pas déjà. S'il existe une instance de &kate; exécutant la session spécifiée, les fichiers indiqués sont chargés dans cette instance. Lorsqu'elle est utilisée avec l'option <option>--use</option>, une instance exécutant cette session sera employée également. </para>
<para>Veille à ce que &kate; utilise une instance existante s'il y en a une. Si vous souhaitez que tous les documents s'ouvrent dans une seule instance de kate, vous pouvez non seulement ajouter cette option à la commande par défaut dans la configuration de votre application kde, mais également créer un alias de shell dans votre intepréteur de commandes s'il prend en charge cette fonction. </para>
<listitem><para>Lit le contenu du document depuis l'entrée standard (STDIN). Cette option est similaire à l'option commune <option>-</option> utiliisée dans de nombreux programmes en ligne de commande, et permet de rediriger la sortie des commandes dans &kate;.</para></listitem>
<listitem><para>Cette option standard de &kde; est prise en charge depuis la version2.5.1 de &kate;. Lorsque utilisée, les fichiers spécifiés sont traités comme des fichiers temporaires et supprimés (si ce sont des fichiers locaux et que vous avez les droits d'accès suffisants) lorsque vous les fermez, à amoins qu'ils ne soient modifiés depuis qu'ils sont été ouverts.</para></listitem>
<para>&kate; utilise le protocole glisser-déposer de &kde;. Les fichiers peuvent être glissés et déposés dans &kate; depuis le bureau, &konqueror; ou un site ftp ouvert dans une fenêtre de &konqueror;. </para>
<para>La section <link linkend="quick-start">Démarragerapide</link> vous montrera comment paramétrer quatre options simples pour configurer immédiatement quelques-unes des fonctionnalités plus puissantes de &kate;. Pour ceux qui ne peuvent pas ou ne veulent pas employer une souris, il existe des <link linkend="keystroke-commands">raccourcis clavier</link> par défaut. </para>
<para>Cette section va décrire quelques-uns des éléments du menu <guimenu>Configuration</guimenu> pour que vous puissiez rapidement configurer &kate; et le faire fonctionner selon vos souhaits. </para>
<para>Lorsque vous lancez &kate; pour la première fois, vous voyez deux fenêtres comportant un fond blanc. Au-dessus de ces deux fenêtres se trouve une barre d'outils avec les icônes étiquetées habituelles. Et au dessus de celle-ci, une barre de menus. </para>
<para>La fenêtre du côté gauche est une barre latérale. Elle combine les fenêtres Documents et Explorateur de système de fichiers. Passez de l'une à l'autre en cliquant sur les onglets à gauche de la fenêtre. </para>
<para>Si vous avez démarré &kate; avec un fichier, la fenêtre de droite affichera le fichier en cours d'édition, alors que la fenêtre Documents de la barre latérale affichera le nom de ce fichier. Utilisez la fenêtre Explorateur de système de fichiers pour ouvrir d'autres fichiers. </para>
<para>Vous pouvez basculer entre la fenêtre Documents et Explorateur de système de fichiers dans le menu <menuchoice><guimenu>Fenêtre</guimenu><guimenuitem>Vues des outils</guimenuitem></menuchoice>. Ce menu vous offre un premier aperçu de la puissance et de la souplesse de &kate;. Dans cette section, nous étudierons trois éléments de menu: </para>
<para>Affiche ou cache la liste des documents. Si la fenêtre Documents/Explorateur du système de fichiers n'est pas ouverte, &kate; lance la barre latérale sous la forme d'une fenêtre séparée, détachée. Pour intégrer cette fenêtre, capturez les deux lignes fines et parallèles au-dessus des onglets en cliquant sur ces derniers avec le &BGS; et en le maintenant enfoncé. Faites glisser la fenêtre dans la fenêtre d'édition de &kate; et relâchez le &BGS; lorsque vous avez positionné la fenêtre Documents/Explorateur de système de fichiers selon vos préférences. </para>
<para>Si vous avez réussi à capturer les deux lignes parallèles, votre pointeur de souris doit se changer en deux flèches croisées lorsque vous faites glisser les lignes parallèles . </para>
<para>Affiche ou cache l'explorateur de système de fichiers. Cet élément de menu est identique à <guimenuitem>Afficher: Documents</guimenuitem> à une différence près. Basculer sur cet élément lance la fenêtre avec l'explorateur de système de fichiers au-dessus. </para>
<para>Affiche ou cache un émulateur de terminal au bas de la fenêtre de &kate;. En d'autres termes, elle vous offre une ligne de commande au sein de l'application. </para>
<para>Beaucoup des commandes de saisie de &kate; (raccourcis clavier) peuvent être configurées par le biais du menu <link linkend="settings">Configuration</link>. Par défaut, &kate; prend en charge les raccourcis clavier suivants. </para>
<entry><para>Basculer entre le mode insertion et écrasement. En mode insertion, l'éditeur ajoute au texte tout caractère saisi et pousse à droite du curseur tout caractère saisi précédemment. Le mode écrasement veille à ce que la saisie de chaque caractère élimine le caractère actuel.</para></entry>
<para>La section Sessions décrit comment &kate; permet de conserver à portée de main plusieurs listes de fichiers de configuration d'interface graphique. Vous pouvez avoir autant de sessions nommées que vous le souhaitez, et employer des sessions sans nom ou anonymes pour les fichiers que vous projetez de n'utiliser qu'une seule fois. Actuellement, &kate; peut enregistrer la liste des fichiers ouverts, ainsi que la configuration générale des fenêtres dans la session. Il se peut que les versions futures de &kate; ajoutent d'autres fonctionnalités dans les sessions. Avec l'introduction des sessions, &kate; permet également d'ouvrir un nombre quelconque d'instances de l'application au lieu d'une seule comme il est d'usage dans le comportement par défaut.</para>
<para>Les sessions sont gérées dans trois zones: <itemizedlist>
<listitem><para><link linkend="command-line-options"><emphasis>Options de la ligne de commande</emphasis></link>, qui permet de sélectionner et de démarrer des sessions lorsqu'on lance kate à partir de la ligne de commande.</para>
<listitem><para>Le <link linkend="sessions-menu"><emphasis>menu Sessions</emphasis></link>, qui permet de changer de session, enregistrer, démarrer et gérer des sessions</para></listitem>
<listitem><para><link linkend="config-dialog-sessions"><emphasis>Options de configuration</emphasis></link>, qui permet de décider comment les sessions devront généralement se comporter.</para></listitem>
<para>Lorsqu'on démarre une nouvelle session, la configuration de l'interface graphique de <guilabel>Session par défaut</guilabel> est chargé. Pour enregistrer la configuration des fenêtres dans la session par défaut, il faut activer l'enregistrement de la configuration des fenêtres dans la page Gestion des sessions de la boîte de dialogue de configuration puis charger la session par défaut, configurer la fenêtre comme souhaité et enregistrer à nouveau la session.</para>
<para>Lorsqu'une session nommée est chargée, &kate; affiche le nom de la session au début du titre de la fenêtre, qui prend alors la forme « <replaceable>Nom de la session</replaceable>: <replaceable>Nom ou &URL; du document</replaceable> - &kate; ».</para>
<para>Lorsqu'on ouvre des fichiers sur la ligne de commande avec <option>--start <replaceable>nom</replaceable></option> ou si on choisit une session à l'aide du sélecteur de sessions, la session spécifiée est chargée avant les fichiers spécifiés sur la ligne de commande. Pour ouvrir des fichiers à partir de la ligne de commande dans une nouvelle session sans nom, configurez kate pour démarrer une nouvelle page de session par défaut dans la page Sessions de la boîte de dialogue ou utilisez <option>--start</option> avec une chaîne vide: <replaceable>''</replaceable>.</para>
<para>Depuis la version2.5.1 de &kate;, le <acronym>PID</acronym> de l'instance actuelle est exporté vers la variable d'environnement <envar>KATE_PID</envar>. Lorsqu'on ouvre des fichiers depuis le terminal intégré, Kate sélectionne automatiquement l'instance actuelle si rien d'autre n'est indiqué sur la ligne de commande.</para>
<title>Rétablir l'ancien comportement de &kate;</title>
<para>Lorsque vous vous habituez à utiliser des sessions, vous constatez sans doute qu'elles offrent un outil très simple et efficace pour travailler dans différentes zones. Cependant, si vous préférez l'ancien comportement de &kate; (une instance ouvre tous les fichiers), vous pouvez aisément y parvenir en suivant cette stratégie simple: <itemizedlist>
<listitem><para>Faire toujours démarrer Kate avec le paramètre <option>--use</option> en ajoutant cette option à la commande dans les préférences de l'application, et en outre employer un alias de shell.</para></listitem>
<listitem><para>Configurer &kate; de façon à charger la dernière session utilisée au démarrage.</para>
<para>Il offre une documentation détaillée de toutes les commandes de menu, les options de configuration, les outils, les boîtes de dialogue, les modules externes &etc; ainsi que des descriptions de la fenêtre de &kate;, de l'éditeur et des différents concepts utilisés dans cette application.</para>
<para>Saisissez <keycap>F1</keycap> ou utilisez l'élément de menu <menuchoice><guimenu>Aide</guimenu></menuchoice> <guisubmenu>Manuel de Kate</guisubmenu> pour afficher ce manuel.</para></listitem>
<para>L'aide Qu'est-ce que c'est? vous apporte une aide immédiate, avec des éléments séparés des fenêtres graphiques, tels que des boutons ou d'autres zones de fenêtres.</para>
<para>Nous nous efforçons de fournir une aide Qu'est-ce que c'est? pour tous les éléments pour lesquels c'est nécessaire. Elle est disponible partout dans la boîte de dialogue de configuration, ainsi que dans beaucoup d'autres boîtes de dialogue.</para>
<para>Pour utiliser l'aide Qu'est-ce que c'est?, saisissez <keycombo>&Maj;<keycap>F1</keycap></keycombo> ou utilisez l'entrée de menu <menuchoice><guimenu>Aide</guimenu><guimenuitem>Qu'est-ce que c'est?</guimenuitem></menuchoice> pour activer le mode Qu'est-ce que c'est?. Le curseur se transformera en une flèche avec un point d'interrogation, et vous pouvez maintenant cliquer sur n'importe quel élément de la fenêtre pour lire l'aide Qu'est-ce que c'est? pour cet élément, si elle est disponible.</para>
<para>Certaines boîtes de dialogue comportent un bouton <guibutton>Aide</guibutton>. Un clic sur ce dernier démarre le ¢reAide; et ouvre la documentation pertinente.</para>
<para>&kate; ne fournit pas (encore!) de moyen pour lire de la documentation relative au document. Selon le fichier que vous modifiez, vous pouvez vous aider de la <link linkend="kate-mdi-tools-konsole">&konsole; intégrée</link> pour afficher les pages de manuel &UNIX; ou la documentation, voire utiliser &konqueror;.</para>
