mojito-cli-doc
v0.0.3
Published
Provide the `doc` command, to generate API docs, for `mojito-cli`
Downloads
117
Readme
mojito-cli-doc
mojito-cli-docs
provides the doc
command for mojito-cli
, that you can install with: npm install -g mojito-cli
.
The doc
command generates, or serves, API documentation for Mojito, Mojito apps,
or mojits.
npm install -g mojito-cli
Usage
To generate documentation for a mojito application, including all the mojits in it's mojits/
subdirectory,
run the following from the application directory:
$ mojito docs app [name]
Optional name
if provided, is used as the sub-directory name to save the generated API docs. See Options below.
To generate documentation for a specific mojit, run the following from the application directory:
$ mojito docs mojit <mojit-name>
To generate documentation for the Mojito framework itself:
$ mojito docs mojito
Options
Specify output directory (if --port
or --server
are not used):
--directory <path>
-d <path>
By default, the generated files are saved in ./artifacts/docs/
, or if a name
argument is provided, ./artifacts/docs/<name>
.
Exclude some files or directories from being processed:
--exclude <pattern>
-e <pattern>
This option can be repeated, for example mojito doc --exclude middleware --exclude build
will exclude files or directories with "middleware" or "build" in their names.
Serve the API docs over HTTP, without rendering them to the file system (assumes --port 3000
):
--server
-s
Serve the API docs over HTTP, like option --server
, using the specified port number:
--port <number>
-p <number>
Discussion/Forums
http://developer.yahoo.com/forum/Yahoo-Mojito
Licensing and Contributions
mojito-cli-doc
is licensed under a BSD license (see LICENSE.txt). To contribute to the Mojito project,
please see Contributing.
The Mojito project is a meritocratic, consensus-based community project, which allows anyone to contribute and gain additional responsibilities.