 |
sommaire général
Les macros peuvent être définies avec ou sans arguments, et chaque argument avec ou sans séparateur.
1. Primitive \def
Pour définir une macro toute simple, c'est-à-dire sans argument, il suffit d'utiliser la primitive \def suivie d'un nom valide de macro, puis de la définition de la macro entre accolades :
| \def \table_logo { <TABLE ALIGN="right"><TR><TD><IMG SRC="logo.gif"></TD></TR> <TR><TD ALIGN="center">ma boîte</TD></TR></TABLE> } \def ¿ { Cliquez } |
Pour appeler une macro sans paramètre, il suffit de donner son nom dans le programme : voici mon logo \table_logo. ¿ où vous voulez.
2. Primitive \let
Une autre façon de définir une macro sans argument est d'utiliser la primitive \let :
| \let \table_logo { <TABLE ALIGN="right"><TR><TD><IMG SRC="logo.gif"></TD></TR> <TR><TD ALIGN="center">ma boîte</TD></TR></TABLE> } \let ¿ { Cliquez } |
La différence avec la \def est que \let développe la définition avant de la stocker en mémoire.
Les deux définitions ci-dessous ne définissent absolument pas la même chose :
| \def
\macro_non_developpee { \num { 130+50 } } \let \macro_developpee { \num { 130+50 } } |
La macro \macro_non_developpee contient exactement le texte \num { 130+50 }, tandis que \macro_developpee, définie avec \let , contient le texte 180.
En pratique on retiendra que \let sert à effectuer les calculs immédiatement, tandis que \def sert aux macros prenant des arguments. \let ne permet pas de définir les macros récursives.
3. Arguments
3.1. Arguments sans séparateur
Pour définir une macro avec argument(s) sans séparateur, il suffit d'utiliser la primitive \def suivie d'un nom valide de macro, des arguments (les noms d'arguments commencent par le caractère « dièse » < # >), puis de la définition de la macro entre accolades :
| \def \mail #texte { <A HREF="mailto:andriana@mail.dotcom.fr">#texte</A> } \def \titre_couleur #couleur #texte { <TABLE BGCOLOR="#couleur"><TR><TD>#texte</TD></TR></TABLE> } |
L'appel à ces macros demandera de mettre les arguments entre accolades, de la façon suivante :
| \titre_couleur {#ff0000}
{Contacts} Pour m'écrire, cliquez \mail{ici}. |
 |
Exemple :
| \mail cliquez
ici \mail évitez de coder ainsi, c'est \mail extrêmement déroutant~! |
est en fait équivalent à :
| \mail{cliquez} ici \mail{é} vitez de coder ainsi, c'est \mail{extr} êmement déroutant~! |
ce qui n'est certainement pas le but recherché !
En revanche la syntaxe suivante est fiable, et peut-être plus lisible qu'avec des accolades après \width :
| \def \largeur_de_page
{ 600 } \table { \width \largeur_de_page \tr { \td { ... } } } |
On remarquera que le passage de la primitive \wait en tant qu'argument doit se faire sans accolades. Voir le chapitre sur les appels de macros.
3.2. Arguments avec séparateurs
Un séparateur d'argument de macro doit être un nom de macro valide : soit un bloc alphanumérique commençant par « antislash » < \ >, soit un caractère non-alphanumérique, soit un caractère non-alphanumérique précédé d'un antislash.
Une même macro peut être définie de façon mixte avec des arguments sans séparateur et des arguments avec :
| \* arguments sans
séparateur *\ \def \texte_en_couleur #texte #couleur { <FONT COLOR="#couleur">#texte</FONT> } \* un argument avec séparateur *\ \def \bloc #texte \fin_de_bloc { <TABLE BORDER="1"><TR><TD>#texte</TD></TR></TABLE> } \* deux arguments avec séparateurs *\ \def \titre_de_bloc #titre \bloc #texte \fin_de_bloc { <TABLE BORDER="1"> <TR><TD><B>#titre</B></TD></TR> <TR><TD>#texte</TD></TR> </TABLE> } \* un argument avec séparateur, un argument sans *\ \def \lettrine #lettre \texte #texte { <TABLE ALIGN="left"> <TR><TD><FONT SIZE="6">#lettre</FONT></TD></TR> </TABLE> #texte } \* un argument sans séparateur, un argument avec *\ \def \taille_de_texte #taille_de_texte #texte \fin_de_texte { <FONT SIZE="#taille_de_texte">#texte</FONT> } |
Voici des exemples d'utilisation des macros ci-dessus :
| écrivons un \texte_en_couleur
{mot} {#ff0000} en rouge. \bloc tout ceci est encadré \fin_de_bloc \titre_de_bloc MON TABLEAU \bloc suite de mon tableau \fin_de_bloc \lettrine C \texte {e logiciel est formidable~!} \taille_de_texte {6} absolument formidable \fin_de_texte |
4. Poursuivre la navigation
retour au sommaire général
- présentation des macros de RAW HTWL
- qu'est-ce qu'un nom valide de macro
- définir des macros
- appeler une macro
- comprendre le développement des macros
- qu'est-ce que la portée d'une macro
- les macros récursives
- les macros prédéfinies de RAW HTWL