DocGist is a URL proxy tool that converts AsciiDoc documents fetched from Gists (http://gist.github.com), GitHub repositories, Dropbox folders and other sources to HTML. The conversion to HTML is performed in the browser (client-side) using the Asciidoctor.js JavaScript library

See it live at http://gist.asciidoctor.org.

To run DocGist locally, make it available somewhere on localhost. First, check out the code:

With Ruby, you can then do something like this:

With Python, there’s this:

If you have Apache httpd running on your machine, you can for example add a symlink along the lines of the following to make it serve DocGist:

The above makes DocGist available at http://localhost/docgist/.

The original idea and code for DocGist came from GraphGist. GraphGist is an interactive documentation tool for the Neo4j database and Cypher query language. Both tools were created by Anders Nawroth, an engineer at Neo Technology.

Copyright © 2013-2014 Anders Nawroth and the Asciidoctor Project. Free use of this software is granted under the terms of the Apache License, Version 2.0.