Prise en main des applications structurées

Prenez en main les applications structurées et découvrez l’importance du formatage dans une application structurée.

Dans FrameMaker non structuré, la configuration d’un environnement de création de documents nécessite un seul fichier modèle. Le fichier modèle définit les formats et les styles, tandis qu’un guide de style définit l’utilisation correcte du modèle. Dans FrameMaker structuré, un modèle structuré ne suffit pas.

Pour établir un environnement de création de documents structurés de base dans FrameMaker, une EDD ou une DTD sont nécessaires. Vous pouvez créer vos propres EDD et DTD ou utiliser des EDD et des DTD prêts à l’emploi. En outre, vous devez associer les définitions d’éléments aux informations de formatage. Vous pouvez lier au formatage des éléments dans le document EDD de trois manières différentes :

Modèle de formatage

Vous pouvez assigner le formatage en fonction des diverses balises (étiquettes de paragraphes, de caractères, etc.) d’un modèle. Si vous disposez déjà d’un modèle de formatage, vous pouvez réutiliser les informations qu’il contient.

Listes de modifications du formatage

Vous pouvez créer des définitions de formatage nommées dans l’EDD. Les listes de modifications du formatage vous permettent de fournir des spécifications de formatage partielles et d’hériter du reste à partir de quelques étiquettes de paragraphes de base. Vous pouvez réutiliser les listes de modifications du formatage pour les éléments associés.

Formatage incorporé

Vous pouvez préciser le formatage en l’incorporant dans chaque définition d’élément.

Une fois l’EDD et le formatage créés, vous pouvez associer les deux composants pour créer un modèle structuré unique. Pour créer ce modèle structuré, vous devez ouvrir le modèle de formatage et importer les définitions d’éléments (Fichier > Importer > Définitions d’éléments) à partir de l’EDD. Le fichier créé correspond à votre modèle structuré.

En plus de l’EDD et du modèle structuré, les éléments suivants sont nécessaires :

Règles de lecture/écriture

Les règles de lecture/écriture contrôlent la conversion de la structure FrameMaker en XML et inversement. Plus particulièrement, ces règles contribuent à la gestion des conversions de tableaux et autres formatages complexes.

Application structurée

L’application structurée répertorie tous les fichiers de composants de votre mise en œuvre de structure et fournit des informations de configuration. Par exemple, vous pouvez utiliser l’application structurée pour indiquer s’il est nécessaire d’exporter le balisage de texte conditionnel et de quelle manière.

Modèles structurés

Toutes les applications structurées FrameMaker doivent disposer de modèles structurés. Les modèles structurés FrameMaker contiennent les définitions de tous les éléments qui peuvent être utilisés dans le document, ainsi que leurs options de mise en page et de formatage.

Les modèles structurés sont similaires aux modèles non structurés, mais ils diffèrent principalement au niveau du catalogue Eléments.

Le catalogue Eléments contient les définitions d’éléments définies dans l’EDD. La première étape de création d’un document structuré consiste à importer les définitions à partir d’une EDD ou d’une DTD. Les définitions d’éléments dans une EDD ou une DTD sont renseignées dans le Catalogue d’éléments. La catalogue Eléments vous permet d’insérer des éléments valides dans votre document et de créer une structure conforme aux règles définies dans l’EDD.

Analyse du contenu

Le terme analyse du contenu décrit une procédure d’examen des documents existants afin de comprendre leur conception et leur structure explicite. Commencez votre analyse en dressant une liste des documents produits par votre entreprise. Votre liste peut comprendre des guides d’utilisateur, des guides de référence, des livres blancs, des tutoriels, des manuels de formation et de l’aide en ligne. Dressez la liste des principaux composants pour chaque type de document. Pour chaque composant, indiquez si l’élément est obligatoire ou facultatif et sa fréquence dans le document. Le tableau suivant présente une analyse de haut niveau pour un livre.

Composant

Exigence

Occurrence

Garde

Obligatoire

1

Table des matières

Obligatoire

1

Préface

Facultatif

0 ou 1

Chapitre

Obligatoire

2 ou plus

Annexe

Facultatif

0 ou plus

Glossaire

Facultatif

0 ou 1

Index

Obligatoire

1

Pour les principaux composants, tels que les leçons (des manuels de formation) ou les chapitres (des livres), divisez la hiérarchie en catégories toujours plus restreintes jusqu’à accéder au niveau le plus bas de la hiérarchie.

Vous devez procéder à une analyse du contenu pour chaque type de document que vous souhaitez créer dans votre environnement structuré. Lorsque vous avez développé un modèle de contenu pour chaque document, vous pouvez rechercher les possibilités d’affiner le modèle et de réutiliser des noms. Admettons par exemple qu’un document à publier intitulé Aide se compose de rubriques et que les chapitres d’un livre le soient également. En créant un élément Rubrique pouvant être utilisé à la fois pour les documents imprimés et en ligne, vous réduisez d’autant le nombre d’éléments de votre définition de structure et pourrez éventuellement réutiliser les informations pour les deux formats de sortie.

Rubrique imprimée

Rubrique en ligne

Rubrique associée

Rubrique

Rubrique

Rubrique

Titre

Titre

Titre

Para

Para

Para

Etapes

Etapes

Etapes

Peut contenir les éléments Para, Liste, Tableau, Graphique, Note

Peut contenir les éléments Para, Liste, Tableau

Peut contenir les éléments Para, Liste, Tableau, Graphique, Note

RubriquesConnexes

RubriquesConnexes

Il est peu probable que tous vos documents soient parfaitement cohérents. Vous devez décider de créer une structure souple (permettant de nombreuses variations) ou stricte (permettant très peu de variations). Vous rencontrerez certaines difficultés, quelle que soit l’option retenue :

Il est très difficile de trouver le juste équilibre entre ces deux extrêmes. Une approche consiste à autoriser les variations uniquement lorsqu’elles ajoutent de la valeur.

