Documentation de Navigator 0.09+

Documentation de Navigator 0.09+

Email : ydesir@gmail.com
URL : http://ydesir.free.fr/navigator/
Adresse : Yoann Désir, 95, avenue du Général Leclerc, Bâtiment A, 94700 MAISONS-ALFORT

Pour utiliser cette neuvième version, vous devez installer la bibliothèque Navigator 0.09+ dans n'importe lequel des ports 0, 1 ou 2 de votre hp49g+/50g.

Utilisation générale :

Navigator 0.09+ n'est qu'une des premières versions, dont les bugs n'ont pas tous été corrigés malgré un débuggage intensif. Le viewer de fichiers HTML semble relativement stable, mais son afficheur pourrait faire planter sévèrement la HP, donc sauvegardez votre IRAM d'abord...

Touches :

Flèches haut et bas : permettent de scroller verticalement le texte. On les utilise en premier pour lire le texte.
Flèches gauche et droite : permettent de revenir à la page précédente ou d'aller à la page suivante respectivement (fonction désormais accessible après appui sur le shift rouge, cela pour éviter à l'utilisateur d'appuyer involontairement sur les flèches latérales). En mode sélection (obtenu par appui sur Enter), déplacent la surluminescence d'un lien à l'autre, et d'une forme à une autre. Si la surluminescence "sort" de l'écran, celui-ci est réajusté.
ENTER en mode texte (mode par défaut) : passage en mode sélection. Le premier lien ou la première forme de l'écran s'affiche en surluminescence (ou avec un curseur pour les zones de texte). En mode sélection : permet de cocher/décocher les checkboxes, enfoncer un bouton radio, sélectionner une option ou "cliquer" sur un lien : Navigator passe alors à la page située au bout du lien. Ainsi, appuyer deux fois sur Enter dans le mode par défaut permet de "cliquer" sur le premier lien de l'écran (s'il n'y a pas de forme avant).
Lorsque le curseur pointe sur une zone de texte, appuyer sur ENTER permet de passer en mode édition (voir plus loin)
ON : pour sortir du proramme. En mode sélection, donc après appui sur Enter, repasse au mode texte (qui permet d'utiliser les flèches latérales shiftées pour changer de page dans l'historique). En mode édition, ON fait retourner au mode sélection.
Shift rouge puis flèches verticales : pour accéder au début ou à la fin du texte.
Touche S (speed) : modifie la vitesse de défilement : une fois pour accélérer, une deuxième fois pour revenir à la vitesse lente. Le sablier indique que la vitesse est rapide.
Touche U (URL) : permet de saisir une adresse internet (Universal Resource Location, ou URL) que le navigateur télécharge et affiche. Le surf continue à partir de cette page, qui est ajoutée à l'historique. Voir le paramètre URL pour le format de saisie. Au lieu de taper une URL, il est également possible d'appuyer sur ENTER pour lancer le FILER.
STO : permet de stocker la page courante dans HOME. Une invite est lancée pour saisir le nom du fichier à sauvegarder, puis Navigator revient à l'affichage de cette page. Note: les pages stockées dans HOME n'ont pas à être re-téléchargées lors du retour à ces pages dans l'historique.
Alpha : en mode sélection, permet d'accéder au mode édition (comme ENTER).

