Blame docs/README.options

Packit f574b8
README.options
Packit f574b8
Packit f574b8
Using the lynx browser [O]ptions configuration tool. 
Packit f574b8
Packit f574b8
General Usage on a unix system:
Packit f574b8
Packit f574b8
Press "O" at any time in your lynx session to access this utility page. 
Packit f574b8
This is one of several custom "system" URLs that cause lynx to self-configure.
Packit f574b8
Packit f574b8
Please note:
Packit f574b8
Ensure and confirm that your [O]ptions session is flushed to disk, by selecting:
Packit f574b8
Packit f574b8
Save options to disk: [_] before selecting "Accept Changes".
Packit f574b8
Packit f574b8
This freshens your .lynxrc file, which is your default "personal" configuration
Packit f574b8
for the lynx browser.  Otherwise you will only affect settings for your 
Packit f574b8
individual session; they aren't remembered next time you use lynx, (since you
Packit f574b8
actually did not tell lynx to remember them).
Packit f574b8
Packit f574b8
This disk write to .lynxrc is not default behaviour for [O]ptions
Packit f574b8
configurations. The lynx browser tends to tread lightly at first. Note that 
Packit f574b8
you must first have permission on your system to create, write to and read
Packit f574b8
from a .lynxrc file in your home directory.
Packit f574b8
Packit f574b8
Using some of the menu items:
Packit f574b8
Packit f574b8
User mode controls the amount of "on screen" help at the bottom of the screen.
Packit f574b8
You get the familiar view of the link target you are on when you use ADVANCED
Packit f574b8
user mode, and this also gives you the most top to bottom screen area. 
Packit f574b8
ADVANCED user mode also allows for sub bookmark functionality (see below). 
Packit f574b8
Packit f574b8
The (for now) command line only option --nomargins provides the largest 
Packit f574b8
readable left to right screen coverage.
Packit f574b8
Packit f574b8
Editor is for jumping to vi or whatever you prefer during local file edits
Packit f574b8
and for textarea editing with ^Xe if you are filling out a form while browsing.
Packit f574b8
Packit f574b8
Please see README.cookies for a brief cookie handling discussion.
Packit f574b8
Packit f574b8
Multi-bookmarks allows several files to be your bookmarks; it will introduce
Packit f574b8
a browse list of them if they are defined as below.
Packit f574b8
Packit f574b8
Once the Multi-bookmarks setup on Options is done and has been written out to
Packit f574b8
your .lynxrc (remember to Accept Changes and to Save Changes to disk),
Packit f574b8
in .lynxrc you will see a list of 25 possible "other" bookmark files 
Packit f574b8
(26 letters minus "A") - you need to then associate some of them with 
Packit f574b8
(meaningful) filenames to get the Multi-bookmark menu.
Packit f574b8
Packit f574b8
Note that the files must be relative to your home directory. 
Packit f574b8
Packit f574b8
The best way to create and manage them is by using the MultiBookmarkMenu (MBM) 
Packit f574b8
configuration tool selectable from the [O]ptions menu. 
Packit f574b8
Packit f574b8
The MBM allows you to describe the sub bookmark, and name a file relative 
Packit f574b8
to your home directory that will contain the html for the saved links.
Packit f574b8
You populate one of the lettered sub bookmarks, describe it, and provide a 
Packit f574b8
filename. ">" saves the edits, and ^G cancels edits.
Packit f574b8
Packit f574b8
The sub bookmarks will be accessible by pressing the associated key from a
Packit f574b8
menu when invoking the bookmark choice (lynx -book, or 'V' in a session), or 
Packit f574b8
when saving new bookmarks. You can directly access your sub bookmarks by letter
Packit f574b8
key alone by defining sub_bookmarks=ADVANCED in .lynxrc or lynx.cfg, if you 
Packit f574b8
have ADVANCED general user mode selected as well.
Packit f574b8
The Multi-bookmark submenu can still be seen in ADVANCED by pressing "=", and
Packit f574b8
is always seen in STANDARD mode.
Packit f574b8
Packit f574b8
They are seen in your .lynxrc like so:
Packit f574b8
Packit f574b8
multi_bookmarkB=cars,Cars
Packit f574b8
multi_bookmarkC=news,News
Packit f574b8
multi_bookmarkD=sports,Sports
Packit f574b8
Packit f574b8
Filename precedes description in .lynxrc, whereas in the MBM configuration
Packit f574b8
utility, the description is the left column, and the filename is in the right
Packit f574b8
column displayed.
Packit f574b8
Packit f574b8
Packit f574b8
Stef Caunter 
Packit f574b8
http://caunter.ca/contact.html
Packit f574b8
http://caunter.ca/README.options
Packit f574b8