154 lines
6.7 KiB
Text
154 lines
6.7 KiB
Text
<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
|
|
|
|
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
|
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
|
modification, are permitted provided that the following conditions
|
|
are met:
|
|
|
|
1. Redistributions of source code (SGML DocBook) must retain the above
|
|
copyright notice, this list of conditions and the following
|
|
disclaimer as the first lines of this file unmodified.
|
|
|
|
2. Redistributions in compiled form (transformed to other DTDs,
|
|
converted to PDF, PostScript, RTF and other formats) must reproduce
|
|
the above copyright notice, this list of conditions and the
|
|
following disclaimer in the documentation and/or other materials
|
|
provided with the distribution.
|
|
|
|
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
|
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
|
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
|
POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
$Id: chapter.sgml,v 1.1 2000-06-12 15:46:33 gioria Exp $
|
|
-->
|
|
|
|
<chapter id="psgml-mode">
|
|
<title> Utiliser <literal>sgml-mode</literal> avec
|
|
<application>Emacs</application></title>
|
|
|
|
<para>Les versions récentes d'Emacs ou Xemacs (disponibles au catalogue des
|
|
logiciels portés) incluent un paquetage très utile appelé PSGML. Il est
|
|
automatiquement appelé au chargement d'un fichier avec l'extension
|
|
<filename>.sgml</filename>, ou lorsque l'on tape <command>M-x
|
|
sgml-mode</command>. C'est un mode majeur pour traiter les fichiers
|
|
SGML, les éléments et les attributs.</para>
|
|
|
|
<para>Connaître certaines des commandes de ce mode peut rendre le travail
|
|
sur des documents comme le Manuel de Référence beaucoup plus
|
|
facile.</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><command>C-c C-e</command></term>
|
|
|
|
<listitem>
|
|
<para>Exécute <literal>sgml-insert-element</literal>. On vous
|
|
demandera le nom de l'élement à insérer là ou se trouve le
|
|
curseur. Vous pouvez utiliser la touche <keycap>Tab</keycap> pour
|
|
compléter le nom de l'élément. Seuls les éléments syntaxiquement
|
|
valides à cet endroit seront acceptés.</para>
|
|
|
|
<para>L'éditeur insérera les marques de début et de fin de l'élément.
|
|
S'il y a d'autres éléments obligatoires qui doivent être inclus
|
|
dans cet élément, ils seront aussi inclus.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><command>C-c =</command></term>
|
|
|
|
<listitem>
|
|
<para>Exécute <literal>sgml-change-element-name</literal>. Mettez-vous
|
|
dans un élément et utilisez cette commande. On vous demandera le nom
|
|
de l'élément par lequel il faut le remplacer. Les marques de début
|
|
et de fin de l'élément seront remplacées.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><command>C-c C-r</command></term>
|
|
|
|
<listitem>
|
|
<para>Exécute <literal>sgml-tag-region</literal>. Sélectionnez du
|
|
texte (placez-vous au début, <command>C-espace</command>, allez à
|
|
la fin du texte, <command>C-espace</command>) et lancez ensuite
|
|
cette commande. On vous demandera quel élement utiliser. Celui-ci
|
|
sera inséré immédiatement avant et après la région choisie.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><command>C-c -</command></term>
|
|
|
|
<listitem>
|
|
<para>Exécute <literal>sgml-untag-element</literal>. Mettez-vous sur
|
|
la marque de début ou de fin de l'élément que vous voulez supprimer
|
|
et lancez cette commande. Les marques de début et de fin de
|
|
l'élément seront supprimées.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><command>C-c C-q</command></term>
|
|
|
|
<listitem>
|
|
<para>Exécute <literal>sgml-fill-element</literal>.
|
|
“Remplira” (i.e., reformatera) le contenu de l'élément
|
|
courant. Cela affectera aussi le contenu dont les blancs sont
|
|
significatifs, comme celui des éléments
|
|
<sgmltag>programlisting</sgmltag>, utilisez donc cette commande avec
|
|
précaution.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><command>C-c C-a</command></term>
|
|
|
|
<listitem>
|
|
<para>Exécute <literal>sgml-edit-attributes</literal>. Ouvre un
|
|
deuxième tampon donnant la liste des attributs de l'élément
|
|
qui inclut le contenu courant, avec leurs valeurs. La touche
|
|
<keycap>Tab</keycap> vous permet de passer d'un attribut à l'autre,
|
|
<command>C-k</command> de modifier une valeur existante, et
|
|
<command>C-c</command> de fermer le tampon et de revenir au
|
|
document principal.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><command>C-c C-v</command></term>
|
|
|
|
<listitem>
|
|
<para>Exécute <literal>sgml-validate</literal>. Vous propose de
|
|
sauvegarder le document en cours (si besoin est) et passe ensuite un
|
|
programme de validation du SGML. Les résultats de cette validation
|
|
sont affichés dans un nouveau tampon et vous pouvez ensuite naviguer
|
|
d'une erreur à l'autre, pour les corriger au fur et à mesure.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
<para>Il y a sans aucun doute d'autres fonctions utiles, mais j'ai décrit
|
|
celles que j'utilise le plus souvent.</para>
|
|
</chapter>
|
|
|
|
|
|
<!--
|
|
Local Variables:
|
|
mode: sgml
|
|
sgml-declaration: "../chapter.decl"
|
|
sgml-indent-data: t
|
|
sgml-omittag: nil
|
|
sgml-always-quote-attributes: t
|
|
sgml-parent-document: ("../book.sgml" "part" "chapter")
|
|
End:
|
|
-->
|
|
|