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

[Soulliere, Robert]

Hi Dan,

This is fantastic!

I checked out the epub file and it looks great. I was also able to process an epub file on the documentation web server. Do you think it is ready to add to the nightly processing schedule and made available on the documentation page, or do you think more asciidoc clean up is required first?

Thanks,
Robert

Robert Soulliere, BA (Hons), MLIS
Systems Librarian
Mohawk College Library
robert.soulliere at mohawkcollege.ca
Telephone: 905 575 1212 x3936
Fax: 905 575 2011
________________________________________
From: open-ils-documentation-bounces at list.georgialibraries.org [open-ils-documentation-bounces at list.georgialibraries.org] On Behalf Of Dan Scott [dan at coffeecode.net]
Sent: April 24, 2012 9:02 PM
To: open-ils-documentation at list.georgialibraries.org
Subject: [OPEN-ILS-DOCUMENTATION] Getting the Evergreen docs on your phone:     generating epub

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!
_______________________________________________
OPEN-ILS-DOCUMENTATION mailing list
OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation

This E-mail contains privileged and confidential information intended
only for the individual or entity named in the message.  If the reader
of this message is not the intended recipient, or the agent responsible
to deliver it to the intended recipient, you are hereby notified that
any review, dissemination, distribution or copying of this communication
is prohibited.  If this communication was received in error, please
notify the sender by reply E-mail immediately, and delete and destroy
the original message.