Le concept du document

En effet, chacun dans notre domaine professionnel ou privé, émettons et consultons quotidiennement un grand nombre de documents et la banalité de l'acte n'incline pas à la réflexion. Les vocables pour désigner l'objet document ne manquent pas et les variations sur le thème sont nombreuses : information, donnée, ressource, fichier, écrit, texte, image, papier, article, oeuvre, livre, journal, feuille, page ... Évidemment, chacun de ces termes se réfère à un contexte particulier mais ils se rattachent tous, à des degrés divers, au concept du document, du latin " documentum " (du verbe " docere " : enseigner).
Mieux gérer l'information signifie principalement deux choses : en premier lieu être apte à retrouver l'information pertinente, et en second lieu être capable de la produire sous une forme adaptée à son destinataire et à son médium.
Quand les ordinateurs ont apparu et se sont investis massivement dans le domaine du traitement et de la production de textes, notre définition naturelle du document, étroitement liée au support papier est devenue plus abstraite. Le papier a été brûlé pour n'en récupérer que l'encre. Lorsque nous parlerons d'information, nous parlerons à la fois du texte et aussi de son, d'image, d'animation et plus encore. La notion de médium ou support devient alors ambiguë : s'agit-il du fichier, du disque physique, ou bien encore de l'écran où le document est affiché ?
Le support électronique a généré également d'autres changements, notamment au niveau de la structure du document, des techniques de production, de stockage et de réutilisation de l'information qui se transforme en bien valuable.
Concernant, le concept de structure, il faut dire que nous sommes habitués aux constituants implicites de la structure et de la hiérarchie du document comme les paragraphes qui parfois sont contenus dans des sections et des chapitres avec des relations d'appartenance entre les différents éléments d'un document (le titre, le chapitre, le sous chapitre, etc.). Nous repérons les paragraphes par un saut de ligne, les sections et les chapitres sont écrits plus gros et sont numérotés.
Cette manière explicite d'exprimer la structure du document nous est cachée par son incarnation physique. Mais, ce qui nous intéresse dans le document n'est pas sa structure, mais l'information contenue par ce document. En revanche, la structure et la hiérarchie sont des clés permettant de mieux comprendre cette information.
Nous sommes donc en présence d'infomation sur l'information, d'où le terme de " meta-information "
Nous venons de voir un type de méta-information, celle concernant la structure du document. Un autre type de méta-information est la variante typographique (gras, italique, soulignement, etc.,) qui est utilisé pour donner de l'emphase à l'information. Cette variante est qualifiée de la méta-information du type sémantique.
Il existe aussi une troisième méta-information qui ne concerne pas le contenu du document, mais le document lui-même. C'est le cas de l'information sur les auteurs, sur la date et des autres renseignements qui ne sont pas directement liés au contenu du document.
Cette découverte sur la méta-information d'un document nous permet de dire que : " l'information peut décrire, de l'information contenue dans le document ou le document lui-même. "
Par la suite : nous allons aborder le document sous un angle plus dynamique en abordant son cycle de vie.

Cycle de vie du document

Un document donne un statut, confère une légitimité à une information car il est porté par le groupe social qui le suscite. Il constitue simultanément une preuve qui fait foi d'un état de choses, une annonce qui prévient d'un événement, un discours qui se rattache à un auteur, un témoignage, une pièce de dossier. La diffusion de l'information qui contient un document doit dépasser la communication intime (la sphère privée) pour accéder à la légitimité.
Prenons un exemple, pour mieux comprendre cette dynamique : dans une institution une pièce de dossier doit être rédigée. La personne qui la rédige devra la taper sur l'ordinateur, puis va la soumettre vraisemblablement à une correction par son ou sa collègue, ensuite elle sera remise à la personne l'ayant demandée. Par la suite, cette dernière personne va la classer dans un dossier ou sous une pile d'autres dossiers. Enfin, quelqu'un voudra peut-être dans un premier temps consulter cette pièce du dossier et puis peut-être la modifier et ainsi de suite.
Cette situation simple résume en fait assez bien les différentes étapes du cycle de vie d'un document.