Remarque : Un problème similaire se présente lors de la création de modèles FrameMaker non structurés. Vous devrez réduire le nombre de balises à gérer tout en mettant à disposition toutes les balises nécessaires à la création de votre contenu.

Une fois l’analyse terminée, vous pouvez choisir entre utiliser une structure existante ou concevoir la vôtre. De nombreuses mises en oeuvre XML sont disponibles ; DocBook et Darwin Information Typing Architecture (DITA) sont les spécifications utilisées pour la documentation technique. Des structures standard sont également définies pour les documents militaires (mil-specs ou mil-standards), les documents de maintenance aérienne et bien d’autres encore. Le tableau suivant décrit certains des facteurs qui peuvent influencer votre décision quant à l’utilisation d’une spécification standard ou à la création de votre propre structure.

Utilisation d’une structure standard

Création de votre structure

Vous devez fournir du contenu respectant la norme. Par exemple, de nombreux fournisseurs de l’armée américaine doivent fournir de la documentation conforme à une norme publiée.

Vous souhaitez créer une structure correspondant précisément à votre analyse du contenu.

Vos exigences en matière de contenu correspondent exactement à une structure existante. Vous devez uniquement apporter quelques modifications mineures à la structure standard.

Votre analyse du contenu indique que vos informations ne correspondent pas vraiment aux structures existantes.

Vous ne voulez pas passer trop de temps à créer une structure et souhaitez modifier l’organisation de votre contenu pour l’adapter à une structure existante.

La structure doit correspondre précisément au contenu.

Une période de mise en œuvre plus longue représente un coût acceptable pour vous assurer de développer précisément ce dont vous avez besoin.

Vous ne disposez pas du savoir-faire technique ou des ressources nécessaires pour développer votre propre structure.

Vous disposez de ressources (internes ou consultants) qui peuvent concevoir la structure.

Eléments

Les composantes de base des documents structurés sont les éléments. Ils représentent les parties du contenu d’un document (son texte, ses graphiques, etc.). L’ensemble de ces éléments constitue la structure du document. Les éléments peuvent être simples ou complexes.

Un élément simple en langage XML contient uniquement du texte. Un élément complexe peut avoir des attributs et peut :

Les éléments peuvent disposer de valeurs comprises dans une plage de valeurs valides.

Tous les documents structurés de FrameMaker utilisent des éléments. Chaque élément possède un nom, ou une balise, tel que <section>, <title>, ou <p>. Ce sont les définitions d’éléments du document qui vont déterminer les balises d’élément disponibles.

Attributs

Les attributs fournissent des informations supplémentaires sur un élément. Par exemple, le concepteur de DTD d’un manuel peut utiliser un attribut nommé version pour son élément de livre afin d’autoriser l’utilisateur à spécifier de statut de révision d’un livre. Dans FrameMaker, les attributs d’un élément font partie de la définition de l’élément même. Dans XML ou SGML, les attributs d’un élément existent séparément dans la DTD, dans une déclaration de liste de définition d’attributs (ATTLIST).

La valeur des attributs peut être par défaut ou fixe. Les attributs peuvent être obligatoires ou optionnels. Par exemple, si vous avez un élément de rubrique, l’ID de la rubrique peut être un attribut obligatoire afin de permettre les références croisées dans les rubriques. Il est également possible d’avoir des plages de valeurs pour les attributs ou d’énumérer les valeurs autorisées d’un attribut.

Règles d’éléments

Les sept règles suivantes contrôlent l’utilisation des éléments selon leur séquence, leur nombre d’occurrences et leur groupe.

Tous

Indique que les éléments enfants peuvent se trouver dans toutes les séquences à condition qu’ils apparaissent au moins une fois.

Choix

Indique que l’occurrence d’un élément enfant est possible.

Séquence

Indique l’ordre d’affichage des éléments enfants.

minOccurs

Indique le nombre d’occurrences minimum d’un élément enfant.

maxOccurs

Indique le nombre d’occurrences maximal d’un élément enfant.

Groupes d’éléments

Les éléments peuvent être regroupés sous une déclaration de groupe.

Groupes d’attributs

Les attributs peuvent être regroupés sous une déclaration attributeGroup.

Schémas XML

Un schéma XML définit les composantes autorisées d’un document XML. A la différence de l’EDD, les fichiers DTD et de schéma ne fournissent pas d’informations de formatage.

Les schémas XML définissent :

Espace de noms XML

Les espaces de noms XML permettent à un document de contenir des éléments XML et des attributs provenant de langages différents sans que cela entraîne des collisions de noms.

Ouverture ou importation d’un schéma

Vous pouvez importer un document XML faisant référence à un fichier de schéma et vous pouvez indiquer un fichier de schéma dans votre application structurée afin de l’utiliser pour valider un document lors de son exportation au format XML.

Pour indiquer le fichier de schéma à utiliser lors de l’exportation vers XML, modifiez le fichier structapps.fm. L’élément Schema, un enfant de l’élément XMLApplication, spécifie le chemin d’accès à un fichier de schéma pour l’exportation.

Création d’une EDD

Apprenez à créer des EDD dans FrameMaker en choisissant une stratégie adaptée.

Un document EDD est un document structuré. Les fonctionnalités de modification structurées permettent de créer et de modifier les documents EDD.

Le document EDD contient les règles de structure du document (DTD, Document Type Definition) et les règles de style qui régissent les styles appliqués à des éléments spécifiques. L’EDD est souvent conçue par un développeur à partir de rien ou à partir d’un fichier DTD existant. Pour plus d’informations, consultez le document Références de développement d’application structurée.

Vous trouverez ci-dessous les étapes de base pour commencer la création de documents structurés dans FrameMaker.

Analyse des exigences

Avant de créer le modèle de devis, analysez les devis existants pour identifier leurs composants. En fonction de cette analyse, créez un plan du contenu. L’exemple de devis respecte l’ordre suivant :

  1. Titre

  2. Résumé : Titre, Un paragraphe

  3. Description du projet : Titre, Un ou plusieurs paragraphes

  4. Coût : Titre, Un ou plusieurs paragraphes

  5. Planification : Titre, Un ou plusieurs paragraphes

