Mon premier document SGML - Linux

Mon premier document SGML
ou comment occupper un samedi
pluvieux d’octobre
Mathieu "zecastor" DECORE
Mon premier document SGML: ou comment occupper un samedi pluvieux
d’octobre
par Mathieu "zecastor" DECORE
Copyright ©
Table des matières
1. Mon premier chapitre.......................................................................................... 9
1.1. Le livre minimum ....................................................................................... 9
1.2. Convertir en HTML, en PS, ... .................................................................... 9
1.3. Un nouveau chapitre ................................................................................. 10
1.4. Un nouveau paragraphe ............................................................................ 10
1.5. Une section................................................................................................ 10
1.6. Une autre section....................................................................................... 11
1.7. Attention ! ................................................................................................. 11
2. Mise en forme du texte....................................................................................... 13
2.1. Choisir la police ........................................................................................ 13
2.2. Les énumérations avec itemizedlist ................................................... 13
2.3. Les énumérations avec procedure.......................................................... 14
2.4. Mettre un exemple .................................................................................... 14
2.5. La balise screen......................................................................................... 15
2.6. La balise programlisting ........................................................................... 15
3. Des maths............................................................................................................ 17
4. Les tableaux........................................................................................................ 19
A. Pour aller plus loin ............................................................................................ 21
A.1. Une section pour aller *encore* plus loin................................................ 21
5
6
Liste des exemples
2-1. Voici un exemple .............................................................................................. 14
2-2. La balise screen ................................................................................................ 15
2-3. La balise programlisting ................................................................................... 15
7
8
Chapitre 1. Mon premier chapitre
1.1. Le livre minimum
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
<book lang="fr">
<bookinfo>
<date>06/10/2001</date>
<title>Mon premier document SGML</title>
<subtitle>ou comment occupper un samedi pluvieux d’octobre</subtitle>
<affiliation>
<address>
<email>[email protected]</email>
</address>
</affiliation>
<authorgroup>
<author>
<firstname>Mathieu</firstname>
<othername>"zecastor"</othername>
<surname>DECORE</surname>
<authorblurb>
<simpara><email>[email protected]</email></simpara>
</authorblurb>
</author>
</authorgroup>
<copyright></copyright>
<legalnotice> </legalnotice>
</bookinfo>
<toc></toc>
</book>
9
Chapitre 1. Mon premier chapitre
1.2. Convertir en HTML, en PS, ...
On peut utiliser jade, mais comme il faut lui donner plein d’options c’est fastidieux.
Il est plus simple d’utiliser les scripts db2*, comme db2dvi, db2html, db2pdf,
db2rtf, db2ps, db2xml.
Par exemple :
$ db2ps livre.sgml
$
1.3. Un nouveau chapitre
Pour commencer un nouveau chapitre :
<chapter id="debut"><title>Mon premier chapitre</title>
</chapter>
Une référence à ce chapitre avec xref : Chapitre 1
Une référence à ce chapitre avec xref : <xref linkend="debut">
1.4. Un nouveau paragraphe
Voici le premier paragraphe. Bon y’a rien là, mais en principe on met ce qu’on a à
dire...
Voici le second paragraphe.
<para>Voici le premier paragraphe.
Bon y’a rien là, mais en principe on met ce qu’on a à dire...</para>
<para>Voici le second paragraphe.</para>
1.5. Une section
10
Chapitre 1. Mon premier chapitre
Voilà encore un paragraphe.
1.5.1. Une sous section
Une sous section, qui peut à son tour contenir des paragraphes.
1.6. Une autre section
Cette section peut à son tour contenir des sous sections, des paragraphes, ...
<sect1><title>Une section</title>
<para>Voilà encore un paragraphe.
<sect2><title>Une sous section</title>
Une sous section, qui peut à son tour contenir des paragraphes.
</sect2>
</para>
</sect1>
<sect1><title>Une autre section</title>
Cette section peut à son tour contenir des sous sections, des paragraphes, ...
</sect1>
1.7. Attention !
Attention
Il faut donner à manger aux poissons rouges.
<caution>Il faut donner à manger aux poissons rouges.</caution>
11
Chapitre 1. Mon premier chapitre
12
Chapitre 2. Mise en forme du texte
2.1. Choisir la police
•
variables avec envar
variables avec <envar>envar</envar>
•
nom de fichier avec filename
nom de fichier avec <filename>filename</filename>
•
en valeur avec emphasis
en valeur avec <emphasis>emphasis</emphasis>
•
une commande avec command
une commande avec <command>command</command>
•
un lien avec ulink
un lien avec <ulink url="ulink">ulink</ulink>
2.2. Les énumérations avec itemizedlist
•
premier élément
•
second élément
13
Chapitre 2. Mise en forme du texte
<itemizedlist>
<listitem>
<para>premier élément</para>
</listitem>
<listitem>
<para>second élément</para>
</listitem>
</itemizedlist>
2.3. Les énumérations avec procedure
1.
premier élément de la liste
et un deuxième paragraphe
2.
second élément de la liste
<procedure>
<step><para>premier élément de la liste</para>
<para>et un deuxième paragraphe</para>
</step>
<step><para>second élément de la liste</para>
</step>
</procedure>
2.4. Mettre un exemple
Exemple 2-1. Voici un exemple
Ben le voilà, quoi...
<example>
14
Chapitre 2. Mise en forme du texte
<title>Voici un exemple</title>
Ben le voilà, quoi...
</title>
</example>
2.5. La balise screen
Exemple 2-2. La balise screen
$ df -h /home/
Filesystem
/dev/hda4
Size
207M
Used Avail Use% Mounted on
40M 157M 20% /home
$
<screen>
<prompt>$</prompt><userinput> df -h /home/</userinput>
Filesystem
Size Used Avail Use% Mounted on
/dev/hda4
207M
40M 157M 20% /home
<prompt>$</prompt>
</screen>
2.6. La balise programlisting
Exemple 2-3. La balise programlisting
int main (void)
{
printf("Salut a tout le monde !-n");
return (0);
}
<programlisting>
15
Chapitre 2. Mise en forme du texte
int main (void)
{
printf("Salut a tout le monde !-n");
return (0);
}
</programlisting>
16
Chapitre 3. Des maths...
1.33 10-19
Ci2
1.33 10<superscript>-19</superscript>
C<subscript>i</subscript><superscript>2</superscript>
17
Chapitre 3. Des maths...
18
Chapitre 4. Les tableaux
A fictitious description of compiler features
Architecture
Company
Max optimization
Intel
Native code
support
yes
i386
alpha
DEC
yes
-O3
Z80
Zilog
no
-O1
-O4
<informaltable frame="all">
<title>A fictitious description of compiler features</title>
<tgroup cols="4">
<thead>
<row>
<entry>Architecture</entry>
<entry>Company</entry>
<entry>Native code support</entry>
<entry>Max optimization</entry>
</row>
</thead>
<tbody>
<row>
<entry>i386</entry>
<entry>Intel</entry>
<entry>yes</entry>
<entry>-O4</entry>
</row>
<row>
<entry>alpha</entry>
<entry>DEC</entry>
<entry>yes</entry>
<entry>-O3</entry>
</row>
<row>
<entry>Z80</entry>
<entry>Zilog</entry>
19
Chapitre 4. Les tableaux
<entry>no</entry>
<entry>-O1</entry>
</row>
</tbody>
</tgroup>
</informaltable>
20
Annexe A. Pour aller plus loin
Bon, encore un paragraphe...
A.1. Une section pour aller *encore* plus loin
Par exemple : prendre le trainpermet de ménager sa monture
<appendix>
<title>Pour aller plus loin</title>
<para>Bon, encore un paragraphe...</para>
<sect1>
<title>Une section pour aller *encore* plus loin</title>
<para>Par exemple :
<emphasis>prendre le train</emphasis>permet de ménager sa monture</para>
</sect1>
</appendix>
21
Annexe A. Pour aller plus loin
22