url.list

#############################################################################################
# Default configuration block.
#
# These configuration values will be used for the sites that follow, unless they are
# overridden by the site configuration values. Parameter names are case-sensitive.
#
# Auth       = "none"; or "username:password"
# Diff       = "webdiff" to detect and highlight differences,
#              "htmldiff" to use HTML::Diff from cpan
#              "none" to mail page as is.
# Hicolor    = "blue"; "yellow"; "pink"; or "grey".
# Ignore     = list of comma-delimited section names containing ignore keywords.
# IgnoreURL  = list of comma-delimited section names containing ignore URLs.
# Tmin       = every token containing <= Tmin words will not be highlighted for differences.
# Tmax       = every token containing >= Tmax words will not be checked for ignore keywords.
# Proxy      = specify proxy "http://your.proxy.here:portnum" if you are behind one.
# MailFrom   = Address from which the mail will appear from.
# Email      = email address to send page to.
# EmailLink  = email address to send URL to.
# EmailError = 0 or 1, zero will disable emailing on errors and 1 will enable (default 1)
# Program    = application to call with the diff-file, special cases:
#              "mozilla", pages are opened in new tabs,
#              "konqueror", pages are opened using "kfmclient openURL"
# ProgramDigest = if specified "true", the application specified under "Program" is
#              invoked with a summary page that provides links to all changed pages.
#############################################################################################

Auth      = none
Diff      = webdiff
Hicolor   = blue
Ignore    = General,Date_Time
IgnoreURL = Adverts
Tmin      = 0
Tmax      = 99999
Email     = ${USER}@example.com
EmailLink = ${USER}@example.com
#MailFrom = ${USER}@example.com
EmailError = 1
AsciiMarker = 1

# enable this to open the webdiff-output in a new Mozilla Tab or specify a 
# different application to run with the changed page
#Program   = mozilla

##########################################################################################
# Sites to monitor
#
# Configuration values for each site is separated by a newline.
# Parameter names are case-sensitive.
# Parameter values override default values (for given site only) if specified.
# URL, Name and Prefix parameters must be specified for each site.
##########################################################################################

url = http://browserwatch.iworld.com/news.html 
Name = Browser Watch
Prefix = browse-watch

URL = http://www.freshmeat.net/
Name = Freshmeat
Prefix = freshmeat
Hicolor = grey

URL = http://www.javaworld.com/
Name = Java World
Prefix = java-world

URL = http://www.linuxgazette.com/
Name = Linux Gazette
Prefix = linux-gazette

URL = http://www.pcmag.com/
Name = PC Magazine
Prefix = pcmag

URL = http://www.pcweek.com/
Name = PC Week
Prefix = pcweek

URL = http://www.sun.com/sunworldonline/
Name = SunWorld Online
Prefix = sunworld-online

URL = http://www.winmag.com/
Name = Windows Magazine
Prefix = winmag

URL = http://www.linuxresources.com/
Name = Linux Resources
Prefix = linux-resources

URL = http://www.news.com/
Name = CNET News
Prefix = cnet-news

URL = http://www.slashdot.org/
Name = Slashdot.org
Prefix = slashdot
Ignore = Slashdot,General,Date_Time

URL = http://www.linuxworld.com/
Name = Linux World
Prefix = linux-world

URL = http://www.theregister.co.uk/
Name = The Register
Prefix = the-register

URL = http://headlines.yahoo.com/Full_Coverage/Tech/Linux/
Name = Yahoo Linux News
Prefix = yahoo-linux-news

URL = http://www.betanews.com/
Name = Betanews
Prefix = betanews
Hicolor = grey

URL = http://www.wired.com/news/
Name = Wired News
Prefix = wired-news

URL = http://www.nongnu.org/websec/
Name = Web Secretary
Prefix = websec-homepage
DateFMT = " - %Y-%m-%d"

URL = http://www.vim.org/
Name = VIM
Prefix = vim
Ignore = General,Date_Time,VIM

URL = http://www.joelonsoftware.com/
Name = Joel on Software
Prefix = joelonsoftware

URL = http://www.openbsd.org/cgi-bin/cvsweb/src/sys/sys/tree.h
Name = OpenBSD tree implementation
Prefix = openbsd-tree
Ignore = cvsweb

__END__

=head1 NAME

url.list - websec url monitoring configuration

=head1 DESCRIPTION

The URL list consists of one or more sections separated by newlines. You can
have sections without a URL, they will update the defaults for all the
subsequenet blocks. The Name and Prefix parameters are required as well as one
of Email, EmailLink and Program. The rest are completely optional. The configuration
is expected to be of the form "keyword = value".

