<!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>
