justdoc v1.1.0
justdoc
A doc gen command-line tool and library which dumps block comments in a javascript project to a docs directory of the same structure.
Install
...as a gulp plugin:
$ npm install --save-dev justdoc
...as a command-line tool:
$ npm install -g justdoc
How to Use
justdoc gulp plugin
In your gulpfile
var justdoc = require('justdoc');
gulp.task('doc', function () {
gulp.src('src/**/*.js')
.pipe(justdoc())
.pipe(gulp.dest('docs'));
});
justdoc command-line
$ justdoc
Usage: justdoc [options] <SourcePath> <DestPath>
Options:
-h, --help output usage information
-V, --version output the version number
-e, --ext <Extension> file extension of doc files (default is 'md')
-i, --input <SourcePath> path to source directory (default is current directory)
-o, --output <DestPath> path to generate new docs directory (default is 'docs')
-g, --glob <Glob> provide custom glob (default is '**/*.js')
Use the justdoc
command to generate docs from a source path, and output them to a destination path:
$ justdoc ./src ./docs
justdoc
assumes markdown, but you specify any extension and use whatever doc format you want:
$ justdoc -e txt ./src ./docs
justdoc javscript block comments
justdoc
parses your javascript source files for block comments and pulls out those that start with the equal sign =
:
/*=
## function - getData()
returns the component data
*/
If the comment doesn't start with =
then it won't be included in the doc output.
The first line can also be used to tell justdoc
to ignore the beginning few character of each line. For example, if you want to start evey line with *_
, then specify it after the =
to make sure that justdoc
will ignore it.
/*=*_
*_## function - getData()
*_returns the component data
*/
This pattern will work with any string of characters (even spaces and tabs). Useful for adding padding to your comments without affecting the doc output.