doxme/test/travis.md

create markdown docs for dox output

# doxme

[![build status](https://secure.travis-ci.org/tmcw/doxme.png)](http://travis-ci.org/tmcw/doxme)

create markdown docs for dox output


### `doxme(dox, readme, package, travis)`

A Markdown formatter for dox. Takes dox's JSON output as stdinand writes Markdown to stdout.
Generates API documentation as well as entire READMEs (like this one!)
README generation supports Travis-CI badges

CLI Usage
dox -r < index.js | doxme
The doxme bin supports one important option: --readme. Whenprovided, it generates a full README.md file, including title,description, installation and test instructions, and aTravis-CI badge if the project is testedwith travis.dox -r < index.js | doxme --readme > README.md
See Also

gulp-doxme runs doxme within aGulp pipeline



### Parameters

| parameter | type    | description                                      |
| --------- | ------- | ------------------------------------------------ |
| `dox`     | Object  | the output of dox as a parsed JSON object        |
| `readme`  | boolean | whether to output a readme or just docs          |
| `package` | Object  | a parsed package.json                            |
| `travis`  | boolean | whether to output a travis badge along with docs |


### Example

```js
var fs = require('fs');
var dox = require('dox');
var doxme = require('doxme');

var sourceCode = fs.readFileSync('./index.js', 'utf8');
var documentation = doxme(dox.parseComments(sourceCode));
```


**Returns** `String`, documentation

## Installation

Requires [nodejs](http://nodejs.org/).

```sh
$ npm install doxme
```

## Tests

```sh
$ npm test
```