DocGist
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
|
Note
|
DocGist is a hosted alternative to the Asciidoctor.js Live Preview extension for Chrome. |
Hosted Demo
See it live at http://gist.asciidoctor.org.
Run Locally
To run DocGist locally, make it available somewhere on localhost.
First, check out the code:
git clone [email protected]:asciidoctor/docgist.git
cd docgistWith Ruby, you can then do something like this:
ruby -run -e httpd . -p 9090With Python, there’s this:
python -m SimpleHTTPServerIf 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:
sudo ln -s /home/anders/git/docgist /var/www/docgistThe above makes DocGist available at http://localhost/docgist/.
History
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 and License
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.