dwww Home | Show directory contents | Find package

The siteconf: Site-specific preferences 

The siteconf consists of URL patterns and preferences associated to them.
You can improve "decode_url" feature by giving charsets of URLs site by site,
or bypass Google's redirector for performance and your privacy.

The siteconf is read from ~/.w3m/siteconf by default.

===== The syntax =====

# comment
url <url>|/<re-url>/|m@<re-url>@i [exact]
substitute_url "<destination-url>"
url_charset <charset>
no_referer_from on|off
no_referer_to on|off
user_agent "string"

The last match wins.

Lines starting with a '#' are ignored. You can use this to annotate the
entries.

===== Examples =====

# This forwards twitter.com to the alternative site.
url m!^https?://([a-z]+\.)?twitter\.com/!
substitute_url "https://nitter.net/"

# This prevents HTTP referers from being sent when you follow links
# at the your.bookmark.net.
url "http://your.bookmark.net/"
no_referer_from on

# This forwards the Google's redirector to your local CGI.
url "http://www.google.com/url?" exact
substitute_url "file:///cgi-bin/your-redirector.cgi?"

# When combinated with "decode_url" option turned on, links to
# Wikipedia will be human-readable.
url /^http:\/\/[a-z]*\.wikipedia\.org\//
url_charset utf-8

# Tell Google we're actually Lynx. (So they send us a text-browser friendly
# results page.)
url m@^https?://(.*\.)google\.com/@
user_agent "Lynx/2.8.8dev.3 libwww-FM/2.14 SSL-MM/1.4.1"

# Tell Twitter we're actually Googlebot. (So they send us a page without
# rejection of a JavaScript disabled browser.)
url m!^https?://([a-z]+\.)?twitter\.com/!
user_agent "Googlebot/2.1"

===== Regular expressions notes =====

Following expressions are all equivalent:

/http:\/\/www\.example\.com\//
m/http:\/\/www\.example\.com\//
m@http://www\.example\.com/@
m!http://www\.example\.com/!

With a trailing 'i' modifier, you can specify a case-insensitive match.
For example, m@^http://www\.example\.com/abc/@i matches to:

http://www.example.com/abc/
http://www.example.com/Abc/
http://www.example.com/ABC/

Hostnames, however, are always converted to lowercases before compared.

Generated by dwww version 1.15 on Thu May 23 08:02:40 CEST 2024.