1. PHP Bibtex Database Manager Menu

1.1 General

Logout : quits the application.

1.2 Administration

Init the Database: this page must be used to create the tables in the database. Once this action has been performed, any further call to this page will produce no result in the database.

Manage users: This page can only be used by the admin user to create/delete users. If you want to modify a user, you must delete it and create it again. The goal of user definition is to identify who has put entries in the database, and define the user rights (read or read/write access).

Verify Database: This page is used to test the integrity of the database. It tests if all the tables seem to be correct, and if the files on the disk are coherent with the citation table. Morevover, it tests if the bibtex citation keys are correctly built (using the rule we have defined (see below)), and tries to find if there are mulitple references to the same citation in the database.

Change password: this page provides the user with a way to modify his password. The old and new password must be given. The password is crypted in the database in the users_tbl table.

1.2 View

View Last Entries: this page shows the last entries in the database (most recent at top of the list).

View Database: this page generates the whole database as a HTML file. You can then make a find on the page to find a particular information.

Generate Bibtex File: this page generates the whole database as a bib file. It can then be used in bibtex as usual.

1.3 Basket

Display My Basket: using this page, a user can see the papers he has inserted in his basket. This basket is store in the database, and thus it is kept from one session to another.

Generate My bibtex: using this page, a user can generate its own bib file (using the entries in his basket) to use with bibtex.

1.4 Bibtex Entries

Formular: this page aims to insert a new citation in the database using a form. The form is automatically modified when you modify the bibtex entry type (article, book, phdthesis ...). If you want to attach a file (pdf, ps ...) to the citation, you must fill both the 'file' field (name of the file on the server disk) and the 'Upload' field (local name of the file). Why is there two fields ? Well, in fact, it is not possible to have two files on the server with the same names. The easiest way to ensure this property is to use the bibtex Citation Key as file name (e.g., key.pdf). Thus, I suggest you use this rule to build the 'file' field. Two submit buttons are provided: the 'Insert' button and the 'Replace' button. Use the first one to insert a NEW citation in the database, and the second one to replace an already existing citation (when you edit it for example). The software can also generate automatically a bibtex key that is not in the database: click on the 'generate bibtex key' button when you have filled the author and year fields. In order to generate a bibtex key, the software uses the following algorithm: if there is only one author, it uses the first three letters of the author name followed by the two last digits of the year (ex: And80). If there are less than 4 authors, it uses the first letters of the author names followed by the last two last digits of the year (ex: ABC98). If the are more then 3 authors, it uses the first letter of the author name followed by "al." and the last two last digits of the year (ex: Tal.99). If the built key already exists, it adds 'a', or 'b' or 'c', ...

The author or editor fields must be built in the standard Latex way (authors must be separated by a ' and ').

Text Entries: You can often find on the web paper bibtex citations in a text format. This page provides a way to copy/paste this information to insert it in the database. You can then edit the inserted citations to add any information you need (e.g., attach a file to the citation).

Import a bibtex file: If you chose to use this tool, then you probably have a big bib file you would like to import in the database.If this is the case, then you just have to select it, and upload it to the application. But you have probably a lot of electronic versions of the papers, and would like these files to be uploaded on the server as well. You must then tell to the application where to find these files (on a ftp server installed on your machine, that has an anonymous account (ftp@ftp)). If the bibtex entries imported have a 'file' field, this field will be used. Otherwise, the program will try to guess the file name using the bibtex Citation key (e.g., key.pdf, key.ps, key.doc, key.txt, key.html ... and so on).

1.5 Search

Simple searches: this page provides multiple simple searches on the database. The result can appear as HTML pages or as bibtex textual citations. In the second case, you can copy/paste the entries to you bib file in order to use it with bibtex.

Complex searches: this page provides a way to make complex requests on the bibtex field contents. The result can appear as HTML pages or as bibtex textual citations. In the second case, you can copy/paste the entries to you bib file in order to use it with bibtex.

Search PDFs: this page uses WebGlimpse to search through the papers on the disk upload directory. You must install Weblimpse II (free for academics) in order to use this feature.

1.5 Links

This menu provides several links to scientific literature sites.

1.6 Help

This menu provides several links to pages where you could find more information on this software. This documentation, the forum where you can discuss about this software, the bugtracker where you can report bugs, and the version of this software.

2. On screen Bibtex entry display

When the software displays a bibtex entry on screen, it provides a number of actions that can be performed on this entry: Edit it (using the bibtex form), Remove it from the database, Copy it to the basket (if it's not already in), Remove it from the basket (if a copy is in the basket), or display it on the bibtex text form. Additionnaly, there is a link to the paper electronic form on the server disk if the file is available, or two links to google to find it on the Web if the paper is not available in the database.

3. Quick Search

At the bottom of the screen, you can find a quicksearch formular. When you activate this function, it will give you the result of this request in the bibtex manager database, but it will also provide links to the result in other databases such as IEEE, ACM, CiteSeer, Google, Google Scholar...

4. Character Set

The software currently handles most latin 1 french characters, and is able to convert them to latex form when it generates the bibtex file.If you need more special characters to be handle, please see the conversion functions in the strings.php file (in the include directory). You have thus the choice to insert citations either using the standard latex characters (e.g., é = \'e), or the latin 1 charset.

5. Cookies

The software stores in a cookie the session variables. The only variable stored is the user variable that contains the user id, his first name and Last name. The password is not available in the variable. The navigator must then accept cookies.

6. Bibtex Word Macro Functionalities

Most of the functionalities of PHP Bibtex Manager are available directly from word using the Word Bibtex macro available on this site. This macro aims to do exactly what the Endnote software with Endnote database, but using a bibtex database. You can thus insert citations in your documents, and format them automatically. The great advantage of this macro is that you do not need anymore to convert files from Bibtex to Endnote or vice-versa if you are using both word and latex (as most people do). If citations use Latex special characters, the most common characters are automatically translated (french latin 1 characters only currently: add more in the macro editor libbibtex/converString function if you need more).

This macro should work on Word 2000 and later versions. The ADO and Listview components must be available on your system. This macro does not work on Word 97 (Visual Basic has evolved, and some functionalities were not available in this version, as well as some components).

7. Openoffice Functionalities

You should be able to interface Openoffice directly with the bibtex database (see the installation notes). Most of the functionalities offered by the Bibtex Word macro are currently available in this software.

Home Page