Books powered by AsciiDoc

1926 views
Skip to first unread message

sardine

unread,
Sep 17, 2009, 9:31:05 AM9/17/09
to asciidoc
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

unread,
Sep 19, 2009, 5:52:39 PM9/19/09
to asci...@googlegroups.com
Thanks for posting these great examples, it's the first I've seen them.

Cheers, Stuart


> >
>

Stuart Rackham

unread,
Sep 20, 2009, 12:04:53 AM9/20/09
to asci...@googlegroups.com
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

unread,
Sep 29, 2009, 12:04:16 PM9/29/09
to asci...@googlegroups.com
We wrote Programming Scala (O'Reilly) using Asciidoc. 


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 

David Hajage

unread,
Sep 30, 2009, 8:30:50 AM9/30/09
to asci...@googlegroups.com

Glenn Eychaner

unread,
Oct 1, 2009, 12:15:21 PM10/1/09
to asciidoc digest subscribers
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:

> 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

unread,
Oct 1, 2009, 3:33:59 PM10/1/09
to asci...@googlegroups.com
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

unread,
Oct 1, 2009, 6:06:05 PM10/1/09
to asci...@googlegroups.com
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

unread,
Oct 1, 2009, 9:35:55 PM10/1/09
to asci...@googlegroups.com
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
Reply all
Reply to author
Forward
0 new messages