<chapter id="kate-part">

<title
>Travailler avec l'éditeur &kate;</title>

<sect1 id="kate-part-overview">

<title
>Vue d'ensemble</title>

<para
>L'éditeur de &kate; est la zone d'édition de la fenêtre de &kate;. Cet éditeur est aussi utilisé par &kwrite;, et peut être utilisé par &konqueror; pour afficher des fichiers textes locaux ou distants, depuis le réseau.</para>

<para
>L'éditeur est constitué des éléments suivants&nbsp;:</para>

<variablelist
> <varlistentry
> <term
>La zone d'édition</term
> <listitem
><para
>C'est ici que se trouve le texte de votre document.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Les barres de défilement</term
> <listitem
> <para
>Les barres de défilement indiquent la position de la partie visible du texte du document, et peut être utilisée pour vous déplacer dans le document. Le défilement à l'aide de ces barres ne fera pas bouger curseur d'insertion de texte.</para
> <para
>Les barres de défilement sont affichées ou cachées selon le besoin.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
>La bordure d'icônes</term
> <listitem
> <para
>La bordure d'icônes est une petite zone sur la gauche de l'éditeur affichant une petite icône à côté des lignes marquées.</para
> <para
>Vous pouvez placer ou enlever un <link linkend="kate-part-bookmarks"
>signet</link
> à une ligne visible en cliquant avec le &BGS; sur la bordure d'icônes à côté de cette ligne.</para
> <para
>L'affichage de la bordure d'icônes peut être activée ou désactivée en utilisant l'option de menu <menuchoice
><guimenu
>Affichage</guimenu
> <guimenuitem
>Afficher la bordure d'icônes</guimenuitem
></menuchoice
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
>La zone de numéros de lignes</term
> <listitem
> <para
>La zone de numéros de lignes affiche les numéros des lignes de toutes les lignes visibles du document.</para
> <para
>L'affichage de la zone de numéros de lignes peut être activé ou désactivé en utilisant l'élément de menu <menuchoice
><guimenu
>Affichage</guimenu
> <guimenuitem
>Afficher les numéros de lignes</guimenuitem
></menuchoice
>.</para
> </listitem
> </varlistentry
> </variablelist>

<itemizedlist
> <title
>Dans ce chapitre&nbsp;:</title
> <listitem
><para
><link linkend="kate-part-navigation"
>Naviguer dans le texte</link
> </para
></listitem
> <listitem
><para
><link linkend="kate-part-selection"
>Travailler avec la sélection</link
></para
></listitem
> <listitem
><para
><link linkend="kate-part-copy-and-paste"
>Copier et coller du texte</link
></para
></listitem
> <listitem
><para
><link linkend="kate-part-find-replace"
>Chercher et remplacer du texte</link
></para
></listitem
> <listitem
><para
><link linkend="kate-part-bookmarks"
>Utiliser les signets</link
></para
></listitem
> <listitem
><para
><link linkend="kate-part-auto-wrap"
>Passage à la ligne automatique</link
></para
></listitem
> </itemizedlist>

</sect1>

<sect1 id="kate-part-navigation">
<title
>Naviguer dans le texte</title>

<para
>Cette section n'est pas encore documentée.</para>

</sect1>

<sect1 id="kate-part-selection">
<title
>Travailler avec la sélection</title>

<para
>Il y a deux façons de sélectionner du texte dans &kate;&nbsp;: en utilisant la souris, ou en utilisant le clavier.</para>

<para
>Pour sélectionner en utilisant la souris, tenez le &BGS; appuyé pendant que vous déplacez le curseur de la souris du point où la sélection doit commencer jusqu'au point où elle doit se terminer. Le texte se sélectionne pendant que vous déplacez le curseur de la souris.</para>

<para
>Double-cliquez sur un mot pour le sélectionner.</para>

<para
>Triple-cliquez sur une ligne pour la sélectionner dans sa totalité.</para>

<para
>Si la touche &Maj; est appuyée pendant que vous cliquez, le texte sera sélectionné&nbsp;:</para>

