Skip to content

mmcgrana/clj-doc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

clj-doc: Clojure HTML documentation generator

clj-doc generates HTML documentation for Clojure source code. The generated docs are searchable via JavaScript and include inline source snippets for the code that defined each var.

Example Docs

You can see example docs generated from recent recent Clojure and Clojure Contrib sources by opening example/index.html in your browser.

Setup

To generate your own docs, you will need the following dependencies:

You will also need clj-doc.jar, which you can produce by invoking ant.

Basic Usage

You can use the built-in clojure_gen.clj script to generate HTML docs for Clojure and the main libraries in Clojure-Contrib:


clj clj-doc/bin/clojure_gen.clj /path/to/output
open /path/to/output/index.html

To generate docs for a different set of libs, create your own script based on clojure_gen.clj. Note that any libs that you are documenting will need to be in your classpath, in addition to the dependencies of clj-doc itself.

About

HTML documentation for Clojure libraries.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published