Grunt task for generating codo documentation.

grunt-codo-codo & grunt-codo has been merged. This package is deprecated, use grunt-codo instead.
Last updated 6 years ago by leny .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install grunt-codo-codo 
SYNC missed versions from official npm registry.


NPM version Dependency Status Downloads counter

Grunt task for generating codo documentation.

Note: I know, the plugin grunt-codo already exists. But it doesn't support multi-tasking (which I need for a project), and don't really fit with the usual practices for Grunt plugin.
As I need a grunt task to generate codo documentation urgently, I prefer to recode my version of grunt-codo, renamed grunt-codo-codo. When the task will be ready, I'll push it on npm and should propose my work to the grunt-codo maintainers, to merge projects.
As for now, I really need reactivity and solutions, so I made it myself.

UPDATE: As grunt-codo-codo & grunt-codo has been merged, this plugin is deprecated. Use grunt-codo instead.

Getting Started

This plugin requires Grunt ~0.4.5

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-codo-codo --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:


The "codo" task


In your project's Gruntfile, add a section named codo to the data object passed into grunt.initConfig().

  codo: {
    options: {
      // Task-specific options go here.
    your_target: {
      // Target-specific file lists and/or options go here.


Codo expect to lookup for coffee files into given folder, and a destination path to generate the documentation.

So, in your target, don't forget to add src and dest properties. The dest property is optional, and is defaulting to "./doc".

Note: as Codo seems to expect folders path instead of files list, if files are given, the task will use their dirname as source.



Type: Boolean
Default value: true

Show stats about the documentation generation.


Type: String
Default value: "coffee"

Coffee files extension.


Type: String (path)
Default value: target.dest, or "./doc"

The documentation destination directory. If this option is given, it will overwrite the target's dest parameter.


Type: String
Default value: theme

The theme to be used.

Type: String
Default value: "Codo"

The project name.


Type: String
Default value: "Documentation"

Documentation HTML Title.


Type: String (path)
Default value: ""

The README file used in documentation.


Type: Boolean
Default value: false

Supress warnings


Type: Boolean
Default value: false

Show parsing errors.


Type: Boolean
Default value: false

List undocumented objects.


Type: Boolean
Default value: false

Try to parse closure-like block comments.


Type: Boolean
Default value: false

Show privates.

Type: String
Default value: false

The Google Analytics ID.


Type: Array of String (path)
Default value: []

Extra files to add to the documentation. Markdown files will be parsed.

Usage Examples

Default Options

In this example, the default options are used to generate the documentation for the coffee files from the src directory into the default ./doc folder.

  codo: {
    src: [

Custom Options

In this example, custom options are used to generate the documentation from api controllers and models into the website/doc/api folder. We also set names and title, include a license file, and ask the task to show us the undocumented objects, but not the stats of the generation.

  codo: {
      name: "AwesomeProject"
      title: "AwesomeProject API Documentation"
      extra: [ "LICENSE-MIT" ]
      undocumented: yes
      stats: no
    src: [
    dest: "website/doc/api"


In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History

  • 2014/07/04 : v0.1.1 - deprecation
  • 2014/06/23 : v0.1.0


  • [ ] Add basic unit tests


Copyright (c) 2014 Leny
Licensed under the MIT license.

Current Tags

  • 0.1.1                                ...           latest (6 years ago)

2 Versions

  • 0.1.1 [deprecated]           ...           6 years ago
  • 0.1.0 [deprecated]           ...           6 years ago
Maintainers (2)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 4
Dependencies (5)
Dev Dependencies (5)
Dependents (0)

Copyright 2014 - 2016 © |