The following parameters (case-sensitive) are recognized in each section:

    URL        - URL of web page to monitor

    Name       - Name of web site. Pages delivered to you will have the
                 following format: "Name - Date (Day)" eg. "PC Magazine - 4
                 Sep 98 (Fri)"

    Prefix     - Prefix of filenames for archive files of web pages created
                 by Web Secretary.

    Email      - Comma-delimited list of email addresses to send highlighted
                 pages to.

    EmailLink  - Comma-delimited list of email addresses to send URL of
                 changed pages to.

    Program    - application to call with the diff-file, special cases:
                 "mozilla", pages are opened in new tabs,
                 "konqueror", pages are opened using "kfmclient openURL"

    Auth       - Authentication information in "username:password" format. 
                 Put "none" if no authentication needed.

    Diff       - Put "none" if you want Web Secretary to always mail this
                 page to you instead of checking for and highlighting
                 changes in the page.  Put "webdiff" if you want Web
                 Secretary to check for changes.
                 Put "htmldiff" to use a different implementation of HTML
                 diff output. Note that you need to install the perl-modules
                 Algorithm::Diff and HTML::Diff which are availabe on 
                 http://www.cpan.org/ for this to work.

    Hicolor   -  Color used to highlight new or changed content. Currently,
                 four colors are defined. They are: blue, pink, yellow and
                 grey. You can also supply your own HTML color tag in the
                 form "#rrggbb".

    Ignore     - Comma-delimited List of section names containing ignore
                 keywords. There must be NO SPACES between delimiters and
                 section names. The ignore sections and keywords are stored
                 in a file called "ignore.list".

    IgnoreURL  - Comma-delimited List of section names containing ignore
                 URLs. There must be NO SPACES between delimiters and
                 section names. The ignore sections and keywords are stored
                 in a file called "ignore.list".

    AsciiMarker - If set to 1 it will add ascii markers around the changes so
	             that highlighting is noticeable in text mode too. Useful for
				 text MUAs users.

    Tmin       - Every token containing <= Tmin words will not be highlighted
                 for differences.

    Tmax       - Every token containing >= Tmax words will not be checked for
                 ignore keywords.

    Proxy      - Specify proxy "http://your.proxy.here:portnum" if you are
                 using one. (Alternatively, you can make use of the
                 "http_proxy" environment variable)

    ProxyAuth  - Specify proxy authentication in "username:password" format.
                 The code for this feature was contributed by Volker Stampa.

    MailFrom   - The E-Mail address to send mail from, this can be left empty
                 and the user used to run websec will be used.

    ProgramDigest - If specified "true", websec does not open all changed pages 
                 separately with the application specified in "Program", but opens
                 a summary page that contains links to all changed pages. 

    Digest     - true|false or yes|no. This works only if EmailLink is
                 specified. It consolidates all the changed URLs and sends
                 them in one email.

    UserAgent  - The User-Agent that will be sent by the web client. This can
                 be used to bypass servers that prevent access based on the user
                 agent.

    DateFMT    - Date format to use in e-mail messages, can be empty for no date.
                 Set it to " - %Y-%m-%d" for ISO dates. This is perl format for dates.

    RandomWait - Websec waits for a random number of seconds between retries up
                 to the value specified by the RandomWait keyword. This is to
                 prevent websec from being blocked by websites that perform log
                 analysis to find time similarities between requests.

Any line which begins with a '#' is treated as comment and ignored.

If a section does not contain a URL entry, the values provided will be
treated as the default for the following sections.

For example,

    # Defaults
    Auth = none
    Diff = webdiff
    Hicolor = blue
    Ignore = General,Date_Time
    IgnoreURL = Adverts
    Tmin = 1
    Tmax = 10
    Proxy = http://proxy.nus.edu.sg:8080
    Email = vchew@post1.com

    # Web page to monitor which does not require authentication
    URL = http://browserwatch.iworld.com/news.html 
    Name = Browser Watch
    Prefix = browsewatch

    # New defaults with authentication information
    Auth = user:password

    # More web pages to monitor which requires authentication
    URL = http://www.infoworld.com
    Name = Infoworld
    Prefix = infoworld

    URL = http://developer.javasoft.com/
    Name = Java Developer Central
    Prefix = jdc


=head1 SEE ALSO

L<ignore.list(5)>


=head1 AUTHOR

Baruch Even <websec@ev-en.org> is maintaining this program.

=cut

vim:set filetype=websec: