support docsify init --plugins

README.md

@@ -67,6 +67,11 @@ docsify init <path> [--local false] [--theme vue]
   - Type: string
   - Default: `vue`
   - Description: Choose a theme, defaults to `vue`, other choices are `buble`, `dark` and `pure`.
+- `--plugins` option:
+  - Shorthand: `-p`
+  - Type: boolean
+  - Default: `false`
+  - Description: Provide a list of plugins to insert as `<script>` tags to `index.html`.
 
 ### `serve` command
 
@@ -106,7 +111,6 @@ docsify generate <path> [--sidebar _sidebar.md]
   - Description: Generate sidebar file, defaults to `_sidebar.md`.
 
 ## Contributing
-
 Please see the [Contributing Guidelines](./CONTRIBUTING.md)
 
 ## Contribution

docs/README.md

@@ -52,6 +52,11 @@ docsify init <path> [--local false] [--theme vue]
   * Type: string
   * Default: `vue`
   * Description: Choose a theme, defaults to `vue`, other choices are `buble`, `dark` and `pure`.
+* `--plugins` option:
+  * Shorthand: `-p`
+  * Type: array
+  * Default: `[]`
+  * Description: Provide a list of plugins to insert as `<script>` tags to `index.html`. If a plugin name is provided the script will have a url of `https://cdn.jsdelivr.net/npm/docsify@4/lib/plugins/<plugin_name>`, otherwise provide the url to the plugin. Example: `docsify init docs/ -p search gitalk https://cdn.jsdelivr.net/npm/docsify-copy-code@2`
 
 ### `serve` command
 

lib/cli.js

@@ -41,9 +41,17 @@ require('yargs')
           nargs: 1,
           requiresArg: true,
           type: 'string'
+        },
+        plugins: {
+          alias: 'p',
+          default: false,
+          desc: chalk.gray(y18n.__('init.plugins')),
+          nargs: 0,
+          requiresArg: false,
+          type: 'boolean'
         }
       }),
-    handler: argv => run.init(argv.path, argv.local, argv.theme)
+    handler: argv => run.init(argv.path, argv.local, argv.theme, argv.plugins)
   })
   .command({
     command: 'serve [path]',

lib/commands/init.js

@@ -3,16 +3,18 @@
 const fs = require('fs')
 const cp = require('cp-file').sync
 const chalk = require('chalk')
+const {version} = require('../../package.json')
 const logger = require('../util/logger')
-const {prompt} = require('enquirer')
+const {prompt, MultiSelect} = require('enquirer')
 const {cwd, exists, pkg, pwd, read, resolve} = require('../util')
+const colors = require('ansi-colors')
 
 const replace = function (file, tpl, replace) {
   fs.writeFileSync(file, read(file).replace(tpl, replace), 'utf-8')
 }
 
 // eslint-disable-next-line
-module.exports = function (path = '', local, theme) {
+module.exports = function (path = '', local, theme, plugins) {
   const msg =
     '\n' +
     chalk.green('Initialization succeeded!') +
@@ -38,19 +40,19 @@ module.exports = function (path = '', local, theme) {
           return process.exit(0)
         }
 
-        createFile(cwdPath, local, theme)
+        createFile(cwdPath, local, theme, plugins)
         console.log(msg)
       })
       .catch(console.error)
 
     return false
   }
 
-  createFile(cwdPath, local, theme)
+  createFile(cwdPath, local, theme, plugins)
   console.log(msg)
 }
 
-function createFile(path, local, theme) {
+function createFile(path, local, theme, plugins) {
   const target = file => resolve(path, file)
   const readme = exists(cwd('README.md')) || pwd('template/README.md')
   let main = pwd('template/index.html')
@@ -95,4 +97,45 @@ function createFile(path, local, theme) {
       .replace(/^git\+/g, '')
     replace(target(filename), 'repo: \'\'', `repo: '${repo}'`)
   }
+
+  if (plugins) {
+    const prompt = new MultiSelect({
+      name: 'plugins',
+      message: 'Select plugins to be used',
+      hint: '(Use <space> to select, <return> to submit)',
+      default: '',
+      choices: [
+        {name: 'front-matter', value: 'front-matter'},
+        {name: 'search', value: 'search'},
+        {name: 'disqus', value: 'disqus'},
+        {name: 'emoji', value: 'emoji'},
+        {name: 'external-script', value: 'external-script'},
+        {name: 'ga', value: 'ga'},
+        {name: 'gitalk', value: 'gitalk'},
+        {name: 'matomo', value: 'matomo'},
+        {name: 'zoom-image', value: 'zoom-image'}
+      ],
+      indicator(state, choice) {
+        if (choice.enabled) {
+          return colors.cyan(state.symbols.radio.on)
+        }
+
+        return colors.gray(state.symbols.radio.off)
+      }
+    })
+    prompt.on('cancel', () => replace(target(filename), '\n  _plugins_', ''))
+    prompt.run()
+      .then(answers => {
+        replace(target(filename), '  _plugins_', '_plugin'.repeat(answers.length + 1))
+        let url = ''
+        answers.forEach(plugin => {
+          url = `//cdn.jsdelivr.net/npm/docsify@${version[0]}/lib/plugins/${plugin}.min.js`
+          replace(target(filename), '_plugin', `  <script src="${url}"></script>\n`)
+        })
+        replace(target(filename), '\n_plugin', '')
+      })
+      .catch(console.error)
+  } else {
+    replace(target(filename), '\n  _plugins_', '')
+  }
 }

lib/template/index.html

@@ -18,5 +18,6 @@
   </script>
   <!-- Docsify v4 -->
   <script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
+  _plugins_
 </body>
 </html>

tools/locales/en.json

@@ -6,6 +6,7 @@
   "start": "Server for SSR",
   "init.local": "Copy docsify files to local. To explicitly set --local to false you may use --no-local.",
   "init.theme": "Theme file to be used.",
+  "init.plugins": "A list of plugins to be used.",
   "serve": "Run local server to preview site.",
   "serve.open": "Open docs in default browser. To explicitly set --open to false you may use --no-open.",
   "serve.port": "Listen port.",

tools/locales/zh.json

@@ -6,13 +6,14 @@
   "init": "创建 docs",
   "init.local": "拷贝 docsify 到本地",
   "init.theme": "选择主题",
+  "init.plugins": "选择插件",
   "serve": "本地预览",
   "serve.open": "自动打开浏览器",
   "serve.port": "设置端口",
-  "serve.indexname": "Custom filename instead of index.html to serve by default",
-  "generate": "Docsify的生成器",
+  "serve.indexname": "自定义入口文件名，代替默认的 index.html",
+  "generate": "docsify 的生成器",
   "generate.sidebar": "生成侧边栏文件",
-  "livereload.port": "设置livereload端口",
+  "livereload.port": "设置 livereload 端口",
   "usage": "例子",
   "version": "当前版本号"
 }