diff options
Diffstat (limited to 'debian/htdig/htdig-3.2.0b6/htdoc/notification.html')
| -rw-r--r-- | debian/htdig/htdig-3.2.0b6/htdoc/notification.html | 185 |
1 files changed, 185 insertions, 0 deletions
diff --git a/debian/htdig/htdig-3.2.0b6/htdoc/notification.html b/debian/htdig/htdig-3.2.0b6/htdoc/notification.html new file mode 100644 index 00000000..2c3bbde1 --- /dev/null +++ b/debian/htdig/htdig-3.2.0b6/htdoc/notification.html @@ -0,0 +1,185 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd"> +<html> + <head> + <title> + ht://Dig: Email notification service + </title> + </head> + <body bgcolor="#eef7ff"> + <h1> + <img alt="ht://Dig" src="htdig.gif" align="bottom" width=81 height=54> Email + notification service + </h1> + <p> + ht://Dig Copyright © 1995-2004 <a href="THANKS.html">The ht://Dig Group</a><br> + Please see the file <a href="COPYING">COPYING</a> for + license information. + </p> + <hr size="4" noshade> + <h2> + Introduction + </h2> + <p> + As any HTML author knows, information is only useful if it is + valid. Unfortunately, a lot of information has an inherent + expiration date. Things like meeting schedules, announcements + of upcoming events, and pages with those annoying yellow + 'NEW' images by certain links. + </p> + <p> + <a href="index.html">ht://Dig</a> is a WWW index/search + system developed at <a href="http://www.sdsu.edu/">San Diego + State University</a>. Since this index system already scans + all HTML documents, it was the logical choice to incorporate + a reminder service into it. + </p> + <p> + ht://Dig can be told to remind you about an HTML page + sometime in the future. The reminder/notification will come + by email and will contain the URL to the page plus some other + information. + </p> + <hr> + <h2> + Use + </h2> + <p> + ht://Dig detects special use of the <META> tag in HTML + documents. The <META> tags should go between + <HEAD> and </HEAD> of an HTML document. + </p> + <p> + Example: + </p> + <blockquote> + <HTML><br> + <HEAD><br> + <META NAME="htdig-email" + CONTENT="pat.user@nowhere.net"><br> + <META NAME="htdig-email-subject" CONTENT="Reminder to + update a page"><br> + <META NAME="htdig-notification-date" + CONTENT="8/28/1995"><br> + <TITLE>Someone's homepage.</TITLE><br> + </HEAD><br> + <BODY><br> + <blockquote> + <em>Body of document</em> + </blockquote> + </BODY><br> + </HTML> + </blockquote> + <p> + After 8/28/1995 pat.user@nowhere.net will get a mail message + which will look something like this: + </p> + <blockquote> + <strong>From:</strong> ht://Dig email notification service<br> + <strong>Subject:</strong> WWW notification: Reminder to + update a page<br> + <strong>To:</strong> pat.user@nowhere.net<br> + <br> + The following page was tagged to notify you after 8/28/1995.<br> + <br> + URL: http://www.sdsu.edu/~turtle/index.html<br> + Date: 8/28/1995<br> + Subject: Reminder to update a page<br> + </blockquote> + <hr> + <h2> + Attributes + </h2> + <p> + The special ht://Dig <META> tag attributes related to + notification are: + </p> + <ul> + <li> + NAME="htdig-email" CONTENT="<em>email address [, email + address] ...</em>" + </li> + <li> + NAME="htdig-notification-date" CONTENT="<em>earliest + notification date</em>" + </li> + <li> + NAME="htdig-email-subject" CONTENT="<em>notification message + subject</em>" + </li> + </ul> + <p> + Descriptions of the values for the attributes: + </p> + <dl> + <dt> + <strong>htdig-email</strong> + </dt> + <dd> + This is the email address the notification message should + be sent to. Multiple email addresses can be given by + separating them by commas. If no email address is given, no + notification will be sent. + </dd> + <dt> + <strong>htdig-notification-date</strong> + </dt> + <dd> + This is the date on or after which the notification should + be sent. The format is simply <em>month / day / year</em>, + or if the <a href="attrs.html#iso_8601">iso_8601</a> + attribute is set, <em>year - month - day</em>. + Make sure that the year has the century with it as well. + This means that you should use <em>1995</em> instead of + <em>95</em>.<br> + The format of dates is actually a little more flexible than + this. Any punctuation or white space can be used as separators, + and if the year, month and date do not appear as expected in the + order listed above, the notification service will try to make + sense of the order used, if the date can be resolved unambiguously + in another order. Using four-digit years avoids ambiguity between + the year and the month or day. The format <em>year - month - + day</em> is accepted without ambiguity when a four-digit year is + used, whether the iso_8601 attribute is set or not. When the + year is given after the month and day, the format is either + <em>day - month - year</em>, if iso_8601 is true and the year + has four digits, or <em>month - day - year</em> otherwise.<br> + If no date is given, no notification will be sent. If a date is + given but is malformed, a notification of this error will be sent. + For correct dates, a notification will be sent every time the + system runs the notification service, on or after the date given. + To end the notifications, you must update or remove the + notification date in the document. + </dd> + <dt> + <strong>htdig-email-subject</strong> + </dt> + <dd> + This specifies the subject the notification message. This + is an optional attribute. Note that if you want to put + spaces in the subject, you <strong>have</strong> to put + double quotes (") around it. + </dd> + </dl> + <p> + There are a couple of other META attributes which are + recognized. These can be found in the more general + <a href="meta.html">ht://Dig META tag documentation</a>. + </p> + <hr> + <h2> + Disclaimer + </h2> + <p> + This service is a free service for all HTML maintainers whose + documents are covered by the ht://Dig search system. If any + of the attributes are improperly formatted, no notifications + will be mailed. Email notification may not always occur on + the date that you specified. We can only guarantee a + notification of at most once a week. + </p> + <hr size="4" noshade> + + Last modified: $Date: 2004/05/28 13:15:19 $ + + </body> +</html> |