js-api-document-creator v1.0.0

js-api-doc-creator

A simple webpack plugin for build docs which descript the apis.

It is helpful for projects to support batch-creating js api docs.

webpack 插件, 用于把批量注释生成markdown文档。

plugin

plugin link

test demo script

test script

    npm run create
    npm run create-en

plugin options

how to use

Below code is the example

build script

js-demo

/**
 * test demo function1
 * @param {*} a:param a @type: Boolean  @default:true  @version: 1.0
 * @param {*} v:param v @type: String  @default: 'x'
 */
function Application(a, v) {
    console.log(a, v)
}

webpack-config

{
    mode: 'production',
    devtool: 'eval',
    entry: path.resolve(__dirname, '../test/demo.js'),
    output: {
        path: path.resolve(__dirname, '../dist'),
        filename: 'bundle.js'
    },
    plugins: [
      new JsApiCreatorPlugin({
        output: '.doc_en-us/doc.md',
        vars: {
            'type': 'Data Type',
            'default': 'Data Default Value',
            'version': 'Version Of Params',
        },
        lang: 'en-us'
      })
    ]
}

output

dist

Application

Function Description：

  test demo function1

Param Description：