Markdox is a structured documentation generator based on Dox, Markdown and EJS with support for JavaScript, CoffeeScript and Iced CoffeeScript. This plugin is a gulp wrapper for it.
First, install gulp-markdox as a development dependency:
npm install --save-dev gulp-markdoxThen, add it to your gulpfile.js:
var markdox = require("gulp-markdox");
gulp.task("doc", function(){
gulp.src("./src/*.js")
.pipe(markdox())
.pipe(gulp.dest("./doc"));
});It can take on .coffee and .iced files, too.
If you want to concatenate all your generated documentation files, use concat option.
All parsed docfiles will be passed to template at once:
var markdox = require("gulp-markdox");
gulp.task("doc", function(){
gulp.src("./src/*.js")
.pipe(markdox({ concat: "doc.md" })
.pipe(gulp.dest("./doc"));
});Following example does the same in more fine-grained manner:
var markdox = require("gulp-markdox");
gulp.task("doc", function(){
gulp.src("./src/*.js")
.pipe(markdox.parse())
.pipe(markdox.format())
.pipe(markdox.render({ concat: "doc.md" }))
.pipe(gulp.dest("./doc"));
});Please refer to markdox's documentation for further documentation of these options.x'.
Generates markdox documentation from source code in the input.
Type: Function
Custom compiler (user in parse phase).
Type: String
Default: utf-8
Encoding of templates and files to parse (used in parse phase).
Type: Function
Custom formatter (used in format phase).
Type: String
File name for concatenated docfile.
Type: String
Path or the custom template (used in render phase).
Input: commented source code in file contents.
Output: raw document object generated from comments assigned to javadoc property.
Input: raw document object generated from comments assigned to javadoc property.
Output: formatted document object assigned to formattedDoc property.
Input: formatted document object assigned to formattedDoc property.
Output: rendered documentation in file contents.
Copyright © 2016 Maciej Chałapuk. Released under MIT License.