 |
sommaire général
1. Arborescence
Le site écrit pour RAW HTWL doit être organisé en arborescence classique. Tous les fichiers concernés, textes, images, binaires, doivent être contenus dans l'arborescence.
Voir la procédure d'utilisation du logiciel. L'arborescence source sera dupliquée à peu de choses près en arborescence cible, moins les fichiers headers « .h », plus les fichiers et les dossiers créés pendant la compilation.
 |
2. Noms de fichiers
On peut mettre dans le dossier source les fichiers ayant les suffixes suivants : « .htwl », « .htw », « .h », « .gif », « .jpeg », « .jpg », « .bin », « .hqx », « .sit », « .sea », « .zip », « .mpeg », « .mpg », « .mov », « .pdf », « .swf », « .txt ».
Ne seront compilés que les fichiers sources suffixés en « .htwl » ou « .htw » (on peut aussi compiler des « .html » et « .htm » : voir les préférences). On peut aussi mettre dans le dossier source des fichiers auxiliaires ; voir certains exemples.
Les fichiers headers « .h » ne donnent lieu à aucun fichier cible directement, tandis que les images et binaires sont purement et simplement dupliqués (on peut aussi en faire des alias, pour plus de rapidité. Voir les préférences).
Contrairement aux noms de macros, les noms de fichiers ne font pas la différence entre minuscules et majuscules. Ils peuvent aussi contenir des espaces et des accents : RAW HTWL se chargera d'y mettre bon ordre ; les lettres accentuées seront remplacées par des caractères ASCII proches, et les espaces seront supprimés ou remplacés par des < _ > (voir les préférences).
Par défaut, RAW HTWL tronque les noms de fichiers cibles à 8 caractères + 3 pour le suffixe. On peut changer cela dans les préférences.
3. Inclusion de fichiers
La primitive \include permet d'inclure un fichier header « .h » ou un fichier auxiliaire « .aux » dans un fichier « .htwl ». Cela permet à plusieurs fichiers « .htwl » de partager une même portion de texte ou des macros communes.
4. Création de fichiers
La primitive \createfile { nom du fichier } { contenu } lance la création d'un nouveau fichier « .htwl » — ou d'un fichier auxiliaire « .aux » — avec le contenu spécifié. Ce contenu sera compilé comme s'il s'agissait d'un « .htwl » source.
4.1. Ajout dans un fichier auxiliaire
La primitive \appendfile permet d'écrire à la fin d'un fichier auxiliaire « .aux » qui existe déjà.
4.2. Création de fichiers différée
La primitive \queuefile est analogue à \createfile, à la différence près que RAW HTWL attend d'avoir fini toutes les pages en cours avant de créer le nouveau fichier. Voir certains exemples.
4.3. Création de dossiers
La primitive \createfolder permet de créer un nouveau dossier dans l'arborescence cible.
4.4. Référence à un fichier créé
Les appels de fichiers créés par ces primitives doivent se faire par l'intermédiaire du nom source et non cible. Ainsi, si on a utilisé \createfile { mon nouveau fichier.htwl } { ... }, et qu'on veut y faire référence dans un lien HTML, il faudra coder <A HREF="mon nouveau fichier.htwl"> et non <A HREF="monnouve.htm">. En pratique, c'est comme si en HTWL on ne codait qu'avec des fichiers sources.
5. Dossier final
Le dossier cible final a le même nom que l'original, plus le suffixe « site ». S'il y avait déjà des sites compilés ayant le même nom, ils sont regroupés dans un dossier « trash », qui par défaut est ensuite mis à la corbeille. On peut alors débarrasser manuellement la corbeille de ces sauvegardes successives. Les préférences permettent aussi d'effacer les vieux fichiers automatiquement.
Note : Par défaut, le site final est débarrassé de ses dossiers vides.
6. Poursuivre la navigation
retour au sommaire général
- organisation des fichiers
- appels de fichiers en RAW HTWL
- fichiers headers « .h »
- fichiers auxiliaires « .aux »