update: versioning

Author: Koooooo-7

e2e/cli.test.js.snap

@@ -5,6 +5,8 @@ const run = require('../lib')
 
 const Locales = require('../tools/locales')
 const y18n = new Locales()
+// Default use the version same to cli
+const docsifyDefaultResourceVersion = pkg.version
 
 require('yargonaut')
   .style('yellow', 'required')
@@ -30,6 +32,15 @@ require('yargs')
           requiresArg: false,
           type: 'boolean'
         },
+        docsifyVersion: {
+          alias: 'ver',
+          default: `${docsifyDefaultResourceVersion}`,
+          desc: chalk.gray(y18n.__('init.version')),
+          choices: [`${docsifyDefaultResourceVersion}`, 'rc'],
+          nargs: 1,
+          requiresArg: true,
+          type: 'string'
+        },
         theme: {
           alias: 't',
           default: 'vue',
@@ -48,7 +59,7 @@ require('yargs')
           type: 'boolean'
         }
       }),
-    handler: argv => run.init(argv.path, argv.local, argv.theme, argv.plugins)
+    handler: argv => run.init(argv.path, argv.local, argv.docsifyVersion, argv.theme, argv.plugins)
   })
   .command({
     command: 'serve [path]',

lib/cli.js

@@ -3,22 +3,24 @@
 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, MultiSelect} = require('enquirer')
 const {cwd, exists, pkg, pwd, read, resolve} = require('../util')
 const colors = require('ansi-colors')
-const semver = require('semver')
 
 const replace = function (file, tpl, replace) {
   fs.writeFileSync(file, read(file).replace(tpl, replace), 'utf-8')
 }
 
+const replaceAll = function (file, tpl, replace) {
+  fs.writeFileSync(file, read(file).replaceAll(tpl, replace), 'utf-8')
+}
+
 // eslint-disable-next-line
-module.exports = async function (path = '', local, theme, plugins) {
+module.exports = async function (path = '', local, docsifyVersion, theme, plugins) {
   const msg =
     '\n' +
-    chalk.green('Initialization succeeded!') +
+    chalk.green(`Initialization succeeded (${docsifyVersion})!`) +
     ' Please run ' +
     chalk.inverse(`docsify serve ${path}`) +
     '\n'
@@ -48,11 +50,11 @@ module.exports = async function (path = '', local, theme, plugins) {
     }
   }
 
-  await createFile(cwdPath, local, theme, plugins)
+  await createFile(cwdPath, local, docsifyVersion, theme, plugins)
   console.log(msg)
 }
 
-async function createFile(path, local, theme, plugins) {
+async function createFile(path, local, docsifyVersion, theme, plugins) {
   const target = file => resolve(path, file)
   const readme = exists(cwd('README.md')) || pwd('template/README.md')
   let main = pwd('template/index.html')
@@ -97,6 +99,9 @@ async function createFile(path, local, theme, plugins) {
     replace(target(filename), 'repo: \'\'', `repo: '${repo}'`)
   }
 
+  const resourceVersion = docsifyVersion
+  replaceAll(target(filename), '__docsifyVersion__', `${resourceVersion}`)
+
   // Return early if not opted for plugins
   if (!plugins) {
     return replace(target(filename), '\n  _plugins_', '')
@@ -147,11 +152,8 @@ async function createFile(path, local, theme, plugins) {
 
   replace(target(filename), '  _plugins_', '_plugin'.repeat(answers.length + 1))
 
-  const {prerelease = [], major} = semver.parse(version) || {}
-  const pluginVersion = prerelease.length ? prerelease[0] : String(major)
-
   answers.forEach(plugin => {
-    const url = `//cdn.jsdelivr.net/npm/docsify@${pluginVersion}/dist/plugins/${plugin}.min.js`
+    const url = `//cdn.jsdelivr.net/npm/docsify@${resourceVersion}/dist/plugins/${plugin}.min.js`
     replace(target(filename), '_plugin', `  <script src="${url}"></script>\n`)
   })
 

lib/commands/init.js

@@ -5,8 +5,8 @@
   <title>Document</title>
   <meta name="description" content="Description">
   <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
-  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@rc/dist/themes/core.min.css">
-  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@rc/dist/themes/addons/vue.min.css">
+  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@__docsifyVersion__/dist/themes/core.min.css">
+  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@__docsifyVersion__/dist/themes/addons/vue.min.css">
 </head>
 <body>
   <div id="app"></div>
@@ -16,8 +16,8 @@
       repo: ''
     }
   </script>
-  <!-- Docsify rc -->
-  <script src="//cdn.jsdelivr.net/npm/docsify@rc"></script>
+  <!-- Docsify resource -->
+  <script src="//cdn.jsdelivr.net/npm/docsify@__docsifyVersion__"></script>
   _plugins_
 </body>
 </html>

lib/template/index.html

@@ -4,6 +4,7 @@
   "help": "Zeige Hilfe an",
   "init": "Erzeuge neue Dokumentation.",
   "init.local": "Kopiere docsify Dateien in lokale Ordner. Um explizit --local auf false zu setzen, kannst du --no-local verwenden.",
+  "init.version": "Wählen Sie die docsify-Version aus; standardmäßig wird die neueste Version verwendet.",
   "init.theme": "Zu verwendende Theme Dateien.",
   "serve": "Lasse lokalen Server zur Webseitenvorschau laufen.",
   "serve.open": "Dokumentation im Standardbrowser öffnen. Um explizit --open auf false zu setzen, kannst du --no-open verwenden.",

tools/locales/de.json

@@ -4,6 +4,7 @@
   "help": "Show help",
   "init": "Creates new docs",
   "init.local": "Copy docsify files to local. To explicitly set --local to false you may use --no-local.",
+  "init.version": "Select docsify version, default is latest.",
   "init.theme": "Theme file to be used.",
   "init.plugins": "A list of plugins to be used.",
   "serve": "Run local server to preview site.",

tools/locales/en.json

@@ -4,6 +4,7 @@
   "help": "帮助",
   "init": "创建 docs",
   "init.local": "拷贝 docsify 到本地",
+  "init.version": "选择 docsify 版本，默认使用最新版本",
   "init.theme": "选择主题",
   "init.plugins": "选择插件",
   "serve": "本地预览",