This package has been deprecated

Author message:

This package has been replaced by the raml2html-slate-theme for raml2html. Thanks for your usage and see you there

raml2slate

0.0.7 • Public • Published

raml2slate NPM version Build Status Dependency Status

Render the RAML API spec in the slate documentation layout

This package is meant to render nice looking documentation for your REST API, based on a RAML file. It is inspired by slate and raml2html.

The package is usable, but the API and templates might still change based upon feedback.

As of v0.0.6 only RAML 1.0 specificiations are supported.

Example

Installation

$ npm install --save raml2slate

Usage

In javascript:

var raml2slate = require('raml2slate');
 
raml2slate.render({
  input: 'path/to/raml/file',
  output: 'path/to/output/directory',
  theme: 'path/to/optional/theme/file',
  logo: 'path/to/optional/png/logo'
});

On the command line:

raml2slate \
-i 'path/to/raml/file' \
-o 'path/to/output/directory' \
-t 'path/to/optional/theme/file' \
-l 'path/to/optional/png/logo'

You can generate a theme file to tweak using:

raml2slate --generate-theme > theme.styl

TODO

  • Add schema definitions to the template
  • Convert render-markdown.js into a metalsmith plugin
  • Investigate making this fully compatible with raml2html

License

Apache-2.0 © Wouter Dullaert

Package Sidebar

Install

npm i raml2slate

Weekly Downloads

3

Version

0.0.7

License

Apache-2.0

Last publish

Collaborators

  • wdullaer