@mathieu_andrade/apidoc-markdown
Generate API documentation in markdown from apiDoc data.
Last updated 5 months ago by mathieu_andrade .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @mathieu_andrade/apidoc-markdown 
SYNC missed versions from official npm registry.

ApiDoc-markdown

npm badge

ApiDoc markdown creates a documentation from API descriptions in your source code.

It uses apidoc to convert inline documentation comments into json schema and later convert it to markdown.

Uses the apidoc-core library.

Documentation: apidocjs.com

Installation

$ npm install -g @mathieu_andrade/apidoc-markdown

Usage

Add some apidoc comments anywhere in your source code:

/**
 * @api {get} /user/:id Request User information
 * @apiName GetUser
 * @apiGroup User
 *
 * @apiParam {Number} id User's unique ID.
 *
 * @apiSuccess {String} firstname Firstname of the User.
 * @apiSuccess {String} lastname  Lastname of the User.
 */

Now generate the documentation from src/ into doc/.

$ apidoc-markdown -i src/ -o doc/

Most important cli commands

-f --file-filters <file-filters>         RegEx-Filter to select files that should be parsed (multiple -f can be used). (default: [])
-e, --exclude-filters <exclude-filters>  RegEx-Filter to select files / dirs that should not be parsed (many -e can be used). (default: [])
-i, --input <input>                      Input/source dirname. (default: [])
-o, --output <output>                    Output dirname. (default: "./doc/")
-t, --template <template>                Template to use for output files. Can be a path or a template type available. (default: "default.md")
-d, --data                               Return data files. (default: false)
-c, --config <config>                    Path to directory containing config file (apidoc.json). (default: "./")
-v, --verbose                            Verbose debug output.
--debug                                  Show debug messages.

Available templates can be found in templates directory.

Support

Please create a new issue if you have a suggestion/question or if you found a problem/bug.

Contributing

ApiDoc-markdown is a collaborative project. Pull requests are welcome. Please see the CONTRIBUTING file.

Todo

  • [ ] Improve gitbook template
  • [ ] Write Automated tests
  • [ ] Create a index file with all links of routes
  • [ ] Write a example
  • [ ] One file per route feature

Don't hesitate to suggest any feature you would like by creating an issue or a pull request.

License

The MIT license

Thanks

  • At apiDoc for the awesome apiDoc-core module
  • At rigwild for its huge work on the apiDoc-markdown module

Current Tags

  • 1.0.1                                ...           latest (5 months ago)

2 Versions

  • 1.0.1                                ...           5 months ago
  • 1.0.0                                ...           5 months ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 3
Last Day 0
Last Week 3
Last Month 0
Dependencies (8)
Dev Dependencies (0)
None
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |