Extension:BiblioPlus

BiblioPlus performs automated retrieval of citations from Pub Med and the ISBN database. It formats these citations for inclusion in a reference section at the bottom of a page, and autonumbers and formats in-text citations.

BiblioPlus was created to correct an error in some PubMed references containing special characters. The original Biblio extension used the National Center for Biotechnology Information (NCBI)'s SOAP service, which returns data in ISO 8859-1, but does not specify this encoding type in the XML header. Therefore, the SOAP parser reads the data as UTF-8 (the default), which results in incorrect output of some special characters. BiblioPlus uses the NCBI's eUtilities service instead, which returns XML data in UTF-8, solving the problem with special characters.

BiblioPlus uses the same tags as the Biblio extension, so if you are currently using Biblio, you can switch to using BiblioPlus without having to change the code in your pages. However, you must delete or comment out the include statement for Biblio, as you cannot run both simultaneously.

Acknowledgement
Coding of BiblioPlus was supported by faculty funding to the laboratory of Prof. Harry Brumer at the Michael Smith Laboratories and Department of Chemistry, University of British Columbia, Vancouver, Canada.

Installation
1) Place the BiblioPlus folder in the extensions subdirectory of your MediaWiki installation 2) Make sure you have the following variables set in LocalSettings.php. These variables are used to make the call to the PubMed database. $wgSitename = YourSiteName $wgEmergencyContact = YourEmailAddress 3) You are strongly encouraged to register your site name and email address with the NCBI. The reason for this is outlined here: NCBI (See Frequency, Timing and Registration of E-utility URL Requests). The values you register with them must be the values of variables $wgSitename and $wgEmergencyContact that you set in LocalSettings.php. To do this, simply send an e-mail to [mailto:eutilities@ncbi.nlm.nih.gov NCBI EUtilities] including these values, along with a contact name.

4) Get an access key for the ISBN database (isbndb.com). It is highly recommended since the daily quota of queries is by default limited to 500. Otherwise, you would share a key with everyone else. Follow this link, register and create a key: create ISBN account

Please contact [mailto:support@isbndb.com ISBN support] if you want to increase your quota. Tell them you are using the BiblioPlus extension for Mediawiki, and that it links each ISBN-referenced book to their site.

5) Update your LocalSettings.php file with these lines, in that order:        $isbndb_access_key = '12345678'; // your access key         require_once("extensions/BiblioPlus/BiblioPlus.php");

How To Use
This module provides tags and. tags create a citation within the text. You must create a unique key (can be any string with no spaces) for each citation. You can put 1 or more keys, separated by spaces, inside a tag. The keys do not have to be numbers; the citations are automatically numbered in order. You must also list these keys in the section, inside the tag. There is at most one section on the page and it must come after the last citation. Notes to be added after a reference should be separated from the biblio key listing by //, as in the example below. Example:

In-text citation: As reported previously key1 key2, the authors have determined that money can indeed buy happiness key3. References:
 * 1) key1 Wikipedia
 * 2) key2 pmid=12345678
 * 3) key3 isbn=0-4714-1761-0 // figure 5, page 72 is particularly interesting