Simplified DocBook

Olivier Issaly <[email protected]> Tue, 13 Jan 2004 00:22:35 +0000
Newsgroups gmane.comp.cms.haricow
Message-ID <[email protected]>
salut,

rapidement je reprends les fonctionnalités souhaitées par rapport à ce que 
proposes Simplified DocBook:

** paragraphe **
Sdb dispose de la balise para, au niveau simplicité et taille du nom, c'est 
parfait.

** niveaux de titre **
Sdb dispose d'une balise section recursive, et d'une balise title
exemple :

<section>
  <!-- titre de niveau  1 -->
  <title>mon titre plip plop</title>
  <para>plip</para>
  <para>plop</para>
  <section>
    <!-- titre de niveau  2 -->
    <title>mon titre flic flac</title>
    <para>flic</para>
    <para>flac</para>
    (etc ..)
  </section>
</section>

Ca me parait correct comme utilisation.

** liste d'éléments **
Plusieurs possibilités:

"itemizedlist — A list in which each entry is marked with a bullet or other 
dingbat"
Ce qui me gène , c'est que la description utilise des termes graphiques, 
mais sinon visiblement c'est l'équivalent d'une liste non ordonnée.
On peut faire:
<itemizedlist>
  <listitem>
    <para>element 1</para>
  </listitem>
  <listitem><para>element 2</para></listitem>
  <listitem><para>element 3</para></listitem>
</itemizedlist>

On a la même chose avec orderedlist, et on peut dans les deux cas attribuer 
un titre à la liste, ca c'est bien.
Il y a aussi varlistentry, qui semble correspondre à ce que je cherchais 
pour une liste genre:
"def1: val1
 def2: val2
 ..." (cf point 8 du mail "Grammaire XML pour le contenu" du 3/1)

Les noms de balises me paraissent un peu longs quand même , comparés à 
(ul|ol)/li de HTML :)

** lien hypertextes **
Sdb dispose de ulink pour cela avec un attribut url.
Il y a aussi link , pour faire des liens dans le document même. Je sais pas 
si c'est utile pour le moment dans le cadre d'un article ... A voir.

** citation **
Il y a blockquote formaté comme bloc, et quote formaté "inline". On a la 
même distinction qu'en HTML, c'est dommage, j'aurais aimé un seul et même 
élément pour les citations, la feuille xslt étant capable de formater 
correctement selon son emplacement .

** acronyme **
Il y a une balise acronyme, mais bizarrement il n'y a pas de d'attribut 
permettant de spécifier sa signification, il faut le faire dans le texte à 
la suite, c'est étrange je trouve, et pas très pratique si on veut générer 
une balise HTML acronym :/

** notes de bas de pages **
il y a une balise footnote, c'est parfait :)

** objets externes **
pour gérer des éléments audio, video ou de l'image, il y a la balise 
mediaobject. Je regarderai de plus près, mais ca m'a l'air correct.


Voila, à première vue, rien n'empeche d'adoter un subset de simplified 
docbook voire même de docbook si il manque des éléments. Il y a quand même 
quelques trucs qui m'ennuient, comme pour la balise acronym.

Je ne pense pas que HTML puisse répondre aux même besoins, ils manquent 
notamment les notes de bas de pages, des niveaux de titres indéfinis (même 
si 6 c'est déjà pas mal). Par contre, je vais essayer de jeter un oeil aux 
brouillons de XHTML 2, ca peut être interessant, je connais pas trop.

Reste aussi à savoir si c'est facilement extensible, et si oui de quelle 
manière ? On ajoute juste un élément dans la specif de la grammaire qu'on 
aura réalisé ? On le distingue par un namespace différent ? (ouarf, 
propre, mais pas très utilisable). Il ne faut pas être bloqué plus tard si 
on a besoin d'étendre la grammaire en dehors de docbook ...

Si vous connaissez d'autres grammaires potentiellement interessantes 
signalez-les :)

a+

-- 
Olivier Issaly
http://www.kiad.org
Jabber-Id: [email protected]

Liste de diffusion haricow
Dernières nouvelles : [email protected]?subject=info
Pour se désinscrire : mailto:[email protected]?subject=unsubscribe