<chapter id="insertcommand">
<chapterinfo>

<title>Insert Command (insérer une commande)</title>

<authorgroup>
<author><firstname>Anders</firstname> <surname>Lund</surname> <affiliation> <address>&Anders.Lund.mail;</address>
</affiliation>
</author>
</authorgroup> <date>2006-05-17</date> <releaseinfo>3.5.2</releaseinfo> <abstract> <para>Le module <quote>insérer une commande</quote> vous permet d'insérer la sortie d'une commande shell dans un document ouvert dans &kate;. </para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>kate</keyword>
<keyword>insert</keyword>
</keywordset>
</chapterinfo>

<title>Introduction</title>

<para>Le module <quote>insérer une commande</quote> vous permet d'insérer la sortie d'une commande shell dans un document ouvert dans &kate;.</para>

<para>Tout d'abord activez le module externe <quote>Insérer une commande</quote> en utilisant la boîte de dialogue  <menuchoice><guimenu>Configuration</guimenu><guimenuitem>Configurer &kate;...</guimenuitem></menuchoice> et en cochant <guilabel>Insérer une commande pour &kate;</guilabel> dans la section <guilabel>Applications</guilabel> <guilabel>Modules externes</guilabel>, puis fermez la boîte de dialogue.</para>

<sect1 id="insertcommand-fund">
<title>Utilisation de l'interface</title>

<para>Pour utiliser ce module, sélectionnez sur <guimenu>Insérer une commande</guimenu> dans le menu <guimenu>Outils</guimenu>. Une petite boîte de dialogue s'affichera pour saisir la commande, choisir un dossier de travail et sélectionner s'il faut inclure ou non les erreurs (la sortie STDERR) dans le texte inséré. Vous pouvez aussi avoir la chaîne de la commande insérée avant la sortie. </para>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="insertcommand.png"/></imageobject>
<textobject>
<phrase>La boîte de dialogue Insérer une commande</phrase>
</textobject>
</mediaobject>

<para>Le module peut se souvenir d'un certain nombre de commandes, telles que sélectionné dans la page de configuration. Elles sont utilisées pour le complètement automatique, et peuvent être sélectionnées depuis une liste dans la saisie de la commande. </para>

<para>Par défaut, la commande sera exécutée dans le dossier de travail du processus kate qui est habituellement votre dossier personnel. Ceci peut être changé dans la page de configuration du module. </para>

<para>Notez que toute commande shell qui requiert une saisie de l'utilisateur (par exemple un mot de passe) ou utilise une interface ncurses ou similaire (par exemple top) ne donnera pas la sortie souhaitée. </para>

</sect1>

<sect1 id="insertcommand-config">
<title>Configuration</title>

<para>Pour configurer le module <quote>Insérer une commande</quote>, ouvrez la boîte de dialogue de configuration de &kate; depuis le menu <menuchoice><guimenu>Configuration</guimenu><guimenuitem>Configurer &kate;...</guimenuitem></menuchoice> et choisissez <menuchoice><guimenuitem>Modules externes</guimenuitem><guilabel>Insérer une commande</guilabel></menuchoice>. </para>

<mediaobject>
<imageobject><imagedata format="PNG"
fileref="configure_insertcommand.png"/></imageobject>
<textobject>
<phrase>L'onglet de configuration Insérer une commande</phrase>
</textobject>
</mediaobject>

<para>Les options de configuration suivantes sont disponibles : </para>

<variablelist>
<varlistentry>
<term><guilabel>Nombre de commandes à mémoriser</guilabel></term>
<listitem>
<para>Ce paramètre est présenté sous la forme d'un compteur qui vous permet de régler le nombre de commandes mémorisées. Tout nombre de 0 à 99 est accepté. La valeur par défaut est 20.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Dossier de travail par défaut</guilabel></term>
<listitem>
<para>Ce paramètre, présenté sous la forme d'un jeu de boutons radio, vous permet de décider comment le dossier de travail d'une commande est choisi. Les options sont : le dossier de travail du processus &kate; (habituellement votre dossier personnel lorsque &kate; à été démarré depuis le menu K), le dossier du document (si un document est ouvert, sinon, l'option ci-dessus est utilisée) ou le dossier de travail de la dernière commande exécutée dans le module. </para>
</listitem>
</varlistentry>

</variablelist>


</sect1>

<sect1 id="insertcommand-thanks-and-acknowledgements">
<title>Remerciements et mentions</title>

<para>Module externe de &kate; <quote>Insert Command</quote> copyright 2001 Anders Lund &Anders.Lund.mail;. </para>

<para>Documentation sous copyright 2001 &Anders.Lund; &Anders.Lund.mail; </para>

<para>Traduction française par &YvesDessertine;.</para> 
&underGPL; </sect1>
</chapter>
