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