[archiving soon] Provide the `doc` command for the mojito-cli tool to generate API docs.
JavaScript CSS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
tests
.gitignore
.jshintrc
.travis.yml
LICENSE.txt
README.md
config.json
docs.js
package.json

README.md

mojito-cli-doc

Build Status

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.