[Booki-dev] Proposed API for archive.org integration

[adam hyde]

also,by the way, the example you used also imports:
birdbookillustra00reedrich

http://www.booki.cc/the-bird-book-illustrating-in-natural-colors-more-than-seven-hundred-north-american-birds-also-several-hundred-photographs-of-their-nests-and-eggs/edit/


if you have a min to show your team that actually book _does_ import i
would be grateful since i really would like them to feel confident that
we are delivering what we say we are :)

adam


On Thu, 2010-04-29 at 21:50 +0200, adam hyde wrote:
> hey raj,
> 
> thanks for this. it was really great meeting with you.
> 
> We should at some point discuss the epub import as i can see that it
> works as expected for some books and not for others. For example this
> works (imported from 'my books' menu item):
> cinderella00dalziala
> 
> and this works:
> abroadcranethoma00craniala
> 
> those were the first two i tested since our meeting. I have the feeling
> it has to do with booki timing out or returning an error if there is no
> _existing_ epub. 
> 
> anyways, i will discuss this with doug but it /might/ not be on our
> side...will report back when we have looked at it again.
> 
> Doug is still away for another 3 weeks or so...
> 
> adam
> 
> 
> 
> 
> 
> 
> On Thu, 2010-04-29 at 12:34 -0700, raj kumar wrote:
> > Hi,
> > 
> > I met with Adam today and we came up with this very simple API for integration with archive.org
> > 
> > There would be two new services that booki.cc would provide, at the following URLs:
> > 
> > - http://booki.cc/edit/IA/bookId.epub
> > - http://booki.cc/download/IA/bookId.epub
> > 
> > (the actual urls could be different to fit with booki naming conventions)
> > 
> > The first url, /edit/IA/bookId.epub, would cause the booki editor to launch, pre-populated with an archive.org epub. The workflow would look something like this:
> > 
> > 1 . Present log in dialog if user is not already logged in to booki.cc
> > 2. Import IA epub, if this is the first time this book is being edited in booki
> > 3. Open booki editor with the latest revision
> > 
> > The second url, /download/IA/bookId.epub, would cause a download of the latest version of the book in one of the following two ways:
> > 
> > 1. If the book has already been cached in an archive.org item, then this service would issue a 302 redirect to something like
> > http://s3.us.archive.org/booki-bookId/bookId.epub
> > 2. If the latest version of the book hasn't been cached yet, booki would generate the epub for the user, and then cache it for subsequent requests.
> > 
> > 
> > >From the IA side, we would add a two links to archive.org, one to download the corrected epub, and one to open the editor.
> > 
> > For example, for this book:
> > 
> > http://www.archive.org/details/birdbookillustra00reedrich
> > 
> > In the list of available formats for download on the left, we would add "Corrected EPUB" below "EPUB". This link would point to
> > http://booki.cc/download/IA/birdbookillustra00reedrich.epub
> > 
> > Elsewhere on the page we would have text that says "Please help us correct the OCR data for this book on booki.cc", which a link that points to
> > http://booki.cc/edit/IA/birdbookillustra00reedrich.epub
> > 
> > What do you guys think?
> > 
> > -raj
> > _______________________________________________
> > Booki-dev mailing list
> > Booki-dev at lists.flossmanuals.net
> > http://lists.flossmanuals.net/listinfo.cgi/booki-dev-flossmanuals.net
> 
> 


-- 
Adam Hyde
Founder FLOSS Manuals
German mobile : + 49 177 4935122
Email : adam at flossmanuals.net
irc: irc.freenode.net #flossmanuals

"Free manuals for free software"
http://www.flossmanuals.net/about