Or, un document se voit d'abord créé par une ou plusieurs personnes. Il sera produit sur un support, que ce soit sur l'écran d'un ordinateur ou sur des feuilles de papier ; suite à cela il sera probablement édité puis stocké.
On comprend aisément que ces différentes étapes de la vie d'un document ne sont pas exhaustives. Mais, ce cycle est une base sur laquelle chaque entité va pouvoir greffer ses sous étapes ainsi que les interactions avec ses différents acteurs.

Le document en situation réel

La précédente partie nous a proposé un cadre théorique dans lequel nous allons pouvoir poser les problèmes de l'élaboration des documents. Pour bien les comprendre, rien ne vaut mieux qu'une situation concrète.

Etude de cas

Nous allons prendre comme exemple le cas d'un professeur qui veut éditer[1] un livre avec le but de le publier sur le web. Le professeur n'est pas formé à l'utilisation des outils pertinents pour l'édition des documents numériques. Nous sommes donc en présence d'un terrain vierge qui va nous permettre de passer en revue les différents problèmes que va rencontrer notre courageux professeur.

Le format

La première chose que le professeur doit faire est de récupérer ses écrits dans un format numérique, ou de les écrire avec un traitement de texte si cela n'était pas le cas. Dans la plupart des cas, le document produit convient à une production papier (le livre) mais se prête relativement mal à une production en ligne (typiquement le format HTML).
Ainsi vient le premier problème : le professeur doit pouvoir produire facilement des documents pour les deux supports (ici donc, le papier et le web). Dans la plupart des cas les solutions trouvées sont soit une réécriture du document destiné au papier en document HTML, ou bien une conversion "sauvage" du document original en document HTML. Ces deux solutions peuvent être acceptables à court terme, mais elles posent notamment deux problèmes:

• Etant donné que chaque support a des exigences ergonomiques propres, le fait d'avoir un document par support engendre au niveau des corrections ou des modifications, le problème non seulement de double travail, mais aussi celui de se focaliser plus sur la mise à jour plutôt que sur la rédaction du contenu de l'écrit.
• Convertir "sauvagement" ses documents ne présente pas exactement les mêmes défauts que de maintenir plusieurs versions. La conversion engendre en général un document qui n'est pas ou peu adapté à son support car la conversion ne prendra pas en compte les spécificités du support.

Le public cible

Un document une fois produit est vu par une personne, mais ce n'est pas toujours la même personne qui consulte le document. Un auteur, par contre, sait en général à qui il s'adresse, ou à qui il veut s'adresser. Ainsi il s'agit pour lui de définir des ensembles de personnes, qui sont en fait le "public cible" de son document, et d'indiquer dans le document les parties qui concernent l'une ou l'autre "public cible". Ce concept est important dans le sens où il apporte la possibilité d'adapter le document à son "auditoire". L'adaptation à son public cible (ou plutôt ses publics cibles) est un critère qui touche plus le contenu que la forme.

La révision

Ici, nous sommes confrontés à deux problématiques :

• les corrections et les modifications du document et les annotations de celles-ci sur le document.
• la garde de la version du document antérieur aux modifications.

Tout ceci est tout à fait faisable sur un document papier, on peut directement faire des annotations sur le document ou y insérer un post-it contenant des notes. Il en est un peu différemment dans des logiciels actuels.
Il s'agit aussi de gérer différentes versions, c'est à dire l'historique et les variantes de documents. Ceci permet de revenir dès qu'on le désire à une version donnée d'un document, et de consulter les mises à jour qui ont été effectuées.
Pour satisfaire au problème de la révision, il faut donc concrètement pouvoir corriger, annoter, et garder un historique des documents et de leurs modifications.

L'indexation

