From d4c9247b87c0a2701683ed1a17383cfb451cf609 Mon Sep 17 00:00:00 2001
From: Joe Pea <joe@trusktr.io>
Date: Wed, 15 Jul 2020 23:00:28 -0700
Subject: [PATCH 01/15] fix: gitignore was ignoring folders in src, so VS Code
 search results or file fuzzy finder were not working, etc

---
 .gitignore | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.gitignore b/.gitignore
index e9803a96f..dc015fd2a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,10 +2,10 @@
 .DS_Store
 .idea
 node_modules
-themes/
-lib/
-cypress/integration/examples
-cypress/fixtures/docs
+/themes/
+/lib/
+/cypress/integration/examples
+/cypress/fixtures/docs
 
 # exceptions
-!.gitkeep
\ No newline at end of file
+!.gitkeep

From e664a3428337eaeedd32dcc4b534748c0f0c7143 Mon Sep 17 00:00:00 2001
From: Joe Pea <joe@trusktr.io>
Date: Wed, 15 Jul 2020 23:20:10 -0700
Subject: [PATCH 02/15] remove `lib` from pull request template as it is
 gitignored

---
 .github/PULL_REQUEST_TEMPLATE.md | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index bb31bd41f..2d5b3e545 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -14,6 +14,7 @@
 - [ ] Refactor
 - [ ] Docs
 - [ ] Build-related changes
+- [ ] Repo settings
 - [ ] Other, please describe:
 
 If changing the UI of default theme, please provide the **before/after** screenshot:
@@ -44,11 +45,3 @@ If adding a **new feature**, the PR's description includes:
 - [ ] Related tests have been updated
 
 To avoid wasting your time, it's best to open a **feature request issue** first and wait for approval before working on it.
-
-
-**Other information:**
-
----
-
-* [ ] DO NOT include files inside `lib` directory.
-

