Gulp-raml2html NPM

gulp-raml2html is back in the game. But you can still help us by submitting PRs on develop branch. Thanks in advance!`

gulp-raml2html

A simple gulp plugin to automate the process of generating HTML documentation based on a RAML API.

If you have any difficulties with the output of this plugin, please use the raml2html tracker.

Note: This plugin wraps raml2html.

Install

npm

npm install gulp-raml2html --save-dev

Usage

gulp basis

Gulp is a build life-cycle tool. You can configure several tasks to be ran when entering gulp [taskname] in your console ('default' task is invoked if not specified). It can also be invoked by Continuous Integration tools. To be able to use it, your application must have a gulpfile.js with the possible tasks configured.

A typical gulpfile.js will start with:

var gulp = require('gulp');
var raml2html = require('gulp-raml2html');

Add HTML generation task

// your existing tasks
gulp.task('apidoc', function() {
  return gulp.src('api.raml')
    .pipe(raml2html())
    .pipe(gulp.dest('build'));
});
// more tasks