<itemizedlist
> <listitem
><para
>Si rien n'est déjà sélectionné, depuis la position du curseur de texte jusqu'à la position du curseur de la souris.</para
></listitem
> <listitem
><para
>S'il y a déjà une sélection, depuis cette sélection, en l'incluant, jusqu'à la position du curseur de la souris</para
></listitem
> </itemizedlist>

<note
> <para
>Lorsque vous sélectionnez du texte à la souris, le texte sélectionnée est copié dans le presse-papiers, et peut être collé en cliquant avec le &BCS; dans l'éditeur, ou dans n'importe quelle application dans laquelle vous pouvez coller du texte. </para
> </note>

<para
>Pour sélectionner en utilisant le clavier, tenez la touche &Maj; enfoncée pendant que vous utilisez les touches de navigation (les touches fléchées, <keycap
>Page précédente</keycap
>, <keycap
>Page suivante</keycap
>, <keycap
>Début</keycap
> et <keycap
>Fin</keycap
>, éventuellement combinées avec la touche &Ctrl; pour étendre le déplacement du curseur de texte).</para>

<para
>Consultez aussi la section <link linkend="kate-part-navigation"
>Naviguer dans le texte</link
> de ce chapitre.</para>

<para
>Pour <action
>copier</action
> la sélection actuelle, utilisez l'entrée de menu <menuchoice
><guimenu
>Édition</guimenu
> <guimenuitem
>Copier</guimenuitem
></menuchoice
> ou le raccourci clavier (<keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
> par défaut).</para>

<para
>Pour <action
>désélectionner</action
> la sélection actuelle, utilisez l'éléément de menu <menuchoice
><guimenu
>Édition</guimenu
> <guimenuitem
>Désélectionner</guimenuitem
></menuchoice
>, ou le raccourci clavier (<keycombo action="simul"
>&Ctrl;&Maj;<keycap
>A</keycap
></keycombo
> par défaut), ou encore en cliquant avec le &BGS; dans l'éditeur.</para>

<sect2 id="kate-part-selection-block">
<title
>Utiliser la sélection en bloc</title>

<para
>Lorsque la sélection en bloc est activée, vous pouvez faire des <quote
>sélections verticales</quote
> dans le texte, &cad; sélectionner les colonnes limitées de plusieurs lignes. Ceci est pratique pour travailler avec des lignes séparées par des tabulateurs, par exemple.</para>

<para
>La sélection en bloc peut être activée ou désactivée en utilisant l'élément de menu <menuchoice
><guimenu
>Édition</guimenu
> <guimenuitem
>Activer&nbsp;/&nbsp;désactiver la sélection en bloc</guimenuitem
></menuchoice
>. Le raccourci clavier par défaut est <keycap
>F4</keycap
>.</para>

</sect2>

<sect2 id="kate-part-seleciton-overwrite">

<title
>Utiliser l'écrasement des sélections</title>

<para
>Si l'écrasement des sélections est activé, le fait de saisir ou de coller du texte dans la sélection remplacera le texte sélectionné par le nouveau. S'il n'est pas activé, le nouveau texte sera ajouté à la position du curseur de texte.</para>

<para
>L'écrasement des sélections est activé par défaut.</para>

<para
>Pour changer le paramétrage de cette option, utilisez la page <link linkend="config-dialog-editor-select"
>Sélection</link
> de la <link linkend="config-dialog"
>Boîte de dialogue de configuration</link
>.</para>

</sect2>

<sect2 id="kate-part-selection-persistent">

<title
>Utiliser la sélection persistante</title>

<para
>Lorsque la sélection persistante est activée, le fait de saisir des caractères ou de déplacer le curseur ne désélectionnera pas la sélection. Ceci signifie que vous pouvez sortir le curseur de la sélection et saisir du texte.</para>

<para
>La sélection persistante est désactivée par défaut.</para>

<para
>La sélection persistante peut être activée dans la page <link linkend="config-dialog-editor-select"
>Sélection</link
> de la <link linkend="config-dialog"
>Boîte de dialogue de configuration</link
>.</para>

