Copyright © 2003 Éric Bellot
2003-04-29
Résumé
Ce document est le référence de conversion de Dn2dbk. Elle présente la correspondance entre les éléments de la RST et le résultat de la conversion au format Docbook.
Table des matières
Les balises Docbook sont présentées sous la forme d'une pseudo-syntaxe XPath. Par exemple, la balise option_list_item est convertie en :
variablelist[@role='option_list']/varlistentry |
Cela signifie que le contenu de cette balise se retrouvera dans :
<variablelist role="option_list">
<varlistentry>
<!-- Contenu de la balise ``option_list_item`` -->
</varlistentry>
</variablelist>
|
Lorsque Dn2dbk ne converti pas certains éléments, la raison en est expliquée succinctement par les termes suivants :
Elément non-défini dans la syntaxe de la RST (du moins, je n'ai pas encore trouvé comment l'utiliser).
Elément présent dans la RST mais pas (encore) supporté par le convertisseur
L'élément et son contenu sont éliminés lors de la conversion. En général, il s'agit d'éléments n'ayant pas de signification pour la Docbook, comme les éléments décoratifs.
|
Eléments RST |
Balises Docbook |
|
|---|---|---|
|
abbreviation |
Non-défini dans la RST |
|
|
acronym |
Non-défini dans la RST |
|
|
address |
articleinfo/address |
|
|
attention |
caution[@role='attention'] |
|
|
author |
author |
|
|
authors |
authorgroup |
|
|
block_quote |
blockquote |
|
|
bullet_list |
itemizedlist |
|
|
caption |
figure/title |
|
|
caution |
caution |
|
|
citation |
bibliography/bibliomixed |
|
|
citation_reference |
xref |
|
|
classifier |
variablelist/varlistentry[@role='x'] x correspond à la valeur de l'attribut classifier. |
|
|
colspec |
informaltable/colspec |
|
|
comment |
Commentaires dans le document Docbook (<!-- ... -->) |
|
|
contact |
articleinfo/bibliomisc/email |
|
|
copyright |
articleinfo/copyright le contenu est décomposé en year et holder |
|
|
danger |
warning[@role='danger'] |
|
|
date |
articleinfo/pubdate |
|
|
decoration |
Eliminé |
|
|
definition |
variablelist/.../definition |
|
|
definition_list |
variablelist |
|
|
definition_list_item |
variablelist/varlistentry |
|
|
description |
variablelist[@role=option_list]/.../definition |
|
|
docinfo |
articleinfo (+ d'autres éléments) |
|
|
doctest_block |
programlisting[@role='doctest'] |
|
|
document |
article |
|
|
emphasis |
emphasis |
|
|
entry |
informaltable/.../entry |
|
|
enumerated_list |
orderedlist |
|
|
error |
warning[@role='error'] |
|
|
field |
utilisé dans docinfo :
|
|
|
field_body |
voir field |
|
|
field_list |
Non-implémenté dans Dn2dbk Les listes de champs semblent être un mécanisme permettant d'étendre le langage RST. |
|
|
field_name |
voir field |
|
|
figure |
figure |
|
|
footer |
Eliminé (décoratif) |
|
|
footnote |
footnote |
|
|
footnote_reference |
footnoteref |
|
|
generated |
Non-défini dans la RST |
|
|
header |
Eliminé (décoratif) |
|
|
hint |
tip |
|
|
image |
mediaobject/imagedata |
|
|
important |
important |
|
|
label |
Eliminé (inutile) |
|
|
legend |
figure/caption |
|
|
line_block |
literallayout |
|
|
list_item |
listitem |
|
|
literal |
literal |
|
|
literal_block |
programlisting |
|
|
note |
note |
|
|
option |
variablelist[@role='option_list']/.../option |
|
|
option_argument |
variablelist[@role='option_list']/.../replaceable |
|
|
option_group |
variablelist[@role='option_list']/.../term |
|
|
option_list |
variablelist[@role='option_list'] |
|
|
option_list_item |
variablelist[@role='option_list']/varlistentry |
|
|
option_string |
variablelist[@role='option_list']/... |
|
|
organization |
articleinfo/author/affiliation/orgname |
|
|
paragraph |
para |
|
|
pending |
Non-défini dans la RST |
|
|
problematic |
Non-implémenté dans Dn2dbk |
|
|
raw |
Seulement si le code est au format Docbook et identifié comme tel :
|
|
|
reference |
Dépend de l'attribut :
|
|
|
revision |
Non-implémenté dans Dn2dbk |
|
|
row |
informaltable/.../row |
|
|
section |
section |
|
|
status |
Non-implémenté dans Dn2dbk |
|
|
strong |
emphasis[@role='strong'] |
|
|
substitution_definition |
Eliminé (inutile, la substitution est réalisée dans de document Docutils-Native) |
|
|
substitution_reference |
Eliminé (voir ci-dessus) |
|
|
subtitle |
subtitle |
|
|
system_message |
Non-implémenté dans Dn2dbk |
|
|
table |
informaltable |
|
|
target |
Non-défini dans la RST |
|
|
tbody |
informaltable/tbody |
|
|
term |
variablelist/.../term |
|
|
tgroup |
informaltable/tgroup |
|
|
thead |
informaltable/thead |
|
|
tip |
tip |
|
|
title |
title |
|
|
title_reference |
citetitle |
|
|
topic |
Peut prendre différentes formes
|
|
|
transition |
Eliminé (décoratif) |
|
|
version |
releaseinfo |
|
|
warning |
warning |