Le livre du professeur est maintenant rédigé. Il s'agit par la suite de repérer dans celui-ci certains mots ou expressions particulièrement significatifs (appelés termes)dans un contexte donné, et de créer un lien entre ces termes et le texte original (méta-information). Par exemple, les pages d'index d'un livre reprennent (parfois) les termes significatifs apparaissant dans le livre, et les relient aux pages du livre où ces termes (ou leurs synonymes) apparaissent. Ceci facilite pour le lecteur la localisation des pages ou sections où l'on mentionne un sujet particulier. De même, la table des matières d'un livre est une forme (assez grossière) d'indexation.

La publication

La publication est un moment délicat, le moment où toutes les informations contenues dans le document entrent en jeu : ce stade cristallise ainsi toutes les attentions que les auteurs ont eu à l'égard du document : ainsi il s'agit de pouvoir publier la bonne version, pour la bonne personne, et dans le format adapté.
Au cas où notre courageux professeur voudrait imprimer une version "du livre," il désirerait forcément avoir la toute dernière version, et avoir l'ensemble des informations supplémentaires : annotations, commentaires, dernières changements réalisés, etc...
D'un autre côté, le professeur peut demander une version numérique non encore fini. Il ne voudra sûrement pas avoir une version du livre non finalisée, par contre, il attend un livre limité à son essentiel, de manière à pourvoir se faire un aperçu rapide de son contenu ; on retrouve ici les aspects d'adaptation du contenu au lecteur, et la notion d'historique.
On comprend donc aisément que l'étape de production est avant tout technique : il faut que l'infrastructure de publication permette de gérer les différents paramètres du document, notamment l'indexation, la révision, et naturellement le format. Par ailleurs l'infrastructure de la publication doit connaître des informations sur le destinataire du document, de manière à servir un document qui conviennent le mieux possible aux attentes du destinataire, tant dans le contenu que dans la forme.

La standardisation de la structure du contenu du document

Supposons maintenant que le professeur veuille échanger le livre avec un professeur d'une autre université. Si tous les deux ont eu des démarches différentes pour l'édition des livres, les documents produits par l'un et par l'autre ne seront donc pas facilement échangeables.
C'est de là que part la problématique de la standardisation : il s'agit de définir un format de documentation commun, afin que plusieurs auteurs d'origines variées soumettent des documents qui s'insèrent sans problème dans le système d'échange de l'information.
La définition de ce format est un aspect très complexe, car il faut qu'il soit à la fois flexible (que tous les deux professeurs aient des éléments de marquage sémantique pour leur travail) et complet (les professeurs ont assez d'éléments de marquage pour s'exprimer).
Paradoxalement, la multiplication des formats " propriétaires ou privés" a conduit à des situations d'illisibilité, difficilement tolérables pour l'utilisateur.
Nous verrons par la suite qu'il existe un ensemble de technologies qui ont posé les premières pierres à une standardisation de la documentation. Ces technologies visent à rendre les documents accessibles (donc indexables), durables (donc maintenables), interopérables (donc transportables dans des contextes technologiques variées et évolutifs) ainsi que réutilisables et adaptables.

Des logiciels pour la création des documents électroniques

Nous allons voir à travers l'évolution des logiciels pour la création de documents électroniques que la manière d'éditer des documents n'étaient pas la plus pertinente, dans le sens où ces logiciels mélangeaient forme et contenu et ne permettaient pas à l'origine de répondre à notre problématique abordé, dans le cas de l'édition du livre par un professeur.

TEX

Le logiciel TEXest un traitement de texte scientifique particulièrement adapté à l'écriture des symboles mathématiques, physique et science informatique.
Il a été créé à partir de 1977 par le mathématicien Donald Knuth. TEX n'est pas un traitement de texte où le document en préparation apparaît à l'écran comme il est censé être une fois imprimé, mais un logiciel traduisant du texte en un document graphique. Cette traduction est non lisible par un humain, mais sera comprise par des logiciels de visualisation et éventuellement des imprimantes (fichier DVI[2] ). Le fichier DVI est ensuite lu par un autre programme appelé gestionnaire de périphérique) qui produit la sortie qui est lisible par les humains.
En fait, TEX était plus un logiciel pour le formatage et la mise en page, c'est-à-dire qu'il ne contenait pas la possibilité de marquer la sémantique d'un document. En autre, l'utilisation de TEX étant assez ardue pour un débutant, il a été étendu en LATEX. Exemples des formules TEX

