Judo is a Julia document generator. It takes documents written in pandoc markdown and converts them into html, but differs from general purpose markdown tools in a few ways.
- Code blocks can be executed and their results, including graphics, inlined in the document.
- Metadata can be attached to a document in the form of YAML front-matter (similar to Jekyll).
- Multiple documents can be compiled and cross-linked.
- Function and types comments can be parsed from Julia source code and included in a document. (Note: this is not fully implemented yet)
The end goal is to make documenting Julia code, whether it be a package, or some quick-and-dirty analysis, as painless as possible.
Status
This is work in progress. I'm using it to generate documentation for Gadfly, and figuring out the details as I go along. Contributions or feedback is welcomed.