<warning>
<para
>Si la sélection persistante et l'écrasement des sélections sont tous les deux activés, le fait de saisir ou de coller du texte lorsque le curseur est dans une sélection remplacera et désélectionnera le texte.</para>
</warning>

</sect2>

</sect1>

<sect1 id="kate-part-copy-and-paste">

<title
>Copier et coller du texte</title>

<para
>Pour copier du texte, sélectionnez-le et utilisez l'élément de menu <menuchoice
><guimenu
>Édition</guimenu
> <guimenuitem
>Copier</guimenuitem
></menuchoice
>. De plus, le fait de sélectionner du texte à la souris copiera le texte dans le presse-papiers.</para>

<para
>Pour coller le texte actuellement dans le presse-papiers, utilisez l'élément de menu <menuchoice
><guimenu
>Édition</guimenu
> <guimenuitem
>Coller</guimenuitem
></menuchoice
>.</para>

<para
>De plus, le texte sélectionné à la souris peut être collé en cliquant avec le bouton du <mousebutton
>milieu</mousebutton
> de la souris à l'emplacement souhaité.</para>

<tip
> <para
>Si vous utilisez l'environnement de bureau &kde;, vous pouvez reprendre un texte copié plus tôt depuis n'importe quelle application en utilisant l'icône de &klipper; dans la boîte à miniatures du tableau de bord.</para
> </tip>

</sect1>

<sect1 id="kate-part-find-replace">
<title
>Chercher et remplacer du texte</title>

<sect2 id="find-replace-dialog">
<title
>Les boîtes de dialogues <guilabel
>Chercher texte</guilabel
> et <guilabel
>Remplacer texte</guilabel
></title>


<para
>Les boîtes de dialogues Rechercher et Remplacer texte de &kate; sont très semblables, excepté que la boîte de dialogue Remplacer texte permet de saisir une chaîne de caractères de remplacement, ainsi que quelques options supplémentaires.</para>

<para
>Les boîtes de dialogue comportent les options suivantes&nbsp;:</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Texte à rechercher</guilabel
></term
> <listitem
><para
>C'est ici que vous devez saisir la chaîne de caractères à rechercher. L'interprétation de la chaîne dépend de quelques options décrites ci-dessous.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Expression rationnelle</guilabel
></term
> <listitem
> <para
>Si cette case est cochée, la chaîne de caractères sera interprétée comme une expression rationnelle. Un bouton pour utiliser un outil graphique pour créer ou modifier l'expression sera activé.</para
> <para
>Reportez-vous aux <link linkend="regular-expressions"
>Expressions rationnelles</link
> pour plus de détails sur celles-ci.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Ne pas tenir compte de la casse</guilabel
></term
> <listitem
> <para
>Si cette option est activée, la recherche ne tiendra pas compte de la casse.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Mots entiers uniquement</guilabel
></term
> <listitem
> <para
>Si cette case est cochée, la recherche ne correspondra que s'il y a un séparateur de mots aux deux extrémités de la chaîne recherchée, c'est-à-dire autre chose qu'un caractère alphanumérique - soit un autre caractère visible, soit un saut de ligne.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Depuis le début</guilabel
></term
> <listitem
> <para
>Si cette case est cochée, la recherche démarrera depuis le début de la première ligne du document. Sinon, elle démarrera depuis la position du curseur.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Recherche en arrière</guilabel
></term
> <listitem
> <para
>Si cette case est cochée, la recherche trouvera la première correspondance avant le point de départ, soit la position du curseur, soit le début du document, si l'option <guilabel
>Depuis le début</guilabel
> est activée.</para
> </listitem
> </varlistentry
> </variablelist>

