Add asciidoc toolchain help in README.md

[clojure-cookbook]

Add asciidoc toolchain help in README.md

[avescodes]

This is a pain, I'm going to talk to @levand about how we can open up this process. Unfortunately right now the actual book build process exposed to us by O'Reilly is not eminently "openable" – I hope to get something on this front within the week.

[eigenhombre]

Sounds good / understood - even the simplest instructions for making HTML versions for self-preview might be helpful to new contributors.

[avescodes]

At worst, I'd like to get what you're talking about, at best, I'd like active contributors to be able to have access to draft renderings. I just need to not have a job so I can do this all sooner 😉

[eigenhombre]

:-)

[hlship]

I did a brew install of asciidoc, but none of the Clojure code came through in the (giant, single-page) output document. I haven't used asciidoc before ... pointers on where to get, and how to configure things would be nice, as would a base script to build the book. I don't like to fly blind!

[levand]

The actual rendering process is using O'Reilly's specific Asciidoc install,
with their own templates applied which (as far as I know) aren't easily
available.

They just opened up the ability to programmatically hit their API and
trigger a build, which I can do based on a Github commit hook, but that
still doesn't help individual authors vet their stuff before actually
filing the pull request.

On Wed, Aug 14, 2013 at 12:01 PM, Howard M. Lewis Ship <
[email protected]> wrote:

I did a brew install of asciidoc, but none of the Clojure code came
through in the (giant, single-page) output document. I haven't used
asciidoc before ... pointers on where to get, and how to configure things
would be nice, as would a base script to build the book. I don't like to
fly blind!

—
Reply to this email directly or view it on GitHubhttps://github.com//issues/59#issuecomment-22646236
.

[avescodes]

I'm going to close this, but this may be worth re-opening after we finish the book shortly.