Lynx 2.7.1
==========

Text-only HTML/Web Browser

QDOS Port by Jonathan Hudson
This Zip archive created by Tim Swenson

Introduction
------------

Lynx is a text-only browser for HTML files.  Due to the QL not having
network access, only local files may be browsed.  If you have Internet
access, either on the QL or other system, HTML files can be saved,
brought to the QL and browsed.  Using standard editors and some HTML
creation tools, HTML documents can be created and browsed on the
QL.

This Archive
------------

This archive of Lynx is taken from an older archive of Jonathan 
Hudsons that is no longer available.  The archive was rather large
and included full source and documentation.  This archive was created
to create a minimal installation of Lynx that should run on most
QL's.  Included is only the necessary files for running Lynx.

This archive should be able to unzip on a 720K disk with a little room 
to spare.  It has been tested on a JSU ROM QL with a Gold Card and it 
ran just fine.  On a starndard QL, it may run a bit slow and it will take
 a while to start up.


Installation
------------

Besides this archive, the Environment Variable (ENV_BIN) extension must 
be present.  This is available with the C68 distribution, Jonathan
Hudson's web page, or the usual QL BB's and freeware sources.

Once you unzip the archive, look at the lynx_BOOT file.  It has the 
Environment Variable commands that must be set before Lynx will run.

   120 SETENV "TERM=qdos"
   130 SETENV "TERMINFO=flp1_terminfo"
   140 SETENV "LYNX_CON=512x256a0x0_6_0_4"
   150 STOP
   170 EX flp1_lynx;"/flp1/index.html"

I would recommend putting these SETENV commands in your BOOT file.
If not, the delete line 150 and run this BOOT file to start Lynx.

There are three example HTML files on disk that can be used
to test out Lynx.  The above line 170 will execute Lynx with
the main example document loaded.

If you are installing Lynx on a hard disk or RomDisq, change
all referenced to 'flp1' to what ever device you need.



Configuring Lynx
----------------

There are two files that are used to configure Lynx: lynxrc and lynx_cfg.
I have edited these files to add only those options I thought that most
QLers would need.  As configured, Lynx will run for most uses.  If you 
feel brave enough to tackle the config files, go ahead.  All discussion
in this document will be based on Lynx with the confuration set as 
unzipped from the archive.


Executing Lynx
--------------

Once the Environment Variables have been set, you need to execute
Lynx.  Lynx can be executed with no arguements and will load with
a blank page.  To execute it with an arguement of an HTML file,
execute it like this:

  the HTML file is flp1_index_html

     exec flp1_lynx;"/flp1/index.html"

You need to convert a QDOS filename to a Unix file name.
You do this by adding a '/' to the device name, convert the
first underscore to another '/', and then use a period instead
of a underscore for the file extension.

If you have a file with more that one underscore, such as,

     flp1_file_name_html

then it would be converted to

     /flp1/file/name.html


Movement in Lynx
----------------

Where most web browsers use a mouse to control the screen, Lynx uses
keys.  Lynx is based on Links.  A link is a pointer to an other file
or to a location in the same file.  Keys are used to move between 
the different links.  Links are shown in reverse text.  If a section
of an HTML file does not have any links, Lynx will display that section
and you use the space bar to scroll more text.

As configured, Lynx used two sets of keys for movement.  Most users will
want to use the Arrow keys on the Number pad (not seperate arrow keys).  
To be used, the NUMLOCK must turned on. The arrow keys perform the 
following functions:

   arrow up    - Move up a link on the screen
   arrow down  - Move down a link on the screen
   arrow right - Move to the link (another file or location)
   arrow left  - Move back a link (to a previous screen)

Lynx is also configured to use the Unix editor 'vi' keys.  These
keys are:

    k  - arrow up
    j  - arrow down
    l  - arrow right
    h  - arrow left

Once Lynx starts, there is a menu at the bottom of the screen.
It lists various other commands.  The Help command is not working
as it want to link to a web site.

The primary commands are:

   Q - quit
   P - Print.  Print current file or save current file to disk.
   / - To search the current file for a word or phrase.
   O - Options.  Same as the in the lynxrc file.
   G - Goto.  Load another HTML file.

When entering text into Lynx (say when loading another file), use
the CTRL-H key instead of the Delete (back arrow) key.


That's All
----------
This document and Lynx archive should be enough to get you started.
If you have any additional questions, please contact me at
  swensont@jack.sns.com


