Re: lynx-dev patch: images & options

[Philip Webb]

990728 Klaus Weide invited:
> Please take this over, as far as I'm concerned.
> I'm not sure it isn't too technical for the UG, but leave that to you
> (and shall try not to complain, whatever you do :) ).
and Philip Webb replied:
> i'll saddle my horse, shine my armour & sharpen my spear ...
 
below are patches for Users Guide, Options Help &  lynx.cfg ,
adding explanations of the various choices for revealing/not images,
& moving VERBOSE_IMAGES to immediately precede the others in  lynx.cfg .
please assess THE RENDERED HTML, NOT the source below.

i await the arrival of the piranhas ...

*** old/Lynx_users_guide.html   Thu Mar  4 05:39:45 1999
--- new/Lynx_users_guide.html   Fri Jul 30 03:56:40 1999
***************
*** 49,54 ****
--- 49,55 ----
  <li><A HREF="#DirEd" NAME="ToC-DirEd">Directory Editing</A>
  <li><A HREF="#MiscKeys" NAME="ToC-MiscKeys">Scrolling and Other useful 
commands</A>
  <li><a href="#Forms" NAME="ToC-Forms">Lynx and HTML Forms</a>
+ | <a href="#Images" NAME="ToC-Images">Lynx and HTML Images</a>
  <li><a href="#Tables" NAME="ToC-Tables">Lynx and HTML Tables</a>
  | <a href="#Tabs" NAME="ToC-Tabs">Lynx and HTML Tabs</a>
  <li><a href="#Frames" NAME="ToC-Frames">Lynx and HTML Frames</a>
***************
*** 1497,1502 ****
--- 1498,1535 ----
  ><em>&lt;META <tab id="cdis">HTTP-EQUIV="Content-Disposition"<BR>
  <tab to="cdis">CONTENT="file;&nbsp;filename=name.suffix"&gt;</em><BR>
  [<A HREF="#ToC-Forms">ToC</A>]
