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: 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://unpkg.com/docsify/lib/plugins/<plugin_name>`, otherwise provide the url to the plugin. Example: `docsify init docs/ -p search gitalk https://unpkg.com/docsify-copy-code@2`
 
 ### `serve` command
 
@@ -88,9 +93,7 @@ docsify serve <path> [--open false] [--port 3000]
   - Type: number
   - Default: `3000`
   - Description: Choose a listen port, defaults to `3000`.
-
 ## Contributing
-
 Please see the [Contributing Guidelines](./CONTRIBUTING.md)
 
 ## Contribution
@@ -99,4 +102,4 @@ Please see the [Contributing Guidelines](./CONTRIBUTING.md)
 
 ## License
 
-[MIT](./LICENSE)
+[MIT](./LICENSE)

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://unpkg.com/docsify/lib/plugins/<plugin_name>`, otherwise provide the url to the plugin. Example: `docsify init docs/ -p search gitalk https://unpkg.com/docsify-copy-code@2`
 
 ### `serve` command
 

e2e/index.js

@@ -4,20 +4,22 @@ const path = require('path')
 const execa = require('execa')
 const test = require('ava')
 
-const rootCommand = path.join(process.cwd(), 'bin/docsify')
+let rootCommand = path.join(process.cwd(), 'bin/docsify')
 
 test('shows up help message without any args', async t => {
   const {stderr} = await execa(rootCommand, {reject: false})
   t.snapshot(stderr)
 })
 
 const matchSnapshot = async (t, arg) => {
-  const {stdout} = await execa(rootCommand, [arg])
+  const args = (typeof arg) === 'object' ? arg : [arg]
+  const {stdout} = await execa(rootCommand, args)
   t.snapshot(stdout)
 }
 
 test('shows help with -h flag', matchSnapshot, '-h')
 test('shows help with --help flag', matchSnapshot, '--help')
+test('shows help with init --help flag', matchSnapshot, ['init', '--help'])
 test('shows version information with -v flag', matchSnapshot, '-v')
 test('shows version information with --version flag', matchSnapshot, '--version')
 

e2e/index.js.md

@@ -4,7 +4,7 @@ The actual snapshot is saved in `index.js.snap`.
 
 Generated by [AVA](https://ava.li).
 
-## shows help with --help flag
+## rejects promise due to error on passing in an unknown command
 
 > Snapshot 1
 
@@ -24,9 +24,11 @@ Generated by [AVA](https://ava.li).
       https://docsifyjs.github.io/docsify-cli␊
     ␊
     Development:␊
-      https://github.com/docsifyjs/docsify-cli/blob/master/CONTRIBUTING.md`
+      https://github.com/docsifyjs/docsify-cli/blob/master/CONTRIBUTING.md␊
+    ␊
+    Unknown argument: junkcmd`
 
-## shows help with -h flag
+## shows help with --help flag
 
 > Snapshot 1
 
@@ -48,7 +50,7 @@ Generated by [AVA](https://ava.li).
     Development:␊
       https://github.com/docsifyjs/docsify-cli/blob/master/CONTRIBUTING.md`
 
-## shows up help message without any args
+## shows help with -h flag
 
 > Snapshot 1
 
@@ -68,29 +70,28 @@ Generated by [AVA](https://ava.li).
       https://docsifyjs.github.io/docsify-cli␊
     ␊
     Development:␊
-      https://github.com/docsifyjs/docsify-cli/blob/master/CONTRIBUTING.md␊
-    ␊
-    [ERROR] 0 arguments passed. Please specify a command`
-
-## shows version information with --version flag
-
-> Snapshot 1
-
-    `␊
-    docsify-cli version:␊
-      4.4.0␊
-    `
+      https://github.com/docsifyjs/docsify-cli/blob/master/CONTRIBUTING.md`
 
-## shows version information with -v flag
+## shows help with init --help flag
 
 > Snapshot 1
 
-    `␊
-    docsify-cli version:␊
-      4.4.0␊
-    `
+    `docsify init [path]␊
+    ␊
+    Creates new docs␊
+    ␊
+    Global Options␊
+      --help, -h     Show help                                             [boolean]␊
+      --version, -v  Show version number                                   [boolean]␊
+    ␊
+    Options:␊
+      --local, -l    Copy docsify files to local. To explicitly set --local to false␊
+                     you may use --no-local.              [boolean] [default: false]␊
+      --theme, -t    Theme file to be used.␊
+                 [string] [choices: "vue", "buble", "dark", "pure"] [default: "vue"]␊
+      --plugins, -p  A list of plugins to be used.                           [array]`
 
-## rejects promise due to error on passing in an unknown command
+## shows up help message without any args
 
 > Snapshot 1
 
@@ -112,4 +113,22 @@ Generated by [AVA](https://ava.li).
     Development:␊
       https://github.com/docsifyjs/docsify-cli/blob/master/CONTRIBUTING.md␊
     ␊
-    Unknown argument: junkcmd`
+    [ERROR] 0 arguments passed. Please specify a command`
+
+## shows version information with --version flag
+
+> Snapshot 1
+
+    `␊
+    docsify-cli version:␊
+      4.4.1␊
+    `
+
+## shows version information with -v flag
+
+> Snapshot 1
+
+    `␊
+    docsify-cli version:␊
+      4.4.1␊
+    `

lib/cli.js

@@ -41,9 +41,14 @@ require('yargs')
           nargs: 1,
           requiresArg: true,
           type: 'string'
+        },
+        plugins: {
+          alias: 'p',
+          desc: chalk.gray(y18n.__('init.plugins')),
+          type: 'array'
         }
       }),
-    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,14 +3,15 @@
 const fs = require('fs')
 const cp = require('cp-file').sync
 const chalk = require('chalk')
+const {version} = require('../../package.json')
 const {cwd, exists, pkg, pwd, read, resolve} = require('../util')
 
 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!') +
@@ -64,5 +65,17 @@ module.exports = function (path = '', local, theme) {
     replace(target(filename), 'repo: \'\'', `repo: '${repo}'`)
   }
 
+  if (plugins) {
+    replace(target(filename), '_plugins_', '_plugin\n  '.repeat(plugins.length))
+    plugins.forEach(plugin => {
+      const major = version[0]
+      const url = plugin.includes('//') ? plugin : `https://cdn.jsdelivr.net/npm/docsify@${major}/lib/plugins/${plugin}.min.js`
+      const scriptTemplate = `<script src="${url}"></script>`
+      replace(target(filename), '_plugin', scriptTemplate)
+    })
+  } else {
+    replace(target(filename), '_plugins_', '')
+  }
+
   console.log(msg)
 }

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.",