<oXygen/> User Guide

Exemples de scénarios de transformation

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 transformation.

  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.

Sortie PDF

  1. Changer le répertoire à [oxygen]/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 répertoire actuel (VotreNomdeFichier.pdf) ou le chemin et le nom du fichier de sortie (C:\RépertoireduFichier\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 répertoire vers [oxygen]/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 répertoire actuel (VotreNomdeFichier.ps) ou le chemin et le nom du fichier de sortie (C:\RépertoireduFichier\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 répertoire vers [oxygen]/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 répertoire actuel (VotreNomdeFichier.txt) ou le chemin et le nom du fichier de sortie (C:\RépertoireduFichier\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 répertoire vers [oxygen]/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 répertoire actuel (VotreNomdeFichier.html) ou le chemin et le nom du fichier de sortie (C:\RépertoireduFichier\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 répertoire vers [oxygen]/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 répertoire de sortie (s'il n'est pas spécifié, le répertoire 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 répertoire vers [oxygen]/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 répertoire de sortie (s'il n'est pas spécifié, le répertoire 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 répertoire vers [oxygen]/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 répertoire actuel (VotreNomdeFichier.html) ou le chemin et le nom du fichier de sortie (C:\RépertoireduFichier\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.