refdb handbook

covers version 0.8.5

Markus Hoenicka

hoenicka_markus@compuserve.com


Table of Contents
Preface
I. Overview
1. General design and feature highlights
Feature list
Design of the bibliography tools
Credits
2. System requirements
Operating system
External libraries necessary to build refdb
External applications
3. Current limitations and platform issues
Limitations
Platform issues
II. Administrator manual
4. Installation
Quickstart guide
Things to know before you start
Installation on Linux and other Unix variants
Installation on Windows NT/2000/XP
Installation on Windows 95/98/ME
Other operating systems
Finishing the refdb installation
Setting up the refdb web services
Logging data
Security issues
5. refdb administration
Create a database
Delete a database
Add or remove a user
Configure the application server
Add or delete bibliography styles
III. User manual
6. Overview of the refdb clients
Quickstart guide
The interactive mode of refdba and refdbc
The non-interactive mode of refdba and refdbc
The non-interactive mode of refdbib
Common command-line options for all clients
7. Data input
Writing RIS datasets
The Emacs RIS mode
Input filters
8. Reference management
Add references
Find and view references
Delete references
Edit references
Use the personal reference list
Global edit references
Create periodical synonyms
Use pdfroot
Interaction with external applications
9. Bibliographies
Manage bibliography styles
Create bibliographies
10. Using the refdb web interface
Overview
The main screens
IV. Reference manual
11. refdbd: the application server
Overview
Starting refdbd
The refdbdrc variables
12. refdba: the administrative client
Overview
Starting refdba
The refdbarc variables
Commands
13. refdbc: the reference management client
Overview
Starting refdbc
The refdbc configuration file variables
Commands
Output formats
The query language
Regular expressions
14. refdbib: the bibliography client
Overview
Starting refdbib
Examples
The refdbibrc variables
15. Reference data conversion tools
dos2unix
nmed2ris
bib2ris
db2ris
16. Bibliography tools
The runbib shell script
The refdbjade shell script
The refdbxml shell script
The bibdb2tei.dsl stylesheet
V. Programmer's manual
17. Reference database design
The table t_refdb
The table t_author
The table t_keyword
The table t_periodical
The table t_user
The table t_xauthor
The table t_xkeyword
The table t_xuser
18. The refdb database design
The table t_journal_words
The table CITSTYLE
The table REFSTYLE
The table SEPARATORS
The table POSITION
19. RIS format specification
The refdb RIS implementation
20. Using the backend API to implement new output formats
The backend API
How to insert a new backend into refdb
21. The refdb SGML/XML input and output formats
The XML input file for bibliographies
The XML input file for bibliographic styles
Processing expectations for the refdb DocBook bibliography output
22. Customization of the refdb web interface
Modifying the stylesheet
Modify the HTML pages
List of Tables
4-1. Log level definitions
5-1. Default access rights for the refdb databases
9-1. Bibliographic reference types
11-1. refdbdrc
12-1. refdbarc
13-1. refdbcrc
13-2. refdbcgirc
14-1. refdbibrc
15-1. nmed2risrc
15-2. nmed2riscgirc
15-3. bib2ris exit codes
15-4. bib2risrc
15-5. bib2riscgirc
15-6. db2risrc
List of Figures
1-1. refdb three-tier architecture
4-1. refdb on a standalone workstation
4-2. refdb on a network
4-3. Example of refdb as a web application
9-1. Schematic representation of a CITESTYLE element