Documentation

1. Embedding into an existing HTML file using JavaScript: Easiest and now recommended.
   Simply insert the following in the HTML file in the desired location:

    <script src="https://bibbase.org/show?bib=[URL-OF-BIBTEX-FILE]&jsonp=1"></script> 

   Pros: extremely easy to set up, full control of where your publications appear on your homepage; the format conforms with the rest of the page; as of 2014 supported by Google.
   Cons: none.

2. Embedding in another page using PHP:
   If your webserver runs PHP and it does not prohibit the use of file_get_contents (you will notice if it does), then this is best option and 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("https://bibbase.org/show?bib=[URL-OF-BIBTEX-FILE]");
                    print_r($contents); ?> 

      Where the bibtex URL should again be set according to what you have decided in your first setup step.

Pros: 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: Not an option if PHP is not supported of the server has file_get_contents disabled.



3. Embedding in another page using server-side includes:
   This method is more advanced. It requires your server to support CGI (Perl) and server-side-includes (most servers do).
   1. Download bibbase_proxy2.cgi -- you will need to right-click it and choose "Save Link As" (or similar).
      • This file is required in order to allow your web page to request pages from bibbase.org for embedding in other pages. All this script does is to request the page you saw in the first method from bibbase.org. This page is then embedded in the page of your choice, see below
   2. Place it in your cgi-bin directory.
   3. Edit the HTML file in which you would like your publications to be embedded and add the following line at the desired place:

      <!--#include virtual="URL-TO-CGI-BIN/bibbase_proxy2.cgi?bib=[URL-OF-BIBTEX-FILE]" -->

      changing the path to your cgi-bin folder and your bibfile-URL according to your setup. You can add additional BibBase options to this URL if you want to further customize your page (see table below).
   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. You can call it index.shtml if you want to use it as your main page, in which case the URL to visit does not need to specify the filename (example.com/instead of example.com/something.shtml).
   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_proxy2.cgi is executable by the web server. On a Unix/Linux server you can ensure that by executing: chmod a+x bibbase_proxy2.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.

4. Embedding as an iFrame: (Not Recommended)
   

   <iframe src="https://bibbase.org/show?bib=[BIBTEXFILE]"></iframe>

   Pros: easy to set up.
   Cons: most search engines will consider the frame to be independent of your homepage and hence will not link to your homepage for search results that regard your publications, but will instead link directly to your publications (BibBase page).

• BibTeX: with this method you have the most control by far. To add links to any additional content, just add fields to your bibtex file that start with url. The remainder of the field name will be used as link description or, when using a theme that shows links as icons instead of text, as the icon tool-tip. Underscore characters (_) will be removed. If the field value is a relative URL (does not start with a protocol specification, e.g., http://), then it is interpreted as relative to the location of your bibtex file.

  For instance: The following bibtex entry specifies two relative files, a paper (pdf) and slides (PowerPoint), as well as a link to a publisher's page.

  
                @InProceedings{ gau-hum-1830,
                author =       {Gauss and Humboldt},
                title =        {Measurements of the world},
                booktitle =    {Proceedings of the Conference that never happened},
                year =         {1830},
                note =         {To appear.},
                url_Paper =    {mypdfs/gau-hum-1830.pdf},
                url_Link =     {http://example.com/1830/measurements-of-the-world.html},
                url_Slides =   {talks/gau-hum-1830.ppt}
                }

  Alternatively, you can use this space-separated format:

  url = { Paper=mypdfs/gau-hum-1830.pdf Link=http://example.com/1830/measurements-of-the-world.html Slides=talks/gau-hum-1830.ppt}

  This is particularly useful when using Zotero, which only supports a single url field. In this format, each url specifier needs to match the regular expression (\w*)=http, i.e., in this format all URLs needs to be absolute.
• Zotero, Mendeley: These services allow you to store your papers on their site. BibBase will add links to you publications to make these papers available. Note however that Mendeley has recently started restricting this access more, which means that some papers are only available to logged-in users.
• DBLP, BibSonomy: In many cases these services already include links to freely available copies of your papers, and to publisher sites. If you want to add additional files/links, you are best advised to just download the resulting bibtex file from the BibBase drop-down menu, and then use the bibtex-method described above.

Yes you can! Use the special field abstract to include your abstract which will be displayed as a folded section underneath your publication.

Similarly, you can use the keywords field to provide a list of comma-separated keywords.

Embedding using JavaScript

Embedding using PHP or server-side includes

With CSS users have a versatile mechanism for changing the appearance of your BibBase page. In the majority of cases when someone asks us whether some for of customization is possible with BibBase, the answer is "yes, with CSS".

Here are some commonly requested styling features, all of which can be accomplished by adding the appropriate CSS specifications to your page.

Changing the Description of Bibtex Types

#group_article div.bibbase_group i+span { display: none; }
          #group_inproceedings div.bibbase_group i+span { display: none; }
          #group_mastersthesis div.bibbase_group i+span { display: none; }
          #group_phdthesis div.bibbase_group i+span { display: none; }
          #group_techreport div.bibbase_group i+span { display: none; }
          #group_unpublished div.bibbase_group i+span { display: none; }
          #group_incollection div.bibbase_group i+span { display: none; }

          #group_article div.bibbase_group i:after { content: " Journal Articles" }
          #group_inproceedings div.bibbase_group i:after { content: " Conference and Workshop Publications" }
          #group_mastersthesis div.bibbase_group i:after { content: " Master's Thesis" }
          #group_phdthesis div.bibbase_group i:after { content: " PhD Thesis" }
          #group_techreport div.bibbase_group i:after { content: " Technical Report" }
          #group_unpublished div.bibbase_group i:after { content: " Unpublished" }
          #group_incollection div.bibbase_group i:after { content: " In Collection" }