# Le manuel de &kate;

Seth
Rothberg

    sethmr@bellatlantic.net

Gonéri
Le Bouder

    goneri@gnuart.org

Mise à jour de la traduction française
Yves
Dessertine

    yves.d@hrnet.fr

Mise à jour de la traduction française
2000
2001
Seth M. Rothberg
&FDLNotice;
2001-05-30
1.00.00

&kate; est un éditeur pour les développeurs. Il fait partie de KDE2.2 et supérieurs.

Ce manuel documente &kate; version 1.0

KDE
kdebase
Kate
texte
éditeur
programmeur
programmation
projets
MDI
Multi
Document
Interface
terminal
console

## Introduction

Bienvenue dans &kate;, un éditeur faisant partie de &kde; version 2.2 et supérieures et destiné aux programmeurs. Parmi les nombreuses options de &kate; on trouve : la coloration syntaxique paramétrable pour des langages allant du C et C++ au HTML, jusqu'au script bash, la capacité de créer et maintenir des projets, une interface multidocuments (MDI), un émulateur de terminal intégré.

Mais &kate; est plus qu'un simple éditeur pour programmeur. Sa capacité à ouvrir plusieurs fichiers à la fois le rend idéal pour éditer les nombreux fichiers de configuration d'&UNIX;. Cette documentation a été rédigée dans &kate;.

## Les Fondamentaux

Si vous avez déjà utilisé un éditeur de texte, vous n'aurez aucune difficulté à utiliser &kate;. Dans les deux prochaines sections, Démarrer &kate; et Travailler avec &kate;, nous vous montrerons tout ce dont vous aurez besoin pour l'installer et l'utiliser rapidement.

### Démarrer &kate;

Vous pouvez lancer &kate; depuis le menu K ou depuis la ligne de commande.

#### Depuis le menu

Ouvrez le menu des programme sKDEen cliquant sur l'icône représentant un grand K de la barre à outil dans le bas à gauche de votre écran. Cela va afficher le menu programme. Déplacez votre curseur au dessus jusqu'au menuÉditeurs de texte. Une liste des éditeurs disponibles va apparaître. Choisissez &kate;.

&kate; ouvrira le dernier fichier édité à moins que vous configuriez &kate; pour qu'il ne le fasse pas. Regardez la section Configurer &kate; pour voir comment régler cette fonction.

#### Depuis la ligne de commande

Vous pouvez lancer &kate; en saisissant son nom dans 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.

    %katemonfichier.txt

Si vous avez une connexion active et les permissions requises, vous pouvez profiter de la transparence réseau de &kde; pour ouvrir des fichiers sur internet.

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

##### Les options de la ligne de commande

La ligne de commande de &kate; accepte les options suivantes :

``kate` `--help``

  Affiche la liste des options les plus simples utilisables par 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` `--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` `--version``

  Affiche les informations concernant les versions de &Qt;, &kde; et &kate;. Aussi disponible par ``kate` `-v``

``kate` `--licence``

  Affiche les informations concernant la licence.

#### Glisser-déposer

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

### Travailler avec &kate;

Démarrage Rapide vous apprendra à paramétrer quatre options simples pour paramétrer &kate;. Pour ceux qui ne peuvent pas ou ne veulent pas utiliser une souris, des Raccourcis clavier sont présents par défaut.

#### Démarrage rapide

Cette section va décrire quelques unes des options du menu Configuration, de cette façon vous pourrez rapidement configurer &kate; afin de le faire fonctionner comme vous le désirez.

Lorsque vous lancez &kate; pour la première fois vous verrez deux fenêtres avec un fond blanc. Au dessus des deux fenêtres se trouve une barre d'outils avec les icônes habituelles. Au dessus se trouve la barre de menus.

La fenêtre du coté gauche est une barre ancrable dans la fenêtre principale. Elle combine le sélectionneur de fichier et de fenêtre. Basculez de l'un a l'autre en cliquant sur l'onglet en haut de la fenêtre.

Si vous avez démarré &kate; avec un fichier, la fenêtre de droite doit l'afficher et la fenêtre de gauche doit donner son nom dans la Liste des documents. Utilisez le sélecteur de documents pour en ouvrir d'autres.

