Utilisation de macros de conversion HTML

Vous pouvez utiliser les tables suivantes sur la page de référence HTML pour définir les macros de conversion HTML :

La table HTLM System Macros, qui contient huit noms de macros prédéfinies permettant d’effectuer des fonctions spéciales au début ou à la fin de pages Web

La table HTML Cross-Référence Macros, qui contient un texte de remplacement pour les références croisées FrameMaker

La table HTML General Macros, qui contient des macros à usage général que vous définissez (par exemple, le titre du document converti)

remarque : les macros System et General HTML ne peuvent pas être modifiées dans la boîte de dialogue Configuration HTML.

Une fois une macro définie, vous pouvez utiliser son nom dans d’autres macros ou l’utiliser pour une mise en correspondance dans la table de HTML Mapping. Le nom de la macro s’affiche dans le menu déroulant Vers de la boîte de dialogue Configuration HTML afin que vous puissiez mettre en correspondance un format avec celle-ci sans modifier directement la table de mise en correspondance.

Pour des exemples de macros de conversion HTML, reportez-vous aux pages de référence des modèles inclus avec FrameMaker.

Création ou modification d’une macro de conversion HTML

1)Choisissez Affichage > Pages référence et affichez la page HTML.

2)Modifiez une macro dans une table ou créez une nouvelle ligne (en appuyant sur les touches Ctrl+Entrée) et entrez une nouvelle macro en commençant par indiquer un nom. (Vous ne pouvez pas ajouter de macros à la table HTML System Macros ; vous pouvez uniquement personnaliser leur texte.)

Le texte personnalisé peut contenir toute combinaison de texte, codes HTML et composantes FrameMaker. Veillez à entrer un code HTML correct, car FrameMaker ne vérifie pas la syntaxe HTML.

Utilisation de composantes dans les macros de conversion HTML

Vous pouvez utiliser les composantes suivantes dans les macros de conversion HTML afin d’inclure des types de texte spéciaux.

Composante

Description

<$paratext>

<$paratag>

<$paranum>

<$paranumonly>

Pour des informations, voir Insertion d’informations sur la source dans les références croisées et Insertion de formats de caractères dans les références croisées.

<$variable[nomvar]>

Contient le texte de la variable.

<$defaulttitle>

Contient le texte du premier intitulé affiché dans le document courant.

<$nextsubdoc>

Contient l’URL du sous-document HTML suivant.

<$prevsubdoc>

Contient l’URL du sous-document HTML précédent.

<$parentdoc>

Contient l’URL du document HTML parent.

Les composantes sont entourées de chevrons simples (< >) et débutent par un signe dollar ($). Entrez ces composantes en lettres minuscules.

remarque : la table General Macros comporte une colonne portant l’étiquette Head. Utilisez-la pour définir un titre ou pour inclure des informations spéciales sur le document HTML (tels que des mots-clés pouvant être utilisés par un moteur de recherche). Pour remplir cette colonne, vous devez connaître les éléments HTML autorisés dans la section HEAD d’un document HTML.

Redéfinition de macros système HTML

Les macros système HTML constituent un cas spécifique car vous pouvez les redéfinir mais vous ne pouvez pas en ajouter de nouvelles.

Ces macros sont particulièrement utiles lors du fractionnement de documents en fichiers HTML distincts. Ainsi, vous pouvez définir la macro StartOfSubDoc afin d’afficher le logo de votre société en en-tête de chaque nouvelle page Web.

Dans ces descriptions, le documentparentdésigne la première page Web et lesous-documentse rapporte à un document lié au document parent.

Macro système

Utilisez

StartOfDoc

Insère le texte au début de la page Web de départ.

EndOfDoc

Insère le texte à la fin de la page Web de départ.

StartOfSubDoc

Insère le texte au début de chaque sous-document excepté les premier et dernier.

EndOfSubDoc

Insère le texte à la fin de chaque sous-document excepté les premier et dernier.

StartOfFirstSubDoc

Insère le texte de remplacement seulement au début du premier sous-document créé.

EndOfFirstSubDoc

Insère le texte de remplacement seulement à la fin du premier sous-document créé.

StartOfLastSubDoc

Insère le texte de remplacement seulement au début du dernier sous-document créé.

EndOfLastSubDoc

Insère le texte de remplacement seulement à la fin du dernier sous-document créé.

Personnalisation de titres

Le titre d’un document HTML s’affiche sur la barre de titre de la fenêtre. Lors de l’ajout d’un signet vers cette page, il s’affiche également dans la liste des signets. Au départ, la composante <$defaulttitle> est utilisée pour le titre, qui utilise le premier intitulé d’un fichier HTML comme titre de ce fichier. Généralement, les titres par défaut sont satisfaisants. Vous pouvez toutefois spécifier un titre différent en modifiant les tables de macros sur la page de référence HTML.

Les macros système et les macros générales permettent de définir deux jeux de texte de remplacement°: l’un s’affichant dans le corps du code et l’autre étant inséré dans la zone de titre.

Vous pouvez modifier le titre par défaut ou le supprimer et définir vos propres titres.

Modification des titres par défaut

1)Choisissez Affichage > Pages référence et affichez la page de référence HTML.

2)Dans la table HTML System Macros, repérez les quatre macros système définissant les titres par défaut. Elles utilisent initialement la composante <$defaulttitle> pour attribuer le premier intitulé d’un fichier comme titre. Vous pouvez modifier une seule macro ou l’ensemble de ces macros.

Nom de la macro

Remplacer par

Intitulé

Commentaires

StartOfDoc

 

<TITLE><$default�title></TITLE>

 

3)Changez la macro par défaut associée à Head. Par exemple, la macro suivante modifie le texte du titre en texte statique.

Nom de la macro

Remplacer par

Intitulé

Commentaires

StartOfDoc

 

<TITLE> Mon livre</TITLE>

 

Définition de vos propres titres

1)Choisissez Affichage > Pages référence et affichez la page de référence HTML.

2)Supprimez le texte de remplacement des quatre titres par défaut dans la table HTML System Macros.

3)Dans la table General Macros, définissez une macro utilisant l’élément HTML <TITLE> dans la troisième colonne, intitulée Remplace With (in HEAD). Par exemple, la macro suivante utilise un texte et un numéro automatique de paragraphe pour le titre, ainsi qu’un texte de paragraphe dans le document.

Nom de la macro

Remplacer par

Intitulé

Commentaires

MonTitre

<P><$para�num><$para�text></P>

<TITLE><$para�num><$paratext>�

</TITLE>

 

4)Mettez en correspondance la macro et le format dans lequel vous fractionnez le document HTML.