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

Attend OERizona to Learn More about Open Education

OERizona Event to Highlight Open Education Practices and Practitioners Pressbooks is proud to cosponsor the first ever  OERizona event this autumn! This free workshop takes place the day before the 16th Annual Open Education Conference in Arizona. We hope you’ll help us spread the word, or register and attend if you’ll be in town! You’ll

Read More

WiLS Offers Members Discount on PressbooksEDU Silver Plans

Any institutional member of WiLS cooperative purchasing service is now eligible for a 30% discount on PressbooksEDU Silver networks.  We’re happy to partner with non-profit library organization WiLS to offer this great deal to its members.  Here’s what PressbooksEDU can bring to your institution’s open educational resource production program:  Easy-to-use software on which to produce

Read More

MathJax: Now Available on PressbooksEDU

We’re happy to announce the much-awaited arrival of full support for MathJax on PressbooksEDU networks!  MathJax is a JavaScript display engine that translates mathematical markup into high resolution, accessible equations that can render in any supported book format on Pressbooks. Equations in exported formats will also display in SVG, or scalable vector graphic format, meaning

Read More