<para
>La boîte de dialogue <guilabel
>Remplacer texte</guilabel
> comporte des options supplémentaires&nbsp;:</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Remplacer par</guilabel
></term
> <listitem
><para
>Saisissez ici la chaîne de remplacement.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Texte sélectionné</guilabel
></term
> <listitem
> <para
>Cette option est désactivée si aucun texte n'est sélectionné, ou si l'option <guilabel
>Demander lors du remplacement</guilabel
> est activée. Si cette case est cochée, toutes les occurrences de la chaîne de recherche dans le texte sélectionné seront remplacés par la chaîne de remplacement.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Demander lors du remplacement</guilabel
></term
> <listitem
><para
>Si cette option est cochée, une petite boîte de dialogue vous demandera ce qu'il faut faite à chaque fois qu'une occurrence est trouvée. Elle offre les options suivantes&nbsp;: <variablelist
> <varlistentry
> <term
><guibutton
>Oui</guibutton
></term
> <listitem
><para
>Choisissez ceci pour remplacer l'occurrence actuelle (qui est sélectionnée dans l'éditeur).</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guibutton
>Non</guibutton
></term
> <listitem
><para
>Choisissez ceci pour sauter l'occurrence actuelle, et essayer d'en trouver une autre.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guibutton
>Tous</guibutton
></term
> <listitem
><para
>Choisissez ceci pour ne plus demander, et remplacer simplement toutes les occurrences.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guibutton
>Fermer</guibutton
></term
> <listitem
><para
>Choisissez ceci pour passer l'occurrence actuelle et arrêter la recherche.</para
></listitem
> </varlistentry
> </variablelist
> </para
></listitem
> </varlistentry
> </variablelist>

<note
> <para
>Il n'y a actuellement aucun moyen d'utiliser une correspondance minimale lors de la recherche d'une expression rationnelle. Ceci sera ajouté dans les versions futures de &kate;.</para
> </note>

</sect2>

<sect2 id="finding-text">
<title
>Trouver du texte</title>

<para
>Pour trouver du texte, ouvrez la boîte de dialogue <guilabel
>Chercher texte</guilabel
> avec <keycombo action="simul"
>&Ctrl;<keycap
>F</keycap
></keycombo
> ou via l'entrée de menu <menuchoice
><guimenu
>Édition</guimenu
> <guimenuitem
>Chercher</guimenuitem
></menuchoice
>, saisissez une chaîne de caractères à rechercher, ajustez les <link linkend="find-replace-dialog"
>options</link
> comme vous le désirez et cliquez sur le bouton <guibutton
>OK</guibutton
>. Si aucune occurrence est trouvée entre le point de départ de la recherche (soit la position du curseur de texte, soit le début du document), le programme vous demandera la permission de continue la recherche depuis le début du document (ou depuis la fin du document, si vous effectuez une recherche en arrière).</para>

<para
>Si une occurrence est trouvée, elle est sélectionnée, et la boîte de dialogue <guilabel
>Chercher texte</guilabel
> est cachée, mais ne partez pas, il est très facile de trouver les autres occurrences&nbsp;:</para>

<para
>Pour trouver la prochaine occurrence dans la direction de la recherche, utilisez la commande <menuchoice
><guimenu
>Édition</guimenu
> <guimenuitem
>Poursuivre la recherche</guimenuitem
></menuchoice
> ou pressez <keycap
>F3</keycap
>.</para>

<para
>Pour trouver la prochaine occurrence dans la direction opposée, utilisez la commande <menuchoice
><guimenu
>Édition</guimenu
> <guimenuitem
>Trouver l'occurrence précédente</guimenuitem
></menuchoice
> ou pressez <keycombo action="simul"
>&Maj;<keycap
>F3</keycap
></keycombo
>.</para>

<para
>Si aucune occurrence est trouvée avant d'atteindre la limite du document, il vous sera demandé la permission d'outrepasser ceci.</para>

</sect2>

<sect2>
<title
>Remplacer du texte</title>

