Skip to content

agrison/scalocco

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

 ______     ______     ______     __         ______     ______     ______     ______    
/\  ___\   /\  ___\   /\  __ \   /\ \       /\  __ \   /\  ___\   /\  ___\   /\  __ \   
\ \___  \  \ \ \____  \ \  __ \  \ \ \____  \ \ \/\ \  \ \ \____  \ \ \____  \ \ \/\ \  
 \/\_____\  \ \_____\  \ \_\ \_\  \ \_____\  \ \_____\  \ \_____\  \ \_____\  \ \_____\ 
  \/_____/   \/_____/   \/_/\/_/   \/_____/   \/_____/   \/_____/   \/_____/   \/_____/

                         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

About

Scalocco, a quick and dirty implementation of Docco in Scala

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages