Help

How to use BibBase

First, you will need to create a bibtex file with all your publications. A good way to start is to scrape your DBLP record using our scraper (below). For now, we'll assume that you called that file list.bib. Second, you will need to make that file available on the web, e.g. at a URL like http://www.cs.toronto.edu/~fritz/list.bib which we will use in our examples. In your bibtex-entries you can use the special fields "urlN", where N is any string (including the empty one), to point to the actual paper and/or any other material you would like to link to your reference. For convenience, you can write the filename only (e.g. url = {mypaper.pdf}). BibBase will then assume that the file resides in the same directory as your list.bib file.
Another special field is abstract, to include an abstract which will be displayed as a "fold-out".
Also the keywords field can be used to provide a comma-separated list of keywords.

There is a number of ways to use BibBase to display your publications on your web page. Each of the following alternatives has its own pros and cons. The following are the two main possibilities, where the former should work for everyone and is very easy to set up, while the latter is more advanced but has certain advantages.

As a separate page, e.g. when using frames:
1. Visit: http://www.bibbase.org/show?bib=www.cs.toronto.edu/~fritz/list.bib (with the URL changed appropriately).
2. If things look good, you can immediately use this URL in a frame on your web page.
Pros: easy to set up.
Cons: some search engines may consider the frame to be independent of your homepage.
Embedded in another page using PHP: (Recommended)
If your webserver runs PHP and it does not prohibit the use of file_get_contents (you will notice if it does), then you are lucky. Embedding bibbase in your homepage is very easy:
1. Rename your current homepage, say index.html, to have the .php extension, say index.php
2. In index.php put the following snippet wherever you want your publications to appear:
```
  <?php
    $contents = file_get_contents("http://www.bibbase.org/show?bib=www.cs.toronto.edu/~fritz/publications/list.bib&proxy=1");
    print_r($contents);
  ?>  
```
  Where the bib-URL should again be changed appropriately.

Pros: still pretty easy to set up, full control of where your publications appear on your homepage; the format conforms with the rest of the page; search-engine friendly.
Cons: PHP is required and some servers disable the file_get_contents function.

Embedded in another page when using PHP is not possible:
This method is more advanced. It requires your server to support CGI (Perl) and server-side-includes (most servers do).
1. Download bibbase_proxy -- you will need to right-click it and choose "Save Link As" (or similar). Why do I need this?
2. Place it in your cgi-bin directory and rename it to bibbase_proxy.cgi.
3. Edit the HTML file in which you would like your publications to be embedded and add the following line at the desired place:  changing the path to your cgi-bin folder and your bibfile-URL according to your setup.
4. Rename the file to [something].shtml, so the server knows that it has to parse the file and interpret the include expression before displaying it.
Trouble Shooting:
- You may need to create a .htaccess file in the same directory as the .shtml and/or add Options +Includes to it. This enables server-side includes in this directory.
- Make sure bibbase_proxy.cgi is executable by the web server. On a Unix/Linux server you can ensure that by executing: chmod a+x bibbase_proxy.cgi.
Pros: full control of where your publications appear on your homepage; the format conforms with the rest of the page; search-engine friendly.
Cons: more complex set-up; some servers don't allow server-side-includes.

Don't have a Bibtex file of your publications yet?

To get started, you can use this scraper to get all your Bibtex entries from DBLP: Scraper.

Parameters

As you have probably seen by now, visitors to your page can customize the way your publications are displayed. In order to set a default, you can use additional parameters. These can be added to the URL by appending any number of terms "&[option]=[value]" to the URL, where the options are as follows:

Option	Values	Description
group0, group1, ..	any bibtex-field, e.g. year	Organize the list in groups, e.g. by the same year. The number indicates the level. E.g.: `group0=year`.
filter	`bibfield:pattern`	Only show elements mentioning `pattern` in the the specified bib-field, e.g.: `filter=authors:Fritz`.
folding	1 or 0	Fold / Unfold everything. Default: 0 (unfold everything).
simplegroups	(any value activates this)	Show only the following grouping criteria: year, author, keywords, type. The option is activated as soon as the option is used with any value.
css	URL to CSS file	User a specific CSS style file for displaying the page. This option is mainly relevant when not using the embedded approach described above. When you do use the embedded method, this field will merely indicate whether or not the surrounding page defines a CSS style or not (in which case BibBase will not interfere with that). The possible ways in which CSS can be used to customize the appearance of your page is best described by this example CSS file, which enumerates all the different defined fields: www.bibbase.org/styles/fancy.css.