Open Library Guided Tour

We have greatly improved our user interface to make interacting with our book data easier. This brief guided tour focusses on the primary improvements to the UI, with an overview on the newly released Developer API:

Viewing Book Records
Editing / Cloning Book Records
Internationalization
Search
Developer API

As we continue to improve these features over the coming months, we encourage you to join our mailing list to provide us with feedback.

  View Book Record

Every record in our book catalog is editable by any user of Open Library. Options to edit the page content and view a revision history are easily accessible from the top navigational bar. From the revision history page, a user can see all of the edits that were made to any given page, and link or revert to a previous version if the information is more accurate or reliable. As an example, here is the revision history for this page.

If a book is available in digitized form on Open Library, a "READ ONLINE" button will appear on the page. Additional options are also available on the right for books that are not believed to be in the public domain. This includes options to buy the book at other sites, see if the book is available at your local library, or if it is available in full or in part from Internet Archive or Google Book Search.

In addition to bibliographic data from a variety of sources, the book view page displays a fully editable description of the book and a table of contents. All of this content is fully editable when a user clicks the edit button.

  Edit / Clone Book Record

When a user enters edit mode on a book record, they are presented with a new set of options in the top navigational bar. The first two are familiar based on the overview of the view book page - "View" will return a user to the book record display, and "History" will display the revision history page for the selected book record. The other three options (Change Page Type, Modify Edit Template and Modify View Template) are aimed at developers of Open Library, and are outside of the scope of this tour (if you are interested in developing Open Library, read the documentation on our templating language.).

The remainder of the form is reserved for direct editing of bibliographic data. Any field that is followed by a "+" sign is repeatable and allows our UI to aggregate data from multiple sources (If you are interested, you can view the schema that defines the book pages of Open Library). There is also a cover upload feature that presently supports one book cover per entry. Multiple book covers will be supported in the future.

A fully editable Table of Contents for every book is also available on the book edit screen. Fields are repeatable as with the bibliographic data. Support for cloning records is also available to facilitate the creation of book records for similar editions. Simply look for the "Clone This Book" option at the bottom of every book edit page.

Another notable feature of the book edit page is the "Edit Summary." This field appears at the bottom of every edit page on Open Library. It provides a level of annotation so that users can describe the reason they made a particular change in the wiki.

This field, when combined with the recent changes or history view of any page, provides an informal control versioning system that enables people to collaborate more effectively. The revision history also appears on every user page so it is easy to track the changes that any member of the community is making to the system.

  Change Language (i18n)

The new internationalization feature of Open Library enables users to translate our UI into any language. Currently, machine translations exist for Spanish, French and Telugu (in progress). More translations are in the works (see "Open Library Internationalization (i18n) Support" for more information) - and any user can initiate a new language or improve an existing translation by editing the strings in our i18n wiki (the edit page for our Spanish translation is shown below).

Editing is as simple as with any book record - simply click "Edit" in the top navigational bar and you are ready to get started. To see the results, simply change your language in your account preferences.

A few things to note:

• You must be logged in to change languages.
• If you do not yet have an account, you can easily create one.
• Once logged in, click on the link "Preferences" in the upper right hand side.
• The pulldown contains the languages that are currently available.

Translation of individual content pages is also possible on Open Library. If a page has been made available for translation by the community (by changing a page type to "i18n_page"), a user will be prompted by a pulldown menu to select the translation they want to edit. Currently, the content translation feature is in beta and only Open Library administrators can change a page type to "i18n_page". As this feature develops, it will be made available to the community.

  Advanced Search

Search on Open Library is centered around faceted classification. In this mode, the top navigational bar is reserved for "facet surfing" which enables users to broaden or refine their result set by toggling options on and off and selecting facets from the "Refine results" option box on the right. A user can further refine their search by choosing the "Scanned books only" filter to browse the full text selections made available through Open Library.

To see a record for a popular current book:

• Type `heartbreaking genius` into the search box on the front page and hit "Go"
• Follow the first result -- taking you to a book page
• This page contains an excerpt from the first chapter, and if you scroll down to the bottom you'll also see excerpts of publisher reviews as well as the rest of the metadata for the book
• Scroll back up to the top and click on the author's name to go to Dave Eggers's page

To see a record for popular old book that we have scanned:

• Search for `tom sawyer detective` and click on the result with the "full text" button to go to the entry for Tom Sawyer abraod, Tom Sawyer, detective
• To view the scan of this book, hit the "read online" button -- taking you to our flip book
• Follow the author's name to go to the author page for Mark Twain

These full text books are made available through a flipbook interface which simulates the act of reading a physical book. Once a user enters the flipbook view, further searching can be conducted within the book using the flipbook search tool. Search terms are highlighted within the text, and denoted by yellow note tabs in the margins.

If a book record cannot be found, a new one can easily be added by clicking the "Add a new book" option at the footer of the search results page.