<oXygen/> XML Editor User Guide

Common DocBook transformations

Les exemples suivants utilisent les feuilles de style XSL de DocBook pour illustrer comment configurer <oXygen/> pour la transformation vers différents formats cibles.

Les étapes suivantes sont communes à tous les exemples de procédures ci-dessous.

  1. Régler le focus de l'éditeur sur le document à transformer.

  2. Sélectionner Document->Configurer un scénario de transformation (Ctrl+Shift+C) pour ouvrir le dialogue de configuration de la tr.

  3. Sélectionner l'onglet XSLT.

  4. Cliquer sur le bouton "Parcourir pour un fichier input XSL". Le sélecteur de fichier est affiché.

[Note]Note

Durant les transformations la barre de statut de l'éditeur va afficher "Transformation - en cours". La transformation est terminée avec succès quand le message "transformation XSL réussie" est affiché. Si la transformation rate, le message "transformation XSL ratée" est affiché ainsi qu'une erreur dans le panneau message. L'utilisateur peut stopper le processus de transformation à n'importe quel point en pressant le bouton "Stopper transformation". Dans ce cas, les message affiché dans la barre de statut sera "Transformation stoppée par l'utilisateur".

Sortie PDF

  1. Changer le dossier à [oxygen]/frameworks/docbook/xsl/fo/.

  2. Sélectionner docbook.xsl, cliquer Ouvrir. Le dialogue se ferme.

  3. Sélectionner l'onglet FOP.

  4. Cocher l'option Exécuter le traitement de FO . Les options restantes sont activées.

  5. Sélectionner les options suivantes :

    1. Résultat XSLT en tant qu'input.

    2. PDF en tant que méthode.

    3. Apache FOP intégré en tant que processeur.

  6. Sélectionner l'onglet de Sortie.

  7. Dans le champ Enregistrer sous entrez le nom du fichier de sortie relativement au dossier actuel (VotreNomdeFichier.pdf) ou le chemin et le nom du fichier de sortie (C:\DossierduFichier\VotreNomdeFichier.pdf).

  8. Optionnellement, décocher les cases XHTML et XML dans Montrer comme.

  9. Cliquer Transformer maintenant. La transformation est lancée.

Sortie PS

  1. Changer le dossier vers [oxygen]/frameworks/docbook/xsl/fo/.

  2. Sélectionner docbook.xsl, cliquer Ouvrir. Le dialogue se ferme.

  3. Sélectionner l'onglet FOP.

  4. Cocher l'option Exécuter le traitement de FO . Les options restantes sont activées.

  5. Sélectionner les options suivantes :

    1. Résultat XSLT comme entrée.

    2. PS comme méthode.

    3. Le processeur intégré (Apache FOP) comme processeur.

  6. Sélectionner l'onglet Rendu.

  7. Dans le champ Enregistrer sous entrez le nom du fichier de sortie relativement au dossier actuel (VotreNomdeFichier.ps) ou le chemin et le nom du fichier de sortie (C:\DossierduFichier\VotreNomdeFichier.ps ).

  8. Optionnellement, décocher les cases XHTML et XML dans Montrer comme.

  9. Cliquer Transformer maintenant. La transformation est lancée.

Sortie TXT

  1. Changer le dossier vers [oxygen]/frameworks/docbook/xsl/fo/.

  2. Sélectionner docbook.xsl, cliquer Ouvrir. Le dialogue se ferme.

  3. Sélectionner l'onglet FOP.

  4. Cocher l'option Exécuter le traitement de FO . Les options restantes sont activées.

  5. Sélectionner les options suivantes :

    1. Résultat XSLT comme entrée.

    2. TXT comme méthode.

    3. Apache FOP intégré comme processeur.

  6. Sélectionner l'onglet Rendu.

  7. Dans le champ Enregistrer sous entrez le nom du fichier de sortie relativement au dossier actuel (VotreNomdeFichier.txt) ou le chemin et le nom du fichier de sortie (C:\DossierduFichier\VotreNomdeFichier.txt).

  8. Optionellement, décocher les cases XHTML et XML dans Montrer comme.

  9. Cliquer Transformer maintenant. La transformation débute.

Sortie HTML

  1. Changer le dossier vers [oxygen]/frameworks/docbook/xsl/html/.

  2. Sélectionner docbook.xsl, Cliquer Ouvrir. Le dialogue se ferme.

  3. Sélectionner l'onglet FOP.

  4. Décocher l'option Exécuter FOP. Les options FOP sont désactivées.

  5. Sélectionner l'onglet Rendu.

  6. Dans le champ Enregistrer sous entrez le nom du fichier de sortie relativement au dossier actuel (VotreNomdeFichier.html) ou le chemin et le nom du fichier de sortie (C:\DossierduFichier\VotreNomdeFichier.html ).

    1. Si vos images ne se trouvent pas relativement à l'endroit de la sortie, vérifiez la case XHTML dans Montrer comme.

    2. Spécifier le chemin vers le dossier ou l'URL où les images se trouvent.

  7. Cliquer Transformer maintenant. La transformation commence.

Sortie HTML Help

  1. Changer le dossier vers [oxygen]/frameworks/docbook/xsl/htmlhelp/.

  2. Sélectionner htmlhelp.xsl, cliquer Ouvrir. Le dialogue se ferme.

  3. Voir le paramètre XSLT base.dir, il identifie le dossier de sortie (s'il n'est pas spécifié, le dossier de sortie est dépendant du système).

  4. Sélectionner l'onglet FOP.

  5. Décocher l'option Exécuter FOP. Les options FOP sont désactivées.

  6. Cliquer Transformer maintenant. La transformation commence.

Sortie JavaHelp

  1. Changer le dossier vers [oxygen]/frameworks/docbook/xsl/javahelp/.

  2. Sélectionner javahelp.xsl, cliquer Ouvrir. Le dialogue se ferme.

  3. Règle le paramètre XSLT base.dir, il identifie le dossier de sortie (s'il n'est pas spécifié, le dossier de sortie est dépendant du système).

  4. Sélectionner l'onglet FOP.

  5. Décocher l'option Exécuter le traitement FO . Les options FOP sont désactivées.

  6. Cliquer Transformer maintenant. La transformation débute.

Rendu XHTML

  1. Changer le dossier vers [oxygen]/frameworks/docbook/xsl/xhtml/.

  2. Sélectionner docbook.xsl, cliquer Ouvrir. Le dialogue se ferme.

  3. Sélectionner l'onglet FOP.

  4. Décocher l'option Exécuter le traitement de FO . Les options FOP sont désactivées.

  5. Sélectionner l'onglet Rendu.

  6. Dans le champ Enregistrer sous entrez le nom du fichier de sortie relativement au dossier actuel (VotreNomdeFichier.html) ou le chemin et le nom du fichier de sortie (C:\DossierduFichier\VotreNomdeFichier.html ).

    1. Si vos images ne se trouvent pas dans l'emplacement de la sortie, cochez la case XHTML dans Montrer comme.

    2. Spécifier le chemin vers le dossier ou l'URL où les images se trouvent

  7. Cliquer Transformer maintenant. La transformation débute.