Cours DocBook accelere

Annexe B. Mode PSGML de Emacs

Il existe peu d'éditeurs SGML. Un des plus connu est Emacs avec le mode PSGML. Il possède la complétion *sur les balises*.

Ici, quelques points sur la façon d'utiliser ce mode. En premier installer le paquetage "psgml", ensuite charger un fichier DocBook dans Emacs.

Note

Emacs avec le mode PSGML ne gère pas les noms de fichiers se terminant par .docbook. Votre nom de fichier doit finir par .sgml ou .xml comme myfile.sgml.

Note

(NdT : Je ne sais pas pour Emacs, mais les extensions .docbook fonctionnent très bien avec XEmacs et le mode PSGML, en tous cas dans la version 21.4.19 sous Fedora 4).

Si vous tapez "C-c C-e" il vous demandera un élément et permettra la complétion seulement si l'élément est valide.

À titre d'exemple, j'ai tapé :



C-c C-e variab<SPACE BAR><RETURN>


et il a inséré ce texte dans le tampon :



    <variablelist>
      <varlistentry>
        <term></term>
        <listitem>
          <!-- one of (epigraph authorblurb abstract highlights comment bridgehead anchor sidebar procedure msgset table figure example equation informaltable informalexample informalequation graphicco graphic blockquote address simpara para formalpara funcsynopsis cmdsynopsis synopsis screenshot screenco screen programlistingco programlisting literallayout warning tip note important caution variablelist simplelist segmentedlist orderedlist itemizedlist glosslist calloutlist) -->
        </listitem>
      </varlistentry>
    </variablelist>

Un autre exemple :



C-c C-e i<SPACE BAR>


et il m'indique les complétions suivantes :




Click mouse-2 on a completion to select it.
In this buffer, type RET to select the completion near point.

Possible completions are:
important                          indexterm
informalequation                   informalexample
informaltable                      itemizedlist