Remarque : Vous pouvez probablement développer l’EDD de ce simple exemple sans analyse formelle du contenu. Pour les projets plus complexes, en revanche, l’analyse du contenu est essentielle.

Choix d’une stratégie EDD

Il existe plusieurs méthodes de création d’une EDD :

  • Créer vous-même un fichier EDD complet

  • Importer un fichier DTD ou un schéma pour créer une EDD contenant des définitions de structure

  • Utiliser un tableau de règles de conversion pour structurer un document type existant, puis créer une version provisoire de l’EDD qui contient des définitions d’éléments de base et un formatage qui correspond à votre modèle non structuré

  • Modifier une EDD existante : soit un des modèles fournis avec FrameMaker, soit une EDD issue d’une autre source.

Conception de l’EDD du devis

En fonction de l’analyse du contenu, vous pouvez à présent créer l’EDD du devis.

  1. Vérifiez que vous exécutez FrameMaker structuré. Pour passer de FrameMaker non structuré à la version structurée, sélectionnez Fichier > Préférences > Général. Dans le menu déroulant Interface produit, sélectionnez FrameMaker structuré. Fermez et redémarrez FrameMaker.

  2. Sélectionnez Structure > EDD > Nouvelle EDD pour créer un fichier EDD. Les éléments par défaut sont insérés dans l’EDD.

    Remarque : L’EDD est un document FrameMaker structuré. Pour créer l’EDD, vous pouvez utiliser le même environnement d’édition assistée que pour les autres documents structurés.
  3. Sélectionnez Structure > Vue de la structure pour afficher le conteneur Vue de la structure.

  4. Créez l’élément Devis de niveau supérieur. <> Positionnez votre curseur à droite de la bulle Balise dans la Vue de la structure, puis entrez Devis. Pendant la saisie, les lettres s’affichent à la fois dans la Vue de la structure et dans la fenêtre de document.

  5. Ouvrez le catalogue Eléments.

  6. Dans la Vue de la structure, cliquez à droite du carré rouge (qui indique que des informations supplémentaires sont requises). Notez que le contenu du catalogue Eléments change en fonction du nouvel emplacement du curseur. Dans le catalogue Eléments, sélectionnez Contenant, puis cliquez sur Insérer. L’élément de type <Contenant> et un élément enfant <RègleGénérale> sont insérés. La règle générale indique quels sont les éléments autorisés dans le devis. Lors de l’analyse de contenu, vous avez identifié ce qui suit : le titre, le résumé, la description du projet, le coût et la planification.

  7. Saisissez une règle générale pour Devis : Titre, Résumé, DescriptionProjet, Coût, Planification

    Remarque : Les noms d’éléments ne peuvent pas contenir d’espaces.
  8. Insérez un élément NiveauSupérieurValide en tant que frère de l’élément RègleGénérale. <><> Pour ce faire, cliquez sous l’élément <RègleGénérale> pour positionner le curseur. Cliquez ensuite sur l’élément <NiveauSupérieurValide> du catalogue Eléments, puis cliquez sur Insérer.

L’élément Devis est complet. <> Vous devez maintenant définir chacun des éléments enfants : <Résumé>, <DescriptionProjet>, <Planification> et <Coût>.

Définition des éléments enfants

  1. Placez votre curseur au bas de la structure.

  2. A l’aide du catalogue d’éléments, insérez une bulle Elément. Nommez l’élément <Résumé>, faites-en un contenant et indiquez le texte suivant en tant que règle générale : Titre, Para+

  3. Répétez l’étape 2 pour définir les éléments restants. Les règles générales sont présentées dans le tableau suivant :

    Menus d’

    élément

    Règle générale

    DescriptionProjet

    Titre, Para+

    Coût

    Titre, Para+

    Schedule

    Titre, Para+

    Titre

    <TEXTE>

    (Saisissez le mot TEXTE entre crochets.)

    Para

    <TEXTE>

    (Saisissez le mot TEXTE entre crochets.)

  4. Enregistrez votre fichier EDD sous le nom EDD_devis.fm.

Ajout du formatage à l’EDD

Vous venez de concevoir une EDD fournissant la structure d’un devis simple. Toutefois, lorsque vous saisissez du contenu, aucun formatage n’est appliqué.

La section suivante explique comment définir le formatage et comment insérer automatiquement le texte correct pour les différents titres. Par défaut, le texte utilise l’étiquette de paragraphe Corps.

Modification de la définition de l’étiquette Courant

  1. Dans structured_proposal.fm, sélectionné Format > Paragraphes > Configuration de paragraphes puis modifiez la définition par défaut des styles de paragraphe Corps et Entête1. Par exemple, modifiez la police ou ajoutez une ligne au-dessus d’Entête1. Pour mettre vos modifications en évidence, vous pouvez également assigner des couleurs uniques aux deux balises.

  2. Dans devis_EDD.fm, modifiez la définition de l'élément <Para> pour inclure une règle de formatage. Pour indiquer que <Para> doit toujours utiliser l’étiquette de paragraphe Corps, cliquez sous l’élément <RègleGénérale>, ajoutez un élément <RèglesFormatageTexte>, puis ajoutez un élément <BaliseFormatagePgfElément>. Entrez Corps en tant que texte de l’élément BaliseFormatfPgfElément.<>

    Pour l’élément Titre, vous avez besoin de règles de formatage plus complexes. <> <Le titre doit automatiquement afficher le titre des sections, notamment Résumé, Description du projet, etc. > Vous devez rédiger une règle contextuelle précisant le texte à afficher pour chaque type de titre et spécifier que le <Titre> utilise la balise de paragraphe Entête1.

  3. Dans devis_EDD.fm, modifiez la définition de l’élément <Titre> de façon à utiliser la balise de paragraphe Entête1. Ajoutez les éléments <RèglesFormatageTexte> et <BaliseFormatagePgfElément> comme vous l’avez fait pour l’élément <Para>.

    Remarque : à l’instar des étiquettes de paragraphe, les informations saisies respectent la casse et les espaces. Par exemple, « Entête1 » est différent de « entête1 » ou « Entête 1 ».

