4. Éléments supportés par le convertisseur

Attention. Cette section n'est plus à jour.

4.1. Résumé des limites essentielles de la conversion

  • Les images ancrées à la page sont perdues.

  • Dans les tableaux, les fusions verticales de cellules ne sont pas supportées.

  • Le document doit avoir une hiérarchie cohérente des titres :

    • le premier titre doit être de niveau 1.

    • Les niveaux doivent être correctement imbriqués (pas de niveau 1 suivi d'un niveau 3, sans niveau 2 intermédiaire).

  • Les sous-listes produisent sont précédées d'un item de liste vide.

4.2. Titres et sections

  • Les sections et titres des sections du Docbook sont construits à partir des niveaux de chapitres du document SXW (menu Outils > Numérotation des chapitres).

  • S'il comporte des chapitres, le 1er chapitre doit être un chapitre de niveau 1.

  • Le document peut ne pas comporter de chapitre, dans ce cas, aucune section n'est générée.

4.3. Métadonnées

  • Les styles Titre principal et Sous-titre sont convertis en <title> et <subtitle> dans <infoarticle>.

Les métadonnées d'OOo sont intégrées à la section <infoarticle>.

  • Auteur => <AuthorGroup>Docbook subtile des identités. Il distingue le titre, le prénom, le nom et le surnom d'une personne (respectivement <honorific>, <firstname>, <surname> et <othername>). Il distingue les différents auteurs d'un document (<author>), il permet d'indiquer d'autres informations (email, adresse, etc.).

    Autant d'éléments qu'OpenOffice, vraiment indigent en la matière, ignore superbement. Il ne propose qu'un champ Auteur sans plus.

    Le convertisseur est capable de rendre correctement le nom et le prénom d'un auteur unique s'il est rédigé sous la forme [Nom, prénom]; la virgule servant de séparateur.

  • Sujet => <subject>

  • Mots-clefs => <keyword>Les mots-clefs doivent être séparés par des virgules.

  • Description => <abstract>

  • Date de dernière modification => <pubdate>

4.4. Paragraphes

  • Corps de texte et Standard => <para>

  • Texte préformatté => <programlisting>Les retours de ligne, espaces et tabulations sont préservés (les tabulations sont converties en 4 espaces)

  • Citation => <quotation>

  • Les autres paragraphes sont convertis en <para>.

4.5. Caractères

  • Accentuation => <emphasis>

  • Accentuation forte => <emphasis role="strong">

    Par défaut, la Docbook ne définie pas d'accentuation forte (en gras le plus souvent). Les Docbook XSL stylesheet doivent être modifiées pour supporter cet ajout, sinon il est tout simplement rendu comme une accentuation standard. Voir TLDP pour plus d'information.

  • Exemple, Texte non proportionnel et Texte source => <literal>

  • Saisie de l'utilisateur => <userentry>

  • Citation => <citetitle> (titre d'une oeuvre citée)

  • Variable => <varname>

    Mais <varname> n'est pas intégré à la Docbook simplifiée, seulement dans la version intégrale.

  • Les autres styles de caractères ne sont pas rendus (sauf les appels de notes qui sont produits automatiquement lors de la création d'une note de bas de page).

4.6. Notes de bas de page et notes de fin

Elles sont supportées avec les limites suivantes :

  • La Docbook ne distingue pas les notes de bas de page et les notes de fin de document. Les deux types de notes sont donc convertis en <footnote> sans distinction.

  • Les appels de notes par caractères spéciaux sont supportés par OOo2sDBK mais ne sont pas rendues lors des conversions avec les Docbook XSL stylesheets. Ces appels de notes sont inclus dans la numérotation automatique.

4.7. Tableaux

Les tableaux sont supportés avec les limites suivantes :

  • Les fusions verticales de cellules sont perdues y compris le texte qu'elles contiennent. De plus le tableau est totalement déstructuré.

  • Les fusions horizontales sont correctement rendues.

  • Les tailles de cellules sont supportées. Toutefois, le Docbook produit ne sera correctement converti qu'en utilisant les extensions fournies par Norman Walsh avec ses Docbook XSL stylesheets.

4.8. Listes

OOo2sDBK supporte les listes à puces et numérotées:

  • Les listes à plusieurs niveaux sont possibles.

  • Les parties d'items de listes séparés par des retours de ligne seront convertis en autant de paragraphes.

Les limitations sont les suivantes :

  • Les styles de puces ou de numérotation personnalisés ne sont pas conservés. Ils sont remplacés par les styles standards dans le Docbook.

  • Les puces graphiques ne sont pas supportées.

  • Une sous-liste numérotée produit un item vide (bogue du XML d'OpenOffice semble-t-il).

4.9. Hyperliens et références croisés

La plupart des fonctionnalités hypertextes sont supportées.

4.9.1. Les URLs

  • Les hyperliens d'OOo sont convertis en <ulink>.

  • L'attribut Frame des hyperliens d'OOo est converti en attribut Type dans le Docbook. Il permet de passer les valeurs de Target (_parent, _blank, etc.).

4.9.2. Les images liées

  • Seules les images ancrées comme caractères supportent les hyperliens.

  • Les liens sur images flottantes sont perdus (ancrage au paragraphe ou au caractère).

4.9.3. Les repères de texte et les renvois internes

  • Les repères de textes et les marques de renvois sont convertis en <anchor>.

  • Les renvois sont convertis en <link>.

4.9.4. Les renvois bibliographiques

  • Les renvois bibliographiques automatiques sont convertis en <xref>.

4.10. Images

  • Les images ancrées à la page sont perdues.

  • Les images ancrées comme caractère sont converties en <InlineMediaObject>.

  • Les images ancrées au paragraphe ou au caractère sont converties <MediaObject>.

  • L'attribut texte facultatif d'une image est converti en <TextObject> (texte de remplacement en cas d'affichage textuel).

  • Les dimensions d'affichage des images sont supportées.

4.10.1. Images liées et images incorporées

OOo2sDbk supporte les images liées et incorporées.

  • Les images incorporées sont extraites du fichier SXW et rassemblées dans un répertoire images créé dans le même répertoire que le document Docbook :

    • Les images sont nommées img001.xxx, img002.xxx, etc. La numérotation suit l'ordre d'apparition des images dans le document.

    • Les images ne subissent aucune conversion.

    • Il est possible de modifier le nom du répertoire images et le radical "img" des images dans le fichier de configuration config.xml.

  • Les images liées ne sont pas touchées :

    • les liens sont passés au document Docbook sans modification.

4.10.2. Positionnement vertical des images flottantes

OpenOffice permet un placement subtil des images flottantes. Il est impossible à rendre dans le Docbook.:

  • L'alignement horizontal des images flottantes est perdu. A ma connaissance, le Docbook ne supporte pas cette fonction.

  • Les images flottantes alignées en haut, au milieu ou d'en haut seront placées au-dessus du paragraphe d'ancrage dans le Docbook.

  • Les images flottantes positionnées en bas seront placées à la suite du paragraphe d'ancrage dans le Docbook.

4.10.3. Images légendées et cadres

La commande Légende appliquée à une image créée un cadre qui incorpore l'image et le texte de la légende.

  • La légende est converti en <caption> dans <MediaObject>.

  • OOo2sDBK n'est pas capable de géré les cadres ancrés comme caractère. Au cas où cela se produirait les cadres seraient placés au dessus du paragraphe de référence.

Cette page a été réalisée sur OpenOffice 1.0 et convertie au format simple Docbook avec OOo2sDBK 0.3.

Le document Docbook produit a été converti en HTML avec les feuilles XSLT pour Docbook (v. 1.50) de Norman Walsh.

Éric Bellot – http://www.chez.com/ebellot/ooo2sdbk