                      README for InterBib Distribution

   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License
   as published by the Free Software Foundation; either version 2
   of the License, or any later version.
   
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.
   
   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,
   USA.

               Andreas Paepcke, paepcke@cs.stanford.edu


This is a distribution of InterBib. The distribution is provided as
is. The service itself runs at http://interbib.stanford.edu

This distribution of InterBib is written in Python, which is available
at http://www.python.org/. 

Implemented 'make' options:

make all               # Gets local services operational; installs Web files
make clean             # Returns setup to state right after unpacking


InterBib is commonly used as a Web service. However, the following are
command line facilities for local use:

	- bib2endnote    ; for Endnote files that were exported as Refer
	- endnote2bib    ; (extension 'enr')
	- bib2refer
	- refer2bib      ; For stricly-Refer files (extension 'ref')
	- bib2html
	- bib2mif
	- bib2interbib

You learn their usage with the -h and -H options. Note that each of 
these commands can take multiple bibliography files, all a mix of
BibTeX and Refer files.

If you want to run InterBib as a Web service, make sure that the HTTP
demon (e.g. Apache) is allowed to run files in the Scripts
subdirectory as cgi scripts. The Scripts directory must therefore be
cgi-enabled.

Other than modifying the httpd.conf file for the cgi setup, MAKE
should take care of all requirements. This is what you'll end up with:

  
                                  .../interbib
                                      /      \
                        bibliographies       scripts
                                                |

                                               tmp
   
Here is an excerpt of my httpd.conf file's virtual host
section. Interbib is installed in /u/testbed/public_html/interbib:


<VirtualHost interbib.stanford.edu>

  ServerName            interbib.stanford.edu

  ServerAlias           www-interbib
  ServerAlias           www-interbib.stanford.edu
  ServerAlias           Interbib
  ServerAlias           Interbib.stanford.edu

  ServerRoot            "/lfs/1/diglib/httpd"
  DocumentRoot          /u/testbed/public_html/interbib
  DirectoryIndex        index.html interbib.html

  ErrorLog              logs/interbib_error_log

  ScriptAlias  /cgi-bin/  "/u/testbed/public_html/interbib/Scripts/"

 <Directory "/u/testbed/public_html/interbib/">
     AllowOverride      None
     Options            FollowSymLinks
     Allow              from all
 </Directory>

 <Directory "/u/testbed/public_html/interbib/Scripts/">
     AllowOverride      None
     Options            +ExecCGI FollowSymLinks
     AddHandler         cgi-script .py
     Allow              from all
 </Directory>

</VirtualHost>

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

InterBib's BibTeX, Endnote, and Strict Refer records and fields, 
relative to each other:

  
 BibTeX/InterBib Recod Types   Endnote Record Types
 ---------------------------   --------------------

   article   	    	      	 Journal Article
   book   	 	      	 Book
   booklet  	    	      	 Book
   conference  	    	      	 Conference Proceedings
   inbook   	    	      	 Book Section
   incollection 	      	 Book Section
   inproceedings 	      	 Conference Proceedings
   manual   	    	      	 Book
   mastersthesis 	      	 Thesis
   misc   		      	 Generic
   phdthesis   	    	      	 Thesis
   proceedings   	      	 Conference Proceedings
   techreport   	      	 Report
   unpublished 	    	      	 Unpublished Work


   BibTeX/Interbib Fields    Strict Refer Fields
   ----------------------    -------------------
    address 	       		  %C
    annote 	       		  %X
    author 	       		  %A
    booktitle 	       		  %B
    containedParts     		  %^
    copyright 	       		  %*
    custom2 	       		  %2
    custom3 	       		  %3
    custom4 	       		  %4
    date 	       		  %D
    editor 	       		  %E
    entryType 	       		  %0
    governmentNumber   		  %G
    header 	       		  %H
    howpublished       		  %W
    institution        		  %Q
    journal 	       		  %J
    keyFieldName       		  %F
    keywords 	       		  %K
    label 	       		  %L
    linksFieldName     		  %1
    note 	       		  %O
    number 	       		  %N
    organization       		  %Q
    pages 	       		  %P
    price 	       		  %$
    publisher 	       		  %I
    references 	       		  %Z
    series 	       		  %S
    title 	       		  %T
    undefined 	       		  %2
    urlFieldName       		  %U
    volume 	       		  %V


   BibTeX/Interbib           Endnote
   ---------------           -------

abstract        	     Abstract                                      
address         	     Place Published                               
affiliation     	     Author Address                                
annote          	     Abstract                                      
author          	     Author                                        
booktitle       	     Secondary Title (of Book/Conference)          
chapter         	     Tertiary Title                                
copyright       	     Database Provider                             
crossref        	     Call Number                                   
custom2         	     Custom 2                                      
custom3         	     Custom 3                                      
custom4         	     Custom 4                                      
date            	     Date                                          
editor          	     Editor/Secondary Author                       
entryType       	     Record Type                                   
governmentNumber	     Call Number                                   
howpublished    	     DOI                                           
institution     	     Subsidiary Author                             
ISBN            	     ISBN/ISSN                                     
journal         	     Secondary Title (Journal Name)                
key             	     Accession Number                              
keyFieldName    	     Label                                         
keywords        	     Keywords                                      
label           	     Call Number                                   
language        	     Language                                      
LCCN            	     ISBN/ISSN                                     
linksFieldName  	     Custom 1                                      
location        	     Place Published                               
month           	     Date                                          
note            	     Notes                                         
number          	     Number (Issue)                                
organization    	     Subsidiary Author                             
pages           	     Pages                                         
publisher       	     Publisher                                     
references      	     Notes                                         
school          	     Subsidiary Author                             
series          	     Teriary Title                                 
title           	     Title                                         
undefined       	     Custom 2                                      
url 		    	     URL                                           
volume          	     Volume                                        
year            	     Year                                          