schematic

A simple literate-programming documentation tool a la docco.

Requirements

• chicken
• fmt (for ansi output)
• sxml-transforms (for html output)
• colorize (for syntax highlighting)

Install

$ git clone git://bitbucket.com/evhan/schematic.git
$ cd schematic
$ chicken-install

Usage

The schematic command takes some number of input files as arguments and outputs formatted, side-by-side documentation & source code for each.

schematic [option ...] [file ...]

options:
  -h, --help            show this message
  -l, --language        input language name
  -o, --output          output format (html, ansi)
  -f, --formatter       external comment formatting command
  -s, --highlighter     external syntax highlighting command
  -c, --comment-string  comment string format
      --stylesheet      alternative stylesheet (html only)
      --directory       output directory (html only)

Two output modes are available, ansi and html. In ansi mode, concatenated output for all files is written to stdout. In html mode, separate HTML files are written to an output directory, along with a default stylesheet. This is the default behavior.

When specifying input files, a dash represents stdin.

--formatter and --highlighter specify external commands that will be used to process documentation and code, respectively. markdown and highlight might be good choices.

--language specifies the input language. If the language is unrecognized, a line comment prefix string can be given explicitly with the --comment-string argument. For example, for Bash or Ruby, --comment-string "# " would give the intended results.

License

BSD. See LICENSE for details.