Ensuite, ajoutez une règle de préfixe à l’élément Titre. <> Les règles de préfixe vous permettent d’indiquer le texte qui doit s’afficher au début de l’élément. En fonction de la position du Titre, indiquez le texte à afficher.

Ajout d’une règle de préfixe

  1. Placez votre curseur sur l’élément <Titre> pour insérer un élément enfant de <Contenant> après <RèglesFormatageTexte>.

  2. Insérez un élément <RèglesPréfixe>.

  3. Insérez un élément RègleContexte. <> Les éléments <Si> et <Spécification> sont automatiquement insérés. Pour le texte <Spécification>, saisissez Résumé.

  4. Placez votre curseur sous l’élément Spécification, puis insérez un élément Préfixe.

  5. Pour le texte de l’élément Préfixe, saisissez : Résumé

  6. Répétez les étapes 3 à 5 pour les autres éléments qui ont besoin de titres (<DescriptionProjet>, <Planification>, et <Coût>) et insérez le texte approprié pour chaque préfixe.

Test des résultats

  1. Enregistrez l’EDD.

  2. Importez les définitions d’éléments dans votre fichier devis_structuré pour tester les résultats. Chaque section doit afficher le texte de titre que vous avez indiqué.

Test de l’EDD

Pour tester l’EDD, vous devez l’importer dans un document, puis vérifier que vous pouvez créer la structure souhaitée. Aucun formatage n’est alors appliqué au document, mais il est tout de même possible de vérifier la structure.

  1. Créez un document vierge, d’orientation portrait, en cliquant sur Fichier > Nouveau > Docuement, puis cliquez sur Portrait.

  2. Assurez-vous que l’EDD et le nouveau fichier de document sont tous les deux ouverts. Dans le nouveau document, sélectionnez Fichier > Importer > Définitions d’éléments. Dans le menu déroulant Importer du document, sélectionnez le fichier devis_EDD.fm, puis cliquez sur Importer.

    Remarque : Si votre EDD ne figure pas dans la liste, vérifiez que le fichier est ouvert et que vous l’avez enregistré. Tant qu’il n’est pas enregistré, le document ne figure pas dans cette liste.

    Les définitions de structure de votre EDD sont importées dans le document vierge. Pour vérifier que les définitions ont bien été importées, positionnez le curseur dans le flux de texte principal, puis affichez le catalogue Eléments. Vous devriez maintenant voir l’élément <Devis>.

  3. Insérez un élément Devis. <> L'élément <Titre>, qui est requis en tant que premier enfant de <Devis>, doit désormais s’afficher dan le catalogue Eléments.

  4. Insérez l’élément Titre. <> Continuez d’insérer des éléments jusqu’à ce que la structure du devis soit complète.

    Remarque : Si la structure est incorrecte, revenez à votre EDD, corrigez-la, puis importez à nouveau les définitions d’éléments. Vous pouvez également vérifier votre EDD en le comparant à l’EDD de devis, disponible à l’adresse : www.adobe.com/go/lr_FrameMaker_support_fr.
  5. Enregistrez votre fichier sous devis_structuré.fm.

Création d’une DTD à partir d’une EDD

Apprenez à créer un fichier DTD (définition de type de document) à partir d’un fichier EDD dans FrameMaker.

Les DTD (Document Type Definitions, définition de type de document) définissent les éléments à inclure dans un document structuré. Elles définissent les éléments, leurs attributs, leur ordre, ainsi que les éléments qui peuvent en contenir d’autres.

  1. Ouvrez l’EDD.

  2. Ajoutez l’élément <StructuredApplication>, puis saisissez le nom de l’application XML que vous avez créée dans la section précédente.

  3. Sélectionnez Structure > DTD > Enregistrer en tant que DTD.

  4. Saisissez un nom de fichier. Veillez à spécifier l’extension .dtd.

    Si votre EDD est valide, aucun journal d’erreurs n’est créé. Toutefois, il est possible de créer des règles générales de style SGML dans FrameMaker qui ne sont pas autorisées dans XML.

  5. Un message vous informant que FrameMaker a terminé l’écriture de la DTD s’affiche dans une nouvelle boîte de dialogue.

  6. Ouvrez la DTD. Si vous n’avez pas spécifié l’élément <StructuredApplication> lors de l’étape 2, vous pouvez le sélectionner à partir de la boîte de dialogue Utiliser l’application structurée qui s’affiche.

Il est maintenant possible d’utiliser la DTD.

Développement d’une application structurée

Apprenez à développer une application structurée dans FrameMaker.

Pour permettre l’importation et l’exportation de contenu XML pour les devis structurés, vous devez configurer une application structurée qui énumère les composants de l’environnement de création de documents structurés.

Pour commencer, vous devez créer une définition de type de document (DTD) correspondant à l’EDD.

Création d’une DTD

  1. Ouvrez le fichier devis_edd.fm dans FrameMaker structuré.

  2. Sélectionnez Structure > DTD > Enregistrer en tant que DTD. Indiquez le nom du fichier (devis.dtd) et l’emplacement auquel vous voulez l’enregistrer. Cliquez ensuite sur Enregistrer.

  3. Dans la boîte de dialogue Utiliser l’application structurée, conservez la sélection par défaut, <Aucune application>, puis cliquez sur Continuer.

  4. Dans la boîte de dialogue Sélectionnez le type, sélectionnez XML, puis cliquez sur OK. Le fichier DTD est écrit et enregistré à l’emplacement spécifié.

Vous avez également besoin d’un modèle structuré contenant le formatage et les informations de l’EDD.

Création d’un modèle structuré

  1. Ouvrez le fichier devis_structuré.fm.

  2. Effacez tout le contenu du fichier. Un modèle structuré doit être vide.

  3. Enregistrez le fichier sous modèle_devis.fm.

A présent, vous êtes prêt à configurer l’application structurée.

