The doc-scripts from janrywang

doc-scripts's Introduction

Features 🦑

🛠 No config
😆 Based on Markdown,Merge and Show all markdown files
👩‍💻 Code Highlighting And JSX Code is Runnable
💯 Emoji Support
🍖 React Props Table Support
✨ Creates Static files (only JS is prism)
🏳️‍🌈 Pretty Pages
🦄 Customizable
🇳🇱 CodeSandbox and iframe Support

Install 🦅

npm install --save doc-scripts

Usage 🌈

1. Node cli

doc-scripts start --input docs

doc-script build --input docs --output doc-site

2. Markdown Usage

examples

3. Javascript api

import {execute} from 'doc-scripts'

const options = {
  title:'xxxx',
  header:'<link rel="stylesheet" href="//xxxxxx">',
  footer:'<script>xxxxx</script>',
  renderer:'./doc-renderer.js',
  requires:[]
}

const webpackConfig = {
  module:{
    rules:[...]
  }
}

execute('start',options,webpackConfig) or execute('build',options,webpackConfig)

4. Webpack extended configuration

Create a new file named doc-scripts.config.js in the root directory. The following is the specific format specification.

module.exports = {
  module: {
    rules: []
  },
  plugins: []
}

//or

module.exports = function(config) {
  return {
    ...config,
    module: {
      rules: []
    },
    plugins: []
  }
}

5. Demo HTML Template extended configuration

Create a new file named doc-scripts.header.html or doc-scripts.footer.html in the root directory. The following is the specific format specification.

<!-- this is doc-scripts.header.html -->
<link rel="stylesheet" href="//unpkg.com/@alifd/next/dist/next.min.css" />

6. Customize Doc Renderer

Create a new file named doc-scripts.renderer.js in the root directory. The following is the specific format specification.

import DocRenderer from 'react-doc-renderer'

//react-doc-renderer default render engien in doc-scripts, so ,you can continue to reuse this component in doc-scripts.renderer.js, or you can completely override its behavior.

export default ({docs = []})=>(
  <div>
    <DocRenderer docs={docs}/>
  </div>
)

Contributors 💪🏻

_Janry 📖 💻 👀 🤔

LICENSE

Doc scripts is open source software licensed as MIT.

doc-scripts's People

Contributors

Stargazers

Watchers

doc-scripts's Issues

多文档组织坑位渲染

可以支持一下 disableHostCheck

new WebpackDevServer(complier, {
        publicPath: '/',
        quiet: true,
        hot: true,
        disableHostCheck: true // add this line
      }).listen(DEFAULT_PORT, HOST, function (err) {
        if (err) {
          return log.error(err);
        }

        openBrowser("http://" + HOST + ":" + DEFAULT_PORT);
      });