HIST : lance un menu déroulant permettant de choisir entre les pages web préférées. Les données sont stockées dans la variable 'Favorites' de HOME.
VAR : enregistre la page actuellement visitée dans la liste des URLs préférées. (fonction seulement accessible quand la page affichée vient d'être téléchargée, c'est-à-dire quand Navigator est en mode online et donc connaît l'adresse de la page actuelle)
COPY (shift rouge puis VAR) : copie le lien actuellement en surluminescence vers le presse-papier de l'éditeur standard de la HP49.

Le mode édition :

Spécificité des versions 0.04 et suivantes, le mode édition permet de taper du texte en utilisant le clavier normal de la hp49g+/50g. On y accède en sélectionnant une zone de texte (appuyer sur ENTER pour passer en mode sélection, puis sur les flèches gauche et droite pour déplacer la sélection sur une zone de texte) puis en appuyant à nouveau sur ENTER ou bien sur Alpha : l'indicateur Alpha s'allume. Les shifts, la touche alpha et le reste du clavier s'utilisent comme en mode édition normal de la calculatrice. Pour sortir du mode édition sans valider, appuyer sur ON. Pour sortir du mode édition en validant la forme, appuyer sur ENTER. Une fois le texte sauvé, on peut l'envoyer au serveur distant en appuyant sur ENTER alors qu'un bouton d'envoi est en surluminescence (les boutons d'envoi sont soulignés, comme les liens).

Voici un diagramme qui résume l'utilisation de base du navigateur :

Ensuite, deux options :

utilisation hors-ligne :
Il vous faut des pages HTML stockées dans HOME et ses sous-répertoires. On peut utiliser en particulier cette documentation garantie compatible avec Navigator, en la transférant de préférence par Xmodem (utiliser Conn4x sous Windows ou C-Kermit par exemple sous Linux).
Placer une chaîne contenant un fichier HTML au niveau 1 pour l'afficher. Si aucun objet n'est placé au niveau 1, ou si ce n'est pas une chaîne, Navigator lance le filer et vous invite à sélectionner un fichier HTML puis à l'ouvrir (icone OPEN).
Pour une utilisation simple, les liens doivent être relatifs : <a href=../docs/fichier.html>.
En cas de lien absolu, Navigator tente de lancer la connexion en exécutant le programme Connection que vous avez stocké dans HOME ou un des sous-répertoires compris dans le chemin courant. Si la connexion réussit, la page demandée est téléchargée et affichée.
Utilisation en ligne :
Nécessite de connecter la hp49/50 à un modem externe au moyen d'un connecteur HP-modem que vous pouvez construire ou acheter : j'en vends en effet quelques uns 3 euros plus 5 euros de port pour faciliter les tests en ligne.
Il est également possible de se servir d'un ordinateur comme passerelle (testé sous Linux) et d'utiliser ainsi la connexion internet de l'ordinateur.
L'utilisation en ligne nécessite d'installer la remarquable bibliothèque Usinagaz 0.3, logiciel TCP/IP de Samuel Thibault.
A noter que les versions précédentes d'Usinagaz ne sont pas compatibles avec Navigator 0.04 et suivantes.

Dans ce cas, il faut définir 2 variables :
Connection : programme à lancer pour effectuer la connexion internet via le modem
URL : adresse internet par laquelle débuter la connexion.
exemples : "www.hp-sources.com/navigator/index.html"
"www.hp-sources.com/navigator/" (ne pas oublier le dernier "/")
A noter que les variables Domain et Path des versions 0.04 et précédentes ne sont plus nécessaires.
D'autre part, on peut se passer de variable 'URL' à condition de placer une chaîne URL au niveau 1 de la pile (en mode connecté).

Exemple de programme pour Connection avec un modem Sportster Flash V.90 Voice PnP :	...et pour modem Olitec Speed'Com V92 Ready (exemple avec authentification PAP)

Une fois ces paramètres définis, il vous suffit de vous connecter à internet avec la hp49/50 et de lancer Navigator pour surfer à partir de la page spécifiée. Pendant la réception des fichiers, l'indicateur I/O clignote. En cas d'erreur temporaire de réception, les indicateurs shift gauche et alarme sont allumés.

Information concernant les différentes entrées de la bibliothèque :

L'entrée NAVIGATOR correspond à la version de Navigator avec présentation graphique.
A la fin de la présentation, appuyer sur ON pour arrêter le programme ou une autre touche pour continuer.
L'entrée NAV correspond à la version à exécution directe, sans présentation.
La fonction FILNAV (présente depuis la version 0.09) permet de lancer le gestionnaire de fichiers, que l'on soit connecté ou non, et quel que soit l'état de la pile, cela pour accélérer facilement l'utilisation lorsqu'on n'est pas connecté. Dans le filer, l'icone BLANK lance l'affichage d'une page blanche, qui permet de presser "U" pour basculer dans le mode online.

Variables créées par Navigator version 0.07 et suivantes :

Cookies : comme son nom l'indique, cette variable sert à stocker les cookies, petits fichiers de données envoyés par le serveur, et que la HP doit ré-emmetre à chaque demande de page du même domaine.
Favorites : liste contenant deux sous-listes, la première contient des noms de page (exemple : "Google", "Yahoo"...), la seconde, des URLs (exemple : "www.google.fr", "www.yahoo.fr"...).

Yoann Désir.