Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Leiningen plugin: Autobuilder and simple server for Marginalia documentation.
branch: master

This branch is 7 commits ahead of kyleburton:master


Leiningen Plugin for Marginalia that watches your source directories for changes to your clojure source files and rebuilds the Marginalia documentation whenever you update your source code.


Add to your project.clj:

:plugins [...
           [com.github.tranchis/lein-margauto "1.0.14"]


lein margauto [some/path/dir]

Open uberdoc.html from the path you set up, or from docs/ by default. Refresh as you make changes to see the updates.


    (defproject my-project "1.0.0"
      :margauto {
        :src-dirs    ["src" "test"]
        :sleep-time  1000
        :target-dir  "resources/public"})


By default lein-margauto only searches src/ for files that end in .clj. You can change this behavior by setting :src-dirs to a vector of directories to search.


lein-margauto uses a brute force appraoch to detecting changes in your sources. It performs a recursive search through the :src-dirs rebuilding when it sees a change. :sleep-time controls how long lein-margauto will pause before checking the directory structure again.

The default is 1000 ms (1 second).


The relative path where the uberdoc.html file will be generated.


Copyright (C) 2011 Kyle R. Burton (C) 2013 Sergio Alvarez-Napagao

Distributed under the Eclipse Public License, the same as Clojure.

Something went wrong with that request. Please try again.