Référencer un fichier en RAW HTWL sommaire général RAW HTWL permet de référencer les fichiers en local sans donner le chemin total. En général on peut ne donner que le nom du fichier source dans le code HTWL source, et cela suffit : RAW HTWL trouvera le bon fichier dans toute l'arborescence, et incluera son chemin relatif cible dans le code HTML résultant. Les résolutions de chemin décrites dans cette page fonctionnent automatiquement pour les paramètres suivants : BACKGROUND, HREF, LOWSRC, SRC. Si on veut correctement utiliser un nom de fichier dans une autre occasion (autre paramètre HTML, ou expression JavaScript), il faudra utiliser la primitive \file ! 1. Référencer un fichier par son seul nom Quand RAW HTWL recherche un fichier local, il regarde d'abord dans le même dossier parent que le fichier appelant, puis dans les dossiers parents successifs, puis, s'il ne l'a toujours pas trouvé, parcourt l'arborescence en entier. 1.1. Le fichier recherché est dans le même dossier  mon dossier  curriculum vitæ.htwl  index.htwl  mes premières macros.h  sommaire.htwl  vacances  images  été 1999  photo campagne.jpeg  index.htwl  logo.gif  index.htwl  vacances.htwl  zéro pointé  index.htwl L'appel <A HREF="index.htwl"> depuis le fichier « vacances.htwl » cherchera d'abord le fichier dans le même dossier parent. Note : cette portion de code deviendra donc <A HREF="index.htm"> dans le fichier « vacances.htm » résultant. 1.2. Le fichier recherché est dans un dossier parent  mon dossier  curriculum vitæ.htwl  index.htwl  mes premières macros.h  sommaire.htwl  vacances  images  été 1999  photo campagne.jpeg  index.htwl  logo.gif  vacances.htwl  zéro pointé  index.htwl S'il ne trouve pas le fichier dans le même dossier parent, l'appel <A HREF="index.htwl"> depuis le fichier « vacances.htwl » cherchera dans les dossiers parents successifs. Note : cette portion de code deviendra donc <A HREF="../index.htm"> dans le fichier « vacances.htm » résultant. 1.3. Le fichier recherché est ailleurs dans l'arborescence  mon dossier  curriculum vitæ.htwl  mes premières macros.h  sommaire.htwl  vacances  images  été 1999  photo campagne.jpeg  logo.gif  vacances.htwl  zéro pointé  index.htwl S'il ne trouve le fichier dans aucun dossier parent, l'appel <A HREF="index.htwl"> depuis le fichier « vacances.htwl » cherchera dans toute l'arborescence un fichier unique ayant le nom voulu. Note : cette portion de code deviendra donc <A HREF="../zeropoin/index.htm"> dans le fichier « vacances.htm » résultant. Voir le chapitre sur les noms de fichiers. 1.4. Le fichier recherché est ailleurs, mais pas unique : erreur !  mon dossier  curriculum vitæ.htwl  mes premières macros.h  sommaire.htwl  vacances  images  été 1999  photo campagne.jpeg  index.htwl  logo.gif  vacances.htwl  zéro pointé  index.htwl S'il ne trouve le fichier dans aucun dossier parent, et que le fichier n'est par ailleurs pas unique, l'appel <A HREF="index.htwl"> depuis le fichier « vacances.htwl » produira une erreur de compilation. Dans notre exemple, RAW HTWL n'a pas trouvé de « index.htwl » dans le dossier parent de « vacances.htwl », qui est « vacances ». Il a donc cherché dans les dossiers parents successifs — donc ici uniquement le dossier racine — mais ne l'a pas davantage trouvé. En cherchant alors dans tout le site, il a trouvé plusieurs fichiers nommés « index.htwl », et a arrêté la compilation sur une erreur. 2. Référencer un fichier par un chemin RAW HTWL résoud le chemin segment par segment, comme s'il s'agissait à chaque fois d'un fichier différent à retrouver. Exemple : <A HREF="vacances/images/zéro pointé/index.htwl"> ... </A> RAW HTWL cherche d'abord le dossier « vacances » selon la méthode précédemment décrite puis on part de « vacances » pour rechercher le dossier « images » de là on va chercher le dossier « zéro pointé » et on finit par aller chercher « index.htwl » à partir de « zéro pointé » On notera que quand une recherche part d'un dossier, RAW HTWL commence bien logiquement par regarder à l'intérieur. On notera aussi que le chemin appelé peut très bien être totalement fantaisiste, du moment que RAW HTWL arrive à retrouver le fichier final. Reprenons l'arborescence précédente :  mon dossier  curriculum vitæ.htwl  mes premières macros.h  sommaire.htwl  vacances  images  été 1999  photo campagne.jpeg  index.htwl  logo.gif  vacances.htwl  zéro pointé  index.htwl L'appel <A HREF="images/index.htwl"> depuis le fichier « vacances.htwl » trouvera bien le fichier voulu. Mais… L'appel <A HREF="été 1999/index.htwl"> depuis le fichier « vacances.htwl » trouvera aussi le fichier ! En effet, après avoir trouvé « été 1999 », RAW HTWL a regardé à l'intérieru. N'y ayant pas trouvé « index.htwl », il a continué de chercher dans les dossiers parents, et l'a justement trouvé dans « images ».  mon dossier  curriculum vitæ.htwl  mes premières macros.h  sommaire.htwl  vacances  images  été 1999  photo campagne.jpeg  index.htwl  logo.gif  vacances.htwl  zéro pointé  index.htwl L'appel <A HREF="zéro pointé/index.htwl"> depuis le fichier « vacances.htwl » trouvera bien le fichier voulu. Tout autre genre d'appel aboutira à l'erreur que nous avons rencontrée plus haut. On peut bien sûr utiliser le code ".." dans ses appels de fichiers, tout comme en HTML classique. Exemple : <A HREF="../zéro pointé/index.htwl"> 3. Poursuivre la navigation retour au sommaire général organisation des fichiers appels de fichiers en RAW HTWL fichiers headers « .h » fichiers auxiliaires « .aux »