LATEX

Leslie Lamport est à l'origine de LATEXqui est une collection de macro-commandes pour TEX. On pourrait présenter LaTeX comme le traitement de texte idéal pour les scientifiques. Il excelle dans le traitement des formules mathématiques et dispose en standard de tous les caractères mathématiques. Son coût modique en fait un logiciel parfaitement adapté au monde de l'enseignement.
Le compilateur LATEX est basé sur l'idée que la rédaction d'un document est plus efficace en se concentrant sur la structure logique (la sémantique du document) en laissant au second plan les détails de mise en page. LATEX sépare donc le forme du contenu.
LATEX est très utilisé dans le monde universitaire (pour sa gratuité, sa qualité et la possibilité de l'adapter à ses besoins en modifiant les macros) et dans des publications scientifiques. Malgré sa syntaxe assez intuitive LATEX permet de rédiger rapidement des équations mathématiques tout en assurant un rendu parfait. Lors de la compilation d'un tel fichier, les titres, figures, équations sont numérotés de manières cohérentes, Cela permet de générer automatiquement sommaires de listes de figures en un minimum d'efforts. LATEX dispose également d'un système de gestion des références bibliographiques très efficace, BIBTEX. Exemple simple:

\documentclass[a4paper, 11pt]{article} \title{Exemple de document LaTeX} \begin{document} Coucou ! \end{document}

Source

Un exemple de math :

${\displaystyle z=\left( \frac {e^{i\theta}+e^{-i\theta}}{2}\right)^2 +left(\frac{e^{i\theta}-e^{-i\theta}}{2i} \right)^2}$

Ce code va produire après compilation la formule mathématique :

SGML (Standard Generalized Markup Language)

Le langage SGML est un langage de description à balises qui est utilisé pour décrire la structure logique d'un document, et non son aspect typographique. Le document est vu comme une structure arborescente et son organisation doit respecter une DTD. Par exemple : on ne peut pas avoir de chapitre à l'intérieur d'un paragraphe. Le principe appliqué est le marquage du contenu d'un document en définissant les titres, auteurs, chapitres, sous-chapitres d'un document, et en identifiant les graphiques et autres types de données. Cette description standardisée permet donc de lire les documents créés selon cette norme sur n'importe quel type de machine, ce qui facilite leur réutilisation et leur circulation sous forme électronique.
Le SGML assure en particulier que tout document pourra être relu, quelle que soit l'évolution des systèmes et des traitements de texte. Le langage SGML est aujourd'hui surtout utilisé dans les agences gouvernementales, les industries aéronautique et pharmaceutique ainsi que dans l'édition.
Le problème de SGML est qu'on ne peut pas écrire un document sans avoir auparavant dicté les règles qui vont contraindre sa structure (DTD)

HTML (HperText Markup Language)

HTML est un langage de balisage de texte qui permet la création des documents affichables par un navigateur web. C'est une application du langage à balises SGML avec une syntaxe fixe et non extensible.
On distingue quatre types de balisage en HTML:

• le balisage structurel : il décrit le but d'un élément d'une page ;
• le balisage hypertexte : il lie un élément d'une page à une autre ressource située sur le Web ;
• le balisage de présentation : il décrit l'apparence que doit prendre un élément d'une page ;
• le balisage "utilitaire" ou "accessoire" : il sert à créer des objets précis tels que des boutons par exemple.

Le balisage de présentation montre que HTML ne sépare pas la forme du contenu du texte qui est une caractéristique fondamentale pour la création de textes numériques. Exemple :

XML (Extensible Markup Language)

XML (entendez extensible Markup Language et traduisezLangage à balises étendu, ou Langage à balises extensible)définit la structure, le contenu, la sémantique, indépendamment de la mise en page du document.
XML n'est pas un langage, mais un méta-langage, c'est-à-dire un outil permettant de créer des langages. XML permet aussi de définir de noms d'éléments, d'attributs en n'importe quelle langue (arabe, russe, etc.)
Les balises utilisées en XML capturent uniquement la structure logique du document (son articulation en partie et sous parties) et ses données, qu'il intègre dans le même fichier. Ainsi le contenu d'un document au format XML est structuré grâce à des balises en forme arborescente.
L'extensibilité (c'est à dire la possibilité de rajouter des balises) de XML est illimitée. La tâche de la représentation visuelle du document XML est confiée aux feuilles de styles spécifiques, et ainsi générer autant de formats d'affichage, d'impression, de diffusion, etc. que l'on souhaite.
XML permet aussi de stocker et d'échanger des données structurées, pour ainsi gérer le contenu du document XML.
En réalité les balises XML décrivent le contenu plutôt que la présentation (contrairement à HTML). Ainsi, XML permet de séparer le contenu de la présentation ce qui permet par exemple d'afficher un même document sur des applications ou des périphériques différents sans pour autant nécessiter de créer autant de versions du document que l'on nécessite de représentations !
XML a la particularité d'être plus souple que SGML, car il n'exige pas l'existence préalable d'une DTD. XML est aussi plus simple, car il a moins d'exceptions syntaxiques. XML a été développé par le World Wide Web Consortium pour permettre aux documents publiés sur Internet une plus grande richesse sémantique, et donc de pouvoir répondre aux problématiques que nous avons abordées précédemment.

