Documentation for Navigator 1.00n+

Documentation for Navigator 1.00n+

Email : ydesir@altern.org
URL : http://ydesir.free.fr/navigator/english.html
Adress : Yoann Désir, 19, rampe Saint-Syllas, 77160 PROVINS, FRANCE

To use this new version, you have to install the Navigator 1.00n+ library in any port of your hp49g+/50g.

Overview :

Navigator 1.00n+ is only one of the first versions, which bugs have not been fixed all, despite an intensive debugging. HTML viewing seems to be quite stable, but the dispaying program could make your HP bug severely, so backup your IRAM first...

Keys :

Up and down arrows : perform vertical text scrolling. They're to be used at first to read the text.
Left and right arrow : to come back to previous page or go to the next one (since version 0.08e, that function needs to press Red shift before, in order to prevent the user from unwillingly pressing the left and right arrows). In selection mode (selected by pressing Enter), moves the video inversion from a link to another one, and from a form to another. If the video inversion goes offscreen, the screen is readjusted.
ENTER : in text mode (default mode), selects the selection mode. The first link or the first form on the screen is video inverted (a cursor appears in the text areas). In selection mode, allows to "click" on a link, check/uncheck a checkbox, select an option or press a radio button. When you click on an link, Navigator goes to the page located at the end of the link. So, pressing Enter twice in the default mode allows to "click" on the first link on the screen (if there is no input form before). Pressing ENTER in selection mode when a text area is selected puts Navigator in editing mode (cf later).
ON : to get out of the program. In selection mode, so after having pressed Enter, comes back to text mode (which allows to use red shift + lateral arrows to move to the previous or next page in the history). In editing mode, comes back to selection mode.
Red shift then vertical arrows : to access to the beginning or the end of the text.
S key (speed) : modifies the scrolling speed : once to accelerate, one more time to slow. The busy annunciator indicates fast speed mode.
U key (URL) : allows to type in an internet adress (Universal Resource Location) that the navigator downloads and displays. Surfing goes on from that page, which is added to the history. See the URL parameter for the typing format. Instead of typing an URL, you can also press ENTER to launch the FILER.
STO : allows to store the current page inside a HOME directory variable. An input is launched to type in the name of the variable to store the page into, then Navigator comes back to the display of that page. Note: the pages stored in HOME variables don't have to be downloaded again when you go back to those pages in the history.
Alpha : in selecting mode, allows to access to the editing mode, like ENTER.

[+/-] (W key) : The most impressive improvement throughout the latest releases : switches the display between small and medium font. Please note the page is thus reloaded and displayed from the beginning again. The input forms and text area content is cancelled and set up again.

HIST : launches a choose box allowing to select one page among your favorite ones. The data is stored in the 'Favorites' variable of the HOME directory.
VAR : saves the adress of the current page into the list of your favorite URLs. (function only available if the displayed page has just been downloaded, that is when Navigator is in online mode and therefore knows the adress of the current page)
COPY (red shift then VAR) : copies the highlighted link into the HP49 standard editor buffer.

The editing mode :

Present in version 0.04 and next ones, the editing mode allows you to type in text using the normal keyboard of the hp49g+/50g. You access to the editing mode with selecting a text area (press ENTER to go to selecting mode, then the left and right arrows to move the selection on a text area), then pressing ENTER again or Alpha : the Alpha annunciator lights on. The shifts, the alpha key and the rest of the keyboard are to be used like in the normal editing mode of the calculator. To get out of the editing mode without saving, press ON. To get out of the editing mode and save the text, press ENTER.
Since the text is saved, you can submit it with pressing ENTER on a highlighted submit button (submit buttons are underlined, like the links).

Here is a graphic which sumaries the basic use of the navigator :

Then, two options :

Offline use :
You need HTML pages stored in HOME and its subdirectories. One can for instance use this documentation guaranteed compatible with Navigator, transfering it with Xmodem (use Conn4x under Windows or C-Kermit for example under Unix).
Put a string containing HTML on stack level 1 to display it. If no object is present on level 1, or if it isn't a string, Navigator launches the filer and invites you to select an HTML file and to open it (OPEN icon).
For a simple use, links must be relative : <a href=../docs/file.html> for example.
In case of an absolute link, Navigator tries to launch the connection executing the Connection program that you have stored in HOME or its subdirectories included in the current path. If the connection succeeds, the page asked is downloaded and displayed.
Online use :
Needs to connect the HP48 or 49 to an external phone modem with an HP-modem connector that you can build or buy : I sell some $3 plus $5 of shipping, to make it easy to perform online tests.
It is also possible to use a computer as a relay (tested under Linux) and to share the internet connexion of the computer.
Online use needs to install the remarkable library Usinagaz 0.3, TCP/IP sofware by Samuel Thibault.
Note that the previous versions of Usinagaz are not compatible with Navigator 0.04 and next versions.

In that case, you need to define 2 variables :
Connection : program to launch to connect to internet via the modem
URL : internet adress with which to start the connection.
examples : "ydesir.free.fr/navigator/english.html"
"ydesir.free.fr/navigator/" (do not forget the last "/")
Note that the Domain and Path variables of versions 0.04 and previous are not necessary anymore.

Note : example of program for Connection with a Sportster Flash V.90 Voice PnP modem :	...and for an Olitec Speed'Com V92 Ready modem (example with PAP authentification)

Once those parameters are defined, you can connect to internet with the hp49/50 and launch Navigator to surf from the specified page. While surfing, the I/O annunciator blinks. In case of temporary receiving error, the Alarm or the left shift annunciators are lightened.

Note about versions 0.06 and next ones :

The NAVIGATOR entry launches the graphic presentation of Navigator. To abort, press ON. To continue, press any other key.
The NAV entry launches Navigator without any graphic presentation.

Variables created by Navigator version 0.07 and next ones :

Cookies : like its name says, this variable stores cookies, which are little data files sent by the web servers, and that the HP calculator has to re-send at each page request in the same domain.
Favorites : list containing two sub-lists, the first with page names (for instance : "Google", "Yahoo"...), and the second, URLs (for example : "www.google.com", "www.yahoo.com"...).

What's new from version 0.09 and above :

A help mode is available from the INFO.NAVIG library entry or from the Navigator itself pressing the [H] key (Help) :
that one enables the display of a rendering of the calculator keyboard.
While moving the highlight from one keyboard key to another using the arrow keys, one can get a recall of the functions the key belongs to.
New entries have been added : FILNAV launches the filer and allows to open (press the [F1-A] key belonging to the "OPEN" icon) an HTML file or either an empty page pressing the menu key belonging to the icon "BLANK";
the WGET entry from the library menu allows to download the html file that is located at the URL set on stack level 1 under the form of a character string.

Yoann Désir.