mirror of https://github.com/seald/nedb
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
43 lines
1.5 KiB
43 lines
1.5 KiB
'use strict'
|
|
const jsdoc2md = require('jsdoc-to-markdown')
|
|
const fs = require('fs')
|
|
const path = require('path')
|
|
|
|
const jsdocConf = './jsdoc.conf.js'
|
|
|
|
/* output path */
|
|
const outputDir = './docs'
|
|
|
|
const getJsdocDataOptions = {
|
|
/* same inpout path as jsdoc */
|
|
files: require(jsdocConf).source.include,
|
|
configure: './jsdoc.conf.js',
|
|
'no-cache': true
|
|
}
|
|
|
|
fs.rmdirSync(outputDir, { recursive: true }) // clean docs dir
|
|
fs.mkdirSync(outputDir) // make docs dir
|
|
|
|
/* get template data */
|
|
const templateData = jsdoc2md.getTemplateDataSync(getJsdocDataOptions)
|
|
|
|
/* reduce templateData to an array of class names */
|
|
const classNames = templateData.filter(({kind}) => kind === 'class').map(({name}) => name)
|
|
|
|
const moduleNames = templateData.filter(({kind}) => kind === 'module').map(({name}) => name)
|
|
|
|
/* create a documentation file for each class */
|
|
for (const className of classNames) {
|
|
const template = `{{#class name="${className}"}}{{>docs}}{{/class}}`
|
|
console.log(`rendering ${className}, template: ${template}`)
|
|
const output = jsdoc2md.renderSync({ data: templateData, template: template })
|
|
fs.writeFileSync(path.resolve(outputDir, `${className}.md`), output)
|
|
}
|
|
|
|
/* create a documentation file for each module */
|
|
for (const moduleName of moduleNames) {
|
|
const template = `{{#module name="${moduleName}"}}{{>docs}}{{/module}}`
|
|
console.log(`rendering ${moduleName}, template: ${template}`)
|
|
const output = jsdoc2md.renderSync({ data: templateData, template: template })
|
|
fs.writeFileSync(path.resolve(outputDir, `${moduleName}.md`), output)
|
|
}
|
|
|