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 :
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.
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.
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 :
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.
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.
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.
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 :
Une structure très souple est plutôt complexe et peut être difficile à gérer en raison du nombre très important de variations autorisées.
Une structure très stricte peut interdire certaines associations d’éléments pourtant nécessaires.
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.
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. |
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 :
être vide ;
contenir d’autres éléments ;
ne contenir que du texte ;
contenir des éléments et du texte.
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.
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.
Les sept règles suivantes contrôlent l’utilisation des éléments selon leur séquence, leur nombre d’occurrences et leur groupe.
Indique que les éléments enfants peuvent se trouver dans toutes les séquences à condition qu’ils apparaissent au moins une fois.
Indique que l’occurrence d’un élément enfant est possible.
Indique l’ordre d’affichage des éléments enfants.
Indique le nombre d’occurrences minimum d’un élément enfant.
Indique le nombre d’occurrences maximal d’un élément enfant.
Les éléments peuvent être regroupés sous une déclaration de groupe.
Les attributs peuvent être regroupés sous une déclaration attributeGroup.
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 :
la liste des éléments qui peuvent figurer dans un document ;
les attributs qui peuvent figurer dans un document pour un élément ;
La hiérarchie des éléments, c’est-à-dire les éléments pouvant s’afficher en tant qu’éléments enfants ;
la séquence des éléments enfants ;
le nombre d’éléments enfants ;
les types de données des éléments et les attributs ;
les valeurs fixes et par défaut des éléments et des attributs.
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.
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.
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.
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 :
Titre
Résumé : Titre, Un paragraphe
Description du projet : Titre, Un ou plusieurs paragraphes
Coût : Titre, Un ou plusieurs paragraphes
Planification : Titre, Un ou plusieurs paragraphes
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.
En fonction de l’analyse du contenu, vous pouvez à présent créer l’EDD du devis.
Vérifiez que vous exécutez FrameMaker structuré. Pour passer de FrameMaker non structuré à la version structurée, sélectionnez Interface produit, sélectionnez FrameMaker structuré. Fermez et redémarrez FrameMaker.
. Dans le menu déroulantSélectionnez
pour créer un fichier EDD. Les éléments par défaut sont insérés dans l’EDD.Sélectionnez Vue de la structure.
pour afficher le conteneurCré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.
Ouvrez le catalogue Eléments.
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.
Saisissez une règle générale pour Devis : Titre, Résumé, DescriptionProjet, Coût, Planification
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>
.
Placez votre curseur au bas de la structure.
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+
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.) |
Enregistrez votre fichier EDD sous le nom EDD_devis.fm.
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.
Dans structured_proposal.fm, sélectionné 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.
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.
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>
.
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.
Placez votre curseur sur l’élément <Titre>
pour insérer un élément enfant de <Contenant>
après <RèglesFormatageTexte>
.
Insérez un élément <RèglesPréfixe>
.
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é.
Placez votre curseur sous l’élément Spécification, puis insérez un élément Préfixe.
Pour le texte de l’élément Préfixe, saisissez : Résumé
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.
Enregistrez l’EDD.
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é.
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.
Créez un document vierge, d’orientation portrait, en cliquant sur Portrait.
, puis cliquez surAssurez-vous que l’EDD et le nouveau fichier de document sont tous les deux ouverts. Dans le nouveau document, sélectionnez Importer du document, sélectionnez le fichier devis_EDD.fm, puis cliquez sur Importer.
. Dans le menu déroulantLes 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>
.
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.
Insérez l’élément Titre. <>
Continuez d’insérer des éléments jusqu’à ce que la structure du devis soit complète.
Enregistrez votre fichier sous devis_structuré.fm.
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.
Ouvrez l’EDD.
Ajoutez l’élément <StructuredApplication>
, puis saisissez le nom de l’application XML que vous avez créée dans la section précédente.
Sélectionnez
.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.
Un message vous informant que FrameMaker a terminé l’écriture de la DTD s’affiche dans une nouvelle boîte de dialogue.
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.
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.
Ouvrez le fichier devis_edd.fm dans FrameMaker structuré.
Sélectionnez devis.dtd) et l’emplacement auquel vous voulez l’enregistrer. Cliquez ensuite sur Enregistrer.
. Indiquez le nom du fichier (Dans la boîte de dialogue Utiliser l’application structurée, conservez la sélection par défaut, <Aucune application>
, puis cliquez sur Continuer.
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.
Ouvrez le fichier devis_structuré.fm.
Effacez tout le contenu du fichier. Un modèle structuré doit être vide.
Enregistrez le fichier sous modèle_devis.fm.
A présent, vous êtes prêt à configurer l’application structurée.
Sélectionnez structapps.fm, qui contient les définitions d’application, à partir de l’emplacement suivant :
. Cette commande ouvre le fichier%appdata%\Adobe\FrameMaker\<version>\
Insérez un élément <ApplicationXML>
en tant qu’enfant de l’élément <ConfigStructurée>
.
Entrez Devis en tant que nom de l’application.
Insérez un élément DTD et spécifiez le texte suivant en tant que texte de cet élément :
$STRUCTDIR/proposal/proposal.dtd
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
Sélectionnez structapps.fm.
pour enregistrer le fichierSélectionnez
pour mettre FrameMaker à jour avec la nouvelle définition d’application.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.
Recherchez le dossier d'installation de FrameMaker à l'aide de l'explorateur de fichiers, puis naviguez dans le dossier Structure\xml.
Dans le dossier xml, créez un dossier devis.
Copiez les fichiers devis.dtd et modèle_devis.fm dans le dossier devis.
Décidez si vous souhaitez utiliser une structure standard existante ou créer la vôtre.
Dans FrameMaker, créez une EDD correspondant à la structure requise.
Testez l’EDD pour vérifier si les définitions de structure sont correctes.
Ajoutez du formatage à l’EDD et testez l’EDD afin de vous assurer du bon fonctionnement du formatage.
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).
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.
Ouvrez le fichier de structure terminé dans FrameMaker pour créer une EDD et ajoutez des informations de formatage à l’EDD.
Une fois les définitions de structure créées, vous devez configurer l’application structurée.
Ouvrez le fichier structapps.fm (sélectionnez ).
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.
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 . La fenêtre Configuration d’applications structurées s’affiche comme suit :
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é.
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.
Entrez le nouveau Nom de l’application.
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.
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.
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.
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.
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.
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.
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électionnezLancer la création d’un fichier de règles, puis cliquez sur OK.
. Sélectionnez l’optionLa boîte de dialogue Création de de fichier de règles s’affiche comme suit :
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 :
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.
Paramètres globaux : affiche la liste des paramètres appliqués globalement à TOUS les éléments.
Entités : affiche la liste de toutes les entités présentes dans la DTD.
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 :
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.
Paramètres globaux : affiche la liste des paramètres appliqués globalement à TOUS les éléments.
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.
Apprenez à tester la conversion XML bidirectionnelle dans FrameMaker.
Une fois l’application structurée configurée, vous pouvez tester l’aller-retour XML.
Créez un devis structuré valide dans FrameMaker.
Exportez le fichier FrameMaker vers XML. Pour ce faire, sélectionnez Devis.
et choisissez XML en tant format de sortie. Le cas échéant, sélectionnez l’applicationOuvrez le fichier XML exporté dans un éditeur de texte ou un éditeur XML et vérifiez que vous disposez d’un fichier XML valide.
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.
Dans FrameMaker, ouvrez le fichier XML. Vérifiez que le fichier XML s’importe correctement et que le formatage est automatiquement appliqué.
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
.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 :
Pour charger un fichier de configuration existant, cliquez sur Charger un fichier de configuration, puis sélectionnez le fichier.
Définissez les valeurs de configuration selon vos besoins. Cliquez sur la colonne de valeur de l’élément de choix ou par défaut et saisissez la nouvelle valeur.
Pour insérer un nouveau choix, cliquez avec le bouton droit de la souris sur la ligne au-dessus de laquelle le choix doit être placé, puis sélectionnez Insérer au-dessus.
Pour supprimer un choix, cliquez dessus avec le bouton droit de la souris, puis sélectionnez Supprimer.
Pour enregistrer la configuration, cliquez sur Enregistrer.
Pour enregistrer la configuration en tant que nouveau fichier de configuration, cliquez sur Enregistrer sous, puis saisissez le nouveau nom de fichier.
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 :
Ouvrez une EDD dans FrameMaker. Sélectionnez Ouvrir s’affiche et vous permet de spécifier le fichier CSS. Le fichier CSS est ensuite importé dans le document EDD. Vous pouvez alors importer les définitions des éléments dans un modèle qui vous servira lors de l’ouverture d’un fichier XML. Si le document EDD contient des règles de formatage, les propriétés uniques de la feuille de style CSS sont ajoutées aux règles existantes. Les autres propriétés CSS remplacent les règles de formatage existantes dans le document EDD. Vous pouvez exporter les informations de style XML disponibles dans le document pour tous les éléments utilisant le format CSS2 vers un fichier EDD, à l’aide de l’option Générer CSS2 du menu Structure.
. FrameMaker vérifie si le document actuel est une EDD. Si tel est le cas, la boîte de dialogueLorsqu’un fichier XML est lié à des feuilles de style (par le biais d’une instruction de traitement de feuille de style XML), FrameMaker lit la DTD et la feuille de style liées au document XML et génère un modèle temporaire servant à l’ouverture du fichier XML. Si un modèle existe déjà pour cette application structurée, FrameMaker ne génère aucun modèle temporaire et se sert du modèle existant pour ouvrir le fichier XML.
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.
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
Ouvrez le fichier EDD dans FrameMaker structuré.
Sélectionnez Importer les styles CSS s’affiche.
. La boîte de dialogueSélectionnez un fichier CSS, puis cliquez sur Ouvrir.
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.
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.
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.
Ouvrez le modèle ou le document et l’EDD qui lui est associée dans FrameMaker structuré.
Sélectionnez
.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.
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 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.
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.
Ouvrez le XML dans FrameMaker à l’aide d’une application structurée. Modifiez-le.
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.
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.
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
:: cette commande convertit un schéma donné en DTD, puis crée une EDD à partir de la DTD.
: 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é.
Dans FrameMaker structuré, choisissez
.Choisissez un fichier de schéma.
Sélectionnez le chemin d’accès de la DTD devant être créée.
Examinez la DTD créée et apportez les éventuelles modifications requises.
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.
Utilisez cette EDD pour créer un modèle pouvant être intégré dans l’application structurée.
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.
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.
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.
Ouvrez le document dans FrameMaker structuré.
Sélectionnez un élément dans la Vue de la structure.
Sélectionnez
.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.
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.