Configuring the CGI part

The Annotate distribution contains a directory named cgi-bin. In this directory, you can find the Annotate CGI scripts together with the components it needs to work. The contents of this directory should be moved to a location where the web server executes them as CGI scripts (i.e., a ScriptAliased directory) . Make sure that the annotate file is executable and that all files in that directory (as well as its subdirectories) are readable.

Note

Maybe you have to adjust the first line of annotate

#!/usr/bin/perl

to point to your Perl binary. The default should work on most systems, but on some systems, the perl binary can be found in a different directory.

I assume that you already have a working RDBMS system at hand. You have to create a table with the columns described below.

Table 1.1. Comment table structure

Field nameField typeDescription
idinteger, not nullidentifier and primary key
node_idchar, not nullDocBook Node-ID
Namecharthe annotation author's name
eMailcharthe author's mail address
Datedatetimeannotation date and time
Commenttextannotation text

If Annotate knows your database type, the installation script will ask you whether it shall create this table for you.