Les solutions : les documents structurés

Nous venons de voir que ces dernières années plusieurs logiciels ont essayé d'apporter une solution viable à l'édition de documentation, permettant de remplacer les traitements de texte dont le plus connu est sans conteste Microsoft Word.
Paradoxalement, pour l'utilisateur habituel, comme l'est notre professeur qui veut éditer sur le web, le traitement de texte est souvent la référence en matière de texte numérique. C'est pourquoi il nous pose la question suivante: " Pourquoi ne pas utiliser Microsoft Word comme outil de documentation ? "
Nous allons donner réponse à cette question, en lui montrant un certain nombre de problèmes qu'il va rencontrer lors de la rédaction du livre :

• Etant donné que les versions de Word changent après un certain temps, le premier problème rencontré est l'incompatibilité des versions Word. Le professeur ne pourra pas lire le document rédigé avec des versions anciennes de Word.
• Le format Word est un format fermé, limité. Il est donc peu portable.
• L'exportation d'un document Word en HTML est problématique. Ceci ne permet donc pas de rendre consultable la documentation sur un site Internet, si ce n'est en effectuant un travail manuel de conversion.
• On perd souvent beaucoup de temps à mettre en forme le document plutôt que de travailler sur le fond (même si un bon modèle peut permettre de gagner du temps.)

Cahier de charges d'un outil de documentation

Voici les points à tenir en compte pour choisir un outil de documentation :

• Pérennité du format. Il faut être sûr qu'on va pouvoir accéder à la documentation dans dix ans s'il le faut.
• Le format choisi doit pouvoir accéder aux documents de n'importe quel poste de travail et en utilisant d'importe quel système d'exploitation également.
• Les différentes balises du format choisi doivent permettre de donner du sens au texte. La mise en forme ne doit pas rentrer en compte au moment de la rédaction.
• Il faut pouvoir établir facilement des liens entre différentes parties d'un document car ces dernières sont très souvent liées.
• Il est nécessaire que le standard de documentation soit connu et reconnu.

Nous pouvons déduire suite au cahier des charges ci-dessus présenté que le format XML a vocation à devenir le format d'échange universel des données structurées qui transitent sur le Web. Ainsi, toutes les solutions que nous aborderons par la suite sont des solutions utilisant, ou basées sur ce type de méta-langage.

DOCBOOK

