naive-ui/demo/loaders/convertMd2Doc.js
songwanli2025@163.com fdf2af8eb5 merge
2020-02-24 16:25:02 +08:00

166 lines
5.5 KiB
JavaScript

const marked = require('marked')
const camelCase = require('lodash/camelCase')
const kababCase = require('lodash/kebabCase')
const mdLoader = require('./NaiveUIMdLoader')
const createRenderer = require('./mdRenderer')
const mdRenderer = createRenderer()
function template (demos, demosLiteral, isSingleColumn = false) {
// return `<component-demos :single-column="${isSingleColumn}">
// ${demos}
// <template v-slot:anchor>
// ${parseDemosAsAnchor(demosLiteral)}
// </template>
// </component-demos>`
return `<component-demos :single-column="${isSingleColumn}">
${demos}
</component-demos>`
}
function parseDemos (demosLiteral, env) {
const demoNames = demosLiteral
.split('\n')
.map(demoName => demoName.trim())
.filter((demoName) => {
if (env === 'production') {
return demoName.length && demoName.indexOf('debug') < 0 && demoName.indexOf('Debug') < 0
}
return demoName.length
})
const demoTags = demoNames.map(demoName => `<${demoName}Demo id="${kababCase(demoName)}" demo-id="${kababCase(demoName)}"/>`)
return demoTags.join('\n')
}
function parseDemosAsAnchor (demosLiteral) {
const demoNames = demosLiteral
.split('\n')
.map(demoName => demoName.trim())
.filter(demoName => demoName.length)
const linkTags = demoNames.map(demoName => `<n-anchor-link :title="anchorLinkMap.get('${kababCase(demoName)}') || ''" href="#${kababCase(demoName)}"/>`)
return `<n-anchor :top="24" :bound="16" position="absolute" affix style="width: 144px;">${linkTags.join('\n')}</n-anchor>`
}
function generateScript (demosLiteral, components = []) {
const demoNames = demosLiteral
.split('\n')
.map(demoName => demoName.trim())
.filter(demoName => demoName.length)
.map(demoName => camelCase(demoName))
components = components.map(component => camelCase(component))
const importStatements = demoNames
.map(demoName => `import ${demoName}Demo from './${demoName}.md'`)
.concat(components.map(component => `import ${component} from './${component}'`))
.join('\n')
const componentStatements = demoNames.map(demoName => demoName + 'Demo').concat(components).join(', ')
const script = `<script>
${importStatements}
export default {
components: {
${componentStatements}
},
provide () {
return {
NDocumentation: this
}
},
data () {
return {
anchorLinkMap: new Map()
}
}
}
</script>`
return script
}
function convertMd2ComponentDocumentation (text, env = 'development') {
const isNoDemo = !!~text.search('<!--no-demo-->')
if (isNoDemo) {
return mdLoader(text)
}
const isSingleColumn = !!~text.search('<!--single-column-->')
const tokens = marked.lexer(text)
const componentsIndex = tokens.findIndex(token => token.type === 'code' && token.lang === 'component')
let components = []
if (~componentsIndex) {
components = tokens[componentsIndex].text
components = components.split('\n').map(component => component.trim()).filter(component => component.length)
tokens.splice(componentsIndex, 1)
}
const demosIndex = tokens.findIndex(token => token.type === 'code' && token.lang === 'demo')
let demos = { text: '' }
let demosLiteral = ''
let headerPart = tokens
let footerPart = []
// console.log(tokens)
if (~demosIndex) {
headerPart = tokens.slice(0, demosIndex)
footerPart = tokens.slice(demosIndex + 1)
demos = tokens[demosIndex]
demosLiteral = demos.text
tokens.splice(demosIndex, 1, {
type: 'html',
pre: false,
text: '<!--demos-->\n'
})
}
headerPart.links = {}
footerPart.links = {}
const documentationHTML = `${marked.parser(headerPart, {
gfm: true,
renderer: mdRenderer
})}\n` + '<!--demos-->\n' + `${marked.parser(footerPart, {
gfm: true,
renderer: mdRenderer
})}\n`
// console.log(documentationHTML)
// const classedDocumentationHTML = addClassToHTML(documentationHTML, 'markdown')
const demosReg = /<!--demos-->/
const demoTags = parseDemos(demosLiteral, env)
const documentationContent = documentationHTML.replace(demosReg, template(demoTags, demosLiteral, isSingleColumn))
// console.log(documentationContent)
const documentationTemplate = `
<template>
<component-documentation>
<div style="display: flex; flex-wrap: nowrap;">
<div style="width: calc(100% - 180px); margin-right: 36px;">
${documentationContent}
</div>
<div style="width: 144px;">
${parseDemosAsAnchor(demosLiteral)}
</div>
</div>
</component-documentation>
</template>`
const documentationScript = generateScript(demosLiteral, components)
// if (components.length) console.log(`${documentationTemplate}\n\n${documentationScript}`)
return `${documentationTemplate}\n\n${documentationScript}`
// console.log(vueComponent)
// return vueComponent
// console.log(marked.parser(tokens))
// const parts = getPartsOfDemo(tokens)
// const mergedParts = mergeParts(parts)
// const vueComponent = genVueComponent(mergedParts)
// console.log(vueComponent)
// return vueComponent
}
// function addClassToHTML (html, className) {
// const classReg = /<[^!/][^>]*>/g
// return html.replace(classReg, (openTag) => {
// return openTag.replace(/>/, ` class="${className}">`)
// })
// }
module.exports = convertMd2ComponentDocumentation
// const startTime = new Date()
// for (let i = 0; i < 100; ++i) {
// const fs = require('fs')
// const md = fs.readFileSync('./marked/component.md').toString()
// console.log(convertMd2ComponentDocumentation(md))
// }
// const endTime = new Date()
// console.log(endTime - startTime)