Articles

  1. Lios
  2. Utiliser les boîtes de contenu dans MadCap Flare : Trucs et astuces
04/072023

Utiliser les boîtes de contenu dans MadCap Flare : Trucs et astuces

Dans la partie 1, vous avez appris comment créer des boîtes de contenu pour des publications au format HTML5 et PDF dans Flare. Dans la partie 2, nous vous donnerons quelques stratégies pour vous aider à utiliser les boîtes de contenu efficacement dans MadCap Flare.

Ajouter une boîte de contenu

Il y a différentes façons d’ajouter une boîte de contenu dans la rubrique sur laquelle vous travaillez. Pour utiliser ces méthodes, créez une rubrique dans votre projet avec des copies de tous les styles que vous utilisez dans votre document, incluant les boîtes de contenu. Vous pouvez nommer ce document modele.htm ou un autre titre similaire.

Copier le code

  1. Allez à modele.htm.
  2. Copiez tout le div de la boîte de contenu que vous voulez utiliser. Vous pouvez le faire en cliquant sur le sélecteur div sur le côté gauche de l’éditeur XML et en appuyant sur Ctrl+C.
    Boîte Danger dans l'éditeur XML de Flare. Le div est sélectionné et son contenu est surligné.
  3. Collez-le dans la page sur laquelle vous travaillez, puis modifiez le contenu.

Conseil : L’espacement dans la boîte, comme l’indentation de p.BoiteDeContenu, pourrait ne pas s’afficher correctement dans l’éditeur XML. Pour vous assurer que l’espacement est correct, générez et affichez la cible.

Utiliser un snippet

  1. Allez à template.htm.
  2. Survolez le div de la boîte que vous voulez utiliser. Cliquez à droite et sélectionnez  Créer un snippet.

    Conseil : Assurez-vous de sélectionner le div au complet et pas seulement le texte à l’intérieur de la boîte.

  3. Dans la fenêtre Créer un snippet :
    1. Donnez un nom pertinent à votre snippet et mettez-le dans le dossier approprié.
    2. Décochez la case Remplacer le contenu source par le nouveau snippet.
    3. Cliquez sur Créer.
      Fenêtre Créer un snippet dans Flare montrant la boîte Danger. Vous pouvez modifier le nom de fichier et le dossier, et voir à quoi ressemble le snippet. Il y a une case décochée dans le bas de la fenêtre qui dit, "Remplacer le contenu source par le nouveau snippet".
  4. Dans la rubrique sur laquelle vous travaillez, allez à Insérer > Snippet dans le ruban du haut. Sélectionnez le snippet de la boîte de contenu que vous voulez utiliser et cliquez sur OK.
    1. Si vous devez ajouter d’autres boîtes de contenu du même type ailleurs, vous pouvez épingler le snippet de la boîte de contenu dans la fenêtre Insérer un lien de snippet en survolant la ligne du snippet et en cliquant sur l’icône de punaise qui apparaît.
      Icône de punaise qui apparaît à côté du snippet.
  5. Cliquez à droite sur le div et sélectionnez Convertir en texte.
    Option "Convertir en texte" pour les snippets dans Flare.
  6. Modifiez le contenu de la boîte de contenu.

 

Ajouter du nouveau contenu dans une boîte

Une des façons d’ajouter du nouveau contenu dans une boîte est d’ajouter le contenu dans la rubrique Flare, puis de l’envelopper dans un div. C’est une bonne stratégie à adopter pour les boîtes dans lesquelles la hauteur de la ligne de l’icône empiète sur la hauteur de la ligne du texte, quand ce texte comprend une seule ligne, ce qui le rend difficile à sélectionner dans l’éditeur XML.

Pour ce faire :

  1. Copiez-collez la boîte de contenu dont vous avez besoin en utilisant une des méthodes décrites plus haut.
  2. Dans un paragraphe sous la boîte de contenu, ajoutez le contenu que vous voulez mettre dans la boîte. Ajoutez à cette étape tout élément dont vous avez besoin, comme des conditions, des références croisées et des variables.
  3. Supprimez le texte qui est dans la boîte de contenu.
  4. Sur le côté gauche de l’éditeur, cliquez à droite sur le sélecteur du paragraphe dans lequel se trouve votre nouveau contenu, puis cliquez sur Déplacer > Faire monter.

    Conseil : Les styles de listes habituels devraient s’afficher correctement dans la boîte s’ils sont précédés par p.BoiteDeContenu et si la propriété de remplissage (padding) du haut pour les styles de listes est définie à 0 dans div.BoîteDeContenu.

  5. Répétez les étapes 4 et 5 pour le reste de votre contenu. Si le style p.BoiteDeContenu utilise un remplissage du haut négatif, utilisez le style p.BoiteDeContenu2 au besoin.
    A GIF showing how to wrap text in a content box div.

Modifier le contenu à l’intérieur de la boîte

Si vous devez modifier le contenu existant d’une boîte de contenu, voici quelques façons de le faire :

  • Cliquez sur le div que vous voulez modifier. Ensuite, allez dans l’onglet Éditeur de texte pour y modifier le contenu. Le code du div que vous avez sélectionné sera déjà surligné. Faites vos modifications dans l’Éditeur de texte.
    Code d'une boîte Danger surligné dans l'éditeur HTML de Flare.
  • Pour modifier du texte, cliquez à l’intérieur de la boîte de contenu, appuyez sur la touche de déplacement vers le bas de votre clavier, puis appuyez sur la touche de déplacement vers la droite. Cela vous amènera à la bonne ligne pour pouvoir modifier le texte. Pour sélectionner du texte, gardez la touche Majuscule enfoncée et appuyez sur la flèche de déplacement pour aller dans la direction du texte à sélectionner.

 

Des boîtes de contenu bien formées peuvent vous aider à diviser votre documentation en petits blocs et à faire ressortir l’information importante. Avec cette série d’articles, vous serez capable de créer des boîtes de contenu faciles à utiliser dans vos projets Flare.