<oXygen/> User Guide |
XML est conçu pour entreposer, diffuser, et échanger des données, pas à afficher des données. Quand on souhaite visualiser les données on doit soit avoir un agent utilisateur compatible XML soit le transformer dans un format qui peut être lu par d'autres agents utilisateur. Ce processus est connu sous le nom de transformation.
Avec la version actuelle de oXygen vous pouvez transformer vos documents XML dans les formats suivants sans avoir à sortir de l'application. Pour la transformation vers des formats non-listés, installez simplement la chaîne d'outils nécessaire pour exécuter la transformation et traiter les fichiers xml créés avec oXygen en accord avec les instructions du processeur.
Le Adobe Portable Document Format (PDF) est un format de fichier binaire compact qui peut être visualisé et imprimé par tout le monde, n'importe où parmi un large éventail de matériels et de logiciels utilisant la visualiseur PDF gratuit de Adobe.
Le PostScript est la technologie d'impression leader de Adobe pour les solutions d'impression de haute qualité depuis les périphériques de bureau jusqu'aux imprimantes numériques les plus avancées et autres systèmes pour les professionnels de l'imprimerie. Les fichiers Postscript peuvent être visualisés en utilisant les visualiseurs comme GhostScript, mais sont plus communément créés en tant que format pré-presse.
Les fichiers texte sont du Plain ASCII Text et peuvent être ouverts dans n'importe quel éditeur de texte ou traitement de texte.
XML signifie EXtensible Markup Language et est un standard du W3C. C'est un langage de formatage, comme HTML, qui a été conçu pour décrire des données. Les balises XML ne sont pas prédéfinies dans XML. Vous devez définir vos propres balises. XML utilise une Document Type Definition (DTD) ou un schéma XML pour décrire les données. XML avec une DTD ou un schéma XML est conçu pour être auto-descriptif. XML n'est pas un remplaçant du HTML. XML et HTML ont été conçus avec des buts différents :
XML a été conçu pour décrire les données et pour se concentrer sur ce que sont les données.
HTML a été conçu pour afficher des données et se concentrer sur le rendu visuel des données.
HTML est pour l'affichage de l'information, XML est pour la description de l'information.
XHTML signifie EXtensible HyperText Markup Language, un standard W3C. XHTML vise à remplacer HTML. Tandis qu'il est presque identique au HTML 4.01, XHTML est une version plus stricte et propre du HTML. XHTML est HTML défini en tant qu'application XML.
Tout le formatage durant une transformation est donné sous le contrôle d'une Extensible Stylesheet (XSLT). Spécifier la XSLT appropriée permet la transformation dans les formats ci-dessus et la préparation des fichiers de sortie pour des applications spécifique de visualisation, dont:
HTML signifie Hyper Text Markup Language et est un standardW3C pour le World Wide Web. HTML est un fichier texte contenant des petites balises de formatage. Les balises de formatage indique au navigateur web comment afficher la page. Un fichier HTML doit avoir une extension de fichier htm ou html. Un fichier HTML peut être créé en utilisant un simple éditeur de texte.
Microsoft HTML Help est le système standard d'aide sur la plateforme Windows. Les auteurs peuvent utiliser HTML Help pour créer une aide en ligne pour un logiciel ou pour créer du contenu pour un titre multimédia ou un site web. Les développeurs peuvent utiliser l'API HTML Help pour programmer une application hôte ou relier une aide contextuelle à une application.
JavaHelp est un système d'aide complet, indépendant de la plateforme et extensible de Sun Microsystems qui permet aux développeurs et aux auteurs d'incorporer une aide en ligne dans les applettes, les composants, les applications, les systèmes d'exploitation, et les périphériques. JavaHelp est un produit gratuit et les binaires pour JavaHelp sont redistributables.
De nombreux autres formats cibles sont possibles, ceci sont les plus populaires. La condition basique pour la transformation vers n'importe quel format est que votre document est valide suivant une DTD donnée et que la XSLT (XSL) utilisée pour la transformation soit compatible avec la DTD.
Une feuille de style XSL spécifie la présentation d'une classe de documents XML en décrivant comment les instances de la classe sont transformées en un document XML qui utilise le vocabulaire de formatage.
XSLT est un langage pour transformer les documents XML.
XPath est un langage d'expression utilisé par XSLT pour accéder ou référer à des parties d'un document XML. (XPath est aussi utilisé par la spécification Linking XML Linking).
XSL-FO est un vocabulaire XML pour spécifier la sémantique de formatage.
Le paquet d'installation de oXygen est distribué avec le ApacheFOP (Formatting Objects Processor). FOP est un formateur indépendant d'impression et de sortie a print piloté par Objets de formatage XSL. FOP est implémenté comme application Java qui lit un arbre d'objets de formatage et rend les pages résultantes vers une sortie spécifiée.
![]() | Astuce |
---|---|
Pour inclure des img PNG dans le document PDF final il vous faut les librairies JIMI ou JAI. Pour les images JAI il vous faut le paquet JAI. Les librairies JIMI et JAI ne sont pas livrées avec Oxygen à cause de la licence de Sun. Les utiliser est aussi facile que les télécharger et copier les fichiers jar nécessaires (requis par la documentation du paquet) dans le sous-répertoire lib du répertoire d'installation de Oxygen. C'est-à-dire JimiProClasses.zip pour JIMI et jai_core.jar, jai_codec.jar et mlibwrapper_jai.jar pour JAI. Pour le paquet JAI il vous faut aussi inclure le répertoire contenant les librairies natives (mlib_jai.dll et mlib_jai_mmx.dll sous Windows) dans la variable système PATH. |
D'autres processeurs de FO peuvent être configurés dans l'option Préférences->Processeurs externes de FO pour l'utilisation dans la transformation de documents.
Avant de transformer le document XML actuellement édité dans Oxygen on doit définir un scénario de transformation à appliquer sur ce document. Un scénario spécifie des valeurs pour divers paramètres définissant une transformation. Il n'est pas lié à un document particulier mais à un type de document :
Un tel scénario contient l'emplacement d'une feuille de style XSLT qui est appliquée sur le document XML édité, et d'autres paramètres.
Un tel scénario contient l'emplacement d'un document XML auquel le fichier XSL édité est appliqué, et d'autres paramètres de transformation.
Le dialogue Configurer un scénario est utilisé pour associer un scénario de la liste de tous les scénarios au document édité en sélectionnant une entrée de la liste. Le dialogue est ouvert en pressant le bouton Configurer un scénario de transformation sur la barre d'outils de la vue du document. Une fois sélectionnée, le scénario sera appliquée en un seul clic sur le bouton Appliquer la transformation de la même barre d'outils. Presser le bouton Appliquer la transformation avant d'avoir associé un scénario au document édité va ouvrir d'abord le dialogue Configurer le scénario puis appliquer le scénario sélectionné.
Ouvrir le dialogue Configuration de la transformation en sélectionnantCtrl+Shift+C).
-> (Compléter le dialogue comme suit:
Utilisez l'onglet XSLT pour spécifier un fichier d'entrée XSL à utiliser pour la transformation. Vous pouvez aussi ajouter des paramètres XSLT et joindre les URL des en-tête et pied de page pour leur inclusion dans la transformation. Pour appliquer une cascade de feuilles de style l'utilisateur peut régler la liste des feuilles de style appliquées après la feuille de style depuis le champ XSL URL du bouton "Cascade de feuille de style". L'utilisateur peut choisir entre Xalan et Saxon lors de la configuration de la transformation. Saxon est plus rapide sur les feuilles de style de Docbook.
Utiliser l'onglet FOP pour activer/désactiver l'utilisation du FOP durant une transformation. L'input FOP peut être donné depuis la sortie XSLT ou la source du document édité. oXygen est livré avec le FOP d'Apache, mais supporte la définition et l'usage d'un processeur d'une tierce partie. La méthode de sortie par défaut est réglée pour utiliser le PDF, mais PS et TXT sont aussi configurés. Vous pouvez ajouter et définir n'importe quelle méthode supportée par votre FOP.
Utiliser l'onglet Rendu pour spécifier le chemin de sortie où les fichiers cibles de sortie seront sauvés. Lors de l'exécution d'une transformation XHTML le chemin relatif pour l'emplacement des images doit être donné afin d'assurer que les chemins des images seront correctement résolus pour les afficher dans les fichiers de sortie. Si on utilise FOP ceci n'est pas nécessaire car les images seront intégrées dans lePDF ou le PS. Cette option sera par conséquent désactivée durant la transformation FOP.
La liste des cascades de feuilles de style peut être éditée dans le dialogue ouvert par le bouton "Cascade de feuilles de style".
Ajoute une feuille de style dans la liste de "Cascade des feuilles de style" en utilisant le dialogue d'un sélecteur de fichiers, vous pouvez aussi entrer une macro dans le champ nom du fichier du sélecteur de fichiers. Le nom de la feuille de style sera ajouté dans la liste après la sélection actuelle.
Ouvre un dialogue dans lequel vous pouvez taper le nom d'une feuille de style. Le nom est considéré en relation à l'URL du document XML actuellement édité. Vous pouvez utiliser des macros dans le nom de la feuille de style. Le nom de la feuille de style sera ajouté dans la liste après la sélection actuelle.
Enlève la feuille de style sélectionnée de la liste de "Cascade de feuilles de style".
Ouvre la feuille de style sélectionnée dans une vue séparée.
Augmente d'une place la feuille de style sélectionnée dans la liste.
Baisse d'une place la feuille de style sélectionnée dans la liste.
Dans les champs réservés pour : URL d'entrée (XSL URL ou XML URL, suivant le type de scénario), URL d'en-tête, URL de pied, les URL dans la liste de cascade de feuilles de style, URL du fichier de sortie (le champ Enregistrer sous dans l'onglet Sortie), URL de la base d'images, l'utilisateur peut utiliser les macros suivantes :
répertoire du fichier actuel - le chemin du document actuellement édité jusqu'au nom du répertoire parent
nom du fichier actuel - le nom du fichier actuellement édité sans extension ni répertoire parent
le chemin du répertoire d'utilisateur
Utiliser la procédure suivante pour créer un scénario.
SélectionnerCtrl+Shift+C) pour ouvrir le dialogue de Configuration de la transformation.
-> (Cliquer sur
pour créer une copie du "scénario" actuel.Double-cliquer dans le champ "Nom" pour sélectionner le texte existant.
Entrer un nouveau nom.
Cliquer
ou pour sauver le "scénario".Si quelqu'un appuie sur le bouton de la barre d'outils Appliquer le scénario de transformation, il n'y a actuellement aucun scénario associé au document édité et celui-ci contient une instruction de traitement "xml-stylesheet" faisant référence à une feuille de style XSLT (utilisée communément pour l'affichage dans les navigateurs internet), puis Oxygen va offrir à l'utilisateur la possibilité d'associer le document avec un scénario intégré par défaut dans le champ URL XSL l'URL de l'attribut href de l'instruction de traitement. Ce scénario aura la case "Utiliser la déclaration xml-stylesheet" cochée par défaut, utilisera Saxon comme moteur de transformation, n'exécutera aucun traitement FO et enregistrera le résultat dans un fichier avec la même URL que celle du document édité sauf que l'extension passera à html. Le nom et le chemin seront préservés car par défaut lenom du fichier de sortie est spécifié en terme de deux macros : ${cfd} et ${cfn}.
L'option d'Exporter des scénarios de transformation est utilisée pour sauver tous les scénarios dans un fichier séparé, un fichier de propriétés. Dans ce fichier seront sauvées aussi les associations entre URL de documents et scénarios. Les URL sauvées sont absolues. Vous pouvez charger les scénarios sauvés en utiliisant l'option Importer scénarios de transformation, tous les scénarios importés auront le mot 'import' ajouté dans leur nom.