Configuration de l’application structurée

  1. Sélectionnez Structure > Définition d’application > Modifier les définitions d’application. Cette commande ouvre le fichier structapps.fm, qui contient les définitions d’application, à partir de l’emplacement suivant :

    %appdata%\Adobe\FrameMaker\<version>\

    Remarque : Tout comme l’EDD, le fichier de définition d’application est structuré.
  2. Insérez un élément <ApplicationXML> en tant qu’enfant de l’élément <ConfigStructurée>.

  3. Entrez Devis en tant que nom de l’application.

  4. Insérez un élément DTD et spécifiez le texte suivant en tant que texte de cet élément :

      $STRUCTDIR/proposal/proposal.dtd
  5. Insérez un élément Modèle et spécifiez le texte suivant en tant que texte de cet élément :

      $STRUCTDIR/proposal/proposal_template.fm
  6. Sélectionnez Fichier > Enregistrer pour enregistrer le fichier structapps.fm.

  7. Sélectionnez Structure > Définition d’application > Lire les définitions d’application pour mettre FrameMaker à jour avec la nouvelle définition d’application.

    Remarque : Pour vérifier si l’application est correctement installée, sélectionnez Structure > Définir l’application structurée pour afficher la boîte de dialogue Définir l’application structurée. Si vous avez correctement configuré les définitions d’application, Devis s’affiche dans la liste déroulante.

Enfin, vous devez copier les fichiers d’application dans le répertoire dans lequel la définition d’application structurée s’attend à les trouver.

Copie des fichiers d’application

  1. Recherchez le dossier d'installation de FrameMaker à l'aide de l'explorateur de fichiers, puis naviguez dans le dossier Structure\xml.

  2. Dans le dossier xml, créez un dossier devis.

  3. Copiez les fichiers devis.dtd et modèle_devis.fm dans le dossier devis.

Création de fichiers de structure

Décidez si vous souhaitez utiliser une structure standard existante ou créer la vôtre.

Création de fichiers de structure sans utiliser de structure existante

  1. Dans FrameMaker, créez une EDD correspondant à la structure requise.

  2. Testez l’EDD pour vérifier si les définitions de structure sont correctes.

  3. Ajoutez du formatage à l’EDD et testez l’EDD afin de vous assurer du bon fonctionnement du formatage.

  4. Créez une DTD à partir de l’EDD.

Vous disposez à présent des deux fichiers de définition de structure dont vous avez besoin : un pour FrameMaker (l’EDD) et un pour XML (la DTD).

Utilisation d’une structure existante

  1. Procurez-vous une copie des fichiers standard et modifiez la DTD ou le fichier de schéma fourni de sorte qu’ils répondent à vos besoins.

  2. Ouvrez le fichier de structure terminé dans FrameMaker pour créer une EDD et ajoutez des informations de formatage à l’EDD.

    Remarque : FrameMaker comprend plusieurs variations de DocBook en tant que modèles d’applications structurées. Si vous envisagez de créer une structure orientée DocBook, pensez à modifier l’une des applications fournies.

Une fois les définitions de structure créées, vous devez configurer l’application structurée.

Configuration d’une application structurée

  1. Ouvrez le fichier structapps.fm (sélectionnez Structure > Définition d’application > Modifier les définitions d’application).

  2. Ajoutez une nouvelle définition d’application au fichier en utilisant des pointeurs vers vos fichiers EDD et DTD/de schéma.

Une fois l’application configurée, il vous faudra affiner les paramètres d’importation/exportation.

Utilisation de la fenêtre Configuration d’applications structurées

La configuration d’applications structurées permet de créer une application structurée à l’aide d’un assistant graphique.

Pour lancer la fenêtre Configuration d’applications structurées, cliquez sur Structure > Configuration d’applications structurées. La fenêtre Configuration d’applications structurées s’affiche comme suit :

Configuration d’applications structurées
Utilisation de la fenêtre Configuration d’applications structurées dans FrameMaker

  1. Sélectionnez une application de base sur laquelle la nouvelle application est basée. Pour charger un nouvel ensemble d’applications de base, cliquez sur Charger des applications et sélectionnez le fichier d’application structurée pertinent. La liste d’applications est renseignée automatiquement à partir du fichier d’application structurée sélectionné.

  2. Si nécessaire, saisissez la DTD, le fichier de règles de lecture/écriture, l’EDD et le fichier de modèle, ainsi que les spécifications DOCTYPES.

  3. Entrez le nouveau Nom de l’application.

  4. Par défaut, l’application est enregistrée dans le fichier structapps.fm dans votre répertoire d’application. Pour modifier le nom du fichier, cliquez sur Enregistrer sous, puis sélectionnez ou saisissez un nouveau nom de fichier.

  5. Le cas échéant, cliquez sur Paramètres avancés pour définir les paramètres avancés et effectuez les choix souhaités.

Pour créer un fichier de règles de lecture/écriture basé sur une DTD existante, spécifiez la DTD et cliquez sur Nouveau dans la section Règles de lecture/écriture. Le marqueur de fichier de règles de lecture/écriture s’affiche.

Remarque : Si vous ne spécifiez aucune DTD, un fichier de règles de lecture/écriture vide est créé. Vous pouvez ensuite ajouter des règles à l’aide du marqueur de fichier de règles de lecture/écriture.
  • Pour mettre à jour un fichier de règles de lecture/écriture, sélectionnez le fichier et cliquez sur Mettre à jour. Apportez vos modifications dans le marqueur de fichier de règles de lecture/écriture.

  • Pour générer une nouvelle EDD, sélectionnez la DTD et cliquez sur Nouveau à partir de la section EDD. Tous les éléments sont chargés dans l’interface EDD. À partir de l’interface EDD, vous pouvez sélectionner des <Balises de format de paragraphe d’élément> pour chaque élément.

  • Cliquez sur Importer des paramètres de formatage pour importer des paramètres de formatage à partir d’une autre EDD.

  • Cliquez sur Enregistrer pour enregistrer les modifications ou sur Réinitialiser pour revenir à la dernière version enregistrée.

  • Pour mettre à jour une EDD, sélectionnez-la et cliquez sur Mettre à jour.

  • Pour générer un nouveau modèle, sélectionnez le fichier EDD correspondant, puis cliquez sur Nouveau dans la section Modèle.