<para
>Pour remplacer du texte, ouvrez la boîte de dialogue <guilabel
>Remplacer texte</guilabel
> avec la commande <menuchoice
><guimenu
>Édition</guimenu
> <guimenuitem
>Remplacer</guimenuitem
></menuchoice
>, ou avec le raccourci clavier <keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
>, saisissez une chaîne de caractères à rechercher et éventuellement une chaîne de remplacement (si aucune chaîne de remplacement n'est saisie, chaque occurrence sera remplacée par &quot;&quot;), ajustez les <link linkend="find-replace-dialog"
>options</link
> comme vous le désirez et cliquez sur le bouton <guibutton
>OK</guibutton
>.</para>

<tip
> <para
>Si vous utilisez une expression rationnelle pour trouver le texte à remplacer, vous pouvez utiliser des références pour réutiliser le texte correspondant aux motifs entre parenthèses de l'expression.</para
> <para
>Reportez-à la section <xref linkend="regular-expressions"/> pour plus de détails sur celles-ci.</para
> </tip>

</sect2>

</sect1>

<sect1 id="kate-part-bookmarks">
<title
>Utiliser les signets</title>

<para
>La fonction signet vous permet de marquer certaines lignes, pour pouvoir les retrouver facilement plus tard.</para>

<para
>Vous pouvez ajouter ou supprimer un signet d'une ligne de deux façons&nbsp;:</para>

<itemizedlist
> <listitem
> <para
>Déplacez le curseur d'insertion à cette ligne, et activez la commande <menuchoice
><guimenu
>Signets</guimenu
><guimenuitem
>Activer&nbsp;/&nbsp;Désactiver Signet</guimenuitem
></menuchoice
> (<keycombo action="simul"
>&Ctrl;<keycap
>B</keycap
></keycombo
>).</para
> </listitem
> <listitem
> <para
>Cliquez dans la bordure d'icônes à côté de cette ligne.</para
> </listitem
> </itemizedlist>


<para
>Les signets sont disponibles depuis le menu <guimenu
>Signets</guimenu
>. Chaque signet est accessible comme élément de menu, nommées avec le numéro de la ligne et les quelques premiers caractères du texte de cette ligne. Pour déplacer le curseur d'insertion au début d'une ligne comportant un signet, ouvrez le menu et sélectionnez le signet.</para>

<tip
> <para
>Si l'option <link linkend="config-dialog-general-reopen-files"
>Réouvrir les fichiers</link
> de la <link linkend="config-dialog"
>boîte de dialogue de configuration</link
> est activée (ou si &kate; a été démarré par le gestionnaire de sessions), vos signets seront rétablis lorsque le document sera réouvert.</para
> </tip>

</sect1>

<sect1 id="kate-part-auto-wrap">

<title
>Passage à la ligne automatique</title>

<para
>Cette fonctionnalité vous permet de formater le texte de manière très simple&nbsp;: le texte ira à la ligne de manière à ce qu'aucune ligne ne soit plus longue qu'un certain nombre de caractères par ligne, à moins qu'il ne s'agisse d'une très longue ligne de caractères accolés sans blancs intermédiaires.</para>

<para
>Pour activer ou désactiver cette option, cochez ou décochez la case <guibutton
>Retour à la ligne automatique</guibutton
> de la page <link linkend="config-dialog-editor-edit"
>Édition</link
> de la <link linkend="config-dialog"
>boîte de dialogue de configuration</link
>.</para>

<para
>Pour régler la longueur maximale de ligne (le nombre maximum de caractères par linge), utilisez l'option <link linkend="config-dialog-editor-edit-wrap-words-at"
><guibutton
>Couper à la colonne</guibutton
></link
> de la page <link linkend="config-dialog-editor-edit"
>Édition</link
> de la <link linkend="config-dialog"
>boîte de dialogue de configuration</link
>.</para>

<para
>Si cette option est activée, elle a les effets suivants&nbsp;: <itemizedlist
> <listitem
><para
>Lors de la saisie, l'éditeur insèrera automatiquement un saut à la ligne forcé après le dernier blanc précédant la position maximale dans la ligne.</para
></listitem
> <listitem
><para
>Lorsqu'un document est chargé, l'éditeur génèrera des retours à la ligne de la même manière, de façon à ce qu'aucune ligne ne dépasse la longueur maximale, si du moins elles contiennent des blancs qui le permettent.</para
></listitem
> </itemizedlist
> </para>

<note
><para
>Il n'y a actuellement aucun moyen de régler le retour à la ligne en fonction du type de document. Ceci sera ajouté dans les versions futures de &kate;.</para
></note>

</sect1>

</chapter>

