Ubuntu Manpage: netrikrc - netrik configuration file

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.