Les métadonnées sont certainement la partie d'un document la plus délicate à construire. Elle suppose une imbrication subtile de styles pour que le convertisseur puisse produire une section infoarticle correcte.
Afin de faciliter la saisie des métadonnées, vous trouverez deux modèles dans l'Autotexte un modèle de métadonnées complet un autre plus court.
Le convertisseur respecte l'ordre dans lequel les éléments sont insérés. Tous les éléments décrits dans cette rubrique seront placés entre les balises <infoarticle> du document Docbook.
Les styles décrits dans cette section ne doivent être utilisés que pour les métadonnées.
Les styles de paragraphe Titre principal et Sous-titre sont convertis en <title> et <subtitle>
Utiliser le style de paragraphe Pubdate.
Il est recommandé de présenter la date sous la forme aaaa-mm-jj (année-mois-jour).
Les styles de paragraphes Author, Editor et Othercredit seront convertis respectivement en <author>, <editor> et <othercredit>.
![[Note]](../common/images/note.png) | Note |
|---|---|
Par défaut, les XSL-stylesheets pour Docbook de Norman Walsh ne convertissent pas la balise <editor> dans les articles. Présente dans le document Docbook, elle disparaît dans les documents HTML, XHTML et FO. | |
Chacun d'eux peux contenir les styles de caractères suivants :
Honorific (titre, civilité) => <honorific>
Firstname (prénom) => <firstname>
Surname (nom de famille) => <surname>
Lineage. Reservé aux noms anglo-saxons : Jr (Junior), Sr (Senior) => <lineage>
Othername. Autre nom en cas de besoin (pour les français cela peut-être un surnom). => <othername>
Jobtitle (fonction, emploi) => <jobtitle>
Orgname (organisme, entreprise, institution) => <orgname>.
Bien qu'insérés directement dans un paragraphe comme Author, les textes stylés en Jobtitle et Orgname seront correctement encadrés par les balises <affiliation>...</affiliation>.
| Note |
|---|---|
Contrairement au habitudes de la Docbook standard, dans la simplified Docbook, il est interdit d'insérer l'email dans la balise <author>. Voir la section Email pour plus de détails | |
Par souci de clarté, on peut insérer des retours de ligne dans un paragraphe Author, Editor ou Othercredit.
On peut faire suivre un paragraphe de style Author, Editor ou Othercredit d'un paragraphe Authorblurb. Il est destiné à contenir une courte présentation de l'auteur.
| Note |
|---|---|
Pour être corectement traité par OOo2sDbk, le paragraphe Authorblurb doit suivre immédiatement l'auteur auquel il réfère. | |
Le style de caractère Email est converti en <email>.
L'insertion de l'email du ou des auteur d'un document est très problématique dans la simplified Docbook. Dans la Docbook standard, l'email peut être placé entre les balises author ou adress. Impossible avec la simplified Docbook qui ne le permet pas dans author ; quant à la balise adress, elle fait partie des balises éliminées de la simplified Docbook.
Il faut donc se résoudre à le placer dans Authorblurb s'il y a plusieurs auteurs, voire Bibliomisc s'il n'y en a qu'un. Aucune de ces solutions n'est très satisfaisante car authorblurb et bibliomisc ne sont pas très bien suportés par les convertisseurs de document Docbook.
Un paragraphe Bibliomisc est converti en <bibliomisc>.
| Note |
|---|---|
Par défaut, les XSL-stylesheets pour Docbook de Norman Walsh ne convertissent pas la balise <bibliomisc>. Présente dans le document Docbook, elle disparaît dans les document HTML, XHTML et FO. | |
Ils doivent être saisis dans les propriétés du document par le menu Fichier > Propriétés > onglet Description.
Les mots-clefs doivent être séparés par des virgules pour être correctement traités :
keyword1, keyword2, keyword3
Les sujets doivent appartenir à un vocabulaire référencé. Ils seront saisis de la façon suivante :
subject-sheme:subject-terme1,subject-terme2,subject-terme3
Il se rédige en style Abstract.
Le résumé ne doit comporter qu'un paragraphe (les paragraphes suivants seront convertis en texte standard). Toutefois, il est possible d'insérer des retours de lignes. Les phrases séparées par des retours de ligne formeront des paragraphes dans le document Docbook.
On peut donné un titre au résumé. Le titre doit précéder immédiatement le paragraphe de résumé et être de style Titre.
Il se rédige en style Copyright et sera converti en <copyright>.
Un paragraphe Copyright doit contenir une ou plusieurs années en style de caractères Year suivi d'un ou plusieurs détenteurs des droits en style Holder (détenteur des droits). Seuls le contenu des éléments stylés en Year et en Holder sont transmis au document Docbook.
Par exemple, le paragraphe de copyright rédigé de la façon suivante :
Copyright©2002 Eric Bellot.
Dans ce paragraphe, « 2002 » est en style Year et « Eric Bellot » en style Holder. Une fois converti, il deviendra :
<copyright><year>2002</year><holder>Eric bellot</holder></copyright>
On remarque que la partie « Copyright© » a disparue. C'est normal, elle sera reconstruite lors de la conversion ultérieure du document Docbook. Il ne faut pas inclure « Copyright© » dans Year.