APIs for Books: Article on O’Reilly Blog

I’ve got a long article up at O’Reilly, “A Publisher’s Job Is to Provide a Good API for Books.” The main premise is that building a good index for an ebook is the same thing as building a good API. If you add some more metadata to your index entries, you can make a great API.

One thing I’d love to see as we move to open source is plugins getting developed to do the things I talk about in this article.

Here is a taste:

And now instead of “just” an index, you have a complete semantic map of your book, a map that was only a little bit harder to produce than the standard index you were going to make anyway.

So what?

With a semantic map like this you have the beginnings of an incredibly powerful API. If in addition to just having the semantic map … you also have your book “live” online (behind an authentication wall or not), it means you can make this semantic map/API available to the world (for free, or under certain commercial arrangements), and say: please, find wonderful things to do with my wonderful book content.

[more on the TOC blog …]

Related Posts

A Big, Warm Welcome to Pressbooks’ Newest team members: Carlos, Ho Man, and Başak

It’s time for us to lift the curtain on some major changes here at Pressbooks!  We’ve spent a lot of time over the last month doing some much-needed maintenance across the platform, including theme improvements and changes to the user experience for institutions using single-sign on technology. These past weeks also included important work on

Read More

Introducing: Malala

Take a look at our new textbook theme and try out its coolest feature: interchangeable fonts As some of you may have noticed, we have a tradition here at Pressbooks of naming our book themes after famous authors. We’ve tried to imprint the legacy that these authors and their books have left on literature onto

Read More

Scheduled Maintenance

To boost the performance and security of the Pressbooks.com network, we intend to perform scheduled maintenance on Thursday, Sept. 12 between 3 a.m. and 5 a.m. Eastern. What to expect. You can expect a short service interruption (1-2 minute downtime expected) at some point during this time frame, which would cut off any long processes like imports/exports.

Read More