XML Docbook est en fait une DTD (Document Type Definition) définissant un langage XML permettant d'écrire des documentations (sous forme d'articles ou d'ouvrages.) Même s'il est plutôt orienté informatique dans sont état actuel, il n'est à priori pas limité à cet usage. Docbook existe en deux versions SGML et XML. Sa force est d'être un format XML, totalement orienté sémantique, il n'inclut en effet aucune information de mise en forme ce qui permet d'utiliser ensuite la documentation ainsi structurée sur tout type de support.
Par structuration, nous insistons sur le fait que chaque élément du texte est très clairement identifié, et deuxièmement, par sa position dans l'arborescence XML qui le positionne très distinctement par rapport à ses ancêtres, sa descendance, ses semblables, etc. Nous avons jusqu'ici parlé du contenu, voici venir la présentation de ce contenu. Un ensemble de feuilles de styles XSL est disponible pour transformer des documents Docbook vers de nombreux formats comme :

• HTML : pour une publication en ligne en une seule page HTML, ou plusieurs pages dont le découpage logique est au choix de l'utilisateur.
• Aide HTML : format des pages d'aide du navigateur d'aide de Microsoft Windows

Ces feuilles de styles XSL sont plus que de simples outils de mise en page car elles réalisent tout le travail de structuration de la documentation. On peut ainsi générer une table des matières de la profondeur souhaitée, la numérotation des titres de section se fait automatiquement, les liens entre les différents documents produits sont eux aussi fait automatiquement, on peut choisir le degré de structuration du document en indiquant à partir de quelle profondeur.
Ces feuilles de style XSL sont aisément personnalisables et permettent d'arriver à un résultat correspondant parfaitement à ce qu'on souhaite.
L'exemple suivant montre la structure d'une feuille de styles. Une feuille de styles est représentée par l'élément " xsl:stylesheet " dans un document XML. " xsl:transform " est autorisé comme synonyme de " xsl:stylesheet. " L'élément " xsl:stylesheet " doit avoir un attribut " version " indiquant la version de XSLT exigées par la feuille de style. Pour cette version de XSLT, la valeur doit être 1.0. Lorsque la valeur n'est pas égale à 1.0, le traitement en compatibilité ascendante est activé.

Source

Document xml

La transformation en HTML sera:

XSLT est un langage dédié à la transformation de données XML, faisant partie de XSL qui est le langage des feuilles de style de XML. En plus de XSLT, XSL inclus un vocabulaire XML pour la spécification de formatage. XSL spécifie les règles de présentation d'un document XML en utilisant XSLT, pour décrire comment le document peut être transformé en un autre document qui utilise le vocabulaire de formatage.
Saxon est un parser Java. Il permet de faire des transformations XSL (comme les docbook-xsl.)
Bien que Docbook soit une DTD très complet pour produire du texte structuré, elle n'est pas la seule solution. D'autres DTD sont aussi adaptées à des contextes différents de la documentation pédagogique.

Simplifiée Docbok

Nous avons vu que DocBook est défini comme une grammaire d'écriture de documents structurés en SGML ou en XML. Destiné initialement à la structuration de livres et d'articles informatiques, DocBook trouve des domaines d'applications dans bien d'autres types de documents.
Par ailleurs sa popularité allant croissant, les initiateurs de DocBook ont publié plusieurs extractions de la D.T.D. principale dont la DTD simplifié de DocBook qui est particulièrement adaptée pour la structuration d'articles et notamment pour la publication sur le WEB.
La DTD simplifiée de DocBook DTD est identifiée par :

• l'identificateur public formel (F.P.I.) :

• l'identificateur système:

La DTD de Simplifiée Docbook est composée de :

• 106 éléments,
• 525 entités :
  302 entités paramètres
  223 entités générales
• 26 notations

Le document article est un sous ensemble du document book. On ne trouvera donc pas d'élément chapter par contre on retrouve sect1 et sect2 ainsi que para
Nous vous conseillons tout de même d'utiliser book dès que le document fait plus de 2 ou 3 pages. Exemple :

Pour plus d'informations voir Manuel Docbook

DITA (Darwin Information Typing Architecture)