From 667496b85d99b168255f58e60a6bfe902cc6ee03 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=B2=88=E5=94=81?= <52o@qq52o.cn>
Date: Sun, 19 Jul 2020 09:00:23 +0800
Subject: [PATCH 03/15] feat: Add title to sidebar links (#1286)

---
 src/core/event/sidebar.js | 2 ++
 src/core/render/tpl.js    | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/core/event/sidebar.js b/src/core/event/sidebar.js
index b15cb2afe..7ca72d94c 100644
--- a/src/core/event/sidebar.js
+++ b/src/core/event/sidebar.js
@@ -86,6 +86,8 @@ export function getAndActive(router, el, isParent, autoTitle) {
       const href = a.getAttribute('href');
       const node = isParent ? a.parentNode : a;
 
+      a.title = a.innerText;
+
       if (hash.indexOf(href) === 0 && !target) {
         target = a;
         dom.toggleClass(node, 'add', 'active');
diff --git a/src/core/render/tpl.js b/src/core/render/tpl.js
index e3b35a5c3..2bad3a311 100644
--- a/src/core/render/tpl.js
+++ b/src/core/render/tpl.js
@@ -91,7 +91,7 @@ export function tree(toc, tpl = '<ul class="app-sub-sidebar">{inner}</ul>') {
 
   let innerHTML = '';
   toc.forEach(node => {
-    innerHTML += `<li><a class="section-link" href="${node.slug}">${node.title}</a></li>`;
+    innerHTML += `<li><a class="section-link" href="${node.slug}" title="${node.title}">${node.title}</a></li>`;
     if (node.children) {
       innerHTML += tree(node.children, tpl);
     }

From 6f9baab616b7c608866582165792d5abf3c40330 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=B2=88=E5=94=81?= <52o@qq52o.cn>
Date: Mon, 20 Jul 2020 08:54:54 +0800
Subject: [PATCH 04/15] style: Update index.html and scroll.js (#1292)

---
 docs/index.html          |  1 -
 index.html               | 10 +++++-----
 src/core/event/scroll.js |  7 +++++--
 3 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/docs/index.html b/docs/index.html
index 3f518db13..766d1acd8 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -62,7 +62,6 @@
           '/': 'Search'
         }
       },
-      formatUpdated: '{MM}/{DD} {HH}:{mm}',
       plugins: [
         function (hook, vm) {
           hook.beforeEach(function (html) {
diff --git a/index.html b/index.html
index 5d2319844..9c950964d 100644
--- a/index.html
+++ b/index.html
@@ -9,6 +9,7 @@
   <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>
+  <link rel="stylesheet" href="/themes/pure.css" title="pure" disabled>
   <style>
     nav.app-nav li ul {
       min-width: 100px;
@@ -52,7 +53,6 @@
           '/': 'Search'
         }
       },
-      formatUpdated: '{MM}/{DD} {HH}:{mm}',
       plugins: [
         function (hook, vm) {
           hook.beforeEach(function (html) {
@@ -68,7 +68,6 @@
               url = 'https://github.com/docsifyjs/docsify/blob/master/docs/' + vm.route.file
             }
             var editHtml = '[:memo: Edit Document](' + url + ')\n'
-
             return editHtml
               + html
               + '\n\n----\n\n'
@@ -82,9 +81,10 @@
   <script src="/lib/plugins/search.js"></script>
   <script src="/lib/plugins/emoji.js"></script>
   <script src="/lib/plugins/front-matter.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>
+  <script src="//cdn.jsdelivr.net/npm/prismjs/components/prism-bash.min.js"></script>
+  <script src="//cdn.jsdelivr.net/npm/prismjs/components/prism-markdown.min.js"></script>
+  <script src="//cdn.jsdelivr.net/npm/prismjs/components/prism-nginx.min.js"></script>
+  <script src="//cdn.jsdelivr.net/npm/prismjs/components/prism-php.min.js"></script>
 </body>
 
 </html>
diff --git a/src/core/event/scroll.js b/src/core/event/scroll.js
index 946589996..96cdade5c 100644
--- a/src/core/event/scroll.js
+++ b/src/core/event/scroll.js
@@ -79,9 +79,12 @@ function highlight(path) {
     const isInView =
       active.offsetTop >= wrap.scrollTop && cur <= wrap.scrollTop + height;
     const notThan = cur - curOffset < height;
-    const top = isInView ? wrap.scrollTop : notThan ? curOffset : cur - height;
 
-    sidebar.scrollTop = top;
+    sidebar.scrollTop = isInView
+      ? wrap.scrollTop
+      : notThan
+      ? curOffset
+      : cur - height;
   }
 }
 

From 13d4232f2d55e9c7f95c238d0cce3d956096e2db Mon Sep 17 00:00:00 2001
From: Doc Oliver <37000451+docyx@users.noreply.github.com>
Date: Mon, 20 Jul 2020 03:11:53 -0400
Subject: [PATCH 05/15] docs: Update helpers.md (#1294)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Remove racist example in docs/helpers.md

* Update helpers.md

Co-authored-by: 沈唁 <52o@qq52o.cn>
---
 docs/helpers.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/helpers.md b/docs/helpers.md
index 9cb511f96..4e8fba770 100644
--- a/docs/helpers.md
+++ b/docs/helpers.md
@@ -2,7 +2,7 @@
 
 docsify extends Markdown syntax to make your documents more readable.
 
-> Note:  For the special code syntax cases, you'd better put them within a code backticks to avoid any conflicting from configurations or emojis. 
+> Note: For the special code syntax cases, you'd better put them within a code backticks to avoid any conflicting from configurations or emojis.
 
 ## important content
 
@@ -70,7 +70,7 @@ You will get `<a href="/demo/">link</a>`html. Do not worry, you can still set ti
 Only when you both set the `routerMode: 'history'` and `externalLinkTarget: '_self'`, you need add this configuration for those Cross-Origin links.
 
 ```md
-[example.com](https://example.com/ ':crossorgin')  
+[example.com](https://example.com/ ':crossorgin')
 ```
 
 ## Github Task Lists
@@ -124,7 +124,7 @@ Only when you both set the `routerMode: 'history'` and `externalLinkTarget: '_se
 ## Customise ID for headings
 
 ```md
-### 你好，世界！ :id=hello-world
+### Hello, world! :id=hello-world
 ```
 
 ## Markdown in html tag

From b8690199006366e86084e9e018def7b9b8f46512 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=B2=88=E5=94=81?= <52o@qq52o.cn>
Date: Wed, 22 Jul 2020 15:01:13 +0800
Subject: [PATCH 06/15] fix: Fix search error when exist translations documents
 (#1300)

---
 src/plugins/search/search.js | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/plugins/search/search.js b/src/plugins/search/search.js
index b931e62cc..8c253587b 100644
--- a/src/plugins/search/search.js
+++ b/src/plugins/search/search.js
@@ -213,6 +213,11 @@ export function init(config, vm) {
   const len = paths.length;
   let count = 0;
 
+  // Fix search error when exist translations documents
+  if (INDEXS !== null && !INDEXS[paths[0]]) {
+    INDEXS = {};
+  }
+
   paths.forEach(path => {
     if (INDEXS[path]) {
       return count++;

From 9f4f79e0f765efb631c2fb0b884fb8cb23e5791d Mon Sep 17 00:00:00 2001
From: Vladimir Dementyev <dementiev.vm@gmail.com>
Date: Thu, 23 Jul 2020 03:16:19 -0700
Subject: [PATCH 07/15] fix typo (#1302)

---
 src/plugins/search/index.js | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/plugins/search/index.js b/src/plugins/search/index.js
index 3bfd3b6b5..54d8a79c7 100644
--- a/src/plugins/search/index.js
+++ b/src/plugins/search/index.js
@@ -1,5 +1,5 @@
 /* eslint-disable no-unused-vars */
-import { init as initComponet, update as updateComponent } from './component';
+import { init as initComponent, update as updateComponent } from './component';
 import { init as initSearch } from './search';
 
 const CONFIG = {
@@ -32,7 +32,7 @@ const install = function(hook, vm) {
   const isAuto = CONFIG.paths === 'auto';
 
   hook.mounted(_ => {
-    initComponet(CONFIG, vm);
+    initComponent(CONFIG, vm);
     !isAuto && initSearch(CONFIG, vm);
   });
   hook.doneEach(_ => {

From 78775b6ee73102cc5ac71c0ee2b392c5f4f6f4f8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=BB=84=E6=9C=9D=E6=99=96?= <huangzhwork@gmail.com>
Date: Fri, 24 Jul 2020 10:22:54 +0800
Subject: [PATCH 08/15] fix: Search plugin: matched text is replaced with
 search text (#1298)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Fix search plugin will replace matching text

* Fix bug that will replace a unexpected text

* Fix bug that will replace a unexpected text

* Optimized

Co-authored-by: 沈唁 <52o@qq52o.cn>
---
 src/plugins/search/search.js | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/plugins/search/search.js b/src/plugins/search/search.js
index 8c253587b..093904b0e 100644
--- a/src/plugins/search/search.js
+++ b/src/plugins/search/search.js
@@ -170,7 +170,10 @@ export function search(query) {
             '...' +
             escapeHtml(postContent)
               .substring(start, end)
-              .replace(regEx, `<em class="search-keyword">${keyword}</em>`) +
+              .replace(
+                regEx,
+                word => `<em class="search-keyword">${word}</em>`
+              ) +
             '...';
 
           resultStr += matchContent;

From d179dde1c71acdcbe66cb762377b123926c55bf2 Mon Sep 17 00:00:00 2001
From: Vladimir Dementyev <dementiev.vm@gmail.com>
Date: Fri, 24 Jul 2020 10:42:00 +0300
Subject: [PATCH 09/15] feat(search): add pathNamespaces option

This option allows to dynamically choose the index path depending on the path prefixes in auto mode. Thus, different path namespace could avoid index intersection (e.g., when having multiple locales)
---
 docs/plugins.md              | 11 +++++++++++
 index.html                   |  3 ++-
 src/plugins/search/index.js  |  2 ++
 src/plugins/search/search.js | 30 ++++++++++++++++++++++--------
 4 files changed, 37 insertions(+), 9 deletions(-)

diff --git a/docs/plugins.md b/docs/plugins.md
index 51acefbb5..feca8b551 100644
--- a/docs/plugins.md
+++ b/docs/plugins.md
@@ -44,6 +44,17 @@ By default, the hyperlink on the current page is recognized and the content is s
       // To avoid search index collision
       // between multiple websites under the same domain
       namespace: 'website-1',
+
+      // Use different indexes for path prefixes (namespaces).
+      // NOTE: Only works in 'auto' mode.
+      //
+      // When initialiazing an index, we look for the first path from the sidebar.
+      // If it matches the prefix from the list, we switch to the corresponding index.
+      pathNamespaces: ['/zh-cn', '/ru-ru', '/ru-ru/v1'],
+
+      // You can provide a regexp to match prefixes. In this case,
+      // the matching substring will be used to identify the index
+      pathNamespaces: /^(\/(zh-cn|ru-ru))?(\/(v1|v2))?/
     }
   }
 </script>
diff --git a/index.html b/index.html
index 9c950964d..ddacdecda 100644
--- a/index.html
+++ b/index.html
@@ -51,7 +51,8 @@
           '/de-de/': 'Suche',
           '/zh-cn/': '搜索',
           '/': 'Search'
-        }
+        },
+        pathNamespaces: ['/zh-cn', '/de-de', '/ru-ru', '/es']
       },
       plugins: [
         function (hook, vm) {
diff --git a/src/plugins/search/index.js b/src/plugins/search/index.js
index 54d8a79c7..e97c3b026 100644
--- a/src/plugins/search/index.js
+++ b/src/plugins/search/index.js
@@ -10,6 +10,7 @@ const CONFIG = {
   maxAge: 86400000, // 1 day
   hideOtherSidebarContent: false,
   namespace: undefined,
+  pathNamespaces: undefined,
 };
 
 const install = function(hook, vm) {
@@ -27,6 +28,7 @@ const install = function(hook, vm) {
     CONFIG.hideOtherSidebarContent =
       opts.hideOtherSidebarContent || CONFIG.hideOtherSidebarContent;
     CONFIG.namespace = opts.namespace || CONFIG.namespace;
+    CONFIG.pathNamespaces = opts.pathNamespaces || CONFIG.pathNamespaces;
   }
 
   const isAuto = CONFIG.paths === 'auto';
diff --git a/src/plugins/search/search.js b/src/plugins/search/search.js
index 093904b0e..6a212c016 100644
--- a/src/plugins/search/search.js
+++ b/src/plugins/search/search.js
@@ -198,9 +198,29 @@ export function search(query) {
 
 export function init(config, vm) {
   const isAuto = config.paths === 'auto';
+  const paths = isAuto ? getAllPaths(vm.router) : config.paths;
+
+  let namespaceSuffix = '';
+
+  // only in auto mode
+  if (isAuto && config.pathNamespaces) {
+    const path = paths[0];
+
+    if (Array.isArray(config.pathNamespaces)) {
+      namespaceSuffix =
+        config.pathNamespaces.find(prefix => path.startsWith(prefix)) ||
+        namespaceSuffix;
+    } else if (config.pathNamespaces instanceof RegExp) {
+      const matches = path.match(config.pathNamespaces);
+
+      if (matches) {
+        namespaceSuffix = matches[0];
+      }
+    }
+  }
 
-  const expireKey = resolveExpireKey(config.namespace);
-  const indexKey = resolveIndexKey(config.namespace);
+  const expireKey = resolveExpireKey(config.namespace) + namespaceSuffix;
+  const indexKey = resolveIndexKey(config.namespace) + namespaceSuffix;
 
   const isExpired = localStorage.getItem(expireKey) < Date.now();
 
@@ -212,15 +232,9 @@ export function init(config, vm) {
     return;
   }
 
-  const paths = isAuto ? getAllPaths(vm.router) : config.paths;
   const len = paths.length;
   let count = 0;
 
-  // Fix search error when exist translations documents
-  if (INDEXS !== null && !INDEXS[paths[0]]) {
-    INDEXS = {};
-  }
-
   paths.forEach(path => {
     if (INDEXS[path]) {
       return count++;

From 1a64dc847fc42a89472e45fc38637b8421a9a6fb Mon Sep 17 00:00:00 2001
From: Bharat Patodi <bharatpatodi@gmail.com>
Date: Sun, 26 Jul 2020 14:49:02 +0530
Subject: [PATCH 10/15] chore: grammatical changes (#1296)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Make grammatical changes

Minor changes.
Solely for improving readability.

* Update changes

Co-authored-by: 沈唁 <52o@qq52o.cn>
---
 docs/configuration.md | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/docs/configuration.md b/docs/configuration.md
index 371ed35f6..1b2d04878 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -12,7 +12,7 @@ You can configure Docsify by defining `window.$docsify` as an object:
 </script>
 ```
 
-The config can also be defined as a function, in which case the first arg is the Docsify `vm` instance. The function should return a config object. This can be useful for referencing `vm` in places like the markdown configuration:
+The config can also be defined as a function, in which case the first argument is the Docsify `vm` instance. The function should return a config object. This can be useful for referencing `vm` in places like the markdown configuration:
 
 ```html
 <script>
@@ -35,7 +35,7 @@ The config can also be defined as a function, in which case the first arg is the
 - Type: `String`
 - Default: `#app`
 
-The DOM element to be mounted on initialization. It can be a CSS selector string or an actual HTMLElement.
+The DOM element to be mounted on initialization. It can be a CSS selector string or an actual [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement).
 
 ```js
 window.$docsify = {
@@ -48,7 +48,7 @@ window.$docsify = {
 - Type: `String`
 - Default: `null`
 
-Configure the repository url or a string of `username/repo` can add the [GitHub Corner](http://tholman.com/github-corners/) widget in the top right corner of the site.
+Configure the repository url, or a string of `username/repo` can add the [GitHub Corner](http://tholman.com/github-corners/) widget in the top right corner of the site.
 
 ```js
 window.$docsify = {
@@ -76,7 +76,7 @@ window.$docsify = {
 - Type: `Boolean|String`
 - Default: `false`
 
-Loads navbar from the Markdown file `_navbar.md` if **true**, or else from the path specified.
+Loads navbar from the Markdown file `_navbar.md` if **true**, else loads it from the path specified.
 
 ```js
 window.$docsify = {
@@ -93,7 +93,7 @@ window.$docsify = {
 - Type: `Boolean|String`
 - Default: `false`
 
-Loads sidebar from the Markdown file `_sidebar.md` if **true**, or else from the path specified.
+Loads sidebar from the Markdown file `_sidebar.md` if **true**, else loads it from the path specified.
 
 ```js
 window.$docsify = {
@@ -110,7 +110,7 @@ window.$docsify = {
 - Type : `Boolean`
 - Default: `true`
 
-This option will completely hide your sidebar and wont render any content of the side even .
+This option will completely hide your sidebar and won't render any content on the side.
 
 ```js
 window.$docsify = {
@@ -149,7 +149,7 @@ window.$docsify = {
 - Type: `String`
 - Default: `README.md`
 
-`README.md` in your docs folder will be treated as homepage for your website, but sometimes you may need to serve another file as your homepage.
+`README.md` in your docs folder will be treated as the homepage for your website, but sometimes you may need to serve another file as your homepage.
 
 ```js
 window.$docsify = {
@@ -196,7 +196,7 @@ window.$docsify = {
 - Type: `Boolean`
 - Default: `false`
 
-If **true** links are relative to the current context.
+If **true**, links are relative to the current context.
 
 For example, the directory structure is as follows:
 
@@ -260,7 +260,7 @@ window.$docsify = {
 
 - Type: `String`
 
-Website logo as it appears in the sidebar, you can resize by CSS.
+Website logo as it appears in the sidebar. You can resize it by using CSS.
 
 ```js
 window.$docsify = {
@@ -367,7 +367,7 @@ window.$docsify = {
 
 - type: `Boolean`
 
-If `loadSidebar` and `autoHeader` are both enabled, for each link in `_sidebar.md`, prepend a header to the page before converting it to html. Compare [#78](https://github.com/docsifyjs/docsify/issues/78).
+If `loadSidebar` and `autoHeader` are both enabled, for each link in `_sidebar.md`, prepend a header to the page before converting it to HTML. Compare [#78](https://github.com/docsifyjs/docsify/issues/78).
 
 ```js
 window.$docsify = {
@@ -474,7 +474,7 @@ window.$docsify = {
 - type: `String`
 - default: `noopener`
 
-Default `'noopener'` (no opener) prevents the newly opened external page (when [externalLinkTarget](#externallinktarget) is `'_blank'`) from having the ability to control our page. No `rel` is set when its not `'_blank'`. See [this post](https://mathiasbynens.github.io/rel-noopener/) for more information about why you may want to use this option.
+Default `'noopener'` (no opener) prevents the newly opened external page (when [externalLinkTarget](#externallinktarget) is `'_blank'`) from having the ability to control our page. No `rel` is set when it's not `'_blank'`. See [this post](https://mathiasbynens.github.io/rel-noopener/) for more information about why you may want to use this option.
 
 ```js
 window.$docsify = {
@@ -557,13 +557,13 @@ window.$docsify = {
 
 - type: `Array<string>`
 
-List of languages that will fallback to the default language when a page is request and didn't exists for the given local.
+List of languages that will fallback to the default language when a page is requested and it doesn't exist for the given local.
 
 Example:
 
-- try to fetch the page of `/de/overview`. If this page exists, it'll be displayed
-- then try to fetch the default page `/overview` (depending on the default language). If this page exists, it'll be displayed
-- then display 404 page.
+- try to fetch the page of `/de/overview`. If this page exists, it'll be displayed.
+- then try to fetch the default page `/overview` (depending on the default language). If this page exists, it'll be displayed.
+- then display the 404 page.
 
 ```js
 window.$docsify = {
@@ -583,7 +583,7 @@ window.$docsify = {
 };
 ```
 
-Load the customised path of the 404 page:
+Load the customized path of the 404 page:
 
 ```js
 window.$docsify = {

From 952f4c921b7a6a558c500ca6b105582d39ad36a2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=B2=88=E5=94=81?= <52o@qq52o.cn>
Date: Thu, 30 Jul 2020 17:58:45 +0800
Subject: [PATCH 11/15] fix: the uncaught typeerror when el is null (#1308)

---
 src/core/router/history/hash.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/core/router/history/hash.js b/src/core/router/history/hash.js
index 166af9ab5..caaea4571 100644
--- a/src/core/router/history/hash.js
+++ b/src/core/router/history/hash.js
@@ -39,7 +39,7 @@ export class HashHistory extends History {
     on('click', e => {
       const el = e.target.tagName === 'A' ? e.target : e.target.parentNode;
 
-      if (el.tagName === 'A' && !/_blank/.test(el.target)) {
+      if (el && el.tagName === 'A' && !/_blank/.test(el.target)) {
         navigating = true;
       }
     });

From 90d283d340502456a5d8495df596bb4a02ceb39b Mon Sep 17 00:00:00 2001
From: Mattia Astorino <astorino.mattia@gmail.com>
Date: Thu, 30 Jul 2020 12:11:04 +0200
Subject: [PATCH 12/15] fix: convert {docsify-ignore} and {docsify-ignore-all}
 to HTML comments (#1318)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* breaking: convert {docsify-ignore} and {docsify-ignore-all} to HTML comments

Close https://github.com/docsifyjs/docsify/issues/441

* chore: add ignore and ignore-all unit tests

Co-authored-by: 沈唁 <52o@qq52o.cn>
---
 docs/more-pages.md                   | 10 ++++----
 src/core/render/compiler.js          |  8 +++---
 src/core/render/compiler/headline.js |  8 +++---
 test/unit/render.test.js             | 37 ++++++++++++++++++++++++++++
 4 files changed, 50 insertions(+), 13 deletions(-)

diff --git a/docs/more-pages.md b/docs/more-pages.md
index 429eaf97a..0f9386848 100644
--- a/docs/more-pages.md
+++ b/docs/more-pages.md
@@ -114,24 +114,24 @@ A custom sidebar can also automatically generate a table of contents by setting
 
 ## Ignoring Subheaders
 
-When `subMaxLevel` is set, each header is automatically added to the table of contents by default. If you want to ignore a specific header, add `{docsify-ignore}` to it.
+When `subMaxLevel` is set, each header is automatically added to the table of contents by default. If you want to ignore a specific header, add `<!-- {docsify-ignore} -->` to it.
 
 ```markdown
 # Getting Started
 
-## Header {docsify-ignore}
+## Header <!-- {docsify-ignore} -->
 
 This header won't appear in the sidebar table of contents.
 ```
 
-To ignore all headers on a specific page, you can use `{docsify-ignore-all}` on the first header of the page.
+To ignore all headers on a specific page, you can use `<!-- {docsify-ignore-all} -->` on the first header of the page.
 
 ```markdown
-# Getting Started {docsify-ignore-all}
+# Getting Started <!-- {docsify-ignore-all} -->
 
 ## Header
 
 This header won't appear in the sidebar table of contents.
 ```
 
-Both `{docsify-ignore}` and `{docsify-ignore-all}` will not be rendered on the page when used.
+Both `<!-- {docsify-ignore} -->` and `<!-- {docsify-ignore-all} -->` will not be rendered on the page when used.
diff --git a/src/core/render/compiler.js b/src/core/render/compiler.js
index 4eaf51215..669b6226f 100644
--- a/src/core/render/compiler.js
+++ b/src/core/render/compiler.js
@@ -208,14 +208,14 @@ export class Compiler {
       let { str, config } = getAndRemoveConfig(text);
       const nextToc = { level, title: str };
 
-      if (/{docsify-ignore}/g.test(str)) {
-        str = str.replace('{docsify-ignore}', '');
+      if (/<!-- {docsify-ignore} -->/g.test(str)) {
+        str = str.replace('<!-- {docsify-ignore} -->', '');
         nextToc.title = str;
         nextToc.ignoreSubHeading = true;
       }
 
-      if (/{docsify-ignore-all}/g.test(str)) {
-        str = str.replace('{docsify-ignore-all}', '');
+      if (/<!-- {docsify-ignore-all} -->/g.test(str)) {
+        str = str.replace('<!-- {docsify-ignore-all} -->', '');
         nextToc.title = str;
         nextToc.ignoreAllSubs = true;
       }
diff --git a/src/core/render/compiler/headline.js b/src/core/render/compiler/headline.js
index 3f5c22039..cfbad7b25 100644
--- a/src/core/render/compiler/headline.js
+++ b/src/core/render/compiler/headline.js
@@ -6,14 +6,14 @@ export const headingCompiler = ({ renderer, router, _self }) =>
     let { str, config } = getAndRemoveConfig(text);
     const nextToc = { level, title: str };
 
-    if (/{docsify-ignore}/g.test(str)) {
-      str = str.replace('{docsify-ignore}', '');
+    if (/<!-- {docsify-ignore} -->/g.test(str)) {
+      str = str.replace('<!-- {docsify-ignore} -->', '');
       nextToc.title = str;
       nextToc.ignoreSubHeading = true;
     }
 
-    if (/{docsify-ignore-all}/g.test(str)) {
-      str = str.replace('{docsify-ignore-all}', '');
+    if (/<!-- {docsify-ignore-all} -->/g.test(str)) {
+      str = str.replace('<!-- {docsify-ignore-all} -->', '');
       nextToc.title = str;
       nextToc.ignoreAllSubs = true;
     }
diff --git a/test/unit/render.test.js b/test/unit/render.test.js
index 28e88ac0e..43a87248d 100644
--- a/test/unit/render.test.js
+++ b/test/unit/render.test.js
@@ -251,6 +251,43 @@ describe('render', function() {
         </h6>`
       );
     });
+
+    it('ignore', async function() {
+      const { docsify } = await init();
+      const output = docsify.compiler.compile(
+        '## h2 tag <!-- {docsify-ignore} -->'
+      );
+      expectSameDom(
+        output,
+        `
+        <h2 id="h2-tag">
+          <a href="#/?id=h2-tag" data-id="h2-tag" class="anchor">
+            <span>h2 tag </span>
+          </a>
+        </h2>`
+      );
+    });
+
+    it('ignore-all', async function() {
+      const { docsify } = await init();
+      const output = docsify.compiler.compile(
+        `# h1 tag <!-- {docsify-ignore-all} -->` + `\n## h2 tag`
+      );
+      expectSameDom(
+        output,
+        `
+        <h1 id="h1-tag">
+          <a href="#/?id=h1-tag" data-id="h1-tag" class="anchor">
+            <span>h1 tag </span>
+          </a>
+        </h1>
+        <h2 id="h2-tag">
+          <a href="#/?id=h2-tag" data-id="h2-tag" class="anchor">
+            <span>h2 tag</span>
+          </a>
+        </h2>`
+      );
+    });
   });
 
   describe('link', function() {

From 9150678d262904add0ea27a06f427ab529001863 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=B2=88=E5=94=81?= <52o@qq52o.cn>
Date: Thu, 30 Jul 2020 19:09:23 +0800
Subject: [PATCH 13/15] fix typo (#1309)

* fix typo

* Update README.md
---
 packages/docsify-server-renderer/README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/docsify-server-renderer/README.md b/packages/docsify-server-renderer/README.md
index 76c5f80dc..9968b1e0b 100644
--- a/packages/docsify-server-renderer/README.md
+++ b/packages/docsify-server-renderer/README.md
@@ -14,7 +14,7 @@ var readFileSync = require('fs').readFileSync
 
 // init
 var renderer = new Renderer({
-  template: readFileSync('./docs/index.template.html', 'utf-8').,
+  template: readFileSync('./docs/index.template.html', 'utf-8'),
   config: {
     name: 'docsify',
     repo: 'docsifyjs/docsify'
@@ -35,12 +35,12 @@ renderer.renderToString(url)
   <meta charset="UTF-8">
   <title>docsify</title>
   <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0">
-  <link rel="stylesheet" href="//unpkg.com/docsify/themes/buble.css" title="buble" disabled>
+  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/themes/vue.css" title="vue">
 </head>
 <body>
   <!--inject-app-->
   <!--inject-config-->
-  <script src="//unpkg.com/docsify/lib/docsify.js"></script>
+  <script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.js"></script>
 </body>
 </html>
 ```

From 2048610aacd4e3c6a592f4247834a726c7ca33fb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=B2=88=E5=94=81?= <52o@qq52o.cn>
Date: Sat, 1 Aug 2020 17:04:08 +0800
Subject: [PATCH 14/15] fix: {docsify-updated} in the sample code is parsed
 into time (#1321)

---
 docs/index.html | 3 ++-
 index.html      | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/index.html b/docs/index.html
index 766d1acd8..d90431ee2 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -33,7 +33,8 @@
         '/zh-cn/(.*)': 'https://cdn.jsdelivr.net/gh/docsifyjs/docs-zh@master/$1',
         '/de-de/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-de/master/$1',
         '/ru-ru/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-ru/master/$1',
-        '/es/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-es/master/$1'
+        '/es/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-es/master/$1',
+        '/write-a-plugin': 'https://raw.githubusercontent.com/docsifyjs/docsify/master/docs/write-a-plugin.md'
       },
       auto2top: true,
       coverpage: true,
diff --git a/index.html b/index.html
index ddacdecda..9f443671b 100644
--- a/index.html
+++ b/index.html
@@ -28,7 +28,8 @@
         '/zh-cn/(.*)': 'https://cdn.jsdelivr.net/gh/docsifyjs/docs-zh@master/$1',
         '/de-de/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-de/master/$1',
         '/ru-ru/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-ru/master/$1',
-        '/es/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-es/master/$1'
+        '/es/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-es/master/$1',
+        '/write-a-plugin': 'https://raw.githubusercontent.com/docsifyjs/docsify/master/docs/write-a-plugin.md'
       },
       auto2top: true,
       basePath: '/docs/',

From 750663ede4cd22f5b264dd34f8611f91c5011383 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=B2=88=E5=94=81?= <52o@qq52o.cn>
Date: Sun, 2 Aug 2020 12:09:08 +0800
Subject: [PATCH 15/15] docs: update other cdn (#1325)

---
 docs/cdn.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/cdn.md b/docs/cdn.md
index 82b2d2d90..05fff3c28 100644
--- a/docs/cdn.md
+++ b/docs/cdn.md
@@ -44,7 +44,7 @@ Alternatively, use [compressed files](#compressed-file).
 
 ## Other CDN
 
-- http://www.bootcdn.cn/docsify
+- https://www.bootcdn.cn/docsify/
 - https://cdn.jsdelivr.net/npm/docsify/
 - https://cdnjs.com/libraries/docsify
-
+- https://unpkg.com/browse/docsify/