> The Neo4j graph database project uses Asciidoc, and the output is published here:
> http://docs.neo4j.org/

> The build process is rather complex, with the master documents and configuration
> stored here:
> https://github.com/neo4j/server/tree/master/manual

> We also have our own filter to include code snippets:
> https://github.com/neo4j/server/tree/master/manual/src/bin/resources/...
> The syntax we use may look strange, but it's very readable. The filter is
> tailored for our build setup, but it shouldn't be hard to change it to fit other
> cases.

> We want to keep documentation and code close to each other, so each project has
> it's own documents, and that gets pulled together by the Maven build tool and
> pushed onto some scripting that executes asciidoc/a2x.

> So for example the code snippets on this page:
> http://docs.neo4j.org/chunked/snapshot/indexing-create.html
> are included from this document:
> https://github.com/neo4j/graphdb/blob/master/lucene-index/src/docs/de...

> The code included lives here:
> https://github.com/neo4j/graphdb/blob/master/lucene-index/src/test/ja...

> and is tested on each commit.

> I just thought this could be interesting to someone on this list :-) And of
> course for the list of projects using Asciidoc!

> BTW, we're still on version 8.6.3 - I hope to upgrade in a couple of weeks. So I
> haven't looked into how filters are handled in 8.6.4 yet.

> /anders

> On 31/03/11 01:10, Anders Nawroth wrote:
>> Hi!

>> The Neo4j graph database project uses Asciidoc, and the output is
>> published here:
>> http://docs.neo4j.org/

>> The build process is rather complex, with the master documents and
>> configuration
>> stored here:
>> https://github.com/neo4j/server/tree/master/manual

> Very impressive, it amazes me what people get up to with AsciiDoc.

>> The syntax we use may look strange, but it's very readable. The filter is
>> tailored for our build setup, but it shouldn't be hard to change it to
>> fit other
>> cases.

> It's a nice solution to your snippet problem, can it be installed using
> the new Filter Plugins mechanism
> (http://www.methods.co.nz/asciidoc/filters.html)? I'm certain that a lot
> of other users would be interested in using it.

>> BTW, we're still on version 8.6.3 - I hope to upgrade in a couple of
>> weeks. So I
>> haven't looked into how filters are handled in 8.6.4 yet.

> Probably answers my Filter Plugins question.

> Cheers, Stuart

>> /anders