|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
<html>
|
|
Packit |
f574b8 |
<head>
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
"HTML Tidy for Linux (vers 25 March 2009), see www.w3.org">
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
<title>Help on the Follow link (or page) number feature</title>
|
|
Packit |
f574b8 |
<link rev="made" href="mailto:lynx-dev@nongnu.org">
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
"text/html; charset=us-ascii">
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
" Lynx allows the user to select a link using a single-digit shortcut. There are several configuration choices which apply to this feature.">
|
|
Packit |
f574b8 |
</head>
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
<body>
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Overview
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Zero and other digits
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Suffixes
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Specifics for Form Fields
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Hidden Links
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Navigating to Hidden
|
|
Packit |
f574b8 |
Links
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
If a user has set one of these modes, (as the default or for
|
|
Packit |
f574b8 |
the current session via the Options menu) then hypertext
|
|
Packit |
f574b8 |
links (and form fields, depending on the keypad mode) are
|
|
Packit |
f574b8 |
prefixed with numbers in square brackets:
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Keypad mode to Links are numbered,
|
|
Packit |
f574b8 |
or
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Form fields are numbered, or
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Links and form fields are numbered
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Entering a keyboard or keypad number is treated as an
|
|
Packit |
f574b8 |
F_LINK_NUM command, and should invoke the Follow
|
|
Packit |
f574b8 |
link (or goto link or page) number: statusline prompt for a
|
|
Packit |
f574b8 |
potentially multiple digit number corresponding to an indicated
|
|
Packit |
f574b8 |
link number.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
digits
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
The prompt can be invoked via typing a zero (0), but
|
|
Packit |
f574b8 |
it will not be treated as the lead digit for the number entry,
|
|
Packit |
f574b8 |
whereas digits 1 through 9 both invoke the prompt and are treated
|
|
Packit |
f574b8 |
as the first digit.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
In Form fields are numbered or Links and form
|
|
Packit |
f574b8 |
fields are numbered mode, if the number corresponds to a
|
|
Packit |
f574b8 |
form field you will be positioned on that field, but if it is a
|
|
Packit |
f574b8 |
submit button it will not be ACTIVATE-ed.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
If the user has set Keypad mode to Numbers act as
|
|
Packit |
f574b8 |
arrows, then only a zero digit will be treated as an
|
|
Packit |
f574b8 |
F_LINK_NUM command for invoking the Follow link (or
|
|
Packit |
f574b8 |
goto link or page) number: prompt.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
After accepting a number at the prompt, Lynx
|
|
Packit |
f574b8 |
accepts an optional suffix:
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
RETURN (activate)
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Without a suffix, e.g., If RETURN is pressed to
|
|
Packit |
f574b8 |
terminate the number entry (e.g., 123) and it
|
|
Packit |
f574b8 |
corresponds to a hypertext link, Lynx will
|
|
Packit |
f574b8 |
retrieve the document for that link as if you had paged or used
|
|
Packit |
f574b8 |
other navigation commands to make it the current link and then
|
|
Packit |
f574b8 |
ACTIVATE-ed it.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
g (go)
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
If the number entered at the prompt has a
|
|
Packit |
f574b8 |
“g” suffix (e.g., 123g), then
|
|
Packit |
f574b8 |
Lynx will make the link corresponding to
|
|
Packit |
f574b8 |
that number the current link, paging as appropriate if the
|
|
Packit |
f574b8 |
link does not appear in the currently displayed page. The
|
|
Packit |
f574b8 |
“g” suffix is inferred (need not be
|
|
Packit |
f574b8 |
entered) for form fields in Form fields are numbered
|
|
Packit |
f574b8 |
or Links and form fields are numbered mode.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
p (page)
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Alternatively, if the number is given a
|
|
Packit |
f574b8 |
“p” suffix (e.g., 123p),
|
|
Packit |
f574b8 |
Lynx will make the page corresponding to
|
|
Packit |
f574b8 |
that number the currently displayed page, and the first link
|
|
Packit |
f574b8 |
on that page, if any, the current link. The
|
|
Packit |
f574b8 |
“g” and “p”
|
|
Packit |
f574b8 |
suffixes thus convert the Follow link (or goto link or
|
|
Packit |
f574b8 |
page) number: feature to an advanced navigation aid.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
+ or
|
|
Packit |
f574b8 |
- (jump)
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Finally, a user may add a + or - suffix
|
|
Packit |
f574b8 |
to a number command to indicate jumping forward or back
|
|
Packit |
f574b8 |
relative to the current link or page. For example, typing
|
|
Packit |
f574b8 |
1g+ followed by RETURN will move the current link to
|
|
Packit |
f574b8 |
the next numbered link, skipping any intervening pages or
|
|
Packit |
f574b8 |
unnumbered links; 1g- goes to the preceding numbered
|
|
Packit |
f574b8 |
link. On a page without links, 3g+ goes to the 3rd
|
|
Packit |
f574b8 |
link following the page. 5p+ skips ahead 5
|
|
Packit |
f574b8 |
pages, and so on. You can also enter 5+ or
|
|
Packit |
f574b8 |
5-, which will activate the 5th link ahead/behind
|
|
Packit |
f574b8 |
where you are currently positioned. Note that typing
|
|
Packit |
f574b8 |
1g+ is different from typing a down arrow in that
|
|
Packit |
f574b8 |
1g+ skips pages containing no links, or intervening
|
|
Packit |
f574b8 |
non-numbered links, such as form fields when form fields are
|
|
Packit |
f574b8 |
not numbered. It also differs from the <tab>
|
|
Packit |
f574b8 |
command in that 1g+ does not skip over whole
|
|
Packit |
f574b8 |
textareas, unless form fields are not numbered.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
NOTE: 1+g 1-g 1+p 1-p are all recognized
|
|
Packit |
f574b8 |
as equivalent to 1g+ 1g- 1p+ 1p- . Any other
|
|
Packit |
f574b8 |
(mistyped) characters end the formula: e.g. 1gh+ is
|
|
Packit |
f574b8 |
treated as 1g.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Fields
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Numbers are associated with form fields only when
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Form fields are numbered or
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Links and form fields are numbered mode has been
|
|
Packit |
f574b8 |
selected.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
If you have selected Numbers act as arrows or
|
|
Packit |
f574b8 |
Links are numbered mode, you can seek form fields in the
|
|
Packit |
f574b8 |
document via WHEREIS searches for strings in their displayed
|
|
Packit |
f574b8 |
values. If they are INPUT or TEXTAREA fields with no values as
|
|
Packit |
f574b8 |
yet, you can use two or more underscores as the search string,
|
|
Packit |
f574b8 |
because underscores are used as placeholders for form fields in
|
|
Packit |
f574b8 |
the displayed document.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
When you have invoked a popup window for a
|
|
Packit |
f574b8 |
list of OPTIONs in a form's SELECT block:
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
each OPTION is associated with a number, and that number
|
|
Packit |
f574b8 |
will be displayed in Form fields are numbered or
|
|
Packit |
f574b8 |
Links and form fields are numbered mode.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
In any keypad mode, the F_LINK_NUM
|
|
Packit |
f574b8 |
(“0”) command will invoke a Select
|
|
Packit |
f574b8 |
option (or page) number: prompt, and you can enter a
|
|
Packit |
f574b8 |
number, and optionally a “g” or
|
|
Packit |
f574b8 |
“p” suffix, to select or seek an OPTION in
|
|
Packit |
f574b8 |
that list.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
If only a number is entered at the prompt, the
|
|
Packit |
f574b8 |
corresponding OPTION will be selected and the popup will be
|
|
Packit |
f574b8 |
retracted.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
If the “g” suffix is included, then
|
|
Packit |
f574b8 |
you will be positioned on the corresponding OPTION in the list,
|
|
Packit |
f574b8 |
paging through the list if necessary, but it will not be
|
|
Packit |
f574b8 |
treated as selected unless you enter the ACTIVATE (RETURN or
|
|
Packit |
f574b8 |
right-arrow) command when positioned on the OPTION.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
For purposes of paging (e.g., in conjunction with the
|
|
Packit |
f574b8 |
“p” suffix), a page is defined as
|
|
Packit |
f574b8 |
the number of OPTIONs displayed within the vertical dimension
|
|
Packit |
f574b8 |
of the popup window.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Finally, the + and - suffixes can be used
|
|
Packit |
f574b8 |
to move forward or back from the current option or page in a
|
|
Packit |
f574b8 |
popup menu, similarly to the way they are used for links.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
For example, while viewing a popup window, the user can type
|
|
Packit |
f574b8 |
3p+ and RETURN to skip ahead 3 pages, and 50g-
|
|
Packit |
f574b8 |
will move the current selection back 50 options. This will work
|
|
Packit |
f574b8 |
whether or not keypad mode is Form fields are
|
|
Packit |
f574b8 |
numbered or Links and form fields are numbered
|
|
Packit |
f574b8 |
since options are numbered internally. If form field numbering is
|
|
Packit |
f574b8 |
turned off, the option numbers will not appear on screen, but the
|
|
Packit |
f574b8 |
user can still navigate using these commands.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Links
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
HTML can be structured so that it includes hidden
|
|
Packit |
f574b8 |
links, i.e., without a visible link name intended for
|
|
Packit |
f574b8 |
ACTIVATE-ing the link. Such links may be created, for example,
|
|
Packit |
f574b8 |
by
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
making an IMG element the sole content of an Anchor
|
|
Packit |
f574b8 |
element, and including an ALT="" attribute name/value pair to
|
|
Packit |
f574b8 |
suppress access to the link when the browser does not have
|
|
Packit |
f574b8 |
support for image handling available.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
having truly empty Anchor content, in cases for which the
|
|
Packit |
f574b8 |
value of an Anchor's HREF attribute is intended as a navigation
|
|
Packit |
f574b8 |
aid for robots (typically indexers) and not as content for a
|
|
Packit |
f574b8 |
browser's rendition of the document.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
using the -ismap command line switch, which makes
|
|
Packit |
f574b8 |
Lynx additionally treat a link to a
|
|
Packit |
f574b8 |
server-side image maps as hidden if there also is a client-side
|
|
Packit |
f574b8 |
map for the same image.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
bad HTML, which may produce hidden links.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Hidden links differ from Anchors that have only a
|
|
Packit |
f574b8 |
NAME or ID attribute name/value pair (intended as positioning
|
|
Packit |
f574b8 |
targets from other links which do have HREF attributes and values
|
|
Packit |
f574b8 |
that include a fragment).
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
Lynx respects instructions for hidden
|
|
Packit |
f574b8 |
links and normally does not include them in the rendition of
|
|
Packit |
f574b8 |
the document. However, if the command line switch
|
|
Packit |
f574b8 |
-hiddenlinks=merge is used, such links will still be
|
|
Packit |
f574b8 |
numbered in sequence with other links which are not hidden, and
|
|
Packit |
f574b8 |
if Links are numbered mode is also on, link numbers will
|
|
Packit |
f574b8 |
appear for them in the displayed text (except for links to image
|
|
Packit |
f574b8 |
maps which are hidden because of -ismap). If
|
|
Packit |
f574b8 |
-hiddenlinks=listonly or -hiddenlinks=ignore is
|
|
Packit |
f574b8 |
in effect, hidden links will not be shown in the text
|
|
Packit |
f574b8 |
even in links are numbered mode. Not using a
|
|
Packit |
f574b8 |
-hiddenlinks flag at all is equivalent to
|
|
Packit |
f574b8 |
-hiddenlinks=listonly.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
to Hidden Links
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
If a document includes hidden links, they will be
|
|
Packit |
f574b8 |
reported, with appropriate labeling, in the menus created for the
|
|
Packit |
f574b8 |
LIST (“l”) or ADDRLIST
|
|
Packit |
f574b8 |
(“A”) commands, unless
|
|
Packit |
f574b8 |
-hiddenlinks=ignore is used. They can then be
|
|
Packit |
f574b8 |
ACTIVATE-ed via those menus.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
If a link was hidden because of an ALT attribute in an IMG
|
|
Packit |
f574b8 |
element, it will be converted to a visible link whenever
|
|
Packit |
f574b8 |
the IMAGE_TOGGLE (“*”) command is used to
|
|
Packit |
f574b8 |
create links for SRC attribute values of IMG elements, because
|
|
Packit |
f574b8 |
this indicates that the user does have some form of image
|
|
Packit |
f574b8 |
handling enabled via a helper application, or wishes to download
|
|
Packit |
f574b8 |
files for subsequent use with a graphic browser or other suitable
|
|
Packit |
f574b8 |
software.
|
|
Packit |
f574b8 |
|
|
Packit |
f574b8 |
HTML forms may have fields with a HIDDEN attribute, indicating
|
|
Packit |
f574b8 |
that a name/value pair for the fields should be included in the
|
|
Packit |
f574b8 |
content submitted for the form, but the value should not be
|
|
Packit |
f574b8 |
displayed in the rendered form. Lynx respects
|
|
Packit |
f574b8 |
this attribute as well, and neither displays the HIDDEN field,
|
|
Packit |
f574b8 |
nor assigns it a number for the F_LINK_NUM
|
|
Packit |
f574b8 |
(“0”) command and Form fields are
|
|
Packit |
f574b8 |
numbered or Links and form fields are numbered
|
|
Packit |
f574b8 |
keypad mode handling, nor includes an entry for it in the menus
|
|
Packit |
f574b8 |
created for the LIST (“l”) or ADDRLIST
|
|
Packit |
f574b8 |
(“A”) commands. However, the HIDDEN
|
|
Packit |
f574b8 |
name/value pairs are included in any displays of submitted form
|
|
Packit |
f574b8 |
content in the Information about the current document
|
|
Packit |
f574b8 |
that is invoked by the INFO (“=”)
|
|
Packit |
f574b8 |
command.
|
|
Packit |
f574b8 |
</body>
|
|
Packit |
f574b8 |
</html>
|