Retouche des paramètres d’importation/exportation

  1. Définissez un fichier de règles de lecture et d’écriture avec les mises en correspondance nécessaires, ainsi que des fichiers de transformation XSL avec les éventuelles modifications supplémentaires.

  2. Ajoutez une référence au fichier de règles de lecture/écriture et aux fichiers de transformation XSL dans la définition de l’application structurée.

  3. Ajoutez les éventuels autres paramètres de configuration requis, tels que le traitement du texte conditionnel et des références croisées externes, à la définition de l’application structurée.

Utilisation de la fenêtre Création d’un fichier de règles de lecture/écriture

FrameMaker comprend un marqueur de fichier de règles de lecture/écriture puissant qui facilite la création de règles. Cela contribue à simplifier la génération de règles, car tous les paramètres sont rassemblés en un seul lieu et vous n’avez pas à vous souvenir des syntaxes de règles.

Pour lancer l’outil Création d’un fichier de règles de lecture/écriture, sélectionnezStructure > Règles de lecture/écriture > Nouvelles règles de lecture/écriture. Sélectionnez l’option Lancer la création d’un fichier de règles, puis cliquez sur OK.

Remarque : Vous pouvez éventuellement spécifier la DTD à utiliser lors de la création des règles.

La boîte de dialogue Création de de fichier de règles s’affiche comme suit :

Création d’un fichier de règles
Utilisation de la fenêtre Création d’un fichier de règles de lecture/écriture dans FrameMaker

La fenêtre Création de fichier de règles comporte deux sections de base :

  • Paramètres d’importation/exportation : ces paramètres s’appliquent à l’opération de lecture et d’écriture.

  • Paramètres d’exportation uniquement : ces paramètres ne sont pas traités dans les Paramètres d’importation/exportation et s’appliquent uniquement à l’opération d’écriture.

La section Paramètres d’importation/exportation est divisée en quatre sections :

  1. Eléments de balisage : permet la modification de tous les balisages présents dans la DTD spécifiée. Pour obtenir une liste de tous les éléments, cliquez sur « sélectionner à partir de la DTD » dans la liste déroulante des valeurs. FrameMaker affiche alors la liste des éléments. Vous pouvez sélectionner plusieurs éléments dans la liste et cliquer sur OK pour insérer les éléments sélectionnés dans le marqueur de fichier de règles de lecture/écriture.

  2. Paramètres globaux : affiche la liste des paramètres appliqués globalement à TOUS les éléments.

  3. Entités : affiche la liste de toutes les entités présentes dans la DTD.

  4. Paramètres avancés : contient les paramètres avancés pour les livres et les mappages de caractères.

La section Paramètres d’exportation uniquement est divisée en trois sections :

  1. Objets FrameMaker : répertorie le type des objets FrameMaker présents. En outre, chaque catégorie d’objets FrameMaker répertorie les balisages mappés comme cet objet. Par exemple, si vous mappez le balisage M1 à l’objet de tableau FrameMaker dans la section Paramètres d’importation/exportation, la liste Tableaux dans la section Paramètres d’exportation uniquement affiche la balise M1.

  2. Paramètres globaux : affiche la liste des paramètres appliqués globalement à TOUS les éléments.

  3. Paramètres avancés : contient les paramètres avancés pour SGML, pour DITA, pour les variables et pour les mappages de caractères.

Lors de l’enregistrement des règles, FrameMaker enregistre uniquement les éléments et les règles ayant été modifiés (les valeurs des éléments modifiés sont indiquées en caractères gras, dans le volet de droite). Les comportements par défaut ne sont pas enregistrés.

Test de conversion XML bidirectionnelle

Apprenez à tester la conversion XML bidirectionnelle dans FrameMaker.

Une fois l’application structurée configurée, vous pouvez tester l’aller-retour XML.

  1. Créez un devis structuré valide dans FrameMaker.

  2. Exportez le fichier FrameMaker vers XML. Pour ce faire, sélectionnez Fichier > Enregistrer sous et choisissez XML en tant format de sortie. Le cas échéant, sélectionnez l’application Devis.

  3. Ouvrez le fichier XML exporté dans un éditeur de texte ou un éditeur XML et vérifiez que vous disposez d’un fichier XML valide.

  4. Dans un éditeur de texte ou XML, modifiez le fichier que vous venez d’exporter. Vous pouvez également créer un fichier XML et le valider en le comparant à la DTD du devis. Enregistrez le nouveau fichier XML.

  5. Dans FrameMaker, ouvrez le fichier XML. Vérifiez que le fichier XML s’importe correctement et que le formatage est automatiquement appliqué.

Editeur de fichier de configuration

Chaque application structurée dispose d’un fichier de configuration qui définit son comportement. Apprenez à utiliser l’éditeur Fichier de configuration dans FrameMaker.

Chaque application structurée peut comprendre un fichier de configuration XML. Le fichier de configuration est facultatif et contient des attributs, ainsi que leurs valeurs suggérées et par défaut. Pour lancer l’éditeur, choisissez Elément > Lancer le créateur de fichier de configuration.

Lors de l’ouverture d’une application structurée, FrameMaker lit le fichier de configuration correspondant (s’il existe) et renseigne les valeurs d’attribut automatiquement.

L’éditeur d’attributs vous permet de modifier ces valeurs lorsque vous utilisez l’application structurée.

La boîte de dialogue Paramètres du fichier de configuration s’affiche comme suit :

Paramètres du fichier de configuration
Paramètres du fichier de configuration pour une application structurée

HTML avec feuilles de style en cascade

Découvrez comment fonctionne la relation entre un document XML et un fichier CSS2 (feuilles de style en cascade) dans FrameMaker structuré.

