# Les fondamentaux

Si vous avez déjà utilisé un éditeur de texte, vous n'aurez aucune difficulté avec &kate;. Les deux prochaines sections, Démarrer &kate; et Travailler avec &kate;, décrivent tout ce qui est nécessaire pour l'installer et le lancer rapidement.

## Démarrer &kate;

On peut démarrer &kate; depuis le &menuk; ou depuis la ligne de commande.

### Depuis le menu

Ouvrez le menu des programmes &kde; en cliquant sur l'icône représentant un grand K dans la barre d'outils située en bas à gauche de votre écran. Un menu s'affiche. Déplacez votre curseur vers le haut, jusqu'à l'élément de menu Applications Utilitaires &kate; (Éditeur de texte avancé).

&kate; va charger les derniers fichiers modifiés, sauf si vous le configurez pour qu'il ne le fasse pas. Consultez la section Configurer &kate; pour savoir comment (dés)activer cette fonctionnalité.

### Depuis la ligne de commande

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.

    %kate monfichier.txt

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.

    %kate ftp://ftp.kde.org/pub/kde/README

#### Options de la ligne de commande

&kate; accepte les options de ligne commande suivantes :

``kate` `--help``

- Affiche la liste des options les plus simples disponibles sur la ligne de commande.

``kate` `--help-qt``

- Affiche la liste des options disponibles pour modifier la façon dont &kate; interagit avec &Qt;.

``kate` `--help-kde``

- Affiche la liste des options disponibles pour modifier la façon dont &kate; interagit avec &kde;.

``kate` `-s` `--start` `name``

- Démarre kate avec le paramètre `name` de la session. Si elle n'existe pas déjà; la session est créée. Au cas où il y ait 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 `--use`, une instance exécutant cette session sera employée également.

``kate` `-u` `--use` `URL``

- 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 dans votre interpréteur de commandes s'il prend en charge cette fonction.

``kate` `-p` `--pid` `PID``

- Réutilise uniquement une instance comportant le PID (ID de processus) spécifié. Employée avec l'option `--use`.

``kate` `-e` `--encoding` `encoding` `URL``

- Utilise l'encodage spécifié pour le document.

``kate` `-l` `--line` `line` `URL``

- Se déplace jusqu'à la ligne spécifiée après l'ouverture du document.

``kate` `-c` `--column` `column` `URL``

- Se déplace jusqu'à la colonne spécifiée après l'ouverture du document.

``kate` `-i` `--stdin``

- Lit le contenu du document depuis l'entrée standard (STDIN). Cette option est similaire à l'option courante `-` utilisée dans de nombreux programmes en ligne de commande et permet de rediriger la sortie des commandes dans &kate;.

``kate` `--tempfile``

- Cette option standard de &kde; est prise en charge depuis la version 2.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, à moins qu'ils ne soient modifiés depuis qu'ils ont été ouverts.

``kate` `--help-all``

- Affiche la liste de toutes les options de la ligne de commande.

``kate` `--author``

- Affiche la liste des auteurs de &kate; dans la fenêtre du terminal.

``kate` `-v` `--version``

- Liste les informations de version pour &Qt;, &kde; et &kate;.

``kate` `--license``

- Affiche les informations de licence.

### Glisser-déposer

&kate; utilise le protocole glisser-déposer de &kde;. Les fichiers peuvent être glissés et déposés dans &kate; depuis le bureau, &dolphin; ou un site FTP ouvert dans une fenêtre de &dolphin;.

## Travailler avec &kate;

La section Démarrage rapide décrit comment (dés)activer quatre options simples permettant de configurer immédiatement quelques-unes des fonctionnalités les plus puissantes de &kate;. Pour ceux qui ne peuvent pas ou ne veulent pas se servir d'une souris, il existe des raccourcis clavier par défaut.

### Démarrage rapide

Cette section présente certains des éléments du menu Configuration pour que vous puissiez rapidement configurer &kate; et le faire fonctionner selon vos souhaits.

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.

La fenêtre du côté gauche est une barre latérale. Elle combine les fenêtres Documents et Explorateur de systèmes de fichiers. Passez de l'une à l'autre en cliquant sur les onglets situés à gauche de la fenêtre.

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èmes de fichiers pour ouvrir d'autres fichiers.

Vous pouvez basculer entre la fenêtre Documents et Explorateur de systèmes de fichiers dans le menu Fenêtre Vues des outils. Ce menu offre un premier aperçu de la puissance et de la souplesse de &kate;. Dans cette section, seront abordés trois éléments de menu :

Afficher les documents

- (Dés)Active l'affichage des documents. Si la fenêtre Documents/Explorateur de systèmes 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 incruster cette fenêtre, capturez les deux fines lignes parallèles situées 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èmes de fichiers selon vos préférences.

  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.

Afficher l'explorateur de systèmes de fichiers

- Affiche ou cache l'explorateur de système de fichiers. Cet élément de menu est identique à Afficher Documents à une différence près. Basculer sur cet élément lance la fenêtre avec l'explorateur de systèmes de fichiers au-dessus.

Afficher le terminal

- 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.

### Raccourcis clavier

Beaucoup des commandes de saisie de &kate; (raccourcis clavier) peuvent être configurées par le biais du menu Configuration. Par défaut, &kate; prend en charge les raccourcis clavier suivants.

