Créer votre article

Créer votre article
Précédent	Chapitre 1. Produire un article docbook [db:article]	Suivant

Des aides à la navigation dans le logiciel

Quelques aides à la navigation dans oXygen:

Les touches de direction sont essentielles à la navigation.

Figure 1.2. les touches de direction clavier

Les différentes fenêtres dans oXygen : au centre, votre fenêtre de travail avec en haut une aide essentielle à la navigation qui vous précise la position de votre curseur.

Figure 1.3. le chemin de votre curseur dans oXygen

Sur un côté, la fenêtre navigateur d'Archives dans laquelle vous avez ouvert votre zip avec les media, votre article, votre fiche LOM, votre connection aux bases de données.

Sur l'autre côté, deux fenêtre indispensables: la fenêtre Eléments avec tous les éléments dont vous disposerez pour la construction de votre article et la fenêtre Attributs dont vous aurez besoin dans les cas où vous insérez un media ou un lien. Si ces fenêtres n'apparaissent pas il est possible de les afficher en allant les activer dans le menu "fenêtre".

Remplir l'entête de l'article

Dans un premier temps, vous allez commencer l'article en remplissant les champs qui définissent le ou les auteurs de l'article puis présenter l'article en rédigeant un résumé.

Cliquer sur l’onglet correspondant à votre article «article.xml»
Passer dans l’onglet de l’article modèle et regarder les éléments présents.
Dans l’article vierge après le titre, sélectionner l’élément «authorgroup», remplir les champs correspondants
Créer ensuite les mêmes éléments que dans l’article modèle: affiliation
Ecrire le résumé : abstract

Il reste à intégrer des sections, des figures, des tableaux ou tout autre éléments en respectant le format ENS-DOA

Faire un plan avec des sections et sous-sections

Lorsque l'on écrit un article, il est important et utile de pouvoir le structurer. Pour cela, il faut utiliser l'élement section: sect 1 pour les grands titres et sect 2 pour les sous-titres...

Insérer du texte dans votre article

Pour écrire du texte, il suffit de se situer à un niveau du curseur qui donne dans les éléments possibles celui de <para>. Si vous souhaitez faire un copier/coller de texte, c'est à cet élément que ce sera possible. Il est dans ce cas plus facile de passer par le mode texte pour un meilleur repérage des balises.

La série de boutons illustrée ci-dessous vous permettra comme dans un traitement de texte classique de pouvoir appliquer du gras, de souligner ou de mettre votre texte en italique, suivant la configuration choisie vous pouvez avoir des icônes ou du texte pour les styles..

Figure 1.4. boutons pour appliquer du style

Intégrer une image dans votre article

Dans la liste des éléments, fenêtre de droite se trouve l'élement figure comme sur l'image ci-dessous:

Ajouter une figure

Il faut commencer par titrer la figure. C'est une étape obligatoire.
Intégrer un objet «image»
1. Soit votre dossier média contient déjà l'image soit vous pouvez ajouter un fichier image.jpg au dossier «media» et au sous dossier «images» (local ou en ligne).
  
  Pour cela, dans le navigateur d'archives, fenêtre de gauche, cliquer droit sur images et ajouter des fichiers:

Sélectionner ensuite "mediaobject" puis "imageobject" puis "imagedata"
Remplir les attributs «fileref» https://media.tremplin.ens-lyon.fr/ressources/users/EricLeJan/NoticeBook/images/nomdufichier.jpg de l'élément "imagedata" . Il est possible de glisser déposer l'image depuis le serveur de media et dans ce cas il faut impérativement modifier l'adresse comme précisé ci-dessus.
Compléter les attributs «width», «align», «alt»

Vous pouvez choisir 400 pour la largeur et "center" pour l'alignement
Ajouter les éléments «info» puis «copyright» puis «legalnotice» puis votre choix de licence Creative Commons http://creativecommons.org/choose/.

Votre image s'affichera en mode auteur. Si cela n'est pas le cas, c'est que le chemin que vous avez attribué à l'image dans l'attribut fileref n'est pas correct.

Intégrer des vidéos ou des fichiers son dans votre article

