calliope
Command line interface for kalamoi/papyr documentation in JS projects.
Last updated 8 years ago by killdream .
MIT · Repository · Original npm · Tarball · package.json
$ cnpm install calliope 
SYNC missed versions from official npm registry.

Calliope

Calliope is a documentation toolkit for JavaScript projects. It uses meta-information available in package.json files and provides a nice and easy-to-use interface for the more generic tools: [kalamoi][] and [papyr][].

Getting Started

  1. Document your files using [kalamoi][]'s documentation format:
/// Module my-project
// A description for this module goes here.

//// Function identity
// This function is part of the module (note the number of comment
// characters).
// :: a -> a
function identity(a){ return a }

//// -- This is a logical group
///// Function foo
// This function belongs to this logical group.
function foo(){ }
  1. Provide information on where to find your files:

    You probably have a package.json file in your project already, Calliope will use the information there, you just need to specify which files should be analysed for extracting documentation:

{ "name": "my-project"
, "version": "1.0.0-snapshot"
, "calliope": {
    "packages": [
      { "parent": "my-project"
      , "files": [ "./lib/*.js" ]
      }]
    }
}

parent is the name of the "main" module that all other modules in a folder are a part of. If you don't use a "package-like" structure (all your modules are flat), you don't need it.

  1. Run the build step to generate your docs:
$ calliope build
  1. Check your documentation on build-docs/index.html.

Installation

One-command easy-install from NPM:

$ npm install -g calliope

Licence

MIT/X11. ie.: do whatever you want with it.

Current Tags

  • 0.1.0                                ...           latest (8 years ago)

1 Versions

  • 0.1.0                                ...           8 years ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 2
Last Day 0
Last Week 1
Last Month 0
Dependencies (6)
Dev Dependencies (0)
None
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |