chore: add changelog 4.5.2

[build] 4.5.2
feat: github task lists, close #215 (#305 )
2026-08-09 21:36:10 +10:00 · 2017-11-09 13:06:59 +08:00 · 2017-11-09 13:06:57 +08:00 · 2017-11-09 13:06:23 +08:00 · 2017-11-07 20:03:42 +08:00 · 2017-11-07 20:03:41 +08:00
37 changed files with 633 additions and 507 deletions
@@ -1,3 +1,59 @@
+<a name="4.5.2"></a>
+## [4.5.2](https://github.com/QingWei-Li/docsify/compare/v4.5.1...v4.5.2) (2017-11-09)
+
+
+### Features
+
+* github task lists, close [#215](https://github.com/QingWei-Li/docsify/issues/215) ([#305](https://github.com/QingWei-Li/docsify/issues/305)) ([d486eef](https://github.com/QingWei-Li/docsify/commit/d486eef))
+
+
+
+<a name="4.5.1"></a>
+## [4.5.1](https://github.com/QingWei-Li/docsify/compare/v4.5.0...v4.5.1) (2017-11-07)
+
+
+### Features
+
+* fetch files with the query params, fixed [#303](https://github.com/QingWei-Li/docsify/issues/303) ([2a2ed96](https://github.com/QingWei-Li/docsify/commit/2a2ed96))
+
+
+
+<a name="4.5.0"></a>
+# [4.5.0](https://github.com/QingWei-Li/docsify/compare/v4.4.1...v4.5.0) (2017-11-04)
+
+
+### Features
+
+* add disqus plugin, closed [#123](https://github.com/QingWei-Li/docsify/issues/123) ([fd7d4e0](https://github.com/QingWei-Li/docsify/commit/fd7d4e0))
+
+
+
+<a name="4.4.1"></a>
+## [4.4.1](https://github.com/QingWei-Li/docsify/compare/v4.4.0...v4.4.1) (2017-10-31)
+
+
+### Bug Fixes
+
+* {docsify-ignore-all} and {docsify-ignore} bug ([#299](https://github.com/QingWei-Li/docsify/issues/299)) ([cc98f56](https://github.com/QingWei-Li/docsify/commit/cc98f56))
+* zoom image plugin issue, fixed [#187](https://github.com/QingWei-Li/docsify/issues/187) ([#300](https://github.com/QingWei-Li/docsify/issues/300)) ([fa772cf](https://github.com/QingWei-Li/docsify/commit/fa772cf))
+
+
+
+<a name="4.4.0"></a>
+# [4.4.0](https://github.com/QingWei-Li/docsify/compare/v4.3.15...v4.4.0) (2017-10-30)
+
+
+### Bug Fixes
+
+* sidebar style issue on firefox, fixed [#184](https://github.com/QingWei-Li/docsify/issues/184) ([#297](https://github.com/QingWei-Li/docsify/issues/297)) ([36bfc9d](https://github.com/QingWei-Li/docsify/commit/36bfc9d))
+
+
+### Features
+
+* add helper for disabled link, fixed [#295](https://github.com/QingWei-Li/docsify/issues/295) ([#296](https://github.com/QingWei-Li/docsify/issues/296)) ([4ad96f3](https://github.com/QingWei-Li/docsify/commit/4ad96f3))
+
+
+
 <a name="4.3.15"></a>
 ## [4.3.15](https://github.com/QingWei-Li/docsify/compare/v4.3.14...v4.3.15) (2017-10-20)

@@ -46,6 +46,7 @@ Create an `index.html`.
 <html>
 <head>
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
  <meta charset="UTF-8">
  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/vue.css">
 </head>
@@ -83,6 +84,9 @@ These projects are using docsify to generate their sites. Pull requests welcome
 | [xTeko](https://docs.xteko.com/) | Addins framework for Pin 3.0 |
 | [vue2-datatable-component](https://github.com/OneWayTech/vue2-datatable) | The best Datatable for Vue.js 2.x which never sucks |
 | [Solidarity](https://infinitered.github.io/solidarity/) | Environment enforcer for your projects across machines. |
+| [rnback](https://rnback.com/) | Backend service for react-native applications. |
+| [IT-films](https://greybax.github.com/IT-films/) | A curated list of awesome movies, documentaries and TV series about hackers, geeks and IT in common, sorted by IMDB rating. |
+| [zooming](http://desmonding.me/zooming/docs) | Image zoom that makes sense. |

 ## Similar projects

@@ -48,7 +48,8 @@ var plugins = [
  { name: 'external-script', entry: 'external-script.js' },
  { name: 'front-matter', entry: 'front-matter/index.js' },
  { name: 'zoom-image', entry: 'zoom-image.js' },
-  { name: 'codesponsor', entry: 'codesponsor.js' }
+  { name: 'codesponsor', entry: 'codesponsor.js' },
+  { name: 'disqus', entry: 'disqus.js' }
 ]

 plugins.forEach(item => {
@@ -4,7 +4,7 @@
  <meta charset="UTF-8">
  <title>docsify</title>
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
-  <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
  <link rel="stylesheet" href="/themes/vue.css" title="vue">
  <link rel="stylesheet" href="/themes/dark.css" title="dark" disabled>
  <link rel="stylesheet" href="/themes/buble.css" title="buble" disabled>
@@ -16,38 +16,38 @@
 </head>
 <body>
  <div id="app"></div>
+  <script>
+    window.$docsify = {
+      alias: {
+        '.*?/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG',
+        '/.*/_navbar.md': '/_navbar.md'
+      },
+      auto2top: true,
+      basePath: '/docs/',
+      executeScript: true,
+      loadNavbar: true,
+      loadSidebar: true,
+      coverpage: true,
+      name: 'docsify',
+      subMaxLevel: 2,
+      mergeNavbar: true,
+      formatUpdated: '{MM}/{DD} {HH}:{mm}',
+      plugins: [
+        function(hook, vm) {
+          hook.beforeEach(function (html) {
+            var url = 'https://github.com/QingWei-Li/docsify/blob/master/' + vm.route.file
+            var editHtml = '[:memo: Edit Document](' + url + ')\n'
+  
+            return editHtml
+              + html
+              + '\n----\n'
+              + 'Last modified {docsify-updated} '
+              + editHtml
+          })
+        }
+      ]
+    }
+  </script>
+  <script src="/lib/docsify.js"></script>
 </body>
-<script>
-  window.$docsify = {
-    alias: {
-      '.*?/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG',
-      '/.*/_navbar.md': '/_navbar.md'
-    },
-    auto2top: true,
-    basePath: '/docs/',
-    executeScript: true,
-    loadNavbar: true,
-    loadSidebar: true,
-    coverpage: true,
-    name: 'docsify',
-    subMaxLevel: 2,
-    mergeNavbar: true,
-    formatUpdated: '{MM}/{DD} {HH}:{mm}',
-    plugins: [
-      function(hook, vm) {
-        hook.beforeEach(function (html) {
-          var url = 'https://github.com/QingWei-Li/docsify/blob/master/' + vm.route.file
-          var editHtml = '[:memo: Edit Document](' + url + ')\n'
-
-          return editHtml
-            + html
-            + '\n----\n'
-            + 'Last modified {docsify-updated} '
-            + editHtml
-        })
-      }
-    ]
-  }
-</script>
-<script src="/lib/docsify.js"></script>
 </html>
@@ -1,6 +1,6 @@
 ![logo](_media/icon.svg)

-# docsify <small>4.3.15</small>
+# docsify <small>4.5.2</small>

 > A magical documentation site generator.

@@ -56,3 +56,23 @@ You will get `<a href="/demo/">link</a>`html. Do not worry, you can still set ti
 [link](/demo ":target=_blank")
 [link](/demo2 ":target=_self")
 ```
+
+
+## Github Task Lists
+
+```md
+
+* [ ] foo
+ * bar
+ * [x] baz
+ * [] bam
+   * [ ] bim
+   * [ ] lim
+```
+
+* [ ] foo
+ * bar
+ * [x] baz
+ * [] bam
+   * [ ] bim
+   * [ ] lim
@@ -91,12 +91,18 @@ Wenn das Skript auf der Seite ein externes ist (eine Javascript Datei über das

 ## Bilder zoomen

-Medium's Bilderzoom. Basierend auf [zoom-image](https://github.com/egoist/zoom-image).
+Medium's Bilderzoom. Basierend auf [medium-zoom](https://github.com/francoischalifour/medium-zoom).

 ```html
 <script src="//unpkg.com/docsify/lib/plugins/zoom-image.min.js"></script>
 ```

+Exclude the special image
+
+```markdown
+![](image.png ':no-zoom')
+```
+
 ## Edit on github

 Add `Edit on github` button on every pages. provided by 3rd party, check [document](https://github.com/njleonzhang/docsify-edit-on-github)
@@ -45,6 +45,7 @@ Wenn du `npm` nicht verwenden möchtest, oder Probleme bei der Installation des
 <html>
 <head>
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
  <meta charset="UTF-8">
  <link rel="stylesheet" href="//unpkg.com/docsify/themes/vue.css">
 </head>
@@ -57,3 +57,28 @@ You will get `<a href="/demo/">link</a>`html. Do not worry, you can still set ti
 [link](/demo2 ":target=_self")
 ```

+## Disable link
+
+```md
+[link](/demo ":disabled")
+```
+
+## Github Task Lists
+
+```md
+
+* [ ] foo
+ * bar
+ * [x] baz
+ * [] bam
+   * [ ] bim
+   * [ ] lim
+```
+
+* [ ] foo
+ * bar
+ * [x] baz
+ * [] bam
+   * [ ] bim
+   * [ ] lim
+
@@ -20,59 +20,59 @@
 </head>
 <body>
  <div id="app">Loading ...</div>
-</body>
-<script>
-  window.$docsify = {
-    alias: {
-      '.*?/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG',
-      '/.*/_navbar.md': '/_navbar.md'
-    },
-    auto2top: true,
-    coverpage: true,
-    executeScript: true,
-    loadSidebar: true,
-    loadNavbar: true,
-    mergeNavbar: true,
-    maxLevel: 4,
-    subMaxLevel: 2,
-    codesponsor: '7c9Ms7xRs-j_y_8abU03DA',
-    ga: 'UA-106147152-1',
-    name: 'docsify',
-    search: {
-      noData: {
-        '/de-de/': 'Keine Ergebnisse!',
-        '/zh-cn/': '没有结果!',
-        '/': 'No results!'
+  <script>
+    window.$docsify = {
+      alias: {
+        '.*?/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG',
+        '/.*/_navbar.md': '/_navbar.md'
      },
-      paths: 'auto',
-      placeholder: {
-        '/de-de/': 'Suche',
-        '/zh-cn/': '搜索',
-        '/': 'Search'
-      }
-    },
-    formatUpdated: '{MM}/{DD} {HH}:{mm}',
-    plugins: [
-      function(hook, vm) {
-        hook.beforeEach(function (html) {
-          var url = 'https://github.com/QingWei-Li/docsify/blob/master/docs/' + vm.route.file
-          var editHtml = '[:memo: Edit Document](' + url + ')\n'
-
-          return editHtml
-            + html
-            + '\n----\n'
-            + 'Last modified {docsify-updated} '
-            + editHtml
-        })
-      }
-    ]
-  }
-</script>
-<script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
-<script src="//unpkg.com/docsify/lib/plugins/search.min.js"></script>
-<script src="//unpkg.com/docsify/lib/plugins/codesponsor.min.js"></script>
-<script src="//unpkg.com/docsify/lib/plugins/ga.min.js"></script>
-<script src="//unpkg.com/prismjs/components/prism-bash.min.js"></script>
-<script src="//unpkg.com/prismjs/components/prism-markdown.min.js"></script>
-<script src="//unpkg.com/prismjs/components/prism-nginx.min.js"></script>
+      auto2top: true,
+      coverpage: true,
+      executeScript: true,
+      loadSidebar: true,
+      loadNavbar: true,
+      mergeNavbar: true,
+      maxLevel: 4,
+      subMaxLevel: 2,
+      codesponsor: '7c9Ms7xRs-j_y_8abU03DA',
+      ga: 'UA-106147152-1',
+      name: 'docsify',
+      search: {
+        noData: {
+          '/de-de/': 'Keine Ergebnisse!',
+          '/zh-cn/': '没有结果!',
+          '/': 'No results!'
+        },
+        paths: 'auto',
+        placeholder: {
+          '/de-de/': 'Suche',
+          '/zh-cn/': '搜索',
+          '/': 'Search'
+        }
+      },
+      formatUpdated: '{MM}/{DD} {HH}:{mm}',
+      plugins: [
+        function(hook, vm) {
+          hook.beforeEach(function (html) {
+            var url = 'https://github.com/QingWei-Li/docsify/blob/master/docs/' + vm.route.file
+            var editHtml = '[:memo: Edit Document](' + url + ')\n'
+  
+            return editHtml
+              + html
+              + '\n----\n'
+              + 'Last modified {docsify-updated} '
+              + editHtml
+          })
+        }
+      ]
+    }
+  </script>
+  <script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
+  <script src="//unpkg.com/docsify/lib/plugins/search.min.js"></script>
+  <script src="//unpkg.com/docsify/lib/plugins/codesponsor.min.js"></script>
+  <script src="//unpkg.com/docsify/lib/plugins/ga.min.js"></script>
+  <script src="//unpkg.com/prismjs/components/prism-bash.min.js"></script>
+  <script src="//unpkg.com/prismjs/components/prism-markdown.min.js"></script>
+  <script src="//unpkg.com/prismjs/components/prism-nginx.min.js"></script>
+</body>
 </html>
@@ -91,12 +91,19 @@ If the script on the page is an external one (imports a js file via `src` attrib

 ## Zoom image

-Medium's Image Zoom. Based on [zoom-image](https://github.com/egoist/zoom-image).
+Medium's image zoom. Based on [medium-zoom](https://github.com/francoischalifour/medium-zoom).

 ```html
 <script src="//unpkg.com/docsify/lib/plugins/zoom-image.min.js"></script>
 ```

+Exclude the special image
+
+```markdown
+![](image.png ':no-zoom')
+```
+
+
 ## Edit on github

 Add `Edit on github` button on every pages. provided by 3rd party, check [document](https://github.com/njleonzhang/docsify-edit-on-github)
@@ -140,3 +147,17 @@ window.$docsify = {
 ```

 See [here](https://github.com/jperasmus/docsify-copy-code/blob/master/README.md) for more details.
+
+
+## Disqus
+
+Disqus comments. https://disqus.com/
+
+```html
+<script>
+  window.$docsify = {
+    disqus: 'shortname'
+  }
+</script>
+<script src="//unpkg.com/docsify/lib/plugins/disqus.min.js"></script>
+```
@@ -45,6 +45,7 @@ If you don't like `npm` or have trouble installing the tool, you can manually cr
 <html>
 <head>
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
  <meta charset="UTF-8">
  <link rel="stylesheet" href="//unpkg.com/docsify/themes/vue.css">
 </head>
@@ -19,7 +19,7 @@ Then you can immediately write Vue code at Markdown file. `new Vue({ el: '#main'

 *README.md*

-```markdown
+````markdown
 # Vue guide

 `v-for` usage.
@@ -33,7 +33,7 @@ Then you can immediately write Vue code at Markdown file. `new Vue({ el: '#main'
 <ul>
  <li v-for="i in 10">{{ i }}</li>
 </ul>
-```
+````

 You can manually initialize a Vue instance.

@@ -56,3 +56,23 @@ You will get `<a href="/demo/">link</a>`html. Do not worry, you can still set ti
 [link](/demo ":target=_blank")
 [link](/demo2 ":target=_self")
 ```
+
+
+## Github Task Lists
+
+```md
+
+* [ ] foo
+ * bar
+ * [x] baz
+ * [] bam
+   * [ ] bim
+   * [ ] lim
+```
+
+* [ ] foo
+ * bar
+ * [x] baz
+ * [] bam
+   * [ ] bim
+   * [ ] lim
@@ -85,13 +85,21 @@

 ## 图片缩放 - Zoom image

-Medium's 风格的图片缩放插件. 基于 [zoom-image](https://github.com/egoist/zoom-image)。
+Medium's 风格的图片缩放插件. 基于 [medium-zoom](https://github.com/francoischalifour/medium-zoom)。

 ```html
 <script src="//unpkg.com/docsify/lib/plugins/zoom-image.js"></script>
 ```


+忽略某张图片
+
+```markdown
+![](image.png ':no-zoom')
+```
+
+
+
 ## Edit on github

 Add `Edit on github` button on every pages. provided by 3rd party, check [document](https://github.com/njleonzhang/docsify-edit-on-github)
@@ -45,6 +45,7 @@ docsify serve docs
 <html>
 <head>
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
  <meta charset="UTF-8">
  <link rel="stylesheet" href="//unpkg.com/docsify/themes/vue.css">
 </head>
@@ -2758,10 +2758,13 @@ function parseQuery (query) {
  return res
 }

-function stringifyQuery (obj) {
+function stringifyQuery (obj, ignores) {
+  if ( ignores === void 0 ) ignores = [];
+
  var qs = [];

  for (var key in obj) {
+    if (ignores.indexOf(key) > -1) { continue }
    qs.push(
      obj[key]
        ? ((encode(key)) + "=" + (encode(obj[key]))).toLowerCase()
@@ -2794,6 +2797,22 @@ var cleanPath = cached(function (path) {
 });

 var cachedLinks = {};
+function getAndRemoveConfig (str) {
+  if ( str === void 0 ) str = '';
+
+  var config = {};
+
+  if (str) {
+    str = str
+      .replace(/:([\w-]+)=?([\w-]+)?/g, function (m, key, value) {
+        config[key] = value || true;
+        return ''
+      })
+      .trim();
+  }
+
+  return { str: str, config: config }
+}

 var Compiler = function Compiler (config, router) {
  this.config = config;
@@ -2810,9 +2829,11 @@ var Compiler = function Compiler (config, router) {
  if (isFn(mdConf)) {
    compile = mdConf(marked, renderer);
  } else {
-    marked.setOptions(merge(mdConf, {
-      renderer: merge(renderer, mdConf.renderer)
-    }));
+    marked.setOptions(
+      merge(mdConf, {
+        renderer: merge(renderer, mdConf.renderer)
+      })
+    );
    compile = marked;
  }

@@ -2881,33 +2902,47 @@ Compiler.prototype._initRenderer = function _initRenderer () {
  origin.code = renderer.code = function (code, lang) {
      if ( lang === void 0 ) lang = '';

-    var hl = prism.highlight(code, prism.languages[lang] || prism.languages.markup);
+    var hl = prism.highlight(
+      code,
+      prism.languages[lang] || prism.languages.markup
+    );

    return ("<pre v-pre data-lang=\"" + lang + "\"><code class=\"lang-" + lang + "\">" + hl + "</code></pre>")
  };
  origin.link = renderer.link = function (href, title, text) {
-    var blank = '';
+      if ( title === void 0 ) title = '';

-    if (!/:|(\/{2})/.test(href) &&
+    var attrs = '';
+
+    var ref = getAndRemoveConfig(title);
+      var str = ref.str;
+      var config = ref.config;
+    title = str;
+
+    if (
+      !/:|(\/{2})/.test(href) &&
      !_self.matchNotCompileLink(href) &&
-      !/(\s?:ignore)(\s\S+)?$/.test(title)) {
+      !config.ignore
+    ) {
      href = router.toURL(href, null, router.getCurrentPath());
    } else {
-      blank = " target=\"" + linkTarget + "\"";
-      title = title && title.replace(/:ignore/g, '').trim();
+      attrs += " target=\"" + linkTarget + "\"";
    }

-    var target = title && title.match(/:target=\w+/);
-    if (target) {
-      target = target[0];
-      title = title.replace(target, '');
-      blank = ' ' + target.slice(1);
+    if (config.target) {
+      attrs += ' target=' + config.target;
+    }
+
+    if (config.disabled) {
+      attrs += ' disabled';
+      href = 'javascript:void(0)';
    }

    if (title) {
-      title = " title=\"" + title + "\"";
+      attrs += " title=\"" + title + "\"";
    }
-    return ("<a href=\"" + href + "\"" + (title || '') + blank + ">" + text + "</a>")
+
+    return ("<a href=\"" + href + "\"" + attrs + ">" + text + "</a>")
  };
  origin.paragraph = renderer.paragraph = function (text) {
    if (/^!&gt;/.test(text)) {
@@ -2919,13 +2954,35 @@ Compiler.prototype._initRenderer = function _initRenderer () {
  };
  origin.image = renderer.image = function (href, title, text) {
    var url = href;
-    var titleHTML = title ? (" title=\"" + title + "\"") : '';
+    var attrs = '';
+
+    var ref = getAndRemoveConfig(title);
+      var str = ref.str;
+      var config = ref.config;
+    title = str;
+
+    if (config['no-zoom']) {
+      attrs += ' data-no-zoom';
+    }
+
+    if (title) {
+      attrs += " title=\"" + title + "\"";
+    }

    if (!isAbsolutePath(href)) {
      url = getPath(contentBase, href);
    }

-    return ("<img src=\"" + url + "\" data-origin=\"" + href + "\" alt=\"" + text + "\"" + titleHTML + ">")
+    return ("<img src=\"" + url + "\"data-origin=\"" + href + "\" alt=\"" + text + "\"" + attrs + ">")
+  };
+
+  var CHECKED_RE = /^\[([ x])\] +/;
+  origin.listitem = renderer.listitem = function (text) {
+    var checked = CHECKED_RE.exec(text);
+    if (checked) {
+      text = text.replace(CHECKED_RE, ("<input type=\"checkbox\" " + (checked[1] === 'x' ? 'checked' : '') + " />"));
+    }
+    return ("<li>" + text + "</li>\n")
  };

  renderer.origin = origin;
@@ -2965,11 +3022,12 @@ Compiler.prototype.subSidebar = function subSidebar (level) {
    var cacheTree = ref.cacheTree;
    var toc = ref.toc;

-  toc[0] && toc[0].ignoreAllSubs && (this.toc = []);
+  toc[0] && toc[0].ignoreAllSubs && toc.splice(0);
  toc[0] && toc[0].level === 1 && toc.shift();
-  toc.forEach(function (node, i) {
-    node.ignoreSubHeading && toc.splice(i, 1);
-  });
+
+  for (var i = 0; i < toc.length; i++) {
+    toc[i].ignoreSubHeading && toc.splice(i, 1) && i--;
+  }

  var tree$$1 = cacheTree[currentPath] || genTree(toc, level);

@@ -3805,14 +3863,14 @@ function initEvent (vm) {
  }
 }

-function loadNested (path, file, next, vm, first) {
+function loadNested (path, qs, file, next, vm, first) {
  path = first ? path : path.replace(/\/$/, '');
  path = getParentPath(path);

  if (!path) { return }

-  get(vm.router.getFile(path + file))
-    .then(next, function (_) { return loadNested(path, file, next, vm); });
+  get(vm.router.getFile(path + file) + qs).then(next, function (_) { return loadNested(path, qs, file, next, vm); }
+  );
 }

 function fetchMixin (proto) {
@@ -3823,6 +3881,8 @@ function fetchMixin (proto) {

    var ref = this.route;
    var path = ref.path;
+    var query = ref.query;
+    var qs = stringifyQuery(query, ['id']);
    var ref$1 = this.config;
    var loadNavbar = ref$1.loadNavbar;
    var loadSidebar = ref$1.loadSidebar;
@@ -3830,7 +3890,7 @@ function fetchMixin (proto) {
    // Abort last request
    last && last.abort && last.abort();

-    last = get(this.router.getFile(path), true);
+    last = get(this.router.getFile(path) + qs, true);

    // Current page is html
    this.isHTML = /\.html$/g.test(path);
@@ -3838,25 +3898,37 @@ function fetchMixin (proto) {
    var loadSideAndNav = function () {
      if (!loadSidebar) { return cb() }

-      var fn = function (result) { this$1._renderSidebar(result); cb(); };
+      var fn = function (result) {
+        this$1._renderSidebar(result);
+        cb();
+      };

      // Load sidebar
-      loadNested(path, loadSidebar, fn, this$1, true);
+      loadNested(path, qs, loadSidebar, fn, this$1, true);
    };

    // Load main content
-    last.then(function (text, opt) {
-      this$1._renderMain(text, opt);
-      loadSideAndNav();
-    },
-    function (_) {
-      this$1._renderMain(null);
-      loadSideAndNav();
-    });
+    last.then(
+      function (text, opt) {
+        this$1._renderMain(text, opt);
+        loadSideAndNav();
+      },
+      function (_) {
+        this$1._renderMain(null);
+        loadSideAndNav();
+      }
+    );

    // Load nav
    loadNavbar &&
-    loadNested(path, loadNavbar, function (text) { return this$1._renderNav(text); }, this, true);
+      loadNested(
+        path,
+        qs,
+        loadNavbar,
+        function (text) { return this$1._renderNav(text); },
+        this,
+        true
+      );
  };

  proto._fetchCover = function () {
@@ -3864,6 +3936,7 @@ function fetchMixin (proto) {

    var ref = this.config;
    var coverpage = ref.coverpage;
+    var query = this.route.query;
    var root = getParentPath(this.route.path);
    var path = this.router.getFile(root + coverpage);

@@ -3873,8 +3946,8 @@ function fetchMixin (proto) {
    }

    this.coverIsHTML = /\.html$/g.test(path);
-    get(path)
-      .then(function (text) { return this$1._renderCover(text); });
+    get(path + stringifyQuery(query, ['id'])).then(function (text) { return this$1._renderCover(text); }
+    );
  };

  proto.$fetch = function (cb) {
@@ -3990,7 +4063,7 @@ initGlobalAPI();
 /**
 * Version
 */
-Docsify.version = '4.3.15';
+Docsify.version = '4.5.2';

 /**
 * Run Docsify
@@ -0,0 +1,53 @@
+(function () {
+'use strict';
+
+location.href = location.href.replace('/-/', '/#/');
+
+function install (hook, vm) {
+  var dom = Docsify.dom;
+  var disqus = vm.config.disqus;
+  if (!disqus) {
+    throw Error('$docsify.disqus is required')
+  }
+
+  hook.init(function (_) {
+    var script = dom.create('script');
+
+    script.async = true;
+    script.src = "https://" + disqus + ".disqus.com/embed.js";
+    script.setAttribute('data-timestamp', +new Date());
+    dom.appendTo(dom.body, script);
+  });
+
+  hook.mounted(function (_) {
+    var div = dom.create('div');
+    div.id = 'disqus_thread';
+    var main = dom.getNode('#main');
+    div.style = "width: " + (main.clientWidth) + "px; margin: 0 auto 20px;";
+    dom.appendTo(dom.find('.content'), div);
+
+    // eslint-disable-next-line
+    window.disqus_config = function() {
+      this.page.url = location.origin + '/-' + vm.route.path;
+      this.page.identifier = vm.route.path;
+      this.page.title = document.title;
+    };
+  });
+
+  hook.doneEach(function (_) {
+    if (typeof window.DISQUS !== 'undefined') {
+      window.DISQUS.reset({
+        reload: true,
+        config: function () {
+          this.page.url = location.origin + '/-' + vm.route.path;
+          this.page.identifier = vm.route.path;
+          this.page.title = document.title;
+        }
+      });
+    }
+  });
+}
+
+$docsify.plugins = [].concat(install, $docsify.plugins);
+
+}());
@@ -0,0 +1 @@
+!function(){"use strict";function i(i,t){var e=Docsify.dom,o=t.config.disqus;if(!o)throw Error("$docsify.disqus is required");i.init(function(i){var t=e.create("script");t.async=!0,t.src="https://"+o+".disqus.com/embed.js",t.setAttribute("data-timestamp",+new Date),e.appendTo(e.body,t)}),i.mounted(function(i){var o=e.create("div");o.id="disqus_thread";var n=e.getNode("#main");o.style="width: "+n.clientWidth+"px; margin: 0 auto 20px;",e.appendTo(e.find(".content"),o),window.disqus_config=function(){this.page.url=location.origin+"/-"+t.route.path,this.page.identifier=t.route.path,this.page.title=document.title}}),i.doneEach(function(i){void 0!==window.DISQUS&&window.DISQUS.reset({reload:!0,config:function(){this.page.url=location.origin+"/-"+t.route.path,this.page.identifier=t.route.path,this.page.title=document.title}})})}location.href=location.href.replace("/-/","/#/"),$docsify.plugins=[].concat(i,$docsify.plugins)}();
@@ -1,6 +1,6 @@
 {
  "name": "docsify",
-  "version": "4.3.15",
+  "version": "4.5.2",
  "lockfileVersion": 1,
  "requires": true,
  "dependencies": {
@@ -4239,6 +4239,11 @@
      "integrity": "sha1-3oGf282E3M2PrlnGrreWFbnSZqw=",
      "dev": true
    },
+    "medium-zoom": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/medium-zoom/-/medium-zoom-0.2.0.tgz",
+      "integrity": "sha512-2595M4GDwjoyZVDtkw6JWY8JxkhZVumqPjvM8coyRcULPZpoij2bQJ1/syqtx4XiflaqTva0cAch1kzqk0ir9Q=="
+    },
    "mem": {
      "version": "1.1.0",
      "resolved": "https://registry.npmjs.org/mem/-/mem-1.1.0.tgz",
@@ -7192,11 +7197,6 @@
          "dev": true
        }
      }
-    },
-    "zoom-image": {
-      "version": "0.1.4",
-      "resolved": "https://registry.npmjs.org/zoom-image/-/zoom-image-0.1.4.tgz",
-      "integrity": "sha1-+q8KgFG7Zya+YM891qM17HPx6Wk="
    }
  }
 }
@@ -1,6 +1,6 @@
 {
  "name": "docsify",
-  "version": "4.3.15",
+  "version": "4.5.2",
  "description": "A magical documentation generator.",
  "author": {
    "name": "qingwei-li",
@@ -31,10 +31,10 @@
  },
  "dependencies": {
    "marked": "^0.3.6",
+    "medium-zoom": "^0.2.0",
    "prismjs": "^1.6.0",
    "tinydate": "^1.0.0",
-    "tweezer.js": "^1.4.0",
-    "zoom-image": "^0.1.4"
+    "tweezer.js": "^1.4.0"
  },
  "devDependencies": {
    "conventional-changelog-cli": "^1.3.2",
@@ -37,5 +37,5 @@
      "integrity": "sha1-6DWIAbhrg7F1YNTjw4LXrvIQCUQ="
    }
  },
-  "version": "4.3.15"
+  "version": "4.5.2"
 }
@@ -1,6 +1,6 @@
 {
  "name": "docsify-server-renderer",
-  "version": "4.3.15",
+  "version": "4.5.2",
  "description": "docsify server renderer",
  "author": {
    "name": "qingwei-li",
@@ -1,29 +1,31 @@
 import { get } from './ajax'
 import { callHook } from '../init/lifecycle'
-import { getParentPath } from '../router/util'
+import { getParentPath, stringifyQuery } from '../router/util'
 import { noop } from '../util/core'
 import { getAndActive } from '../event/sidebar'

-function loadNested (path, file, next, vm, first) {
+function loadNested (path, qs, file, next, vm, first) {
  path = first ? path : path.replace(/\/$/, '')
  path = getParentPath(path)

  if (!path) return

-  get(vm.router.getFile(path + file))
-    .then(next, _ => loadNested(path, file, next, vm))
+  get(vm.router.getFile(path + file) + qs).then(next, _ =>
+    loadNested(path, qs, file, next, vm)
+  )
 }

 export function fetchMixin (proto) {
  let last
  proto._fetch = function (cb = noop) {
-    const { path } = this.route
+    const { path, query } = this.route
+    const qs = stringifyQuery(query, ['id'])
    const { loadNavbar, loadSidebar } = this.config

    // Abort last request
    last && last.abort && last.abort()

-    last = get(this.router.getFile(path), true)
+    last = get(this.router.getFile(path) + qs, true)

    // Current page is html
    this.isHTML = /\.html$/g.test(path)
@@ -31,29 +33,42 @@ export function fetchMixin (proto) {
    const loadSideAndNav = () => {
      if (!loadSidebar) return cb()

-      const fn = result => { this._renderSidebar(result); cb() }
+      const fn = result => {
+        this._renderSidebar(result)
+        cb()
+      }

      // Load sidebar
-      loadNested(path, loadSidebar, fn, this, true)
+      loadNested(path, qs, loadSidebar, fn, this, true)
    }

    // Load main content
-    last.then((text, opt) => {
-      this._renderMain(text, opt)
-      loadSideAndNav()
-    },
-    _ => {
-      this._renderMain(null)
-      loadSideAndNav()
-    })
+    last.then(
+      (text, opt) => {
+        this._renderMain(text, opt)
+        loadSideAndNav()
+      },
+      _ => {
+        this._renderMain(null)
+        loadSideAndNav()
+      }
+    )

    // Load nav
    loadNavbar &&
-    loadNested(path, loadNavbar, text => this._renderNav(text), this, true)
+      loadNested(
+        path,
+        qs,
+        loadNavbar,
+        text => this._renderNav(text),
+        this,
+        true
+      )
  }

  proto._fetchCover = function () {
    const { coverpage } = this.config
+    const query = this.route.query
    const root = getParentPath(this.route.path)
    const path = this.router.getFile(root + coverpage)

@@ -63,8 +78,9 @@ export function fetchMixin (proto) {
    }

    this.coverIsHTML = /\.html$/g.test(path)
-    get(path)
-      .then(text => this._renderCover(text))
+    get(path + stringifyQuery(query, ['id'])).then(text =>
+      this._renderCover(text)
+    )
  }

  proto.$fetch = function (cb = noop) {
@@ -8,6 +8,20 @@ import { isAbsolutePath, getPath } from '../router/util'
 import { isFn, merge, cached } from '../util/core'

 const cachedLinks = {}
+function getAndRemoveConfig (str = '') {
+  const config = {}
+
+  if (str) {
+    str = str
+      .replace(/:([\w-]+)=?([\w-]+)?/g, (m, key, value) => {
+        config[key] = value || true
+        return ''
+      })
+      .trim()
+  }
+
+  return { str, config }
+}

 export class Compiler {
  constructor (config, router) {
@@ -25,9 +39,11 @@ export class Compiler {
    if (isFn(mdConf)) {
      compile = mdConf(marked, renderer)
    } else {
-      marked.setOptions(merge(mdConf, {
-        renderer: merge(renderer, mdConf.renderer)
-      }))
+      marked.setOptions(
+        merge(mdConf, {
+          renderer: merge(renderer, mdConf.renderer)
+        })
+      )
      compile = marked
    }

@@ -91,33 +107,43 @@ export class Compiler {
    }
    // highlight code
    origin.code = renderer.code = function (code, lang = '') {
-      const hl = Prism.highlight(code, Prism.languages[lang] || Prism.languages.markup)
+      const hl = Prism.highlight(
+        code,
+        Prism.languages[lang] || Prism.languages.markup
+      )

      return `<pre v-pre data-lang="${lang}"><code class="lang-${lang}">${hl}</code></pre>`
    }
-    origin.link = renderer.link = function (href, title, text) {
-      let blank = ''
+    origin.link = renderer.link = function (href, title = '', text) {
+      let attrs = ''

-      if (!/:|(\/{2})/.test(href) &&
+      const { str, config } = getAndRemoveConfig(title)
+      title = str
+
+      if (
+        !/:|(\/{2})/.test(href) &&
        !_self.matchNotCompileLink(href) &&
-        !/(\s?:ignore)(\s\S+)?$/.test(title)) {
+        !config.ignore
+      ) {
        href = router.toURL(href, null, router.getCurrentPath())
      } else {
-        blank = ` target="${linkTarget}"`
-        title = title && title.replace(/:ignore/g, '').trim()
+        attrs += ` target="${linkTarget}"`
      }

-      let target = title && title.match(/:target=\w+/)
-      if (target) {
-        target = target[0]
-        title = title.replace(target, '')
-        blank = ' ' + target.slice(1)
+      if (config.target) {
+        attrs += ' target=' + config.target
+      }
+
+      if (config.disabled) {
+        attrs += ' disabled'
+        href = 'javascript:void(0)'
      }

      if (title) {
-        title = ` title="${title}"`
+        attrs += ` title="${title}"`
      }
-      return `<a href="${href}"${title || ''}${blank}>${text}</a>`
+
+      return `<a href="${href}"${attrs}>${text}</a>`
    }
    origin.paragraph = renderer.paragraph = function (text) {
      if (/^!&gt;/.test(text)) {
@@ -129,13 +155,33 @@ export class Compiler {
    }
    origin.image = renderer.image = function (href, title, text) {
      let url = href
-      const titleHTML = title ? ` title="${title}"` : ''
+      let attrs = ''
+
+      const { str, config } = getAndRemoveConfig(title)
+      title = str
+
+      if (config['no-zoom']) {
+        attrs += ' data-no-zoom'
+      }
+
+      if (title) {
+        attrs += ` title="${title}"`
+      }

      if (!isAbsolutePath(href)) {
        url = getPath(contentBase, href)
      }

-      return `<img src="${url}" data-origin="${href}" alt="${text}"${titleHTML}>`
+      return `<img src="${url}"data-origin="${href}" alt="${text}"${attrs}>`
+    }
+
+    const CHECKED_RE = /^\[([ x])\] +/
+    origin.listitem = renderer.listitem = function (text) {
+      const checked = CHECKED_RE.exec(text)
+      if (checked) {
+        text = text.replace(CHECKED_RE, `<input type="checkbox" ${checked[1] === 'x' ? 'checked' : ''} />`)
+      }
+      return `<li>${text}</li>\n`
    }

    renderer.origin = origin
@@ -173,11 +219,12 @@ export class Compiler {
    const currentPath = this.router.getCurrentPath()
    const { cacheTree, toc } = this

-    toc[0] && toc[0].ignoreAllSubs && (this.toc = [])
+    toc[0] && toc[0].ignoreAllSubs && toc.splice(0)
    toc[0] && toc[0].level === 1 && toc.shift()
-    toc.forEach((node, i) => {
-      node.ignoreSubHeading && toc.splice(i, 1)
-    })
+
+    for (let i = 0; i < toc.length; i++) {
+      toc[i].ignoreSubHeading && toc.splice(i, 1) && i--
+    }

    const tree = cacheTree[currentPath] || genTree(toc, level)

@@ -22,10 +22,11 @@ export function parseQuery (query) {
  return res
 }

-export function stringifyQuery (obj) {
+export function stringifyQuery (obj, ignores = []) {
  const qs = []

  for (const key in obj) {
+    if (ignores.indexOf(key) > -1) continue
    qs.push(
      obj[key]
        ? `${encode(key)}=${encode(obj[key])}`.toLowerCase()
@@ -0,0 +1,48 @@
+location.href = location.href.replace('/-/', '/#/')
+
+function install (hook, vm) {
+  const dom = Docsify.dom
+  const disqus = vm.config.disqus
+  if (!disqus) {
+    throw Error('$docsify.disqus is required')
+  }
+
+  hook.init(_ => {
+    const script = dom.create('script')
+
+    script.async = true
+    script.src = `https://${disqus}.disqus.com/embed.js`
+    script.setAttribute('data-timestamp', +new Date())
+    dom.appendTo(dom.body, script)
+  })
+
+  hook.mounted(_ => {
+    const div = dom.create('div')
+    div.id = 'disqus_thread'
+    const main = dom.getNode('#main')
+    div.style = `width: ${main.clientWidth}px; margin: 0 auto 20px;`
+    dom.appendTo(dom.find('.content'), div)
+
+    // eslint-disable-next-line
+    window.disqus_config = function() {
+      this.page.url = location.origin + '/-' + vm.route.path
+      this.page.identifier = vm.route.path
+      this.page.title = document.title
+    }
+  })
+
+  hook.doneEach(_ => {
+    if (typeof window.DISQUS !== 'undefined') {
+      window.DISQUS.reset({
+        reload: true,
+        config: function () {
+          this.page.url = location.origin + '/-' + vm.route.path
+          this.page.identifier = vm.route.path
+          this.page.title = document.title
+        }
+      })
+    }
+  })
+}
+
+$docsify.plugins = [].concat(install, $docsify.plugins)
@@ -1,22 +1,14 @@
-import zoom from 'zoom-image'
-import style from 'zoom-image/css/zoom-image.css'
+import mediumZoom from 'medium-zoom'

 function install (hook) {
-  const dom = Docsify.dom
-  let destroys
-
-  // add style
-  dom.appendTo(dom.head, dom.create('style', style))
+  let zoom

  hook.doneEach(_ => {
-    const images = dom.findAll('img:not(.emoji)')
-
-    if (Array.isArray(destroys) && destroys.length) {
-      destroys.forEach(o => o())
-      destroys = []
+    if (zoom) {
+      zoom.detach()
    }

-    destroys = images.map(zoom)
+    zoom = mediumZoom('img:not(.emoji):not([data-no-zoom])')
  })
 }

@@ -75,6 +75,11 @@ img {
  max-width: 100%;
 }

+a[disabled] {
+  cursor: not-allowed;
+  opacity: 0.6;
+}
+
 kbd {
  border: solid 1px #ccc;
  border-radius: 3px;
@@ -86,6 +91,11 @@ kbd {
  vertical-align: middle;
 }

+li input[type=checkbox] {
+  margin: 0 0.2em 0.25em -1.6em;
+  vertical-align: middle;
+}
+
 /* navbar */
 .app-nav {
  left: 0;
@@ -207,6 +217,7 @@ main {
  display: block;
  position: relative;
  size: 100vw 100%;
+  z-index: 0;
 }

 .anchor {
@@ -227,7 +238,7 @@ main {
 .sidebar {
  border-right: 1px solid rgba(0, 0, 0, 0.07);
  overflow-y: auto;
-  padding: 40px 0;
+  padding: 40px 0 0;
  position: absolute 0 * 0 0;
  transition: transform 250ms ease-out;
  width: $sidebar-width;
@@ -252,6 +263,7 @@ main {

  .sidebar-nav {
    line-height: 2em;
+    padding-bottom: 40px;
  }

  ul {
@@ -444,10 +456,7 @@ body.close {
@media print {
  .github-corner,
  .sidebar-toggle,
-  .sidebar {
-    display: none;
-  }
-
+  .sidebar,
  .app-nav {
    display: none;
  }
@@ -47,10 +47,11 @@ body {
 }

 .app-sub-sidebar {
-  .section-link {
+  li {
    &::before {
      content: '-';
      padding-right: 4px;
+      float: left;
    }
  }
 }
@@ -99,9 +100,7 @@ body {
 }

 .markdown-section figure,
-.markdown-section p,
-.markdown-section ul,
-.markdown-section ol {
+.markdown-section p {
  margin: 1.2em 0;
 }
Author	SHA1	Message	Date
qingwei.li	405349102f	chore: add changelog 4.5.2	2017-11-09 13:06:59 +08:00
qingwei.li	9d6595d04b	[build] 4.5.2	2017-11-09 13:06:57 +08:00
cinwell.liandGitHub	d486eef6cc	feat: github task lists, close #215 (#305 )	2017-11-09 13:06:23 +08:00
qingwei.li	b3c3180bab	chore: add changelog 4.5.1	2017-11-07 20:03:42 +08:00
qingwei.li	c30af850a1	[build] 4.5.1	2017-11-07 20:03:41 +08:00
qingwei.li	2a2ed96eb8	feat: fetch files with the query params, fixed #303	2017-11-07 20:03:11 +08:00
Desmondandcinwell.li	0d54c0cf83	Add zooming to showcase (#302 )	2017-11-05 00:42:10 -05:00
qingwei.li	f27ce7d2b2	chore: add changelog 4.5.0	2017-11-04 13:56:25 +08:00
qingwei.li	2e1a7367a8	[build] 4.5.0	2017-11-04 13:56:24 +08:00
qingwei.li	7510f75968	fix lint	2017-11-04 13:56:08 +08:00
qingwei.li	fd7d4e0e4e	feat: add disqus plugin, closed #123	2017-11-04 13:54:37 +08:00
qingwei.li	025bc5cddf	chore: update all plugins.md, fixed #187	2017-11-02 10:48:09 +08:00
cinwell.liandGitHub	8f1066a035	chore: update doc fixed #187	2017-11-01 21:43:09 -05:00
qingwei.li	800c0c503a	chore: add changelog 4.4.1	2017-10-31 21:48:15 +08:00
qingwei.li	d5194b4f6b	[build] 4.4.1	2017-10-31 21:48:15 +08:00
cinwell.liandGitHub	fa772cfa94	fix: zoom image plugin issue, fixed #187 (#300 )	2017-10-31 08:20:08 -05:00
Li Xueliandcinwell.li	cc98f56cdd	fix: {docsify-ignore-all} and {docsify-ignore} bug (#299 ) * fix {docsify-ignore-all} not work bug * fix {docsify-ignore} bug	2017-10-31 08:19:48 -05:00
Li Xueliandcinwell.li	752f68e5f8	chore: {docsify-ignore-all} not working properly (#298 )	2017-10-31 03:11:40 -05:00
qingwei.li	bde17e1f10	chore: update template	2017-10-30 21:58:33 +08:00
qingwei.li	2db197f6dc	chore: add changelog 4.4.0	2017-10-30 19:02:56 +08:00
qingwei.li	e8b5b09f2c	[build] 4.4.0	2017-10-30 19:02:55 +08:00
cinwell.liandGitHub	36bfc9d91d	fix: sidebar style issue on firefox, fixed #184 (#297 )	2017-10-30 06:01:01 -05:00
cinwell.liandGitHub	4ad96f3d12	feat: add helper for disabled link, fixed #295 (#296 )	2017-10-30 06:00:31 -05:00
Aleksandr Filatovandcinwell.li	1f04912a8f	Added IT-films project which is based on docsify in readme (#293 )	2017-10-27 09:23:21 -05:00
Sanctuaryandcinwell.li	65f17b4753	Move script tags above closing body tag (#290 )	2017-10-22 20:38:38 -05:00
Ron Hashimotoandcinwell.li	b3419f3842	docs: fix a broken code block (#286 )	2017-10-20 09:41:38 -05:00
Maxandcinwell.li	0bb7e18018	Add rnback website to showcase (#287 )	2017-10-20 09:41:26 -05:00
				`@@ -0,0 +1 @@`
				!function(){"use strict";function i(i,t){var e=Docsify.dom,o=t.config.disqus;if(!o)throw Error("$docsify.disqus is required");i.init(function(i){var t=e.create("script");t.async=!0,t.src="https://"+o+".disqus.com/embed.js",t.setAttribute("data-timestamp",+new Date),e.appendTo(e.body,t)}),i.mounted(function(i){var o=e.create("div");o.id="disqus_thread";var n=e.getNode("#main");o.style="width: "+n.clientWidth+"px; margin: 0 auto 20px;",e.appendTo(e.find(".content"),o),window.disqus_config=function(){this.page.url=location.origin+"/-"+t.route.path,this.page.identifier=t.route.path,this.page.title=document.title}}),i.doneEach(function(i){void 0!==window.DISQUS&&window.DISQUS.reset({reload:!0,config:function(){this.page.url=location.origin+"/-"+t.route.path,this.page.identifier=t.route.path,this.page.title=document.title}})})}location.href=location.href.replace("/-/","/#/"),$docsify.plugins=[].concat(i,$docsify.plugins)}();