raml2html 安装,GitHub - walling/gulp-raml2html: A simple RAML to HTML documentation generator, wrapped...

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

Run

gulp apidoc will grab api.raml and generate a build folder with the generated HTML on it.

Example

Included in this repository. Click here to go to the "example" folder

API

supportJsonInput

Type: boolean

Default value: false

When set to true it also takes JSON files as input (generated by the RAML parser).

https

Type: boolean

Default value: false

When set to true the raml2html generator will output links to the all assets over https protocol.

License

The code for gulp-raml2html is licensed under the MIT license. See license.txt file for more info.