Après avoir lancé le programme, il faut choisir l'option
"commencer" du menu fichier. Là, le sélecteur de fichiers
va s'ouvrir, et vous proposera de choisir le fichier
html à traiter. Ensuite, le formulaire ci-contre doit
s'ouvrir.
Voici le détail des options de ce formulaire :
Fichier html à convertir
le fichier html à convertir est le fichier que vous venez de choisir. Deux flèches permettent de voir son nom en entier, s'il n'apparait pas entièrement dans le cadre. En cliquant sur ce cadre, vous pouvez choisir un autre fichier html à convertir. Vous pouvez également, avec un système multitache, utiliser le drag 'n drop du fichier vers une fenêtre de Ih!.
Appel récursif
si l'option "appel récursif" est cochée, un appel récursif sera effectué sur tous les fichiers référencés que le programme trouvera (fichiers trouvés dans les instructions href="..." et src="..." (pour les frames)). Cela permet de traiter toute une documentation html en ne passant en paramètre que la home-page.
Garder les originaux
si l'option ".dup" est cochée, les fichiers html originaux seront renommés en fichier.dup.
Vérifier les paramètres ALT
l'option 'Vérifier l'existence de ALT' permet, comme son nom l'indique, de vérifier que chaque tag <img...> dispose d'un paramètre ALT. Si tel n'est pas le cas, un message sera inscrit dans la fenêtre résultat (ou le fichier résultat) pour vous en rendre compte.
Fichier resultat.txt
si l'option "créer un fichier resultat.txt" est cochée, toutes les opérations effectuées par Ih! y seront indiquées, de façon explicite. Ce fichier sera créé dans le répertoire courant, c'est à dire à côté du programme.
Afficher les résultat
si l'option "afficher les résultats", une fenêtre texte s'ouvrira, et affichera tous ce qui est (ou aurait pu être) écrit dans le fichier resultat.txt.
GO!!!!!
Quand tout est paramètré, il n'y a qu'à cliquer sur "GO". Une fenêtre va s'ouvrir, et vous indiquera l'opération que Ih! est en train d'effectuer, avec les éventuels messages d'erreurs.
La grande fenêtre est la fenêtre "résultat". Elle peut être fermée, cela ne perturbera pas le programme, par contre, il ne sera plus possible de la ré-ouvrir pendant le processus.
Le petit formulaire vous indique en temps réel l'opération que Ih! est en train d'effectuer. Vous pouvez fermer cette fenêtre. Cela aura pour effet d'interrompre le processus.
Vous pouvez également passer le fichier html à convertir
en paramètre lors de l'exécution du programme (en déposant l'icône
du fichier html sur celle du programme) : c'est plus rapide.
Il est également possible, avec un système multitâches, de déposer l'icône du fichier html à convertir sur une des fenêtres de Ih!.
Le fichier "à convertir" n'est pas nécessairement un fichier html. Ce peut également être un fichier "projet" généré par Qed (fichier avec l'extension ".qpj"). C'est un fichier ASCII qui contient la liste des fichiers html à traiter, séparés par un retour chariot. Ce fichier est très facilement généré par Qed, ou par n'importe quel éditeur de texte, et doit porter l'extension ".qpj" pour être considéré comme tel.
Si vous désirez me contacter pour faire évoluer ce programme, n'oubliez pas d'indiquer la version du programme que vous utilisez. Elle figure dans le formulaire d'information, ouvert par l'option "A propos de " du menu "Ih!".
Tout d'abord, j'ai voulu faire de ce programme quelque chose d'utile et de fiable, en quoi on peut avoir confiance. Dans cette optique, Ih! ne modifie le fichier html que si il est sur à 100% de son coup.
En clair, Ih! n'ajoute les champs width et height que si il a réussi à les calculer, et si ils ne sont pas spécifié dans le fichier html. Si au moins un de ces champs est spécifié, il n'écrit rien ! Dans ce cas, il ne fait qu'émettre des messages pour avertir l'utilisateur d'une éventuelle erreur (le créateur du fichier html est seul maitre à bord !).
Ainsi, les champs qui se terminent par un % sont considéré comme corrects. Les champs exprimé en pixels sont vérifié, et un message prévient l'utilisateur en cas de différence avec les valeurs réelles de l'image.
Pour être complet, voici les messages que Ih! est susceptible de vous indiquer :
ERREUR : lecture du fichier impossible
Le fichier html n'a pu être ouvert en lecture.
ERREUR : création du fichier impossible
Le fichier html ne peut être ouvert en écriture.
Ligne xxx : ERREUR : WIDTH ou HEIGHT avant SRC
Dans un tag <img... le champ width ou height a été rencontré
avant le champ src
Ligne xxx : Ajout des champs WIDTH et HEIGHT
Les champs Width et Height calculés ont été ajoutés dans le
fichier html
Ligne xxx : ERREUR : cette image n'est reconnue par aucun RIM en mémoire
Aucun des modules RIM chargé ne reconnait l'image
Ligne xxx : ERREUR ? Impossible de déterminer les dimensions
C'est le cas quand le fichier image ne peut être chargé, parceque le
champ "src" est erroné ou parcequ'il se réfère à un image qui n'est
pas locale, comme les compteurs (src=http://etc...)
Ligne xxx : ATTENTION : WIDTH (lu) = "yyy" WIDTH (réel) = yyy
vous signale une différence entre les dimensions réelles de l'image,
et ce qui est indiqué dans le fichier html. Cette différence peut être
volontaire pour redimentionner une image.
Ligne xxx : ERREUR : il n'y a pas de champ SRC
Le tag img ne comporte pas de champ src.
Ligne xxx : ATTENTION : il n'y a pas de champ ALT
Si vous souhaitez vérifier la présence des champs ALT, ce message
apparait pour vous signaler qu'un tag img ne contient pas ce champ