Add generators

Author: sy-records

lib/cli.js

@@ -109,6 +109,23 @@ require('yargs')
       }),
     handler: argv => run.start(argv.path, argv.config, argv.port)
   })
+  .command({
+    command: 'gen <path>',
+    aliases: 't',
+    desc: chalk.gray(y18n.__('gen')),
+    builder: yargs =>
+      yargs.options({
+        sidebar: {
+          alias: 's',
+          default: '_sidebar.md',
+          desc: chalk.gray(y18n.__('gen.sidebar')),
+          nargs: 1,
+          requiresArg: true,
+          type: 'string'
+        }
+      }),
+    handler: argv => run.gen(argv.path, argv.sidebar)
+  })
   .help()
   .option('help', {
     alias: 'h',

lib/commands/gen.js

@@ -0,0 +1,56 @@
+'use strict'
+
+const fs = require('fs')
+const {cwd, exists} = require('../util')
+const chalk = require('chalk')
+const path = require('path')
+
+// eslint-disable-next-line
+module.exports = function (path = '', sidebar) {
+  const cwdPath = cwd(path || '.')
+
+  if (exists(cwdPath)) {
+    if (sidebar) {
+      console.log(sidebar)
+      const sidebarPath = cwdPath + '/' + sidebar || '_sidebar.md'
+
+      if (!exists(sidebarPath)) {
+        genSidebar(cwdPath, sidebarPath)
+        return true
+      }
+
+      console.log(chalk.red(`${sidebarPath}`) + ' already exists.')
+      return false
+    }
+  }
+
+  console.log(chalk.red(`${cwdPath}`) + ' directory does not exist.')
+}
+
+function genSidebar(cwdPath, sidebarPath) {
+  let node = ''
+  travel(cwdPath, function (pathname) {
+    path.relative(pathname, cwdPath)
+    pathname = pathname.replace(cwdPath + '/', '')
+    node += '* [' + path.basename(pathname, '.md') + '](' + pathname + ')\n'
+  })
+  fs.writeFile(sidebarPath, node, 'utf8', err => {
+    if (err) {
+      throw err
+    }
+
+    console.log('gen success')
+  })
+}
+
+function travel(dir, callback) {
+  fs.readdirSync(dir).forEach(function (file) {
+    let pathname = path.join(dir, file)
+
+    if (fs.statSync(pathname).isDirectory()) {
+      travel(pathname, callback)
+    } else if (path.extname(file) === '.md') {
+      callback(pathname)
+    }
+  })
+}

lib/index.js

@@ -1,5 +1,6 @@
 module.exports = {
   init: require('./commands/init'),
   serve: require('./commands/serve'),
-  start: require('./commands/start')
+  start: require('./commands/start'),
+  gen: require('./commands/gen')
 }

tools/locales/en.json

@@ -10,6 +10,8 @@
   "serve.open": "Open docs in default browser. To explicitly set --open to false you may use --no-open.",
   "serve.port": "Listen port.",
   "serve.indexname": "Custom filename instead of index.html to serve by default",
+  "gen": "Docsify's generators",
+  "gen.sidebar": "Generate sidebar file",
   "livereload.port": "livereload Listen port.",
   "usage": "Usage",
   "version": "Show version number"

tools/locales/zh.json

@@ -10,6 +10,8 @@
   "serve.open": "自动打开浏览器",
   "serve.port": "设置端口",
   "serve.indexname": "Custom filename instead of index.html to serve by default",
+  "gen": "Docsify的生成器",
+  "gen.sidebar": "生成侧边栏文件",
   "livereload.port": "设置livereload端口",
   "usage": "例子",
   "version": "当前版本号"