Vous pouvez activer ou désactiver la fenêtre de gauche dans le menu Configuration. Ce menu vous offre votre premier aperçu de la puissance de kate et de sa flexibilité. Dans cette section nous regarderons quatre éléments :

Affiche la barre d'outils

  Affiche ou cache la barre d'outils.

Affiche la liste des documents

  Affiche ou cache la liste des documents. Si la liste ou le sélecteur de documents n'est pas ouvert, &kate; lance la barre latérale dans une fenêtre séparée. Pour l'intégrer, capturez les deux lignes fines et parallèles au dessus des onglets, en cliquant dessus avec le &BGS; et gardez le bouton enfoncé.Glissez cette fenêtre dans la fenêtre d'édition de &kate; et relâchez le bouton de la souris lorsque vous avez positionné la barre tel que vous l'entendez.

  Si vous avez correctement saisi les deux lignes parallèles, votre pointeur de souris doit se changer en une croix formée de deux flèches croisées.

Afficher le sélecteur de documents

  Affiche ou cache le sélecteur de documents. Cette option du menu est la même que Afficher la liste des documents à une exception près.

Afficher le terminal

  Affiche ou cache le terminal dans le bas de la fenêtre de &kate;.cela revient à vous donnez une ligne de commande intégrée à l'application.

#### Raccourcis clavier

Beaucoup des raccourcis clavier sont configurable par le menu Configuration. Par défaut &kate; utilise les raccourcis clavier suivant.

Insérer | Permet de passer entre le mode Insérer ou Remplacer. En mode insertion, l'éditeur doit ajouter des caractères saisis dans le texte, il les insère et pousse les caractères se trouvant après le curseur. En mode remplacer, chaque nouvelle entrée écrase l'ancienne se trouvant à la droite du curseur.
Flèche vers la gauche | Déplace le curseur d'un caractère sur la gauche
Flèche vers la droite | Déplace le curseur d'un caractère sur la droite
Flèche vers le haut | Déplace le curseur d'une ligne vers le haut
Flèche vers le bas | Déplace le curseur d'une ligne vers le bas
Page vers le haut | Déplace le curseur d'une page vers le haut
Page vers le bas | Déplace le curseur d'une page vers le bas
Retour Arrière | Supprime le caractère à la 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 à la droite du curseur (ou un texte sélectionné)
Maj Flèche gauche | Sélectionne un caractère sur la gauche
Maj Flèche droite | Sélection un caractère sur la droite
F1 | Aide
Maj F1 | Qu'est-ce que c'est ?
Ctrl F | Chercher
F3 | Poursuivre la recherche
Ctrl B | Ajouter 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 du document se trouvant dans l'éditeur
Ctrl R | Remplacer
Ctrl S | Enregistre votre fichier.
Ctrl V | Coller.
Ctrl X | Supprime le texte sélectionné et le copie dans le presse-papiers.
Ctrl Z | Annuler
Ctrl Maj Z | Refaire

## Entrées du Menu

### Le menu Fichier

Ctrl N Fichier Nouveau

  Cette commande ouvre un nouveau document dans la fenêtre d'édition. Dans la liste des documents sur la gauche, le nouveau document est nommé Sans titre .

