Création d’une EDD

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

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 la liste déroulante 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.

   Note: 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 panneau 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

   Note: 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 le style de paragraphe Corps.

Modification de la définition de l’élément Corps

1. Dans structured_proposal.fm, sélectionnez Format > Paragraphes > Configuration de paragraphes et modifiez les définitions par défaut des styles de paragraphes 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 le style de paragraphe Corps, cliquez sous l’élément <GeneralRule>, ajoutez un élément <TextFormatRules>, puis un élément <ElementPgfFormatTag>. 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 le style de pragraphe Heading1.

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

   Note: À l’instar des styles de paragraphe, les informations saisies doivent respecter 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. À partir du nouveau document, sélectionnez Fichier > Importer > Définitions d’éléments. Dans la liste déroulante Importer du document, sélectionnez le fichier proposal_EDD.fm et cliquez sur Importer.

   Note: 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.

   Note: Si la structure est incorrecte, revenez à votre EDD, corrigez-la, puis importez à nouveau les définitions d’éléments. Pour plus d’informations, consultez le document Références de développement d’application structurée.

5. Enregistrez votre fichier sous devis_structuré.fm.