Les documents écrits en SGML peuvent être validés afin de vérifier la conformité de leur syntaxe et de leur structure à la DTD la décrivant. La validation commence par l'analyse de la syntaxe du document, puis continue par la vérification du contexte dans lequel apparaissent les éléments écrits. Ainsi, lorsqu'un élément se trouve dans un contexte non prévu, une erreur est déclenchée.
Une fois validés, les documents sont prêts à être publiés, c'est-à-dire à être transformés en une forme affichable ou imprimable. Cette publication passe par la transformation du document SGML en une autre forme grâce à une feuille de style. Les feuilles de style sont écrites dans un langage décrivant la transformation de sa structure en présentation. Un exemple de langage de description de feuille de style est DSSSL.
Les outils utilisés pour manipuler un document AlcoveBook sont
alcovebook2pdf, pour la conversion vers le PDF (via LaTeX), avec une table des matières cliquable. C'est le format primaire des documentations sortant d'Alcôve ;
alcovebook2ps, pour la conversion vers le PostScript (via LaTeX) ;
alcovebook2html, pour la conversion vers l'HTML.
Tous ces outils utilisent la même syntaxe pour la prise en compte des arguments, à savoir: alcovebook2x fichier.sgml. Il est possible de spécifier un style particulier à la compilation, en utilisant l'option -s style. Ainsi, pour construire une version PostScript d'une proposition technique: alcovebook2ps -s proposal propale.sgml.
Ces outils sont des scripts shells qui utilisent le parseur jade pour effectuer la transformation d'un document SGML en un document d'un format cible.
Cette section décrit quelques erreurs à la transformation parmi les plus fréquentes:
cette erreur est dûe généralement à un élément fermant utilisé alors que l'élément ouvrant correspondant n'a pas été utilisé. Cette erreur peut de plus être dûe à l'absence d'un élément obligatoire dans un contexte donné ;
l'entité &plop;
a été utilisée sans
être définie ;
l'élément ouvrant computeroutput
a été utilisé
mais n'a pas été refermé. Certains éléments permettent
l'omission de l'élément fermant, mais il ne s'agit pas
d'un cas général ;
les données textuelles ne sont pas autorisées dans un contexte donné.
Notez que l'écriture d'un fichier Makefile est obligatoire pour tous les documents placés dans l'espace CVS interne d'Alcôve. Nous recommandons que tous les documents rédigés en alcovebook soient placés sous CVS. De plus et afin de garantir la consistance des Makefile pour alcovebook, nous recommandons l'inclusion d'un fichier contenant des macros make dans votre Makefile. Ce fichier est situé sous CVS et s'appelle alcove/commun/make/alcovebook. L'inclusion de ce fichier doit se faire en utilisant la commande include de make et en utilisant un chemin relatif à la position de votre document dans l'arborescence CVS.