Skip to content

Latest commit

 

History

History
34 lines (25 loc) · 1.87 KB

README.md

File metadata and controls

34 lines (25 loc) · 1.87 KB
 ______     ______     ______     __         ______     ______     ______     ______    
/\  ___\   /\  ___\   /\  __ \   /\ \       /\  __ \   /\  ___\   /\  ___\   /\  __ \   
\ \___  \  \ \ \____  \ \  __ \  \ \ \____  \ \ \/\ \  \ \ \____  \ \ \____  \ \ \/\ \  
 \/\_____\  \ \_____\  \ \_\ \_\  \ \_____\  \ \_____\  \ \_____\  \ \_____\  \ \_____\ 
  \/_____/   \/_____/   \/_/\/_/   \/_____/   \/_____/   \/_____/   \/_____/   \/_____/

                         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