[OPEN-ILS-DOCUMENTATION] Getting the Evergreen docs on your phone: generating epub

Dan Scott dan at coffeecode.net
Tue Apr 24 21:02:10 EDT 2012


I was thinking about doing this at the hackfest, but ended up playing
around on the plane over instead, so... As of commit ed287098f29915ba,
the docs now play nicely with the "a2x --format epub root.txt" command
and will generate an epub file suitable for loading on your e-reader
hardware or application of choice.

The major barrier to epub output was a handful of errors in the Asciidoc
source. I think the plain old "asciidoc" command is more tolerant of
some errors, so the epub run was good in any case as I think I've sorted
out a few problems like you can currently see on 
http://docs.evergreen-ils.org/2.2/_fund_tags.html (but won't see in a
few hours), where the "Note" is preceded and succeeded by "+" lines and
the numbers start at 1 again after the note. Also, the build complained
loudly about missing images, so those got sorted out (typos, for the
most part).

The 2.2 docs are really coming together, folks - nice work!


More information about the OPEN-ILS-DOCUMENTATION mailing list