Mettre à jour une extension personnalisée

Publication des sources DITA Leçon 4 : Extensions personnalisées Mettre à jour une extension personnalisée
Progression de la Leçon
0% Terminé

Une des raisons les plus courantes pour mettre à jour le style d’une extension personnalisée est un changement de marque de l’entreprise. Vous devrez peut-être également mettre à jour une extension personnalisée pour tenir compte des changements apportés à la structure du contenu source, par exemple, ajouter un nouvel élément à votre spécialisation ou vous spécialiser pour la première fois.

La personnalisation des extensions DITA OT est difficile et nécessite de nombreux tests pour s’assurer que les mises à jour de l’extension entrainent les résultats souhaités dans la publication. Des connaissances spéciales sont nécessaires pour personnaliser les extensions ou mettre à jour les extensions personnalisées, comme la connaissance de Ant, XSL, et DTD pour l’architecture de l’extension de base, plus d’autres connaissances sur la sortie y compris XHTML, JavaScript et XSL-FO. C’est pourquoi la plupart des entreprises engagent un expert – qu’il s’agisse d’un consultant externe ou d’un employé interne – pour personnaliser les extensions.

CSS, ou feuilles de style en cascade, peut être utilisé pour modifier l’apparence de la sortie à partir de l’extension xhtml. Parce que beaucoup de gens ont une connaissance basique de CSS, une entreprise peut ne pas avoir besoin d’embaucher un expert si le seul type de sortie requis est XHTML et si tous les aspects de l’image de marque peuvent être manipulés par des modifications du CSS.

Les instructions suivantes vous montrent comment effectuer des mises à jour simples du CSS pour votre extension ld_xhtml personnalisée et générer une sortie XHTML pour tester les résultats.

Exercice
  1. Placez-vous dans votre dossier sorties/sortie_perso et ouvrez le fichier c_especes_canards_sauvages.html dans un navigateur.

    La sortie XHTML ressemble à :

  2. Placez-vous dans votre dossier dita-ot-x.x/plugins/com.learningdita.ld_xhtml/resource et ouvrez le fichier ld_style.css dans un éditeur de texte.
  3. Réalisez les modifications suivantes dans ld_style.css :

    (Les zones où des changements sont requis sont indiquées en gras et en surbrillance.)

    .p {
  margin-top: 1em;
  font-family: "Lingua Franca", Palatino, serif;
  font-size: 0.9em;
  color: #D48028;
}

.topictitle1 {
  margin-top: 0;
  margin-bottom: .1em;
  font-size: 2em;
  font-family: "Gill Sans", Helvetica, sans-serif;
  font-weight: normal;
  color: #86CCCC;
}
  4. Enregistrez vos changements dans ld_style.css.
  5. Saisissez les commandes suivantes dans un terminal de commande pour tester les mises à jour de votre extension personnalisée :

    Sur Windows :

    bin\dita -i [cheminfichier]/sources/canards/m_canards.ditamap -f ld_xhtml -o sorties/sortie_perso -v

    Sur Mac :

    ./bin/dita -i [cheminfichier]/sources/canards/m_canards.ditamap -f ld_xhtml -o sorties/sortie_perso -v
  6. Appuyer sur ENTRER pour lancer DITA OT.
  7. Regardez dans votre dossier sortie_perso pour voir votre sortie XHTML personnalisée générée.
  8. Ouvrez c_especes_canards_sauvages.html dans un navigateur pour voir les changements CSS que vous avez réalisés.

    La sortie XHTML ressemble maintenant à :

Contributeurs
Chapitre précédent
Retour à la Leçon
Chapitre suivant