Installation requirements
A machine running a web server with PHP (4 or later) and a MySql server (4 or later).
For Linux users, I recommend installing apache 2, php 4 and MySql 4.
For Mac users, the common apache+mysql installation available on Mac OS X 10.4 (Tiger) is sufficient to run the software.
For windows users, I recommend the installation of EasyPHP (URL).
I also suggest the increase of the size of the upload_max_filesize parameter in the apache php configuration file to at least 10MB (an electronic version of a paper can have such a huge size).
Php Bibtex Database Mgr Installation steps
- Uncompress the archive in the web server root directory (an empty upload directory must be created when you uncompress the zip archive: if that's not the case, create it)
- Modify the owner of the upload directory (apache2 is usually run as www-data) and/or its access rights to permit to apache to write files in it
- Create a database and a local user on the mysql server that is able to create tables in this database (if you don't know how to perform this operation, use a tool able to manage a MySql database, such as phpMyAdmin for example)
- Edit the file include/database.inc and configure the user name, password and database name (the host name should be kept as localhost)
- Open your navigator and request the databaseinit.php file: it will create the database, its tables and an admin user with the password "admin"
- Open your navigator to the index.php page, and login as admin
- Create the users that will use the database
Php Bibtex Database Mgr Installation Update
If you have a previous version of PHP Bibtex Dabatase Manager installed, you must update the format of the database using the script databaseupdate12to13.php.
Installing with Word on Windows
- You must install the mysql ODBC driver on Windows (Download here)
- Configure your ODBC connector under windows
- copy the .dot file (see the Download section) to your Model directory, and edit the libdatabase macro to configure the strings at the beginning of the file (MySql server IP, database user name, database name). Save the .dot file
- create a document using this model, and test if you can access the database
- insert citations in the document, format and unformat them to test the macros (the macro scans all the files opened to find citations,and generate the bibliography in the current active document)
Installing with Openoffice on Windows or Linux
- on both systems, you must install the mysql ODBC driver (and also the unixodbc drivers on Linux)
- in Openoffice, create a new data source using the mysql ODBC driver
- Declare this data source as your bibliography source
- Map the openoffice bibliography fields on the bibtex fields (only the ISBN field is missing)
- use this data source to insert and format bibliography fields in your document