Lorsqu’un document XML est ouvert dans FrameMaker, FrameMaker traite la CSS2 (Cascading Style Sheet 2, feuille de style en cascade de niveau 2) en mettant les informations de cette feuille de style en correspondance avec les règles EDD du document EDD.

Le traitement au format CSS2 dans FrameMaker est décrit dans les exemples suivants :

Remarque : Un fichier XML ouvert dans FrameMaker peut comporter plusieurs fichiers CSS. FrameMaker prend uniquement en charge la feuille de style du créateur du document et non celle de l’utilisateur.

Importation de styles d’éléments CSS  dans un fichier EDD

Le formatage d’éléments des feuilles de style CSS  dans les EDD peut être importé, garantissant ainsi l’harmonisation du formatage entre différentes applications XML. Le fichier CSS peut être référencé dans le document XML ou importé manuellement. Il est possible d’importer séquentiellement plusieurs fichiers CSS, pour un formatage multiniveau.

Lors de l’importation de styles d’éléments dans FrameMaker, les informations contextuelles (sélecteur ou caractéristique d’élément) issues de la CSS sont conservées et importées dans les contextes EDD adéquats.

Remarque : FrameMaker importe les informations de style uniquement au niveau de l’élément.

Vous pouvez également définir les préférences CSS dans XML à l’aide de FrameMaker structuré. Pour plus d’informations, consultez le manuel Développement d’applications structurées avec Adobe FrameMaker

  1. Ouvrez le fichier EDD dans FrameMaker structuré.

  2. Sélectionnez Structure > Importer les styles CSS. La boîte de dialogue Importer les styles CSS s’affiche.

  3. Sélectionnez un fichier CSS, puis cliquez sur Ouvrir.

  4. Si un élément d’application structurée du fichier EDD ne définit pas un nom d’application, la boîte de dialogue Utiliser l’application structurée s’affiche. Sélectionnez l’application utilisée pour créer le fichier EDD. Cliquez sur Continuer.

Le fichier CSS est ensuite importé dans le fichier EDD.

Remarque : Si l’EDD contient déjà les règles de formatage, les propriétés CSS sont ajoutées aux règles existantes. Si les propriétés CSS correspondent à des règles existantes, les propriétés CSS remplacent les règles existantes dans l’EDD. L’EDD ne prend pas en charge les propriétés et sélecteurs définis dans CSS 2.0. Si la mise en correspondance d’une propriété ou d’un sélecteur du fichier CSS avec une règle EDD équivalente n’est pas possible, la propriété ou le sélecteur est ignoré. Dans ce cas, aucune erreur ne s’affiche et aucun journal d’erreurs n’est créé.

Une fois les styles CSS importés, vous pouvez importer les définitions d’éléments à partir de l’EDD vers un modèle, puis ouvrir un fichier XML à l’aide du modèle.

Vous pouvez aussi ouvrir dans FrameMaker un fichier XML auquel des styles CSS sont déjà associés. Lorsque vous ouvrez le fichier XML dans FrameMaker, les fichiers CSS et DTD sont lus et un modèle temporaire est généré pour ouvrir le fichier XML.

Exportation de CSS pour un fichier XML FrameMaker

Vous pouvez exporter les informations de style XML disponibles dans le document pour tous les éléments utilisant le format CSS2 (Cascading Style Sheets 2) vers un fichier EDD. Ensuite, vous pouvez importer ces définitions de style CSS à partir d’un fichier EDD vers de nouveaux fichiers XML. Les feuilles de style en cascade permettent aux auteurs d’attacher des styles, tels que des polices et l’espacement, à des fichiers XML structurés. Le format CSS2 est une norme W3C.

Lorsque vous choisissez la commande Générer CSS2, des styles issus de documents structurés correctement formés sont générés, selon les informations de formatage disponibles dans l’EDD associée au document source. FrameMaker exporte les informations de style uniquement au niveau de l’élément. Ainsi, si vous appliquez un style à un mot spécifique d’un élément Texte, le style appliqué au mot n’est pas exporté.

Vous pouvez définir les préférences CSS2 dans l’application XML. Vous pouvez, par exemple, déterminer si le fichier CSS2 est automatiquement généré lors d’une exportation au format XML. Pour plus d’informations, consulter le manuel en ligne Développement d’applications structurées avec Adobe FrameMaker.

  1. Ouvrez le modèle ou le document et l’EDD qui lui est associée dans FrameMaker structuré.

  2. Sélectionnez Structure > Générer CSS2.

XML avec schéma

Découvrez ce qu’est un XML avec schéma, et familiarisez-vous avec le flux de production des schémas dans FrameMaker. Utilisation des espaces de noms XML dans FrameMaker

FrameMaker vous permet d’importer des documents comportant des balises XML associés au langage Schema XML du consortium W3C (World Wide Web Consortium). FrameMaker crée automatiquement une DTD et une EDD à partir du schéma. Au moment de l’importation et de l’exportation au format XML, FrameMaker valide la structure du document en la comparant au schéma associé, mais toutes les informations de schéma ne sont pas conservées durant l’exportation.

Pour plus d'informations sur la mise en correspondance des schémas en DTD, reportez-vous au guide de référence du développeur d'application structuréehttp://help.adobe.com/en_US/framemaker/2015/StructuredDev/Structure_Dev_Reference.pdf.

Remarque : Cette version offre une prise en charge du langage Schema équivalente à celle des DTD. Par conséquent, l’EDD n’a pas été étendu pour prendre en charge les fonctions de Schema qui ne sont pas disponibles dans les DTD. Pour cette raison, les schémas sont en lecture seule et vous ne pouvez pas rétablir le format EDD à partir d’un schéma.

Flux de production des schémas

