Structure d'article scientifique médical (XML, DTD, XLST)
Résultat
- Lien vers la DTD
- Lien vers la documentation externe de la DTD.
La DTD est aussi documentée en interne dans le fichier .dtd. - Lien vers le fichier XML
- Lien vers le fichier XSL
- Lien vers le fichier CSS
Objectifs de la DTD
La DTD a pour objectif d'aider à la rédaction d'un article de recherche scientifique dans le domaine médical. En tant que telle, elle s'adresse plutôt à un public de jeunes chercheurs dans le domaine médical mais peut être utilisée par l'ensemble de la communauté des chercheurs médicaux.
Objectifs XSLT
Pour connaître la méthodologie de rédaction employée dans les sciences médicales (éléments devant figurer dans ce type d'article),
j'ai tout d'abord consulté 3 références universitaires (cf. sources des Universités de Rennes et Rouen).
Ensuite, j'ai consulté plusieurs articles pour me faire une idée de la mise en page adoptée dans ce domaine, ceci afin de m'en inspirer.
L'article-exemple qui illustre la réalisation de cet exercice correspond en partie à Etude descriptive de
l'utilisation des cartes conceptuelles comme stratégie en sciences de la santé.
A noter donc que cet article n'est pas complet dans le fichier XML mais a été simplement utilisé en guise d'illustration. D'autre part, j'ai ajouté une annexe
qui n'était pas présente dans l'article d'origine à partir de Questionnaire enseignants 2014 afin d'illustrer la partie "annexes" du fichier.
Démarche de conception
Voici le résumé des principales étapes de conception :
- Recherche d'une thèmatique : création d'un caneva permettant la rédaction d'un article scientifique médical.
- Lecture des tutoriels sur XML et DTD (Edutechwiki et d'autres sources complémentaires).
- Réflexion sur la structure du document : sur papier puis réalisation d'une mind map avec CMAPTOOLS (cf.documentation de la DTD). Pendant la réalisation de la carte conceptuelle, j'ai préparé la réalisation de la DTD ; j'ai donc indiqué des notes mnémotechniques : "0" ou "1" ou "n" qui correspondent au nombre de fois où l'élément peut être présent.
- Réalisation du fichier XML à partir de la documentation de la DTD. J'ai beaucoup hésité pour choisir entre DTD et XML pour commencer. Finalement, j'ai opté pour le XML. Cela me paraissait plus simple de construire la DTD sur le fichier XML que l'inverse (le fichier XML étant plus "familier").
- Réalisation de la DTD
- Lecture des tutoriels sur XSLT (Edutechwiki et également sources complèmentaires)
- Réalisation du fichier XSLT
- Lecture de tutoriels sur la manière de combiner le XSLT et le CSS.
- Réalisation de la feuille de style CSS.
Auto-évaluation (technique et ergonomique) et axes d'amélioration possible
Au niveau technique, je n'ai pas cherché à faire quelque chose de trop simple (car c'est facile de faire simple) ni de trop compliqué pour ne pas que la création de ces fichiers
ne m'échappe. Aussi, lors de la création du document, je me suis rendue compte qu'il était possible d'aller beaucoup plus loin dans la codification que ce que ce fichier propose
(par exemple, on pourrait améliorer la partie "références" en les codifiant en norme APA) mais, compte tenu du temps imparti et des autres impératifs de rendus de livrables,
j'ai choisi une difficulté moyenne me permettant de comprendre XML, DTD et XSLT un peu plus que de simples bases.
Au niveau ergonomique, le document crée aide le jeune chercheur à la rédaction tout en lui laissant des axes de liberté. Par exemple, le chercheur n'est pas obligé
de produire une conclusion ni des annexes. D'autre part, la présentation de ce document en fait quelque chose de relativement clair et facile à prendre en main pour pour un jeune chercheur.
Partie autoscopique (difficultés)
Pour le fichier XML: pas de difficultés.
Les choses ont commencé a devenir plus compliquées avec la DTD. D'ailleurs, j'avais une erreur "Unable to load DTD" mais impossible de vérifier les erreurs avec une DTD externe (du moins,
si cela existe, je n'ai pas trouvé). De ce fait, j'ai eu l'idée de mettre la DTD en interne dans le fichier XML pour corriger les erreurs (avec XML copy Editor, les erreurs sont de suite
signalées lors du codage). Une fois corrigée, j'ai pu retransférer
les données dans une DTD externe. J'ignore si la procédure est ou non protocolaire mais en tout cas, ça a fonctionné!
Ensuite, j'ai eu quelques difficultés avec XSLT mais rien d'insurmontable, juste le temps de comprendre le fonctionnement.
Une fois ceci compris, je n'ai finalement pas eu tant de difficultés que je croyais a crée des conditions ("if") et des boucles ("for each") dans le fichier pour certaines parties de l'article.
Concernant la transformation XSLT, j'ai eu des difficultés. Bien qu'ayant lu le document sur Exchanger XML Editor en français
et en anglais, avoir consulté Internet ainsi que la page discussion de l'exercice, j'avais toujours une erreur malgré des fichiers valides et bien formés:
FATAL ERROR: java.net.MalformedURLException: no protocol: articleex10.dtd.
Ne voyant pas la solution, j'ai demandé à Monsieur Schneider qui a trouvé des erreurs dans les déclarations de fichiers.J'ai corrigé mes fichiers et essayé de
nouveau mais même souci. La génération ne fonctionnait pas alors que j'avais les générations effectuées par Monsieur Schneider donc la preuve que ça fonctionnait !!
J'ai donc téléchargé tous les fichiers en provenance de Monsieur Schneider et comparer point par point les déclarations de fichier mais toujours pas de succès, la transformation
ne marchait pas.
Finalement, j'ai eu un "éclair" et je me suis souvenue que j'avais eu un souci dans le passé pour cause d'un chemin vers le fichier trop long. J'ai donc tout copier-coller sur le desktop de
l'ordinateur et ai lancé une génération qui a enfin fontionnée.
Enfin, pour le CSS, pas de difficultés particulières.
Sources
- Tutoriels et liens Edutechwiki de l'exercice 10
- Tutoriel Introduction technique à XML
- Cours sur l'écriture de DTD
- Tutoriels de code (plusieurs pages) sur stack overflow
- Source pour XSLT : XSLT tutorial
- Référence de l'université de Rouen : La rédaction médicale: quelques conseils.
- Référence de l'université de Rouen : Lecture critique d'article.
- Référence de l'université de Rennes 1 : Instructions aux auteurs.
- Image icône XML
- Documentation sur balise 'xsl:output' Du bon usage de xsl:output et Déclarations et styles (TECFA)
Contributions au Wiki
Liens
- Liste des contributions
- XML Copy Editor : création et documentation de la page (Introduction et parties 1 à 5).
- XML Schema : création et début de document (partie 1 et 2).
Objectifs
Tout d'abord, j'ai documenté un éditeur XML. J'ai choisi XML copy Editor qui est celui que j'utilise.
N'ayant que peu de contenus dans XML Copy Editor, j'ai décidé d'apporter une autre contribution; je me suis intéressée à la conception de documents XML et DTD.
j'ai donc commencé à rédigé une page sur XML schema. Le temps a manqué pour terminer mais le plan est réalisé pour permettre de poursuivre l'écriture.
Enfin, j'ai relié ces pages à :
- Pour la page XML Copy Editor : création d'un lien avec la page sur STIC II _ Exercice 10 en ajoutant un lien et insertion du nom de catégorie (XML) en bas de page (insertion du modèle "catégorie").
- Pour la page XML Schéma : un lien a été crée dans la page Tutoriel DTD et dans la page STIC II _ Exercice 10 en bas de page. Enfin, j'ai inséré le nom de catégorie dans la page XML schema (catégorie : XML).
Difficultés
Quelques difficultés pour trouver de la documentation sur XML copy editor; la page créee est la synthèse des différentes sources lues.