# $JOBUK/conf/lynx.cfg # # Lynx configuration for the project jobfeed_uk. # # Definition pairs are of the form VARIABLE:DEFINITION # NO spaces are allowed between the pair items. # # If you do not have write access to /usr/local/lib you may change # the default location of this file in the userdefs.h file and recompile, # or specify its location on the command line with the "-cfg" # command line option. # # Items may be commented out by putting a '#' as the FIRST char of the line # (Any line beginning with punctuation is ignored). Leading blanks on each # line are ignored; trailing blanks may be significant depending on the option. # An HTML'ized description of all settings (based on comments in this file, # with alphabetical table of settings and with table of settings by category) # is available at http://www.hippo.ru/~hvv/lynxcfg_toc.html # ### The conversion is done via the scripts/cfg2html.pl script. ### Several directives beginning with '.' are used for this purpose. INCLUDE:/etc/lynx.cfg # CHARACTER_SET defines the display character set, i.e., assumed to be # installed on the user's terminal. It determines which characters or strings # will be used to represent 8-bit character entities within HTML. New # character sets may be defined as explained in the README files of the # src/chrtrans directory in the Lynx source code distribution. For Asian (CJK) # character sets, it also determines how Kanji code will be handled. The # default is defined in userdefs.h and can be changed here or via the # 'o'ptions menu. The 'o'ptions menu setting will be stored in the user's RC # file whenever those settings are saved, and thereafter will be used as the # default. For Lynx a "character set" has two names: a MIME name (for # recognizing properly labeled charset parameters in HTTP headers etc.), and a # human-readable string for the 'O'ptions Menu (so you may find info about # language or group of languages besides MIME name). Not all 'human-readable' # names correspond to exactly one valid MIME charset (example is "Chinese"); # in that case an appropriate valid (and more specific) MIME name should be # used where required. Well-known synonyms are also processed in the code. # # Raw (CJK) mode # # Lynx normally translates characters from a document's charset to display # charset, using ASSUME_CHARSET value (see below) if the document's charset # is not specified explicitly. Raw (CJK) mode is OFF for this case. # When the document charset is specified explicitly, that charset # overrides any assumption like ASSUME_CHARSET or raw (CJK) mode. # # For the Asian (CJK) display character sets, the corresponding charset is # assumed in documents, i.e., raw (CJK) mode is ON by default. In raw CJK # mode, 8-bit characters are not reverse translated in relation to the entity # conversion arrays, i.e., they are assumed to be appropriate for the display # character set. The mode should be toggled OFF when an Asian (CJK) display # character set is selected but the document is not CJK and its charset not # specified explicitly. # # Raw (CJK) mode may be toggled by user via '@' (LYK_RAW_TOGGLE) key, # the -raw command line switch or from the 'o'ptions menu. # # Raw (CJK) mode effectively changes the charset assumption about unlabeled # documents. You can toggle raw mode ON if you believe the document has a # charset which does correspond to your Display Character Set. On the other # hand, if you set ASSUME_CHARSET the same as Display Character Set you get raw # mode ON by default (but you get assume_charset=iso-8859-1 if you try raw mode # OFF after it). # # Note that "raw" does not mean that every byte will be passed to the screen. # HTML character entities may get expanded and translated, inappropriate # control characters filtered out, etc. There is a "Transparent" pseudo # character set for more "rawness". # # Since Lynx now supports a wide range of platforms it may be useful to note # the cpXXX codepages used by IBM PC compatible computers, and windows-xxxx # used by native MS-Windows apps. We also note that cpXXX pages rarely are # found on Internet, but are mostly for local needs on DOS. # # Recognized character sets include: # # string for 'O'ptions Menu MIME name # =========================== ========= # 7 bit approximations (US-ASCII) us-ascii # Western (ISO-8859-1) iso-8859-1 # Western (ISO-8859-15) iso-8859-15 # Western (cp850) cp850 # Western (windows-1252) windows-1252 # IBM PC US codepage (cp437) cp437 # DEC Multinational dec-mcs # Macintosh (8 bit) macintosh # NeXT character set next # HP Roman8 hp-roman8 # Chinese euc-cn # Japanese (EUC-JP) euc-jp # Japanese (Shift_JIS) shift_jis # Korean euc-kr # Taipei (Big5) big5 # Vietnamese (VISCII) viscii # Eastern European (ISO-8859-2) iso-8859-2 # Eastern European (cp852) cp852 # Eastern European (windows-1250) windows-1250 # Latin 3 (ISO-8859-3) iso-8859-3 # Latin 4 (ISO-8859-4) iso-8859-4 # Baltic Rim (cp775) cp775 # Baltic Rim (windows-1257) windows-1257 # Cyrillic (ISO-8859-5) iso-8859-5 # Cyrillic (cp866) cp866 # Cyrillic (windows-1251) windows-1251 # Cyrillic (KOI8-R) koi8-r # Arabic (ISO-8859-6) iso-8859-6 # Arabic (cp864) cp864 # Arabic (windows-1256) windows-1256 # Greek (ISO-8859-7) iso-8859-7 # Greek (cp737) cp737 # Greek2 (cp869) cp869 # Greek (windows-1253) windows-1253 # Hebrew (ISO-8859-8) iso-8859-8 # Hebrew (cp862) cp862 # Hebrew (windows-1255) windows-1255 # Turkish (ISO-8859-9) iso-8859-9 # ISO-8859-10 iso-8859-10 # Ukrainian Cyrillic (cp866u) cp866u # Ukrainian Cyrillic (KOI8-U) koi8-u # UNICODE (UTF-8) utf-8 # RFC 1345 w/o Intro mnemonic+ascii+0 # RFC 1345 Mnemonic mnemonic # Transparent x-transparent # # The value should be the MIME name of a character set recognized by # Lynx (case insensitive). # Find RFC 1345 at http://www.ics.uci.edu/pub/ietf/uri/rfc1345.txt . # CHARACTER_SET:utf-8 #CHARACTER_SET:iso-8859-1 # LOCALE_CHARSET overrides CHARACTER_SET if true, using the current locale to # lookup a MIME name that corresponds, and use that as the display charset. # This feature is experimental because while nl_langinfo(CODESET) itself is # standardized, the return values and their relationship to the locale value is # not. GNU libiconv happens to give useful values, but other implementations # are not guaranteed to do this. LOCALE_CHARSET:FALSE # ASSUME_CHARSET changes the handling of documents which do not # explicitly specify a charset. Normally Lynx assumes that 8-bit # characters in those documents are encoded according to iso-8859-1 # (the official default for the HTTP protocol). When ASSUME_CHARSET # is defined here or by an -assume_charset command line flag is in effect, # Lynx will treat documents as if they were encoded accordingly. # See above on how this interacts with "raw mode" and the Display # Character Set. # ASSUME_CHARSET can also be changed via the 'o'ptions menu but will # not be saved as permanent value in user's .lynxrc file to avoid more chaos. # ASSUME_CHARSET:utf-8 # ASSUME_LOCAL_CHARSET is like ASSUME_CHARSET but only applies to local # files. If no setting is given here or by an -assume_local_charset # command line option, the value for ASSUME_CHARSET or -assume_charset # is used. It works for both text/plain and text/html files. # This option will ignore "raw mode" toggling when local files are viewed # (it is "stronger" than "assume_charset" or the effective change # of the charset assumption caused by changing "raw mode"), # so only use when necessary. # #ASSUME_LOCAL_CHARSET:utf-8 # If Lynx encounters a charset parameter it doesn't recognize, it will # replace the value given by ASSUME_UNREC_CHARSET (or a corresponding # -assume_unrec_charset command line option) for it. This can be used # to deal with charsets unknown to Lynx, if they are "sufficiently # similar" to one that Lynx does know about, by forcing the same # treatment. There is no default, and you probably should leave this # undefined unless necessary. # ASSUME_UNREC_CHARSET:utf-8 # If COLLAPSE_BR_TAGS is set FALSE, Lynx will not collapse serial BR tags. # If set TRUE, two or more concurrent BRs will be collapsed into a single # line break. Note that the valid way to insert extra blank lines in HTML # is via a PRE block with only newlines in the block. # #COLLAPSE_BR_TAGS:TRUE # If TAGSOUP is set, Lynx uses the "Tag Soup DTD" rather than "SortaSGML". # The two approaches differ by the style of error detection and recovery. # Tag Soup DTD allows for improperly nested tags; SortaSGML is stricter. #TAGSOUP: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: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, 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 `Show Images' in the Form-based Options Menu. # #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 `Show Images' in the Form-based Options Menu. # #MAKE_PSEUDO_ALTS_FOR_INLINES:TRUE # If SUBSTITUTE_UNDERSCORES is TRUE, the _underline_ format will be used # for emphasis tags in dumps. # # The default defined here will override that in userdefs.h, and the user # can toggle the default via a "-underscore" command line switch. # #SUBSTITUTE_UNDERSCORES:FALSE # If HISTORICAL_COMMENTS is TRUE, Lynx will revert to the "Historical" # behavior of treating any '>' as a terminator for comments, instead of # seeking a valid '-->' terminator (note that white space can be present # between the '--' and '>' in valid terminators). The compilation default # is FALSE. # # The compilation default, or default defined here, can be toggled via a # "-historical" command line switch, and via the LYK_HISTORICAL command key. # #HISTORICAL_COMMENTS:FALSE # If MINIMAL_COMMENTS is TRUE, Lynx will not use Valid comment parsing # of '--' pairs as serial comments within an overall comment element, # and instead will seek only a '-->' terminator for the overall comment # element. This emulates the Netscape v2.0 comment parsing bug, and # will help Lynx cope with the use of dashes as "decorations", which # consequently has become common in so-called "Enhanced for Netscape" # pages. Note that setting Historical comments on will override the # Minimal or Valid setting. # # The compilation default for MINIMAL_COMMENTS is FALSE, but we'll # set it TRUE here, until Netscape gets its comment parsing right, # and "decorative" dashes cease to be so common. # # The compilation default, or default defined here, can be toggled via a # "-minimal" command line switch, and via the LYK_MINIMAL command key. # MINIMAL_COMMENTS:TRUE # If SOFT_DQUOTES is TRUE, Lynx will emulate the invalid behavior of # treating '>' as a co-terminator of a double-quoted attribute value # and the tag which contains it, as was done in old versions of Netscape # and Mosaic. The compilation default is FALSE. # # The compilation default, or default defined here, can be toggled via # a "-soft_dquotes" command line switch. # #SOFT_DQUOTES:FALSE # HIDDEN_LINK_MARKER - HTML parsing # This option defines the string that will be used as title of hidden link (a # link that otherwise will have no label associated with it). Using an empty # string as the value will cause lynx to behave in the old way - hidden links # will be handled according to other settings (mostly the parameter of # --hiddenlinks command-line switch). If the value is non-empty string, hidden # link becomes non-hidden so it won't be handled as hidden link, e.g., listed # among hidden links on 'l'isting page. # #HIDDEN_LINK_MARKER: # JUSTIFY - Appearance # This option mirrors command-line option with same name. Default is TRUE. If # true, most of text (except headers and like this) will be justified. This # has no influence on CJK text rendering. # # This option is only available if Lynx was compiled with EXP_JUSTIFY_ELTS. # JUSTIFY:FALSE # JUSTIFY_MAX_VOID_PERCENT - Appearance # This option controls the maximum allowed value for ratio (in percents) of # 'the number of spaces to spread across the line to justify it' to # 'max line size for current style and nesting' when justification is allowed. # When that ratio exceeds the value specified, that particular line won't be # justified. I.e. the value 28 for this setting will mean maximum value for # that ratio is 0.28. # #JUSTIFY_MAX_VOID_PERCENT:35