Man Linux: Main Page and Category List

NAME

       netrikrc - netrik configuration file

DESCRIPTION

       Netrik(1)  will  read  the file ~/.netrikrc (i.e. the file .netrikrc in
       your home directory), if present, to get default settings.

       The file structure is very simple: All options that  can  be  given  as
       command  line arguments to netrik can also be listed in this file. Just
       put all options you wish (including the leading "--") here,  one  on  a
       line.

       As  every option also has an inverted version (usually --no-foo instead
       of --foo, but there are a few excepions), You still  can  override  the
       defaults from this file by command line options.

       You  can  also specify a URL in the config file, simply putting it on a
       line without any options. It will serve as a  home  page:  It  will  be
       loaded  when no other file is given upon netrik invocation, and ignored
       otherwise.

OPTIONS

       Note: netrik is still in early development state; options  are  subject
       to changes.

       --force-colors
              Force  usage of netrik’s default text colors (white on black for
              normal text), even if the terminal has other  defaults.  Without
              this  option,  netrik  tries to adopt to the terminal’s default.
              (Thus keeping the light background of most xterms.)

       --no-term-width
              When using the pager, this causes a page that contains extremely
              long  words  to  be  rendered  wider than the screen, instead of
              breaking the  word.  Note  however  that  side  scrolling  isn’t
              implemented  yet -- you won’t be able to see the end of the line
              when using this option... In dump mode, this option causes usage
              of  the default width of 80 columns instead of what the terminal
              definition says. (Words are always broken in dump mode.)

       --fussy-html
              Abort on any HTML syntax errors or warnings encountered. A short
              error  description  is  printed.  (This  description  may not be
              terribly useful at times...) This mode is primarily intended for
              HTML  debugging.  (Note  however  that  netrik  may oversee some
              errors; but most are reported.)

       --clean-html
              Do not abort on  HTML  syntax  errors.  Error  descriptions  are
              printed for every syntax error (or warning), but netrik tries to
              parse the page anyhow.  Workarounds are used  for  some  typical
              syntax  errors  (e.g.  unescaped  ’<’  or ’&’ characters); other
              errors are ignored. After the whole  page  is  loaded,  if  some
              error(s)  were found, a warning message is printed (according to
              the severity of the worst encountered bug), and the pager starts
              after a keypress.

       --valid-html
              This  mode  is  identical  to  --clean-html,  except that netrik
              doesn’t pause after loading completes,  if  only  warnings  were
              generated  but no real errors were encountered. (i.e. constructs
              that are discouraged in the standard, but strictly speaking  are
              valid.)

       --broken-html (default)
              This  mode is identical to --valid-html, except that netrik also
              doesn’t pause if only simple errors with known  workaround  were
              encountered,  which  probably  won’t  disturb  layouting.  Usage
              should be avoided if possible.  (The  file  syntax_error.txt  or
              syntax_error.html  in  the documentation directory (see SEE ALSO
              below) explains why.)

       --ignore-broken
              In this mode no warning is showm for any syntax errors, even  if
              they might cause heavily broken layouting. Don’t use!

       --debug
              Before  displaying  (or  dumping)  the  page,  some intermediate
              layouting stages are shown. (This output  is  described  in  the
              README.)  Try  it -- it’s quite interesting to watch netrik work
              :-) It can be also useful to find HTML errors in a page,  as  it
              dumps the page while loading/parsing it.
              (This  option  is not available if compiled with --disable-debug
              to ./configure)

       --warn-unknown
              Issue a warning when encountering an  unknown  HTML  element  or
              attribute.  This is probably only useful for debugging purposes,
              as there are quite a  lot  of  (legal)  HTML  facilities  netrik
              doesn’t know.

       --dump Just  dump  the  file  given as argument to the screen and quit,
              instead of starting the pager. (The page is layouted correctly.)
              You  may  want  to  give the --bw option also (see below), which
              will  ensure  the  dump  is  plain  text  without  any   control
              sequences.

       --no-proxy
              Ignore  the  "http_proxy" and "HTTP_PROXY" environment variables
              with --builtin-http. (No effect on wget! See below.)

       --no-builtin-http
              Use wget(1) to retrieve pages from a HTTP server, instead of the
              builtin  HTTP  handling  code.  Note that HTTP redirects in most
              cases cause relative links in the page to be broken  when  using
              wget.  The  builtin HTTP code seems to work good now; using wget
              shouldn’t be necessary. (FTP pages however are always loaded via
              wget.)

       --no-anchor-offset
              When  jumping  to  an  anchor  (following a link with a fragment
              identifier), the page will be scrolled (if possible) so that the
              anchor  will  stand  just  below  the screen top. (In the second
              line, which is the first line in which links can be  activated.)
              By  default,  the  anchor  is  at about 1/5 of the screen height
              below the top.

       --cursor-keys
              Use the arrow keys to move the cursor, instead of the  lynx-like
              navigation  used by default. (This is useful for blind users, as
              it allows  using  the  "flash  cursor"  keys  found  on  braille
              displays.)

       --xterm
              Assume  the  terminal  has  xterm-like attribute handling. (i.e.
              needs a workaround to display a bright background color.)
              This setting is used automatically if the terminal  type  ($TERM
              environment  variable)  contains the string "xterm", so you only
              need to set it manually if you have  some  other  terminal  that
              also needs that workaround.
              Note  that this workaround works *only* on xterm (and maybe some
              other terminals), but not on linux console, so  you  can’t  just
              set it categorically!

       --console
              Assume  the  terminal  doesn’t  need  and  understand  the xterm
              workaround for bright background colors. (See above.)

       --dark-background
              Use  the  color   definitions   from   colors-dark.c   (formerly
              colors.alt.c).  A  black  background  will  be used (even if the
              terminal uses a bright background by default!),  and  a  set  of
              foreground  colors which look very nice on black backgound. (But
              would be unusable on bright background.)
              This is the default now.

       --bright-background
              Use   color   definitions   from    colors-bright.c    (formerly
              colors.default.c).  The  terminal’s  default colors will be used
              for background and normal text, and an alternative color  scheme
              suitable  for  bright  background  will  be  used for other text
              types.
              Use this if you have a terminal  with  bright  background  (like
              most xterms), and also want to stick to that in netrik.
              Note that this can be used on a terminal with dark background as
              well; some colors are somewhat hard to read, however.

       --no-force-colors
              Use  terminal’s  default  colors  even  with  --dark-background,
              instead  of forcing usage of netrik’s default text colors (white
              on black for normal text).   This  is  useful  if  you  use  the
              default  (dark)  colors and your terminal has a black background
              anyways -- forcing the default colors is only a waste of time in
              this situation.

       --bw   Start  up in b/w mode. Useful to avoid the warning about missing
              color capabilities if you really have a terminal not capable  of
              switching  text colors. Also useful together with --dump option.

       --color
              Undo --bw option.

EXAMPLES

       The following config file:

              --broken-html
              --no-anchor-offset
              file:///usr/local/share/doc/netrik/index.html

       means:

       --broken-html: Do not to stop on smaller HTML errors. (Use --valid-html
       or  --clean-html  on  the  command  line  to override that for a single
       netrik invocation).

       --no-anchor-offset: When going to an anchor, scroll the  page  so  that
       the  anchor will appear at the screen top, instead of 1/5 of the screen
       hight below the top. (Use --anchor-offset to override.)

       file:///usr/local/share/doc/netrik/index.html:  When  no   other   file
       name/URL   is   specified   on   the  command  line,  open  the  netrik
       documentation overview. (If netrik was installed from a Debian  or  RPM
       package, use file:///usr/share/doc/netrik/index.html instead.)

VERSION

       This manual page documents the config file for netrik 1.16.1.

AUTHOR

       Netrik  was created and is maintained by Olaf D. Buddenhagen AKA antrik
       (<antrik@users.sf.net>), with major contributions  from  Patrice  Neff,
       Sören  Schulze, and others. (For a full listing of all contributors see
       AUTHORS in the doc directory, see below.)

       This man page was created by antrik.

SEE ALSO

       netrik(1)

                               April 19th, 2004