1URL.LIST(5) User Contributed Perl Documentation URL.LIST(5)
2
3
4
6 url.list - websec url monitoring configuration
7
9 The URL list consists of one or more sections separated by newlines.
10 You can have sections without a URL, they will update the defaults for
11 all the subsequenet blocks. The Name and Prefix parameters are required
12 as well as one of Email, EmailLink and Program. The rest are completely
13 optional.
14
15 The following parameters (case-sensitive) are recognized in each
16 section:
17
18 URL - URL of web page to monitor
19
20 Name - Name of web site. Pages delivered to you will have the
21 following format: "Name - Date (Day)" eg. "PC Magazine - 4
22 Sep 98 (Fri)"
23
24 Prefix - Prefix of filenames for archive files of web pages created
25 by Web Secretary.
26
27 Email - Comma-delimited list of email addresses to send highlighted
28 pages to.
29
30 EmailLink - Comma-delimited list of email addresses to send URL of
31 changed pages to.
32
33 Program - application to call with the diff-file, special cases:
34 "mozilla", pages are opened in new tabs,
35 "konqueror", pages are opened using "kfmclient openURL"
36
37 Auth - Authentication information in "username:password" format.
38 Put "none" if no authentication needed.
39
40 Diff - Put "none" if you want Web Secretary to always mail this
41 page to you instead of checking for and highlighting
42 changes in the page. Put "webdiff" if you want Web
43 Secretary to check for changes.
44 Put "htmldiff" to use a different implementation of HTML
45 diff output. Note that you need to install the perl-modules
46 Algorithm::Diff and HTML::Diff which are availabe on
47 http://www.cpan.org/ for this to work.
48
49 Hicolor - Color used to highlight new or changed content. Currently,
50 four colors are defined. They are: blue, pink, yellow and
51 grey. You can also supply your own HTML color tag in the
52 form "#rrggbb".
53
54 Ignore - Comma-delimited List of section names containing ignore
55 keywords. There must be NO SPACES between delimiters and
56 section names. The ignore sections and keywords are stored
57 in a file called "ignore.list".
58
59 IgnoreURL - Comma-delimited List of section names containing ignore
60 URLs. There must be NO SPACES between delimiters and
61 section names. The ignore sections and keywords are stored
62 in a file called "ignore.list".
63
64 AsciiMarker - If set to 1 it will add ascii markers around the changes so
65 that highlighting is noticeable in text mode too. Useful for
66 text MUAs users.
67
68 Tmin - Every token containing <= Tmin words will not be highlighted
69 for differences.
70
71 Tmax - Every token containing >= Tmax words will not be checked for
72 ignore keywords.
73
74 Proxy - Specify proxy "http://your.proxy.here:portnum" if you are
75 using one. (Alternatively, you can make use of the
76 "http_proxy" environment variable)
77
78 ProxyAuth - Specify proxy authentication in "username:password" format.
79 The code for this feature was contributed by Volker Stampa.
80
81 MailFrom - The E-Mail address to send mail from, this can be left empty
82 and the user used to run websec will be used.
83
84 ProgramDigest - If specified "true", websec does not open all changed pages
85 separately with the application specified in "Program", but opens
86 a summary page that contains links to all changed pages.
87
88 Digest - true|false or yes|no. This works only if EmailLink is
89 specified. It consolidates all the changed URLs and sends
90 them in one email.
91
92 UserAgent - The User-Agent that will be sent by the web client. This can
93 be used to bypass servers that prevent access based on the user
94 agent.
95
96 DateFMT - Date format to use in e-mail messages, can be empty for no date.
97 Set it to " - %Y-%m-%d" for ISO dates. This is perl format for dates.
98
99 RandomWait - Websec waits for a random number of seconds between retries up
100 to the value specified by the RandomWait keyword. This is to
101 prevent websec from being blocked by websites that perform log
102 analysis to find time similarities between requests.
103
104 Any line which begins with a '#' is treated as comment and ignored.
105
106 If a section does not contain a URL entry, the values provided will be
107 treated as the default for the following sections.
108
109 For example,
110
111 # Defaults
112 Auth = none
113 Diff = webdiff
114 Hicolor = blue
115 Ignore = General,Date_Time
116 IgnoreURL = Adverts
117 Tmin = 1
118 Tmax = 10
119 Proxy = http://proxy.nus.edu.sg:8080
120 Email = vchew@post1.com
121
122 # Web page to monitor which does not require authentication
123 URL = http://browserwatch.iworld.com/news.html
124 Name = Browser Watch
125 Prefix = browsewatch
126
127 # New defaults with authentication information
128 Auth = user:password
129
130 # More web pages to monitor which requires authentication
131 URL = http://www.infoworld.com
132 Name = Infoworld
133 Prefix = infoworld
134
135 URL = http://developer.javasoft.com/
136 Name = Java Developer Central
137 Prefix = jdc
138
140 ignore.list(5)
141
143 Baruch Even <websec@ev-en.org> is maintaining this program.
144
145
146
147perl v5.30.0 2019-07-27 URL.LIST(5)