+ 
+ <h2 ID="Images"><A NAME="Images"><em>Lynx and HTML Images</em></a></h2>
+ 
+ As a text browser, Lynx does not display images as such<br>
+ -- you need to define a viewer in <em>lynx.cfg</em>: see there -- ,<br>
+ but users can choose a number of ways of showing their presence.
+ <p>
+ There are 3 choices in <em>lynx.cfg</em>, with 2 corresponding keys:
+ <p><pre>
+      MAKE_LINKS_FOR_ALL_IMAGES        *  IMAGE_TOGGLE
+      MAKE_PSEUDO_ALTS_FOR_INLINES     [  INLINE_TOGGLE
+      VERBOSE_IMAGES                   no corresponding key
+ </pre><p>
+ You can also use the Options Menu, as outlined below:
+ <p><pre>
+      key  lynx.cfg       FM LM .lynxrc    variable in source
+ 
+        *  MAKE_LINKS_     Y  N       N    clickable_images
+        [  MAKE_PSEUDO_    Y  N       N    pseudo_inline_alts
+           VERBOSE_        Y  Y       Y    verbose_img
+ 
+ FM = new Form Menu ; LM = old List Menu ;
+ in  .lynxrc ,  VERBOSE_IMAGES  is called `verbose_images':
+ the other two cannot be saved between sessions.
+ </pre><p>
+ In the Forms Menu, the 3-way `Show images' selection<br>
+ combines the effects of the `*' & `[' keys, as follows:
+ <p><pre>
+      Ignore      clickable_images = FALSE, pseudo_inline_alts = FALSE
+      As labels   clickable_images = FALSE, pseudo_inline_alts = TRUE
+      As links    clickable_images = TRUE,  pseudo_inline_alts = unchanged
+ </pre>
  
  <h2 ID="Tables"><A NAME="Tables"><em>Lynx and HTML Tables</em></a></h2>
  
*** old/lynx_help/keystrokes/option_help.html   Wed Feb 17 09:29:33 1999
--- new/lynx_help/keystrokes/option_help.html   Fri Jul 30 04:16:40 1999
***************
*** 251,271 ****
  
  <H1><A NAME="SI">Show Images</A></H1>
  
! Text-based browser cannot show images directly, so we have a choice:
! <em>ignore all</em> images without ALT= text string
! (this is also switched by <A HREF="../Lynx_users_guide.html#[-key">'[' 
key</A>),
! <em>show labels</em> (see also "verbose images" for choice between [IMAGE] 
and filename),
! <em>use links</em> for every image to make it possible to download them
! (also switched by <A HREF="../Lynx_users_guide.html#*-key">'*' key</A>).
! Changing these settings will not be saved but could be made permanent
! by changing the respective settings in lynx.cfg.
  
  <H1><A NAME="VB">Verbose Images</A></H1>
  
! Controls whether or not Lynx replaces the [LINK], [INLINE] and [IMAGE] 
comments
! (for images without ALT) with filenames of these images.  This is extremely
! useful because now we can determine immediately which images are decorations
! (button.gif, line.gif) and which are important.
  
  <H1><A NAME="VI">VI keys</A></H1>
  
--- 251,275 ----
  
  <H1><A NAME="SI">Show Images</A></H1>
  
! This option combines the effects of the `*' & `[' keys as follows:
! <p><pre>
!      <em>ignore</em> all images which lack an ALT= text string,
!      <em>show labels</em>, e.g. [INLINE] -- see `Verbose Images' below -- ,
!      <em>use links</em> for every image, enabling downloading.
! </pre><p>
! This option setting cannot be saved between sessions.<br>
! See <A HREF="../Lynx_users_guide.html#Images">Users Guide</A>
! & <em>lynx.cfg</em> for more details.
  
  <H1><A NAME="VB">Verbose Images</A></H1>
  
! This allows you to replace [LINK], [INLINE] and [IMAGE]<br>
! -- for images without ALT -- with filenames:<br>
! this can be helpful by revealing which images are important<br>
! & which are merely decoration, e.g. <em>button.gif</em>, 
<em>line.gif</em>.<br>
! See <A HREF="../Lynx_users_guide.html#Images">Users Guide</A>
! & <em>lynx.cfg</em> for more details.
! 
  
  <H1><A NAME="VI">VI keys</A></H1>
  
*** old/lynx.cfg        Wed Jul 28 23:49:15 1999
--- new/lynx.cfg        Fri Jul 30 04:34:20 1999
***************
*** 459,473 ****
  #
  #SHOW_CURSOR:FALSE
  
- # VERBOSE_IMAGES controls whether or not Lynx replaces the [LINK], [INLINE] 
and
- # [IMAGE] comments (for images without ALT) with filenames of these images.
- # This can be useful in determining what images are decorations
- # (button.gif, line.gif) and what images are important (if the page writer
- # bothers to use useful names).
- #
- # If this option is set here, it will override the setting in userdefs.h.
- VERBOSE_IMAGES:TRUE
- 
  # If BOLD_HEADERS is set to TRUE the HT_BOLD default style will be acted
  # upon for <H1> through <H6> headers.  The compilation default is FALSE
  # (only the indentation styles are acted upon, but see BOLD_H1, below).
--- 459,464 ----
***************
*** 1218,1250 ****
  #
  #NO_FILE_REFERER:FALSE
  
  # If MAKE_LINKS_FOR_ALL_IMAGES is TRUE, all images will be given links
  # which can be ACTIVATEd.  For inlines, the ALT or pseudo-ALT ("[INLINE]")
! # strings will be links for the resolved SRC rather than just text.  For
! # ISMAP or other graphic links, the ALT or pseudo-ALT ("[ISMAP]" or "[LINK]")
! # strings will have '-' and a link labeled "[IMAGE]" for the resolved SRC
! # appended.  See also VERBOSE_IMAGES flag.
! #
! # The default defined here will override that in userdefs.h, and the user
! # can use LYK_IMAGE_TOGGLE to toggle the feature on or off at run time.
! #
! # The default also can be toggled via an "-image_links" command line switch.
  #
  MAKE_LINKS_FOR_ALL_IMAGES:FALSE
  
! # If MAKE_PSEUDO_ALTS_FOR_INLINES is FALSE, inline images which do not
! # specify an ALT string will not have "[INLINE]" inserted as a pseudo-ALT,
! # i.e., they'll be treated as having ALT="".  If MAKE_LINKS_FOR_ALL_IMAGES
! # is defined or toggled to TRUE, however, the pseudo-ALTs will be created
! # for inlines, so that they can be used as links to the SRCs.
  # See also VERBOSE_IMAGES flag.
  #
! # The default defined here will override that in userdefs.h, and the user
! # can use LYK_INLINE_TOGGLE to toggle the feature on or off at run time.
! #
! # The default also can be toggled via a "-pseudo_inlines" command line
! # switch.
! #
  MAKE_PSEUDO_ALTS_FOR_INLINES:FALSE
  
  # If SUBSTITUTE_UNDERSCORES is TRUE, the _underline_ format will be used
--- 1209,1247 ----
  #
  #NO_FILE_REFERER:FALSE
  
+ # VERBOSE_IMAGES controls whether Lynx replaces [LINK], [INLINE] and [IMAGE]
+ # (for images without ALT) with filenames of these images.
+ # This can be useful in determining what images are important
+ # and which are mere decorations, e.g. button.gif, line.gif,
+ # provided the author uses meaningful names.
+ #
+ # The definition here will override the setting in userdefs.h.
+ VERBOSE_IMAGES:TRUE
+ 
  # If MAKE_LINKS_FOR_ALL_IMAGES is TRUE, all images will be given links
  # which can be ACTIVATEd.  For inlines, the ALT or pseudo-ALT ("[INLINE]")
! # strings will be links for the resolved SRC rather than just text.
! # For ISMAP or other graphic links, ALT or pseudo-ALT ("[ISMAP]" or "[LINK]")
! # will have '-' and a link labeled "[IMAGE]" for the resolved SRC appended.
! # See also VERBOSE_IMAGES flag.
  #
+ # The definition here will override that in userdefs.h
+ # and can be toggled via an "-image_links" command-line switch.
+ # The user can also use the LYK_IMAGE_TOGGLE key (default `*')
+ # or the `Show Images' option in the (new) Options Form.
  MAKE_LINKS_FOR_ALL_IMAGES:FALSE
  
! # If MAKE_PSEUDO_ALTS_FOR_INLINES is FALSE, inline images which don't specify
! # an ALT string will not have "[INLINE]" inserted as a pseudo-ALT,
! # i.e. they'll be treated as having ALT="".
! # Otherwise (if TRUE), pseudo-ALTs will be created for inlines,
! # so that they can be used as links to the SRCs.
  # See also VERBOSE_IMAGES flag.
  #
! # The definition here will override that in userdefs.h
! # and can be toggled via a "-pseudo_inlines" command-line switch.
! # The user can also use the LYK_INLINE_TOGGLE key (default `[')
! # or the `Show Images' option in the (new) Options Form.
  MAKE_PSEUDO_ALTS_FOR_INLINES:FALSE
  
  # If SUBSTITUTE_UNDERSCORES is TRUE, the _underline_ format will be used


-- 
========================,,============================================
SUPPORT     ___________//___,  Philip Webb : address@hidden
ELECTRIC   /] [] [] [] [] []|  Centre for Urban & Community Studies
TRANSIT    `-O----------O---'  University of Toronto