Manuel des modules externes de Kate
Copyright © 2001, 2002
Permission est accordée de copier, distribuer et/ou modifier ce document selon les termes de la Licence de Documentation Libre GNU (GNU Free Documentation License), version 1.1 ou toute version ultérieure publiée par la Free Software Foundation sans section invariante, sans texte de première de couverture, ni texte de quatrième de couverture. Une copie de la licence est fournie dans la section intitulée " GNU Free Documentation License ".
Ceci est le manuel des modules externes de Kate, le traitement de texte avancé de KDE (Ndt : KDE's Advanced Text Editor).
Table des matières
Les modules externes de Kate sont des fonctions supplémentaires pour l'éditeur Kate. Ils peuvent ajouter de nouveaux menus et raccourcis-claviers, et étendre les possibilités de Kate. Vous pouvez en installer autant que vous voulez. Depuis Kate, ouvrez la boîte de dialogue de configuration avec ->. Choisissez -> afin de cocher les modules désirés.
Pour plus d'informations sur l'utilisation de Kate et l'activation des modules que vous voulez, veuillez vous reporter au manuel de Kate.
Les modules externes installés dans ce manuel sont :
Ce module vous donne des astuces sur ce qui est autorisé à une position donnée dans un fichier XML, cela en se basant sur le DTD du fichier. Il donnera la liste des éléments, des attributs, des valeurs des attributs ou des entités possibles, selon la position du curseur (toutes les entités sont listées si le caractère à gauche du curseur est « & »). Il est aussi possible de fermer la balise ouverte la plus proche à gauche.
Le DTD doit exister au format XML, tel que généré par le programme Perl dtdparse. Notez que ce DTD au format XML n'est pas le modèle XML. Il est appelé « meta DTD ». Certains meta DTD sont fournis. Ils sont installés dans $KDEDIR/share/apps/katexmltools/, qui est aussi le dossier par défaut lorsque vous choisissez . Pour fabriquer vos propres meta DTD, procurez-vous dtdparse depuis http://dtdparse.sourceforge.net.
Démarrez Kate et ouvrez la boîte de dialogue de configuration dans ->. Choisissez Complètement XML pour Kate qui se trouve dans la sectionApplication/ Modules externes puis fermez la boîte de dialogue. Après cela, choisissez ->. Si votre document ne contient pas de « DOCTYPE » ou que le doctype est inconnu, vous aurez a sélectionner une méta-DTD depuis votre système de fichiers. Sinon la méta-DTD qui correspond au document actuel sera chargé automatiquement.
Vous pouvez maintenant utiliser le module durant votre rédaction :
Ceci déclenchera une liste d'éléments possibles à moins que le curseur soit déjà à l'intérieur d'une balise. Notez qu'actuellement, vous ne pouvez pas l'employer pour insérer un élément de niveau supérieur (par exemple « <html> »).
La touche guillemet appelle une liste de valeurs possibles d'attribut, s'il y en a et si vous êtes à l'intérieur d'une étiquette.
Cette touche déclenchera une liste d'attributs possibles pour l'élément actuel si vous êtes à l'intérieur d'une balise.
Cette touche déclenchera une liste d'entités nommées.
Vous pouvez tester toutes les fonctions et limitations en chargeant $KDEDIR/share/apps/katexmltools/testcases.xml dans Kate, en suivant les instructions contenues dans le fichier. Notez que le travail avec plus d'un document n'est pas supporté correctement actuellement par ce module.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Cela ouvre une boîte de dialoguequi vous permet d'insérer un élément XML. Les caractères <, > ainsi que l'étiquette de fermeture sera inséré automatiquement. Si vous avez sélectionné du texte lorsque cette option est sélectionné, le texte sera entouré par les étiquettes ouvrante et fermante. La boîte de dialogue offre de plus d'autocomplètement de tous les éléments pouvant être insérés à la position actuelle du curseur. Cela à condition d'avoir sélectionné un meta DTD. en utilisant .
Ceci recherchera une balise pas encore fermée dans votre texte, et la fermera en insérant la balise de fermeture correspondants. La recherche démarre à la position du curseur et va vers la gauche. S'il ne peut pas trouver de balise ouvrante, rien ne se passera.
Cela précise au module quel meta DTD utiliser pour tous les documents actuellement ouverts. Notez que cette assignation ne sera pas enregistrée, vous aurez à la répéter la prochaine fois que vous démarrerez Kate.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Module externe de Kate « Complètement XML » copyright 2001, 2002 Daniel Naber (daniel.naber AT t-online.de)
Documentation sous copyright 2001,2002 Daniel Naber
Traduction française par Yves Dessertine (kde AT yvesd.net).
Mise à jour par Gonéri Le Bouder (goneri AT gnuart.org).
Ce programme est soumis aux termes de la Licence Générale Publique GNU (GNU General Public License).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Ce module contrôle le fichier actuel. Une liste d'erreurs et d'avertissement apparaît en bas de la fenêtre Kate principale. Vous pouvez cliquer sur un message d'erreur afin de sauter directement à sa place correspondante dans le fichier. Si le fichier a un « DOCTYPE », le DTD fournit avec le doctype sera utilisé pour contrôler la validité du fichier. La position relative du DTD dans le texte est utilisé pour le trouver. Par exemple, si le doctype fait référence à « DTD/xhtml1-transitional.dtd » et que le fichier est /home/pierre/test.xml, le DTD doit se trouver à : /home/pierre/DTD/xhtml1-transitional.dtd. Cependant il faut savoir que les DTD spécifiés via http sont gérés.
Si le fichier n'a pas de doctype, il sera examiné pour s'assurer de sa bonne forme.
Pour en apprendre plus au sujet du contrôle du XML, consultez les pages officielles du W3C XML qui sont aussi disponibles en français.
En interne, ce module appelle la commande externe xmllint qui fait partie de libxml2. Le module ne fonctionnera pas si cette commande n'est pas disponible.
Un fichier temporel a besoin d'être écrit dans le même dossier que celui du fichier à contrôler, il est donc important d'avoir les droits d'écriture dans le dossier.
Pour charger ce module externe, ouvrez la boîte de dialogue de configuration de Kate avec ->. Choisissez alors Validation XML pour Kate qui apparaît dans la section ApplicationModules externes, puis fermez la boîte de dialogue.
Module Kate « Validation XML » copyright 2002 Daniel Naber (daniel.naber AT t-online.de)
Documentation sous copyright 2002 Daniel Naber
Traduction française par Gonéri Le Bouder (goneri AT gnuart.org).
Ce programme est soumis aux termes de la Licence Générale Publique GNU (GNU General Public License).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Le module « insérer une commande » vous permet d'insérer la sortie d'une commande shell dans un document ouvert dans Kate.
Tout d'abord activez le module externe « Insérer une commande » en utilisant la boîte de dialogue -> et en cochant Insérer une commande pour Kate dans la section Applications Modules externes, puis fermez la boîte de dialogue.
Pour utiliser ce module, sélectionnez sur dans le menu . 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.
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.
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.
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.
Pour configurer le module « Insérer une commande », ouvrez la boîte de dialogue de configuration de Kate depuis le menu -> et choisissez +Insérer une commande.
Les options de configuration suivantes sont disponibles :
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.
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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Module externe de Kate « Insert Command » copyright 2001 Anders Lund (anders AT alweb.dk).
Documentation sous copyright 2001 Anders Lund (anders AT alweb.dk)
Traduction française par Yves Dessertine (kde AT yvesd.net).
Ce programme est soumis aux termes de la Licence Générale Publique GNU (GNU General Public License).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Ce module ouvrira une boîte de dialogue vous demandant un nom de balise HTML. Les attributs et les valeurs à placer dans la balise ouvrante doivent êtres saisis sous la forme attribute-name="attribute-value"
Module externe de Kate « Outils HTML » copyright 2002 Joseph Wenninger (kde AT jowenn.at).
Documentation sous copyright 2005 Francis Giannaros
Traduction française par Yves Dessertine (kde AT yvesd.net) et Ludovic Grossard (grossard AT kde.org).
Ce programme est soumis aux termes de la Licence Générale Publique GNU (GNU General Public License).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Le module externe de Kate « Open Header » n'a actuellement aucune documentation. Si vous êtes volontaire pour remédier à cette situation, veuillez contacter Lauri Watts (lauri AT kde.org), la coordinatrice de l'équipe de documentation KDE.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Le module externe de Kate « Text Filter » n'a actuellement aucune documentation. Si vous êtes volontaire pour remédier à cette situation, veuillez contacter Lauri Watts (lauri AT kde.org), la coordinatrice de l'équipe de documentation KDE.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Le module externe Modèles de fichiers vous permet de créer des fichiers basés sur d'autres fichiers. Vous pouvez utiliser n'importe quel fichier comme modèle, ce qui créera une copie du fichier avec une URL vide ou bien utiliser un modèle spécial pouvant contenir des macros pour compléter des informations comme votre nom et votre adresse électronique, la date du jour, etc. et positionner le curseur à un endroit approrprié dans le nouveau fichier.
De plus, les modèles situés dans les dossiers des modèles seront présentés dans l'élément de menu ->.
Le module externe prévoit également une méthode pour créer facilement un nouveau modèle à partir d'un document ouvert.
Les dossiers des modèles font partie du système de fichiers KDE et se composent d'au moins KDEDIR/share/applications/kate/plugins/katefiletemplates/templates et KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Si votre variable d'environnement contient des dossiers additionnels, ceux-ci font l'objet d'une analyse pour rechercher un sous-dossier similaire également. Si des modèles nommés de la même manière sont trouvés, c'est celui qui se trouve dans le dossier (KDEHOME) local qui est choisi.
Affiche une boîte de dialogue Ouvrir un document qui vous permet d'utiliser n'importe quel fichier comme modèle. Si le fichier choisi est doté de l'extension katetemplate, une analyse est effectuée pour rechercher les informations et les macros du modèle.
Affiche une liste de fichiers récemment utilisés comme modèles, représentés par leur URL.
Le reste des sous-menus contient des liens vers les modèles. Cliquez sur un élément de menu pour créer un fichier comme décrit dans le texte de l'élément de menu.
Cet élément permet d'ouvrir une boîte de dialogue comportant une liste de tous les modèles trouvés dans les dossiers de modèles, ainsi que des options pour ajouter, modifier ou supprimer des modèles.
Lorsqu'on crée un fichier à partir d'un modèle contenant des macros de modèles, certaines macros apparaissent sous forme de variables modifiables dans le texte. De telles variables apparaissent sous forme de mots soulignés dans le texte.
Comme la première variable sera sélectionnée, il suffit de la saisir pour la modifier. Si le texte du document contient sd'autres instances de la même variable, elles sont changées au fur et à mesure que vous modifiez. Pour aller vers la prochaine variable modifiable, appuyez sur la touche de tabulation. Une fois la dernière variable modifiée, la liste disparaît et votre touche TAB fonctionne normalement.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Pour créer un nouveau modèle, utilisez l'élément -> pour ouvrir la boîte de dialogue de gestion des modèles. Dans cette dernière, cliquez sur pour lancer l'assistant Modèles de fichiers. Une invite vous demande de transformer un fichier optionnel en modèle, à saisir les paramètres d'informations du modèle, puis un modèle de fichier est créé pour vous.
Il est également possible de créer un modèle manuellement en ajoutant les informations du modèle au début de chaque fichier, d'ajouter du texte ainsi que des macros, puis de l'enregistrer avec l'extension katetemplate.
Le menu des modèles est mis à jour automatiquement si vous choisissez de stocker votre modèle dans le dossier des modèles.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Pour modifier un modèle, utilisez ->. Sélectionnez le modèle sur lequel vous voulez travailler et cliquez sur : le modèle de fichier est ouvert. Fermez la boîte de dialogue, modifiez le modèle de fichier selon vos souhaits, enregistrez-le et fermez-le. Les changements apportés aux modèles prenant effet immédiatement, vous pouvez mettre en œuvre le modèle pour tester vos changements après l'avoir enregistré.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Si vous utilisez des fichiers dotés de l'extension katetemplate, ils font l'objet d'une analyse pour rechercher les informations, les macros du modèle et la position du curseur.
Lorsqu'il lit le fichier, le programme d'analyse conserve les lignes commençant par la phrase katetemplate: et y recherche les informations des modèles de la forme NOMVARIABLE=VALEUR. La première ligne ne commençant pas par katetemplate: sera prise au début du contenu du modèle. Le paramètre VALEUR peut contenir n'importe quel caractère sauf le signe égal (=). Les noms de variables admis sont :
TemplateC'est le nom du modèle, affiché dans le menu ->.
GroupeLe groupe place le modèle dans un sous-menu du menu ->.
NomC'est le nom qui sera donné au document et affiché dans la liste des fichiers, ainsi que la barre de titre. Si le nom contient %N, celui-ci sera remplacé par un nombre qui augmentera si d'autres documents ont le même nom.
Coloration syntaxiqueLe module externe tentera de définir la coloration syntaxique du nouveau document à la valeur de cette variable. La valeur devrait être le nom, tel qu'on le trouve dans le menu ->.
DescriptionUne courte description informative du modèle. On utilise actuellement cette variable pour définir une chaîne « Qu'est-ce que c'est » pour l'élément de menu, mais il se peut qu'elle ait d'autres fonctions dans le futur.
Une chaîne qui identifie l'auteur, par exemple de la forme Nom <adresse électronique>. On utilise actuellement cette variable pour définir une chaîne « Qu'est-ce que c'est » pour l'élément de menu, mais il se peut qu'elle ait d'autres fonctions dans le futur.
Les macros de la forme %{NOM} ou ${NOM} sont étendues lors de l'analyse du contenu du modèle. Si vous utilisez le préfixe $, la macro étendue est considérée comme une variable modifiable quand un document est créé à partir du modèle, alors qu'avec % elle ne l'est pas, sauf si son expansion a échoué.
Les macros suivantes sont étendues :
S'étend à l'heure actuelle dans votre format de locale.
S'étend à la date actuelle en format abrégé.
S'étend à la date et à l'heure actuelle, formatées comme une chaîne, en fonction de votre locale.
L'année en cours sous la forme d'un nombre à quatre chiffres.
Le nom complet du mois en cours, en fonction de votre locale.
S'étend au jour actuel du mois.
S'étend au nom d'hôte de votre ordinateur.
S'étend à 'i'.
S'étend à votre nom complet, comme défini par l'adresse du propriétaire dans votre carnet d'adresses KDE standard.
S'étend à votre prénom, comme défini par l'adresse du propriétaire dans votre carnet d'adresses KDE standard.
S'étend à votre nom patronymique, comme défini par l'adresse du propriétaire dans votre carnet d'adresses KDE standard.
S'étend à votre adresse électronique, comme défini par l'adresse du propriétaire dans votre carnet d'adresses KDE standard.
Toute macro ne se trouvant pas dans la liste ci-dessus est considérée comme une variable modifiable, quel que soit le préfixe. Si la même variable apparaît plusieurs fois dans le modèle, il est possible de la modifier immédiatement après avoir créé un document à partir du modèle.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Module externe « Modèles de fichiers » de Kate - copyright 2004 Anders Lund (anders AT alweb.dk).
Documentation copyright 2004 Anders Lund
Traduction française par Joëlle Cornavin (jcornavi AT club-internet.fr)
Ce programme est soumis aux termes de la Licence Générale Publique GNU (GNU General Public License).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Les copyrights pour chaque applet se trouvent dans le chapitre correspondant.
Cette documentation est soumise aux termes de la Licence de Documentation Libre GNU (GNU Free Documentation License).
Ce programme est soumis aux termes de la Licence Générale Publique GNU (GNU General Public License).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team