Additional Installation Notes
=============================

General Notes
=============

Most of the scripts should be modified to match your local configuration.
It may be worthwhile to create a centralized set of authorization files,
to be used with the 'do' operations in each script, so that you can easily
modify usernames and passwords without later interfering with the actual
data.

Database Installation
=====================

The 'pub_create.pl' script can be used to populate a running MySQL server
with the proper tables prior to running.  You'll want to use it.

Web Installation
================

The following instructions assume a fairly basic Apache configuration; it
may not work with yours, but it has been known to work, and it's a good
start in setting up your own configuration.  Set up your files as so:

cgi-bin/
  pubs.cgi		Copied or linked from cgi-bin/pubs.cgi

Publications/Papers
  abstract.cgi		Copied or linked from cgi-bin/public/abstract.cgi
  disclaimer		Taken from cgi-bin/public/disclaimer
  index.html		Taken from cgi-bin/public/index.html
  journal.cgi		Copied or linked from cgi-bin/public/journal.cgi
  list.cgi		Copied or linked from cgi-bin/public/list.cgi
  pdf.cgi		Copied or linked from cgi-bin/public/pdf.cgi
  stylesheet.css	Copied or linked from cgi-bin/stylesheet.css
  topic.cgi		Copied or linked from cgi-bin/public/topic.cgi
  SMD/, IMD/, etc	
    index.cgi		Copied or linked from cgi-bin/public/subject.cgi
    title		Taken from cgi-bin/public/subject/title
    numbers		Taken from cgi-bin/public/subject/numbers
    header		Taken from cgi-bin/public/subject/header

Internal Page
  Admin/		
    .htpasswd		Created with 'htpasswd'  
    .htgroup 		See sample htgroup-base
    .htaccess		See sample htaccess-base
    index.cgi		Copied or linked from cgi-bin/paper_admin.cgi
    stylesheet.css	Copied or linked from cgi-bin/stylesheet.css
  index.cgi		Copied or linked from cgi-bin/paper_internal.cgi
  stylesheet.css	Copied or linked from cgi-bin/stylesheet.css
  external/		Symlink back to Publications/Papers

Note that *most* of these files are not installed into any directory
structure by default, due to limitations on Perl's Makefile.PL system.

Non-Web Installation
====================

You'll want to set up all of the directory paths in
TCB::Publications::Papers, as well as the necessary files. 

The bib.bbl file (from $TCB::Publications::Papers::BIBFILE) must exist if
you want a lot of these scripts to work properly.  This file is created
from a *.bib file and run through BibTeX; see the scripts/bibtex.pl script
for some details.

The web abstracts (TCB::Publications::Papers::ABSTRACTS) should also be in
accesible location.  These abstracts are parsed out of the database with
scripts/abstract.pl .

General Running
===============

The TCB Group has three people in charge of its publications database.
One person is in charge of content and actually maintaining the database;
another is in charge of the file system information (bib files, abstracts,
which files are accessible via the web); a third does the software
development for both of these.  This may be a good way to handle things
for other research groups.