DITA est une architecture ouverte permettant de décrire des topics extensibles (concepts, tâches, références) composés d'un titre, suivi d'une courte description, de textes complets (et d'images) pouvant être orga-nisés en sections. Un topic peut être autonome ou rattaché à un topic parent dont il peut "hériter" les propriétés et inaugurer une hiérarchie. De plus, DITA permet d'organiser des topics voisins en Information Type. Ce type d'organisation permet de réaliser des recherches pertinentes par type de topics et donc de présenter à l'utilisateur uniquement l'information qui lui convient, pour réaliser une tâche particulière.
L'objectif de DITA est de constituer des référentiels documentaires assemblables par configuration de publication. L'idée de base est, sur un sujet donné, de créer l'ensemble des modules d'informations qui seront nécessaires à la compréhension et à "l'opérationnalité" de l'utilisateur. Ceci fait, les modules s'assemblent par configuration, soit en fonction de parcours de cet utilisateur, sur un support électronique, soit en fonction d'un ordre pré-établi, pour une publication papier. Exemple :

Source

Pour plus d'information voir Frequently Asked Questions about the Darwin Information Typing Architecture

Logiciels d'édition

Des éditeurs XML pouvant créer ou modifier un fichier XML, tout en respectant la DTD Docbook existent. Ces éditeurs sont divisés en deux familles : les éditeurs XML travaillant uniquement sur l'arborescence et les éditeurs acceptant des feuilles de style comme CSS sur les balises.
Les éditeurs XML les plus simples qui ne travaillent que sur l'arborescence sont en général des freewares et servent à valider le document avec une DTD.

Xerlin

Licence : libre

Systèmes : JVM (Windows, Linux, MacOS...)

Langage : Java

Version : 1.2

Cet éditeur, dont la dernière version stable date de juin 2002, est plutôt limité. Il ne permet que l'édition en mode arbre, et n'est pas vraiment conçu pour être utilisé avec DocBook et ses centaines de balises.
D'après sa documentation, il serait plutôt étudié, grâce à une API adequate, pour pouvoir utiliser des plugins rendant l'édition plus facile ou plus spécifique aux besoins de l'utilisateurs. Le nombre de plugins disponibles semble cependant assez limité...

Source

Qemacs

Licence : LGPL

Systèmes : Unix-like

Langage : C

Version : 0.3.1

Cet éditeur possède l'interface et les principales fonctionnalités d'Emacs, tout en restant très petit. Il possède d'autres fonctionnalités intéressantes, comme par exemple l'édition simultanée en mode source ou en mode WYSIWYG. Il ne se limite pas à DocBook et est aussi conçu pour d'autres langages.
Il manque cependant encore de maturité et ne propose pas de fonctions spécifiques à DocBook comme l'auto-complètement, la validation, la conversion...

Source

JXMLpad

Licence : Shareware, évaluation gratuite.

Systèmes : JVM (Windows, Linux, MacOS...)

Langage : Java

Version : 1.9.2

Ce petit éditeur est en fait un composant Java qu'il est possible d'intégrer dans d'autres applications. Il propose l'édition en mode source avec colorisation syntaxique et une vue sous forme d'arbre.

Source

Il existe des éditeurs XML complets qui acceptent des feuilles de style comme CSS sur les balises. Exemple :

XXE (XMLmind XML Editor)

Licence : commerciale et gratuite (fonctionnalités restreintes)

Systèmes : JVM (Windows, Linux, MacOS...)

Langage : Java

Version : 2.4

Il s'agit là aussi d'un des meilleurs éditeurs disponibles. Édition possible en mode WYSIWYG et arbre simultanément. Correcteur orthographique. Interface très pratique.

Souce

oXygen

Licence : commerciale, évaluation gratuite pendant 30 jours

Systèmes : JVM (Windows, Linux, MacOS...)

Langage : Java

Version : 2.0.3

Cet éditeur est spécialisé dans le mode source où il offre une possibilité d'auto-complètement des balises au fur et à mesure qu'on les tape. Il existe aussi un mode arbre, mais qui est malheureusement affiché dans une fenêtre différente.
Configuration de la conversion du document XML vers un autre format intégré à l'interface. Correcteur orthographique intégré.

Source

Jaxe (pour documents Docbook simplifiés)

Licence : GPL

Systèmes : JVM (Windows, Linux, MacOS...)

Version : 1.7

Petit éditeur, simple mais complet, avec la liste des balises possibles accessible facilement

Mode d'édition unique avec balises simples ou sur une ligne.

Aucun raccourci clavier!

Rendu HTML accessible depuis l'interface.

Correcteur orthographique.

Source

Morphon

Cet éditeur est l'un des meilleurs disponibles, et il présente l'avantage d'être distribué gratuitement. Il permet d'éditer le document en mode WYSIWYG[3], avec balises visibles (simples ou encadrant leur contenu) et en mode source (arborescence).
L'éditeur Morphon se compose de deux parts intégrales: le rédacteur de XML et l'éditeur CSS.
Le XML Morphon permet aux utilisateurs de créer des documents XML valides et bien formés. Il aide donc l'utilisateur à écrire des documents selon le type de données choisi (par exemple la DTD Docbook), rendant impossible d'écrire XML de manière incorrect.
Le Morphon CSS-Editor permet aux utilisateurs de créer un modèle visuel pour le XML en utilisant une interface graphique facile. CSS ajoute des styles sur les balises, les listes, la numératotation, l'affichage des images, le rendu de tableaux.
Morphon offre de nombreux avantages :

• Un éditeur de texte presque WYSIWYG et une vue hiérarchique du document.
• Il est possible d'éditer des tableaux et d'afficher des images JPEG et GIF lors de l'édition
• Il est entiérement écrit en Java 2 et est disponible sur beaucoup de plates-formes : Windows, Unix et Mac OS.
• Il possède des avantages comme l'internalisation[4] et la transformation du document en utilisant XSL.
• Il a un correcteur orthographique.

Source

Le document XML créé avec l'éditeur MORPHON est montré dans la figure ci-dessus. A gauche se trouve une fenêtre montrant l'arborescence du document.
A droit en bas se trouve une fenêtre montrant la hiérarchie d'éléments composant la structure logique du document courant est défini par la DTD (dans ce cas de Docbook) Cette structure définit les types des éléments pouvant intervenir dans un document et la façon dont ils peuvent être combinés pour former la structure du document. Par exemple, la structure logique du livre de la DTD Docbook énonce qu'un livre (book) est composé successivement des éléments title, bookinfo, chapter, reference, appendix. Cette structure énonce également qu'un chapter est composé d'un titre du chapter et des paragraphes.
Au milieu, on trouve la fenêtre d'édition pour le rendu avec la feuille de style et l'ajout de texte pour les éléments.
On aurait préféré que l'éditeur n'utilise qu'une seule zone de travail (la fenêtre d'édition), la fenêtre d'arborescence semble utilisé uniquement pour naviguer. De plus, il n'y a pas de lien de la zone d'édition vers la zone de l'arborescence : ce qui engendre des difficultés pour se repérer dans la structure.

Des autres éditeurs XML

Nous avons aussi regardé s'il était éventuellement possible d'utiliser un traitement de texte de type WYSIWYG comme Word ou StartOffice. Ces logiciels ont des avantages comme l'ergonomie et la facilité d'utilisation, mais sont mal adaptés à notre contexte, comme nous l'avons montré dans la rubrique : Les solutions : les documents structurés
Il existe aussi FrameMaker 7.0 de Adobe qui permet de créer et d'éditer des fichier XML, validés en WYSIWYG. Il fonctionne sous Windows, Mac OS et Unix. Ce produit permettra peut-être au professeur d'éditer son livre mais est très cher et il est un peu compliqué de le mettre en œuvre.
Pou finir, on peut voir qu'il n'existe donc pas encore de solution idéale en matière de logiciels pour l'édition de documents, mais on conseillera au professeur d'utiliser l'éditeur MORPHON pour éditer son livre.