______ ______ ______ __ ______ ______ ______ ______
/\ ___\ /\ ___\ /\ __ \ /\ \ /\ __ \ /\ ___\ /\ ___\ /\ __ \
\ \___ \ \ \ \____ \ \ __ \ \ \ \____ \ \ \/\ \ \ \ \____ \ \ \____ \ \ \/\ \
\/\_____\ \ \_____\ \ \_\ \_\ \ \_____\ \ \_____\ \ \_____\ \ \_____\ \ \_____\
\/_____/ \/_____/ \/_/\/_/ \/_____/ \/_____/ \/_____/ \/_____/ \/_____/
Scala implementation of Docco
-----------------------------
Produces HTML pages that displays your comments alongside your code.
Scalocco is a really quick-and-dirty, literate-programming-style documentation generator. It is a Scala port of Docco, which was written by Jeremy Ashkenas in Coffescript and runs on node.js.
Scalocco produces HTML that displays your comments alongside your code. Comments are passed through Markdown, and code is highlighted using google-code-prettify syntax highlighting.
Currently, to build Scalocco, you'll need sbt and scala. The project depends on scala-mustache and Markdown4j
To run Scalocco, just use sbt:
sbt "run /path/to/scala/files"
...will generate linked HTML documentation for the named source files, saving
it into a docs
folder.
The visual style was borrowed from the .Net implementation of Docco: Nocco
You can see the result of running Scalocco on its own source code here: http://grison.me/scalocco/source