express-aglio

1.1.0 • Public • Published

express-aglio

easily use aglio with express to serve documentation for your api.

Don't know what aglio is? its an awesome commandline tool/node library tool for writing and compiling docs written in the Api Blueprint Language (APIB), which is really similar to markdown. It makes doc writing a breeze.

install


npm install --save express-aglio

features

  • watch fs and recompile changes with node-watch
  • automatically serve docs with express.static() (default uri is /docs)
  • save time by devving express app and docs at the same time from same server. easy peasy lemon squeezy.

usage

var app = require('express')();
 
require('express-aglio')(app,{
    source: __dirname+ '/docs/source/index.apib',
    output: __dirname+ '/docs/html/index.html'
});
 
app.listen(3000);

options

{
source: '',//input path/file eg /docs/source/index.apib OR /docs/source
output: '',//output path/file eg /docs/html/index.html OR /docs/html
watch: true, //watch source dir/file for changes.
expose: true, //serve docs with express
uri: '/docs', //path to serve docs from
debug: true, // disable the default logger
log: function(){ // a simple logger, you can override
    this.debug && console.log.apply(console,arguments);
},
aglioOptions:{}, //options to pass specifically to aglio(themes, etc checkout aglio npm module's api for more info)
}

testing

(soon-ish)

Package Sidebar

Install

npm i express-aglio

Weekly Downloads

4

Version

1.1.0

License

MIT

Unpacked Size

29.5 kB

Total Files

7

Last publish

Collaborators

  • gmorris_89