Books powered by AsciiDoc

[sardine]

I am learning to write a book using AsciiDoc, I found three successful
stories on the web:

1. Git Magic
http://www-cs-students.stanford.edu/~blynn/gitmagic/
http://github.com/blynn/gitmagic/tree/1e5780f658962f8f9b01638059b27275cfda095c
(Source)
2. Apache CouchDB
http://books.couchdb.org/relax/
http://groups.google.com/group/asciidoc/browse_thread/thread/a60f67cbbaf862aa/d214bf7fa2d538c4?lnk=gst&q=book#d214bf7fa2d538c4
(Cue)

3. Ramaze Manual
http://book.ramaze.net/
http://github.com/manveru/ramaze-book/tree/master (Source)

Anybody suggests more examples about using AsciiDoc to write books?
tnks.

[Stuart Rackham]

Thanks for posting these great examples, it's the first I've seen them.

Cheers, Stuart


> >
>

[Stuart Rackham]

I've added these to the examples on the AsciiDoc homepage:
http://www.methods.co.nz/asciidoc/index.html#_overview_and_examples

Cheers, Stuart


> >
>

[Dean Wampler]

We wrote Programming Scala (O'Reilly) using Asciidoc. 

http://oreilly.com/catalog/9780596155957/index.html

We haven't publically documented how we did it, but essentially we used Asciidoc to generate Docbook from which O'Reilly generated PDF.

We had to do some hacking on the configuration files in order to get the particular Docbook tags that O'Reilly wanted for various things. In general, it worked pretty well.

dean 

--
Dean Wampler
coauthor of "Programming Scala" (O'Reilly)
-  http://programmingscala.com
twitter: @deanwampler, @chicagoscala
Chicago-Area Scala Enthusiasts (CASE):
-  http://groups.google.com/group/chicagoscala
-  http://www.meetup.com/chicagoscala/ (Meetings)
http://www.objectmentor.com
http://www.polyglotprogramming.com
http://www.aspectprogramming.com
http://aquarium.rubyforge.org
http://www.contract4j.org

[David Hajage]

It is not a book, but...
http://www.lco.cl/Members/geychaner
http://www.lco.cl/Members/geychaner/Install%20instructions.html
http://www.lco.cl/operations-inf/web-site-documentation/Using%20AsciiDoc.html
http://www.lco.cl/operations-inf/web-site-documentation/WebDAV%20and%20Plone.html

The second link is very interesting: there is a tutorial for mac os X asciidoc installation.
The third seems to be a good introduction to asciidoc markup.

David

[Glenn Eychaner]

Thanks! The install instructions are basically "useful Mac software
for astronomical data analysis and programming". (Note also that the
way I am patching a2x to get around the lack of an extended "readlink"
on Mac is pretty awful.) The WebDAV and Plone pertains to Plone 2; in
Plone 3, in theory, one should be able to create a plugin that allows
pages to be written directly in AsciiDOC, similar to the existing
support for ReStructuredText. In practice, we're still using Plone 2,
and the documentation for the Plone 3 markup plugins was practically
nonexistent last time I checked.

-G.

On Oct 1, 2009, at 7:15 AM, asciidoc group wrote:

> It is not a book, but...
> http://www.lco.cl/Members/geychaner
> http://www.lco.cl/Members/geychaner/Install%20instructions.html
> http://www.lco.cl/operations-inf/web-site-documentation/Using%20AsciiDoc.html
> http://www.lco.cl/operations-inf/web-site-documentation/WebDAV%20and%20Plone.html
>
> The second link is very interesting: there is a tutorial for mac os X

> asciidoc installation<http://www.lco.cl/Members/geychaner/Install%20instructions.html#asciidoc

> >
> .
> The third seems to be a good introduction to asciidoc markup.

--
Glenn Eychaner (geyc...@lco.cl)
Telescope Systems Programmer, Las Campanas Observatory

[Stuart Rackham]

Hi Glenn

Glenn Eychaner wrote:
> Thanks! The install instructions are basically "useful Mac software
> for astronomical data analysis and programming". (Note also that the
> way I am patching a2x to get around the lack of an extended "readlink"
> on Mac is pretty awful.)

I've rewritten a2x in Python (in the trunk) which should get round this problem,
the next release will have a lot of new stuff.

I like the styling of your website, crisp and clean and the 'live search' is nice.


Cheers, Stuart

[Stuart Rackham]

Hi Dean

Thanks for that, I'll add it to the list on the AsciiDoc home page.

I've been meaning to learn Scala, took a quick squiz at your book, liked what I
saw and ordered a copy. It's been many years since I programmed on the Java
platform but I've recently started playing with, and have become a fan of,
Groovy and Grails. Seems like there is a Java resurgence in the air.


Cheers, Stuart

[Dean Wampler]

Thanks for patronizing my book! I hope you enjoy it. 

For Asciidoc purposes, you might find Scala interesting for the combinator parser library that comes with the standard library. It makes it pretty easy to write parsers based on context-free grammars using a DSL that looks a lot like BNF. We discuss it in the DSL chapter. 

For the rest of you, you can read that chapter online here: http://programming-scala.labs.oreilly.com/ch11.html

dean