Ctrl O Fichier Ouvrir

  Cette commande n'ouvre pas de fichier. Elle lance la boîte de dialogue «Ouvrir un document» de &kde; qui vous permet de sélectionner le fichier que vous désirez ouvrir.

  La boîte de dialogue «Ouvrir un document» fonctionne comme une version simple de &konqueror;. Utilisez le bouton gauche de la souris pour cliquer sur le fichier que vous voulez sélectionner. Double-cliquez sur le nom d'un fichier pour l'ouvrir. Lorsque vous avez sélectionnez un fichier vous pouvez aussi presser le bouton OK pour l'ouvrir.

  Sélectionnez plusieurs fichiers en gardant la touche Ctrl ou Maj enfoncée et en cliquant avec le bouton gauche de la souris. Ctrl Gauche Cliquez pour choisir fichier par fichier. Maj Gauche Cliquez pour choisir une suite continue de fichiers.

  Dans le sélecteur de fichier, lorsque l'on clique sur un dossier, cela ouvre le dossier et affiche son contenu. Cliquer sur un nom de fichier affiche une vue miniature du fichier dans la fenêtre de prévisualisation à droite de la fenêtre du système de fichier.

  Utilisez les boutons et le champ au dessus de la boîte «Ouvrir un document» pour naviguer dans le système de fichier ou pour ajuster les propriétés de cette fenêtre.

  En bas de la fenêtre «Ouvrir un document» se trouve le champ Emplacement. Saisissez-y le nom du fichier que vous désirez éditer. Si vous cliquez sur la flèche sur la droite du menu déroulant, vous pouvez choisir parmi les fichiers récents. Ouvrez plusieurs fichiers en notant chaque nom de fichier.

  Au dessous de la boîte de sélection se trouve le champ filtre. Saisissez un masque de fichier pour afficher uniquement le type de fichier désiré dans la boîte de Sélection. Par exemple, saisissez le filtre `*.txt` et pressez Entrée limitera l'affichage des fichiers à ceux ayant une extension en `.txt`. Le champ filtre conserve les filtres les plus utilisés.

Fichier Ouvrir...Récemment ouvert(s)

  Cette commande vous permet d'ouvrir un fichier depuis un sous-menu contenant une liste de fichiers récemment ouverts.

Ctrl S Fichier Enregistrer

  Cette commande enregistre votre fichier. Utilisez-la régulièrement. Si le fichier s'appelle Sans titre ,la commande Enregistrer se transforme en Enregistrer Sous....

Fichier Enregistrer sous

  Enregistrez et renommez des fichiers avec cette commande. Elle ouvre la boîte de dialogue «Enregistrer le document». Cette boîte fonctionne de la même façon que la boîte d'ouverture de fichier. Vous pouvez l'utilisez afin de naviguer dans votre système, prévisualiser des fichiers déjà existants, ou bien filtrer l'affichage des fichiers grâce au masque de fichier.

  Saisissez le nom que vous désirez donner au futur fichier enregistré, ensuite, appuyez sur le bouton OK.

Ctrl L Fichier Tout enregistrer

  Cette commande enregistre l'ensemble des fichiers ouverts.

F5 Fichier Recharger

  Relit le fichier actif depuis le disque dur. Cette commande est utile à partir du moment ou d'autres programmes ou processus ont modifié le fichier alors que vous l'aviez ouvert dans &kate;

Fichier Ouvrir avec...

  Cette commande lance la boîte de dialogue Ouvrir qui vous permet de sélectionner une autre application pour ouvrir le fichier actif. Votre fichier sera toujours ouvert dans &kate;.

Ctrl P Fichier Imprimer...

  Imprime le fichier actif.

Ctrl W Fichier Fermer

  Fermez le fichier actif avec cette commande. Si vous avez effectué des modifications sans les avoir enregistrées, on vous demandera si vous désirez le faire avant que &kate; ne le ferme.

Fichier Tout fermer

  Cette commande ferme l'ensemble des fichiers que vous avez ouvert dans &kate;.

Fichier Nouvelle fenêtre

  Ouvre une nouvelle fenêtre identique au &kate; en cours.

Ctrl Q Fichier Quitter

  Cette commande ferme &kate;ainsi que l'ensemble des fichiers que vous éditiez. Si vous avez réalisé des modifications sans les enregistrer, il vous sera demandé, pour chacun de ces fichiers modifiés, si vous désirez les enregistrer.

## Configurer Kate

Ce chapitre vous montrera toutes les options de la configuration de &kate;.

## Remerciements et licence

&kate; Copyright 2000, 2001, Christoph Cullmann.

Documentation copyright 2000,2001 Seth Rothberg, sethmr@bellatlantic.net

Traduction française par Gonéri Le Bouder goneri@gnuart.org

Mise à jour de la traduction française par Yves Dessertine yves.d@hrnet.fr

&underFDL; &underGPL;

&documentation.index;