BibDesk Search Groups

From BibDeskWiki

Table of contents

1 Adding a New Search Group 2 Adding a Bookmark for a Search Group 3 Saving a Search Group to File 4 Adding a Default Server 5 Editing a Default Server 6 Removing a Default Server 7 Resetting the Default Servers to the Factory Settings 8 Links to Search Groups 9 Custom Servers

Adding a New Search Group

BibDesk search groups allow you to search certain servers for bibliography information that you can easily import into your BibDesk database. Currently BibDesk can search servers for Z39.50 (the standard for libraries around the world), Entrez (e.g. PubMed), and ISI World of Science.

• New default or custom search group:
  1. Choose Searches->New Search Group...
  2. Select a server type
  3. Select a default server from the popup, or Other for a custom server
  4. Supply the necessary server information for a custom server. You need to supply a name and database, for Z39.50 you also need to supply the host address and port number.
  5. Hit OK
• New search group from bookmark:
  1. Select a search group bookmark from the Searches menu
• New search group from file:
  1. Drop a .bdsksearch file on the main window

Adding a Bookmark for a Search Group

You can save a search group - including the search term - to a bookmark. With the search group selected, choose Searches->Add Bookmark..., and enter a title for the bookmark. You can later add the search group as described above.

Saving a Search Group to File

You can save a search group - including the search term - to file. Simply drag the search group from the side bar to the Finder. You can later add the search group as described above.

Adding a Default Server

The default servers are the named servers that appear in the Server popup in the search group editing sheet.

• Adding a custom server to the default servers:
  1. Select the search group and choose Edit->Get Info or double-click the search group icon in the side bar to show the server settings.
  2. You may need to select the downward arrow next to the Server popup to view the full server information.
  3. Hit the Add button.
• Adding a search group from file as a default server:
  1. Move or copy the search group file to ~/Library/Application Support/BibDesk/SearchGroupServers/ (~ is the home folder of this user). You may have to create this folder if it does not exist.
  2. Restart BibDesk.

Editing a Default Server

Occasionally you may want to edit the server information for a default server.

• Editing a default server:
  1. Show the server information as described above. Make sure you have a default server selected.
  2. Hit the Edit button.
  3. Edit the server information.
  4. Hit the Set button to commit the changes to the default server.
  5. Hit OK to commit the changes to the current search group.

Removing a Default Server

Occasionally you may want to remove a default server. This can not be done for build-in default server.

• Removing a default server:
  1. Show the server information as described above. Make sure you have a default server selected.
  2. Hit the Remove button.

Resetting the Default Servers to the Factory Settings

After changing adding or editing default servers, you may want to reset the default servers to their factory defaults.

• Resetting the default servers:
  1. Show the server information as described above. Make sure you have a default server selected.
  2. Hit the Reset All button.

Links to Search Groups

The latest nightly builds support custom URLs you can use to add links in a document to quickly open search groups in BibDesk. A search group URL has the syntax

x-bdsk-search://server/database;name?options

For Entrez and ISI groups, the server part is entrez and isi, respecitively. For Z39.50 groups, the server part has the form host:port or user:password@host:port. The name part is optional and defaults to the database. The options part is optional, and consists of zero or more option=value pairs, separated by &. Any group can have a searchTerm option. Z39.50 groups in addition recognize the options recordSyntax, resultEncoding, and removeDiacritics. You can also pass the name, database, username, or password in the options. Invalid URL characters as well as reserved characters (such as ;/?:@&=+$,) need to be %-escaped. E.g. a space character is escaped as %20. Some examples for the Library of Congress and PubMed search groups:

x-bdsk-search://z3950.loc.gov:7090/Voyager;Library%20of%20Congress?recordSyntax=US%20MARC&resultEncoding=marc-8
x-bdsk-search://entrez/pubmed;PubMed

You can easily get a URL for a search group by choosing Group URL from the contextual menu.

Custom Servers

This is a list of additional search groups that can be added to BibDesk. These scripts are written by BibDesk users; for further discussion or to post groups, use the BibDesk-users mailing list (http://lists.sourceforge.net/lists/listinfo/bibdesk-users). Right-click the link to save them.

• Z39.50 Servers
  • OCLC ArticleFirst (http://www.reed.edu/~ahm/Projects/Citation/BibDesk/SearchGroupServers/OCLC%20ArticleFirst.bdsksearch) - "OCLC index of articles from the contents pages of journals." (Alex Montgomery)
  • OCLC ECO (http://www.reed.edu/~ahm/Projects/Citation/BibDesk/SearchGroupServers/OCLC%20ECO.bdsksearch) - "An OCLC collection of scholarly journals." (Alex Montgomery)
  • OCLC WorldCat (http://www.reed.edu/~ahm/Projects/Citation/BibDesk/SearchGroupServers/OCLC%20WorldCat.bdsksearch) - "OCLC catalog of books and other materials in libraries worldwide." (Alex Montgomery)
  • Orbis Cascade Summit (http://www.reed.edu/~ahm/Projects/Citation/BibDesk/SearchGroupServers/Orbis%20Cascade%20Summit.bdsksearch) - "A library catalog that combines information from Pacific Northwest academic libraries into a single unified database." (Alex Montgomery)
  • baC (http://www.simifilm.ch/bibdesk/baC.bdsksearch) - "Catalogue of the public libraries of Berlin." (Simon Spiegel)
  • Helveticat (http://www.simifilm.ch/bibdesk/Helveticat-zoom.bdsksearch) - "Swiss national library." (Simon Spiegel)
  • NEBIS (http://www.simifilm.ch/bibdesk/NEBIS-zoom.bdsksearch) -"Network of Libraries and Information Centers in Switzerland." (Simon Spiegel)
• Entrez Databases
  • Entrez databases (http://bibdesk.sourceforge.net/searchgroups/EntrezSearchGroups.zip) - All available Entrez databases (Christiaan Hofman)