Vous pouvez importer un document XML faisant référence à un fichier de schéma et vous pouvez indiquer un fichier de schéma dans votre application structurée afin de l’utiliser pour valider un document lors de son exportation au format XML.

  1. Pour un document XML donné, vous pouvez inclure le fichier du schéma dans le XML à l’aide des attributs @noNamespaceSchemaLocation ou @schemaLocation selon que votre schéma comprend un espace de noms cible ou non.

  2. Pour indiquer le fichier de schéma à utiliser lors de l’exportation XML, modifiez le fichier structapps.fm. Utilisez l’élément <Schema> de <XMLApplication> pour préciser le chemin d’accès du fichier de schéma à utiliser pour l’exportation.

  3. Ouvrez le XML dans FrameMaker à l’aide d’une application structurée. Modifiez-le.

  4. Enregistrez le XML à l’aide d’une application structurée. L’élément <Schema> du fichier structapps.fm est envoyé dans le fichier et la validation s’effectue par comparaison avec lui.

Dans ce flux de production, une DTD est générée automatiquement en tant que fichier intermédiaire à partir du schéma fourni dans le document XML. Vous ne pouvez pas la modifier. En revanche, vous pouvez utiliser un fichier de schéma pour générer un EDD. Voir Génération d’un catalogue d’éléments (EDD) à partir d’un schéma.

Modifications apportées à l’application structurée pour la prise en charge des schémas

Le nouvel élément <Schema>, enfant de l’élément <XMLApplication>, indique le chemin d’accès à un fichier de schéma dans le fichier d’application structurée structapps.fm. Si les documents d’instance utilisent des espaces de noms, la valeur de la propriété <Namespace> de <XmlApplication> doit être true.

Pour qu’une application structurelle puisse être sélectionnée dans la liste Utiliser l’application structurée pendant l’importation d’un document associé à un schéma, l’élément racine du schéma doit être inclus dans l’élément <DOCTYPE> de l’élément <XMLApplication> de l’application.

Génération d’un catalogue d’éléments (EDD) à partir d’un schéma

Vous pouvez créer une EDD à partir d’une définition de schéma ou importer les éléments d’une définition de schéma dans une EDD existante. FrameMaker commence par convertir la définition de schéma en DTD, puis crée ou importe les éléments vers une EDD.

Utilisez les commandes suivantes du menu Structure > Schéma :

  • Ouvrir le schéma : cette commande convertit un schéma donné en DTD, puis crée une EDD à partir de la DTD.

  • Importer le schéma : cette commande convertit un schéma donné en DTD, puis importe les éléments de la DTD dans l’EDD existante.

Chaque commande ouvre une boîte de dialogue Choisir un fichier dans laquelle vous pouvez indiquer le fichier de schéma, puis une boîte de dialogue Enregistrer dans laquelle vous pouvez indiquer l’emplacement dans lequel enregistrer le fichier DTD généré.

  1. Dans FrameMaker structuré, choisissez Structure > Schéma > Ouvrir le schéma.

  2. Choisissez un fichier de schéma.

  3. Sélectionnez le chemin d’accès de la DTD devant être créée.

  4. Examinez la DTD créée et apportez les éventuelles modifications requises.

  5. Créez une EDD à partir de la DTD générée, en suivant la procédure décrite dans le guide Références de développement d’application structurée.

  6. Utilisez cette EDD pour créer un modèle pouvant être intégré dans l’application structurée.

  7. Fournissez le chemin d’accès à la DTD ainsi que l’emplacement du schéma dans le XML. Cette opération permet à FrameMaker d’utiliser correctement votre modèle. La validation du XML d’entrée et de sortie s’effectue toujours par rapport au schéma.

Affichage ou modification d’espaces de noms XML

Un espace de noms XML constitue une collection de noms de types d’éléments et de noms d’attributs spécifiques figurant dans un document XML. Le champ d’un espace de noms s’étend au-delà du document contenant.

Dans la mesure où un même document XML peut contenir des éléments et des attributs susceptibles d’être utilisés par plusieurs applications, vous pouvez utiliser les espaces de noms pour différencier les attributs et éléments qui doivent être utilisés par telle ou telle application. Les applications qui traitent XML utilisent des espaces de noms afin d’identifier les balises et attributs qu’elles sont censées traiter.

Les noms des espaces de noms XML peuvent se présenter sous la forme de noms qualifiés, avec un point séparant les deux parties, à savoir le préfixe de l’espace de noms et la partie locale. Le préfixe, mis en correspondance avec une référence URI (Uniform Resource Identifier), identifie un espace de noms. La combinaison de l’espace de noms URI universel et le propre espace de noms du document permet de créer des identificateurs uniques.

Utilisation des espaces de noms XML dans FrameMaker

FrameMaker assure la prise en charge des espaces de noms pour tous les éléments d’un document XML. Lors de l’importation d’un document XML contenant des espaces de noms, toutes les informations des espaces de noms sont conservées.

Vous pouvez afficher, éditer, ajouter ou supprimer des espaces de noms d’un document XML dans FrameMaker structuré à l’aide de la commande Espaces de noms. Vous pouvez également utiliser cette commande pour visualiser la définition du préfixe d’une balise d’élément et sélectionner l’élément qui définit le préfixe.

Dans FrameMaker, les espaces de noms sont traités par défaut comme des espaces de noms et s’affichent dans la boîte de dialogue Espaces de noms. Vous pouvez toutefois désactiver les espaces de noms dans l’application afin qu’ils soient considérés comme des attributs et qu’ils s’affichent dans la Vue de la structure.

  1. Ouvrez le document dans FrameMaker structuré.

  2. Sélectionnez un élément dans la Vue de la structure.

    Remarque : Les éléments qui contiennent des espaces de noms apparaissent dans la Vue de la structure avec un astérisque (*) à côté de leur nom.
  3. Sélectionnez Elément > Espaces de noms.

  4. Dans la boîte de dialogue Espaces de noms, cliquez sur Sélectionner l’élément de définition pour visualiser l’espace de noms de l’élément sélectionné dans la Vue de la structure.

  5. Apportez les modifications requises aux champs Espaces de noms déclarés, Préfixe ou Chemin d’accès, puis cliquez sur Ajouter, Modifier ou Supprimer. Pour fermer sans enregistrer les modifications, fermez la boîte de dialogue sans cliquer sur une option.


January 20, 2022

Legal Notices | Online Privacy Policy