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