Préférences de RAW HTWL sommaire général RAW HTWL 1.0b offre la possibilité de régler certains paramètres de la compilation : 1. Fichiers sources 1.1. Compiler aussi les fichiers « .html » Par défaut, RAW HTWL reconnaît les suffixes « .htw » et « .htwl » (voir le chapitre consacré aux fichiers), et transforme ce type de fichiers en « .htm » et « .html » en développant les macros qu'ils contiennent. On peut demander en cochant cette case de parser aussi les « .htm » et « .html ». 1.2. Utiliser les macros Par défaut, RAW HTWL développe les macros qu'il rencontre dans les fichiers « .htw » et « .htwl » (et « .htm » et « .html » si on a coché l'option ci-dessus). Cela implique notamment que les caractères \ { } ~ ne sont plus des caractères banals (puisqu'ils jouent un rôle dans les macros). Si l'on ne souhaite pas que RAW HTWL développe les macros, mais qu'il se contente de traduire les lettres accentuées et les caractères non-ASCII en codes HTML, décocher cette option. 1.3. Vérifier les liens locaux Par défaut, RAW HTWL vérifie la présence dans le site local des fichiers passés en valeur des paramètres BACKGROUND HREF SRC et LOWSRC, ainsi que ceux appelés par la primitive \file. On peut désactiver cette fonctionnalité. La version 1.0b ne permet pas de décocher cette option. 2. Noms des fichiers cibles 2.1. Passer les noms en minuscules Comportement par défaut. 2.2. Limiter le nombre de caractères Un souci assez courant concerne l'archivage de son site au mode DOS, ou la publication chez des hébergeurs un peu nazes qui n'acceptent pas les noms trop longs (exemple rencontré personnellement en 1999 : Infonie). En réduisant par défaut la longueur des noms de fichiers à 8 caractères + 3 pour l'extension, RAW HTWL pallie ce genre de déconvenue. 2.3. Supprimer les espaces Les noms des fichiers sources sont systématiquement traduits en caractères ASCII sans espaces : « Mes vacances à la plage.htwl » donnera comme fichier cible « mes_vacances_a_la_plage.html » (avec les préférences « passer en minuscules » et « autoriser les noms longs »). Les traits soulignés « underscore » < _ > qui apparaissent à la place des espaces sont souvent disgracieux. Cette option (cochée par défaut) permet de les supprimer : le fichier cible s'appellera finalement « mesvacancesalaplage.html » (puis « mesvacan.htm » après réduction à 8+3). 3. Dossier du site final 3.1. Garder le vieux site Quand RAW HTWL recompile un site, on peut lui demander de garder la vieille version de côté au lieu de l'effacer. Effacer tous les vieux fichiers est en effet parfois très long (cela est analogue à vider la corbeille, or un site peut comporter des centaines de fichiers…). 3.2. Jeter le vieux site à la corbeille Pour ne pas avoir trop de fichiers de travail, on peut demander de jeter la vieille version, sans pour autant vider la corbeille. Il faudra ensuite vider la corbeille soi-même. Cette option et la précédente sont cochées par défaut. 3.3. Effacer les dossiers vides À la fin d'une compilation il arrive qu'on se retrouve avec des dossiers vides (par exemple quand on avait mis ses « .h » dans un dossier réservé à cet usage). Pour éviter l'accumulation de dossiers vides, RAW HTWL permet de les effacer à la fin (option cochée par défaut). 3.4. Dupliquer les images et les binaires L'organisation du dossier du site final est basée sur celle du dossier source. À ce titre, les images et les binaires d'origine se retrouvent tels quels dans le dossier cible. Par défaut, RAW HTWL duplique ces fichiers, afin de préparer le dossier final à une publication par FTP. Mais ce procédé est coûteux tant en temps qu'en espace disque. Si on est dans une phase d'expérimentation du site, on pourra préférer ne faire que des alias de ces fichiers, ce qui allègera notablement le trafic. 4. Contenu des fichiers cibles 4.1. Vérifier la syntaxe du HTML 3.2 résultant RAW HTWL permet de vérifier la syntaxe du code final. On ne vérifie que la conformance aux spécifications W3C du HTML 3.2, sans tag propriétaire, et surtout sans JavaScript. La version 1.0b ne permet pas d'activer cette fonctionnalité. 4.2. Couper les lignes à 72 caractères Pour une meilleure lisibilité du code final, RAW HTWL justifie le texte par défaut. 4.3. Rassembler le code en un bloc RAW HTWL peut sauter une ligne après chaque tag, ou tout rassembler en un seul bloc (comportement par défaut). 4.4. Indenter les tags Quand on a choisi de sauter une ligne après chaque tag HTML, on peut aussi demander de faire apparaître les niveaux d'enboîtement des tags. Pour que cette option fonctionne bien il faudrait que RAW HTWL ait des notions de corrections syntaxiques du code HTML. Par conséquent, la version 1.0b du logiciel risque de parfois donner des résultats surprenants si on coche cette option. 5. Comment changer les préférences par défaut La version 1.0b de RAW HTWL n'enregistre pas ses préférences sur le disque. La seule possibilité de modifier les préférences par défaut est de bidouiller avec ResEdit. 6. Autres préférences, astuces ResEdit donne aussi accès à des paramètres cachés : 6.1. Lancement des fichiers finals Par défaut le navigateur qui ouvrira les fichiers HTML résultants est Netscape Communicator, de créateur MOSS. Cette valeur est stockée quelque part dans une ressource STR et est très facilement modifiable en Microsoft Internet Explorer (créateur MSIE), iCab (créateur iCAB), BBEdit (créateur R*ch)… 6.2. Macros prédéfinies Toutes les macros prédéfinies de RAW HTWL sont stockées dans des ressources STR. On peut donc facilement les modifier, ou rajouter des macros construites sur le même modèle. 7. Poursuivre la navigation retour au sommaire général présentation du logiciel utilisation du logiciel préférences du logiciel téléchargements