L'élément "figure" permet également de gérer le média vidéo.

Ce média pour être affiché par tous les navigateurs doit être fourni aux formats :

webm
mp4

L'élément "figure" permet également de gérer le média audio.

Ce média pour être affiché par tous les navigateurs doit être fourni aux formats :

mp3
aac

Ces quatre formats peuvent être obtenus grâce à ffmpeg où à des logiciels comme "media converter" basés sur ffmpeg. Bien veiller à ce que les fichiers de media soient conformes et complets, certains convertisseurs se dispensent de fournir des métadonnées inutiles pour la visualisation mais indispensables dans des livres numériques.

Les élements et leur ordre de mise en place :

"figure" puis "titlle" Pour le titre, "mediaobject" puis "videoobject" pour intégrer la première vidéo, puis "videodata" pour renseigner le chemin vers le media mais aussi sa disposition dans la page, enfin "info" puis "legalnotice" puis le choix de votre licence Creative Commons.

On place les deux formats en ajoutant deux ensembles "videoobject" "/videoobject" supplémentaires.

Pour les fichiers audio on remplace par :

"figure" puis "titlle" Pour le titre, "mediaobject" puis "audioobject" pour intégrer le premier fichier son, puis "audiodata" pour renseigner le chemin vers le media mais aussi sa disposition dans la page, enfin "info" puis "legalnotice" puis le choix de votre licence Creative Commons.

Les attributs à compléter :

C’est l’élément «videodata» qui impose à minima les attributs :

fileref= "" pour le chemin d'acès au media dans l'archive
width="" pour la largeur sur la page
align="" pour l'alignement sur la page
alt="" pour le texte alternatif à afficher pour l'accessibilité

Résultat de l'intégration vidéo.

Les media audio s'intègrent de la même façon que les media vidéo. Les formats à mettre en place sont .mp3 et .AAC.

Les balises sont en revanche différentes "mediaobject", "audioobject", "audiodata".

Figure 1.7. Un exemple d'intégration de video

Insérer des liens

Cet élément est très utilisé dans nos articles.

L’élément link, en mode texte <link></link> décrit un lien.

Pour qu’un lien soit actif il faut rentrer l’adresse du lien dans les attributs. xlink:href= http://

On peut aussi renseigner le titre pour obtenir un affichage lors du survol de l’expression. xlink:title= «le titre»

Insérer des listes

Les listes sont des objets que nous pouvons utiliser pour obtenir une présentation un peu plus structurée.

On peut créer des listes à puces ou des listes numérotées.

Il y a des éléments pour ces deux types de listes :

pour la liste à puce: élément "itemizedlist" puis "listitem" et "simpara".
pour la liste numérotée: élément "orderedlist" puis "listitem" et "simpara".

Utiliser les boutons

Maintenant que vous maitrisez la structure de ce logiciel, il existe des boutons qui vous feront gagner du temps si vous les utilisez à bon escient:

Vous retrouverez les fonctions déjà évoquées précédemment et une permettant la création d'un tableau lorsque vous avez l'élément "para"

Figure 1.10. insérer un tableau avec le bouton

Vous pouvez alors choisir un titre, le nombre de lignes et de colonnes. Pour légender les lignes et les colonnes, il suffit de placer le curseur à l'endroit où vous souhaitez écrire puis dans les éléments choisir <simpara>. Si vous souhaitez introduire une image dans votre tableau, l'élément est <informalfigure> puis <mediaobject> la suite des éléments est identique à celle indiquée dans le paragraphe 2.5

Cette présentation succincte vous aura permis de vous familiariser avec les procédures de base de la rédaction d'un article. Le logiciel propose de nombreuses autres astuces et facilités pour accélérer la rédaction, vous pourrez cliquer utilement sur le bouton aide qui propose des ressources en français et un moteur de recherche sur les fonctionnalitéss assez performant.

Vous disposez maintenant d'un article au format DocBook qui vous permet d'explorer le format livre. Pour un livre il est souhaitable d'avoir un article suffisamment structuré ou plusieurs articles à réunir dans le livre.