Insertion | Bascule entre les modes insertion et écrasement. En mode insertion, l'éditeur ajoute au texte tout caractère saisi et pousse à droite du curseur toutes les saisies précédentes. Le mode écrasement veille à ce que la saisie de chaque caractère élimine le caractère actuel.
Flèche gauche | Déplace le curseur d'un caractère vers la gauche
Flèche droite | Déplace le curseur d'un caractère vers la droite
Flèche haut | Déplace le curseur d'une ligne vers le haut
Flèche bas | Déplace le curseur d'une ligne vers le bas
Page précédente | Déplace le curseur d'une page vers le haut
Page suivante | Déplace le curseur d'une page vers le bas
Correction | Supprime le caractère à gauche du curseur
Début | Déplace le curseur au début de la ligne
Fin | Déplace le curseur à la fin de la ligne
Supprimer | Supprime le caractère à droite du curseur (ou tout texte sélectionné)
&Maj;Entrée | Insère un saut de ligne incluant les caractères de début de la ligne actuelle, autres que des lettres ou des nombres. Cette fonction est utile &pex; pour écrire des commentaires dans le code : à la fin de la ligne // de texte, cliquez sur ce raccourci clavier et la prochaine ligne commence déjà par // . Ainsi, vous n'avez pas à saisir de caractères de commentaires au début de chaque nouvelle ligne comportant des commentaires.
&Maj;Flèche gauche | Sélectionne un caractère de texte vers la gauche
&Maj;Flèche droite | Sélectionne un caractère de texte vers la droite
F1 | Aide
&Maj;F1 | Qu'est-ce que c'est ?
&Ctrl;F | Chercher
F3 | Poursuivre la recherche
&Ctrl;B | Définit un signet
&Ctrl;C | Copie le texte sélectionné dans le presse-papiers.
&Ctrl;N | Nouveau document
&Ctrl;P | Imprimer
&Ctrl;Q | Quitter - Ferme la copie active de l'éditeur
&Ctrl;R | Remplacer
&Ctrl;S | Enregistre votre fichier.
&Ctrl;V | Colle.
&Ctrl;X | Supprime le texte sélectionné et le copier dans le presse-papiers.
&Ctrl;Z | Annuler
&Ctrl;&Maj;Z | Refaire

## Utiliser les sessions

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.

Les sessions sont prises en charge dans trois zones :

- Options de la ligne de commande : permet de sélectionner et de démarrer des sessions lorsqu'on lance Kate à partir de la ligne de commande.

- Menu Sessions : permet de changer de session, enregistrer, démarrer et gérer des sessions

- Options de configuration : permet de décider comment les sessions devront en général se comporter.

Lorsqu'on démarre une nouvelle session, la configuration de l'interface graphique Session par défaut 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.

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 « `Nom de la session` : `Nom ou &URL; du document` - &kate; »

Lorsqu'on ouvre des fichiers sur la ligne de commande avec `--start `nom`` ou si l'on choisit une session à l'aide du sélecteur de sessions, la session demandé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 de façon à ce qu'il démarre une nouvelle session par défaut dans la page « Sessions » de la boîte de dialogue de configuration ou utilisez `--start` avec une chaîne vide : `''`.

Depuis la version 2.5.1 de &kate;, le PID de l'instance actuelle est exporté vers la variable d'environnement `KATE_PID`. 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.

### Rétablir l'ancien comportement de &kate;

Quand vous vous habituerez à utiliser des sessions, vous constaterez 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 l'obtenir en suivant cette stratégie simple :

- Faire toujours démarrer Kate avec le paramètre `--use` en l'ajoutant à la commande dans les préférences de l'application et, de plus, en employant un alias d'interpréteur.

- Configurer &kate; de façon à charger la dernière session utilisée au démarrage.

- Configurer &kate; de façon à enregistrer la liste lors de la fermeture d'une session.

- Charger la session par défaut une seule fois

## Comment obtenir de l'aide

### Avec &kate;

Ce manuel uilisateur

- Il offre une documentation détaillée de toutes les commandes des menus, des options de configuration, des outils, des boîtes de dialogue, des 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.

  Appuyez sur F1 ou cliquez sur l'élément de menu Aide, Manuel utilisateur de &kate; pour afficher ce manuel.

Aide « Qu'est-ce que c'est ? »

- L'aide Qu'est-ce que c'est ? vous apporte une aide immédiate pour chacun des éléments des fenêtres graphiques, tels que des boutons ou d'autres zones de fenêtres.

  Nous nous efforçons de fournir une aide « Qu'est-ce que c'est ? » pour tous les éléments pour lesquels elle est nécessaire. Elle est disponible partout dans la boîte de dialogue de configuration et dans beaucoup d'autres boîtes de dialogue également.

  Pour utiliser l'aide « Qu'est-ce que c'est ? », appuyez sur &Maj;F1 ou cliquez sur l'élément de menu Aide Qu'est-ce que c'est ? pour activer ce mode. Le curseur se transformera en une flèche suivie d'un point d'interrogation. Vous pouvez alors 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.

Boutons d'aide dans les boîtes de dialogue

- Certaines boîtes de dialogue comportent un bouton Aide. Un clic sur ce dernier démarre le ¢reAide; et ouvre la documentation correspondante.

### Avec vos fichiers texte

&kate; ne fournit pas (encore !) de moyen pour lire de la documentation relative à un document. Selon le fichier que vous modifiez, vous pouvez vous aider de l'émulateur de terminal intégré pour visualiser les pages de manuel relatives à &UNIX; ou de la documentation, voire utiliser &konqueror;.