belaban/JGroups — pull request #95 by mstanleyjones (2013-08-22 02:32:42+00:00)
Title: Converted the manual to AsciiDoc

Hi Bela, I converted the manual to AsciiDoc. First, the steps I took. Then, the errata.

Steps:
1. Clone https://github.com/oreillymedia/docbook2asciidoc
2. For each XML file, ran the command in the readme of #1 to get chunked output. Made sure that those outputs went into the asciidoc/ directory. I used the same structure you already had.
3. Manually added the include statements to the master.asciidoc (see errata)
4. Manually fixed image references and committed the images directory. Since you had asked about scaling to 50%, I made sure that was set up, and made each image a link to the full-size image. I used the PNG version of the images.

I'm surprised that I had to do step 3, and that the includes don't work. I think this might be user error on my part.

Errata:
1. The inclusions don't work with the Github automatic rendering, or I've done it wrong. You have to click each .asciidoc file to see its rendered output. Asciidoctor is actually the mechanism Github uses for this rendering, so @mojavelinux (Dan) may be able to help with this.
2. I used the default docbook-to-asciidoc element mappings from the O'Reilly tool. There may be things you would render in a different way. See http://powerman.name/doc/asciidoc for a quick lesson in Asciidoc markup. Asciidoctor has extended this further.
3. To Mavenize your build and output to HTML or PDF, you will need to use Asciidoctor: https://github.com/asciidoctor/asciidoctor (or for a presentation, see http://mojavelinux.github.io/decks/asciidoc-with-pleasure/)