[Taxacom] Linking to the BHL

Beach, James H beach at ku.edu
Tue Jun 24 16:47:04 CDT 2008


Please respond to the original sender directly as he does not subscribe
to Taxacom.
 
________________________________

From: Garnett, Tom [mailto:GarnettT at si.edu] 
Sent: Tuesday, June 24, 2008 3:55 PM
To: Beach, James H
Subject: FW: Linking to the BHL



Jim,

 I don't subscribe to Taxaxom but someone shared a recent posting about
the BHL.  Below is my response.  Can you see to it that this gets
posted, please?\

Thanks,

 

Thomas Garnett

Biodiversity Heritage Library Program Director

Smithsonian Institution Libraries

Rm. CE-G23

MRC 154 PO Box 37012

Washington, D.C. 20013-7012

202-633-2238

202-786-2866 fax

garnettt at si.edu

 

________________________________

From: Garnett, Tom 
Sent: Monday, June 23, 2008 11:50 AM
To: 'taxacom-bounces at mailman.nhm.ku.edu'; 'Paul Kirk '
Cc: 'Chuck Miller'; Mike Lichtenberg; Chris.Freeland at mobot.org;
cnorton at mbl.edu; G.Higley at nhm.ac.uk; Garnett, Tom; Rinaldo, Connie
Subject: Linking to the BHL

 

Colleagues,

Thank you for raising issues about ways to use BHL content.  Below,
excerpted from the BHL Tool Page  <
http://www.biodiversitylibrary.org/Tools.aspx> are the various ways one
can _currently_ link to BHL content.  Notice that one can right now link
to a specific page. This is close to but not exactly the same, I
believe, as what Paul Kirk means when he writes that the BHL has "no
URLs which simply resolve to a jpg"  We can facilitate linking to a JPG,
but to ensure that the link persists we need to do a bit more server
programming.    I suggest that we further define the requirements Paul
requests (off-list) and evaluate the best implementation path.

Yours,

 

Thomas Garnett

Biodiversity Heritage Library Program Director

Smithsonian Institution Libraries

Rm. CE-G23

MRC 154 PO Box 37012

Washington, D.C. 20013-7012

202-633-2238

202-786-2866 fax

garnettt at si.edu

 

 

 

<Begin BHL Tools Page>

BHL is building APIs to allow individual users and data providers to
remix and reuse BHL content. The following APIs are currently available
or under development. To suggest an API or enhancement, please use our
Feedback <http://www.biodiversitylibrary.org/Feedback.aspx> . 

Scientific Names

BHL uses TaxonFinder
<http://www.ubio.org/index.php?pagename=xml_services> , a taxonomic
intelligence tool developed by collaborators at uBio.org
<http://www.ubio.org> , to locate and identify scientific names within
the text of digitized books. This names-based index is an incredibly
valuable tool for organismal research, and is easily incorporated into
external web sites through two different methods of access.

1. Bibliography by URL 
To easily link into a list of all pages containing a given scientific
name, use the following URL:

http://www.biodiversitylibrary.org/name/Scientific_name

Where Scientific_name is any uninomial, binomial, or trinomial. Replace
spaces with the underscore ( _ )character. 

Examples:

*	http://www.biodiversitylibrary.org/name/Orchidaceae (Orchid
family) 
*	http://www.biodiversitylibrary.org/name/Carcharodon_carcharias
(Great white shark) 
*
http://www.biodiversitylibrary.org/name/Phalacrocorax_carbo_maroccanus
(Great Cormorant) 

2. BHL Name Services 
The BHL Name Services are XML-based web services that can be invoked via
SOAP or HTTP GET/POST requests. Responses can be received in one of
three formats: XML wrapped in a SOAP envelope, XML, or JSON.

If you want to use SOAP to invoke the service methods, you can navigate
to http://www.biodiversitylibrary.org/services/name/NameService.asmx to
view the available methods. From that page, you can view the WSDL
document for the web service, or click on each method to see detailed
information about invoking the method and about the data that is
returned.

If you are using HTTP to invoke the methods, the services are located at
http://www.biodiversitylibrary.org/services/name/NameService.ashx. Note
the difference in the extension on the service URL: ASHX for HTTP vs.
ASMX for SOAP.

Full documentation on the BHL Name Services is available at: 
http://docs.google.com/Doc?id=dgvjvvkz_1x5qbm3

Stable URLs

BHL produces stable URLs for our content and will ensure viability of
these URLs. Stable URLs are available for the following areas of
content, with examples:

Subject: Insects 
http://www.biodiversitylibrary.org/subject/Insects

Author: Darwin, Charles, (1809 - 1882) 
http://www.biodiversitylibrary.org/creator/93

Title: The Journal of the Linnean Society 
http://www.biodiversitylibrary.org/title/350

Item/Book: The Journal of the Linnean Society, v. 8 1865 
http://www.biodiversitylibrary.org/item/8361

Page/Article: Bentham, G. (1865). On the Genera Sweetia, Sprengle, and
Glycine, Linn., simultaneously published under the name of
Leptolobium.The Journal of the Linnean Society, 8: 259-267. 
http://www.biodiversitylibrary.org/page/226820

Citation Linking

Data providers can include links to literature using our stable URLs for
scanned pages. The URL is displayed below "Link to this page". For
example, to cite the original description of Zea mays:

Citation: Carl Linnaeus' Species Plantarum. 2 : 971. 1753. 
http://www.biodiversitylibrary.org/page/358992

Coming Soon - Data providers will be able to query BHL to determine if a
given journal article or book has been digitized. Plans are underway to
use OpenURL to facilitate linking.

 

 




More information about the Taxacom mailing list