## del.icio.us.pl 0.2

## This is free software.  
## It may be modified and/or distributed under 
## the same terms as Perl itself.
## 2003 Wayne Burkett
## http://www.dionidium.com

## Inspired by Paul Hammond's
## blo.gs.pl, which solves a similar problem.
## http://www.paranoidfish.org/projects/blo.gs.pl/


## INSTALLATION

1) Register an account at del.icio.us.  Post some links.

2) Edit del.icio.us.pl.  The first line (#!usr/bin/perl)
   should point to your copy of Perl.  You MUST modify
   $id and $path to reflect your del.icio.us user id and 
   the path to del.icio.us.pl on your server, respectively.

   Optionally, you MAY edit $cache, $template, $opts{num},
   $opts{tag}, and $opts{clean} to your tastes.

   More information on editing variables is included in 
   del.icio.us.pl.


3) Upload del.icio.us.pl to a writable directory on your server.
   You MUST be able to run CGI scripts from this directory.  You 
   may need to save this file in /cgi-bin, or add the .cgi
   extension to the end of it.  Additionally you will need to set 
   the permissions on this file to be executable (chmod 755 on UNIX
   systems).

4) Upload .tmpl files to the same directory.

5) Visit http://www.yoursite.com/del.icio.us.pl
   You should see your links.

6) To include your links on your site via SSI, first change the
   $template variable in del.icio.us.pl to del.icio.us.tmpl (instead
   of del.icio.us.full.tmpl).  Next, add this line to your 
   Web site: <!--#include virtual="path/to/del.icio.us.pl"-->


## TEMPLATES

The templates support 1 loop and a few variables, all elements of the 
del.icio.us XML file:

1) <TMPL_LOOP NAME="details"></TMPL_LOOP>
   Loops over all entries.

2) <TMPL_VAR NAME="link">
   Your link.

3) <TMPL_VAR NAME="title">
   Your link's title.

4) <TMPL_VAR NAME="description">
   A short description of your link.

5) <TMPL_VAR NAME="about">
   Currently the same as description.

6) <TMPL_VAR NAME="date">
   UTC W3CDTF date. YYYY-MM-DDTHH:MM:SSZ

7) <TMPL_VAR NAME="month"> <TMPL_VAR NAME="day"> 
   <TMPL_VAR NAME="year"> <TMPL_VAR NAME="hour"> 
   <TMPL_VAR NAME="minute"> <TMPL_VAR NAME="second">
   These work now, too.
   

## Changes in this version

1) del.icio.us.pl now uses the del.icio.us API instead of the public RSS feeds.

2) Fixed a bug in HTML entity handling, which sometimes caused existing entities to 
   be mistakenly converted.

3) Corrected this readme text to list template variables as <TMPL_VAR> instead of
   <TMPL_LOOP>

4) Lengthened the default cache time to reflect del.icio.us's growing poularity.

5/06/2004 Script now sets the User-Agent HTTP header.
3/17/2004 The default tag option was unintentionally set to 'site.'  Changed the default
          behavior to set no specific tag.
2/24/2004 Fixed a bug that affected the handling of HTML entities.
2/24/2004 Cleaned existing templates and added two new templates to support HTML 
          definition lists.