Merge branch 'develop' into master

2024-11-29 18:48:14 +08:00 · 2020-07-14 15:04:27 +08:00 · 2020-07-14 15:04:27 +08:00 · 05d650e606
commit 05d650e606
parent 366500f5dd 0268594f90
19 changed files with 336 additions and 184 deletions
--- a/README.md
+++ b/README.md
@ -11,7 +11,7 @@
 <p align="center">
  <a href="#backers"><img alt="Backers on Open Collective" src="https://opencollective.com/docsify/backers/badge.svg?style=flat-square"></a>
  <a href="#sponsors">
-    <img alt="Sponsors on Open Collective" src="https://opencollective.com/docsify/sponsors/badge.svg?style=flat-square"></a> 
+    <img alt="Sponsors on Open Collective" src="https://opencollective.com/docsify/sponsors/badge.svg?style=flat-square"></a>
  <a><img src="https://github.com/docsifyjs/docsify/workflows/Unit%20tests%20Suite/badge.svg?branch=develop&amp;event=push" alt="Unit tests Suite"></a>
  <a><img src="https://github.com/docsifyjs/docsify/workflows/Linting%20Checks/badge.svg?branch=develop&amp;event=push" alt="Linting Checks"></a>
  <a><img src="https://github.com/docsifyjs/docsify/workflows/Testing%20the%20e2e%20test%20suites/badge.svg?branch=develop&amp;event=push" alt="Testing the e2e test suites"></a>
@ -41,7 +41,7 @@
 ## Features

 - No statically built html files
- Simple and lightweight (~21kB gzipped)
+- Simple and lightweight
 - Smart full-text search plugin
 - Multiple themes
 - Useful plugin API
@ -123,3 +123,9 @@ This project exists thanks to all the people who contribute. [[Contribute](CONTR
 ## License

 [MIT](LICENSE)
+
+## Special Thanks
+
+_Vercel_ has given us a Pro account.
+
+<a href="https://vercel.com/?utm_source=docsifyjsdocs" target="_blank"><img src="docs/_media/vercel_logo.svg" width="100px"></a>
--- a/build/build.js
+++ b/build/build.js
@ -29,7 +29,17 @@ async function build(opts) {
          __VERSION__: version,
          'process.env.SSR': false
        })
-      ])
+      ]),
+      onwarn: function (message) {
+        if (message.code === 'UNRESOLVED_IMPORT') {
+          throw new Error(
+            `Could not resolve module ` + 
+            message.source + 
+            `. Try running 'npm install' or using rollup's 'external' option if this is an external dependency. ` +
+            `Module ${message.source} is imported in ${message.importer}`
+            )
+        }
+      }
    })
    .then(function (bundle) {
      var dest = 'lib/' + (opts.output || opts.input)
--- a/cypress/fixtures/tpl/docs.index.html
+++ b/cypress/fixtures/tpl/docs.index.html
@ -1,123 +1,111 @@
 <!DOCTYPE html>
 <html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <title>docsify-e2e-tests</title>
-    <link rel="icon" href="_media/favicon.ico" />
-    <meta
-      name="google-site-verification"
-      content="6t0LoIeFksrjF4c9sqUEsVXiQNxLp2hgoqo0KryT-sE"
-    />
-    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
-    <meta
-      name="keywords"
-      content="doc,docs,documentation,gitbook,creator,generator,github,jekyll,github-pages"
-    />
-    <meta name="description" content="A magical documentation generator." />
-    <meta
-      name="viewport"
-      content="width=device-width, initial-scale=1.0, minimum-scale=1.0"
-    />
-    <link rel="stylesheet" href="lib/themes/vue.css" title="vue" />
-    <link rel="stylesheet" href="lib/themes/dark.css" title="dark" disabled />
-    <link rel="stylesheet" href="lib/themes/buble.css" title="buble" disabled />
-    <link rel="stylesheet" href="lib/themes/pure.css" title="pure" disabled />
-    <script src="//unpkg.com/docsify-plugin-codefund/index.js"></script>
-    <style>
-      nav.app-nav li ul {
-        min-width: 100px;
-      }
-    </style>
-  </head>

-  <body>
-    <div id="app">Loading Docsify e2e tests suite...</div>
-    <script>
-      window.$docsify = {
-        alias: {
-          '.*?/awesome':
-            'https://raw.githubusercontent.com/docsifyjs/awesome-docsify/master/README.md',
-          '.*?/changelog':
-            'https://raw.githubusercontent.com/docsifyjs/docsify/master/CHANGELOG.md',
-          '/.*/_navbar.md': '/_navbar.md',
-          '/zh-cn/(.*)':
-            'https://raw.githubusercontent.com/docsifyjs/docs-zh/master/$1',
-          '/de-de/(.*)':
-            'https://raw.githubusercontent.com/docsifyjs/docs-de/master/$1',
-          '/ru/(.*)':
-            'https://raw.githubusercontent.com/docsifyjs/docs-ru/master/$1',
-          '/es/(.*)':
-            'https://raw.githubusercontent.com/docsifyjs/docs-es/master/$1'
-        },
-        auto2top: true,
-        coverpage: true,
-        executeScript: true,
-        loadSidebar: true,
-        loadNavbar: true,
-        mergeNavbar: true,
-        maxLevel: 4,
-        subMaxLevel: 2,
-        ga: 'UA-106147152-1',
-        matomo: {
-          host: '//matomo.thunderwave.de',
-          id: 6
-        },
-        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) {
-              if (/githubusercontent\.com/.test(vm.route.file)) {
-                url = vm.route.file
-                  .replace('raw.githubusercontent.com', 'github.com')
-                  .replace(/\/master/, '/blob/master')
-              } else {
-                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' +
-                '<a href="https://docsify.js.org" target="_blank" style="color: inherit; font-weight: normal; text-decoration: none;">Powered by docsify</a>'
-              )
-            })
-          }
-        ]
-      }
-    </script>
-    <script src="lib/docsify.min.js"></script>
-    <script src="lib/plugins/search.min.js"></script>
-    <script src="lib/plugins/ga.min.js"></script>
-    <script src="lib/plugins/matomo.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>
+<head>
+  <meta charset="UTF-8" />
+  <title>docsify-e2e-tests</title>
+  <link rel="icon" href="_media/favicon.ico" />
+  <meta name="google-site-verification" content="6t0LoIeFksrjF4c9sqUEsVXiQNxLp2hgoqo0KryT-sE" />
+  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
+  <meta name="keywords" content="doc,docs,documentation,gitbook,creator,generator,github,jekyll,github-pages" />
+  <meta name="description" content="A magical documentation generator." />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0" />
+  <link rel="stylesheet" href="lib/themes/vue.css" title="vue" />
+  <link rel="stylesheet" href="lib/themes/dark.css" title="dark" disabled />
+  <link rel="stylesheet" href="lib/themes/buble.css" title="buble" disabled />
+  <link rel="stylesheet" href="lib/themes/pure.css" title="pure" disabled />
+  <style>
+    nav.app-nav li ul {
+      min-width: 100px;
+    }
+  </style>
+</head>

-    <script>
-      ;((window.gitter = {}).chat = {}).options = {
+<body>
+  <div id="app">Loading Docsify e2e tests suite...</div>
+  <script>
+    window.$docsify = {
+      alias: {
+        '.*?/awesome':
+          'https://raw.githubusercontent.com/docsifyjs/awesome-docsify/master/README.md',
+        '.*?/changelog':
+          'https://raw.githubusercontent.com/docsifyjs/docsify/master/CHANGELOG.md',
+        '/.*/_navbar.md': '/_navbar.md',
+        '/zh-cn/(.*)':
+          'https://raw.githubusercontent.com/docsifyjs/docs-zh/master/$1',
+        '/de-de/(.*)':
+          'https://raw.githubusercontent.com/docsifyjs/docs-de/master/$1',
+        '/ru/(.*)':
+          'https://raw.githubusercontent.com/docsifyjs/docs-ru/master/$1',
+        '/es/(.*)':
+          'https://raw.githubusercontent.com/docsifyjs/docs-es/master/$1'
+      },
+      auto2top: true,
+      coverpage: true,
+      executeScript: true,
+      loadSidebar: true,
+      loadNavbar: true,
+      mergeNavbar: true,
+      maxLevel: 4,
+      subMaxLevel: 2,
+      ga: 'UA-106147152-1',
+      matomo: {
+        host: '//matomo.thunderwave.de',
+        id: 6
+      },
+      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) {
+            if (/githubusercontent\.com/.test(vm.route.file)) {
+              url = vm.route.file
+                .replace('raw.githubusercontent.com', 'github.com')
+                .replace(/\/master/, '/blob/master')
+            } else {
+              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' +
+              '<a href="https://docsify.js.org" target="_blank" style="color: inherit; font-weight: normal; text-decoration: none;">Powered by docsify</a>'
+            )
+          })
+        }
+      ]
+    }
+  </script>
+  <script src="lib/docsify.min.js"></script>
+  <script src="lib/plugins/search.min.js"></script>
+  <script src="lib/plugins/ga.min.js"></script>
+  <script src="lib/plugins/matomo.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>
+
+  <script>
+      ; ((window.gitter = {}).chat = {}).options = {
        room: 'docsifyjs/Lobby'
      }
-    </script>
-    <script
-      src="https://sidecar.gitter.im/dist/sidecar.v1.js"
-      async
-      defer
-    ></script>
-  </body>
-</html>
+  </script>
+  <script src="https://sidecar.gitter.im/dist/sidecar.v1.js" async defer></script>
+</body>
+
+</html>
--- a/cypress/integration/sidebar/config.spec.js
+++ b/cypress/integration/sidebar/config.spec.js
@ -157,7 +157,6 @@ context('sidebar.configurations', () => {
    'disqus',
    'gitalk',
    'pagination',
-    'codefund',
    'tabs',
    'more-plugins',
  ];
--- a/docs/README.md
+++ b/docs/README.md
@ -11,7 +11,7 @@ See the [Quick start](quickstart.md) guide for more details.
 ## Features

 - No statically built html files
- Simple and lightweight (~21kB gzipped)
+- Simple and lightweight
 - Smart full-text search plugin
 - Multiple themes
 - Useful plugin API
@ -30,3 +30,9 @@ Please consider donating if you think docsify is helpful to you or that my work
 ## Community

 Users and the development team are usually in the [Gitter chat room](https://gitter.im/docsifyjs/Lobby).
+
+## Special Thanks
+
+_Vercel_ has given us a Pro account.
+
+<a href="https://vercel.com/?utm_source=docsifyjsdocs" target="_blank"><img src="_media/vercel_logo.svg" width="100px"></a>
--- a/docs/_coverpage.md
+++ b/docs/_coverpage.md
@ -4,7 +4,7 @@

 > A magical documentation site generator.

- Simple and lightweight (~21kB gzipped)
+- Simple and lightweight
 - No statically built html files
 - Multiple themes

--- a/docs/_media/vercel_logo.svg
+++ b/docs/_media/vercel_logo.svg
@ -0,0 +1 @@
+<svg width="283" height="64" viewBox="0 0 283 64" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M141.04 16c-11.04 0-19 7.2-19 18s8.96 18 20 18c6.67 0 12.55-2.64 16.19-7.09l-7.65-4.42c-2.02 2.21-5.09 3.5-8.54 3.5-4.79 0-8.86-2.5-10.37-6.5h28.02c.22-1.12.35-2.28.35-3.5 0-10.79-7.96-17.99-19-17.99zm-9.46 14.5c1.25-3.99 4.67-6.5 9.45-6.5 4.79 0 8.21 2.51 9.45 6.5h-18.9zM248.72 16c-11.04 0-19 7.2-19 18s8.96 18 20 18c6.67 0 12.55-2.64 16.19-7.09l-7.65-4.42c-2.02 2.21-5.09 3.5-8.54 3.5-4.79 0-8.86-2.5-10.37-6.5h28.02c.22-1.12.35-2.28.35-3.5 0-10.79-7.96-17.99-19-17.99zm-9.45 14.5c1.25-3.99 4.67-6.5 9.45-6.5 4.79 0 8.21 2.51 9.45 6.5h-18.9zM200.24 34c0 6 3.92 10 10 10 4.12 0 7.21-1.87 8.8-4.92l7.68 4.43c-3.18 5.3-9.14 8.49-16.48 8.49-11.05 0-19-7.2-19-18s7.96-18 19-18c7.34 0 13.29 3.19 16.48 8.49l-7.68 4.43c-1.59-3.05-4.68-4.92-8.8-4.92-6.07 0-10 4-10 10zm82.48-29v46h-9V5h9zM36.95 0L73.9 64H0L36.95 0zm92.38 5l-27.71 48L73.91 5H84.3l17.32 30 17.32-30h10.39zm58.91 12v9.69c-1-.29-2.06-.49-3.2-.49-5.81 0-10 4-10 10V51h-9V17h9v9.2c0-5.08 5.91-9.2 13.2-9.2z" fill="#000"/></svg>
--- a/docs/_navbar.md
+++ b/docs/_navbar.md
@ -3,4 +3,4 @@
  - [:cn: 中文](/zh-cn/)
  - [:de: Deutsch](/de-de/)
  - [:es: Spanish](/es/)
-  - [:ru: Russian](/ru/)
+  - [:ru: Russian](/ru-ru/)
--- a/docs/cover.md
+++ b/docs/cover.md
@ -26,7 +26,7 @@ Set `coverpage` to **true**, and create a `_coverpage.md`:

 > A magical documentation site generator.

- Simple and lightweight (~21kB gzipped)
+- Simple and lightweight
 - No statically built html files
 - Multiple themes

--- a/docs/deploy.md
+++ b/docs/deploy.md
@ -135,3 +135,49 @@ frontend:
 | /<*>.md        | /<*>.md        | 200 (Rewrite) |
 | /<*>.png       | /<*>.png       | 200 (Rewrite) |
 | /<*>           | /index.html    | 200 (Rewrite) |        
+
+
+## Docker
+
+- Create docsify files 
+
+  You need prepare the initial files instead of making in container.  
+  See the [Quickstart](https://docsify.js.org/#/quickstart) section for instructions on how to create these files manually or using [docsify-cli](https://github.com/docsifyjs/docsify-cli).
+
+    ```sh
+    index.html
+    README.md
+    ```
+
+- Create dockerfile
+
+  ```Dockerfile
+    FROM node:latest
+    LABEL description="A demo Dockerfile for build Docsify."
+    WORKDIR /docs
+    RUN npm install -g docsify-cli@latest
+    EXPOSE 3000/tcp
+    ENTRYPOINT docsify serve .
+  
+  ```
+
+  So, current directory structure should be this: 
+
+  ```sh
+   index.html
+   README.md
+   Dockerfile
+  ```
+
+- Build docker image
+
+  ```sh
+  docker build -f Dockerfile -t docsify/demo .
+  ```
+
+- Run docker image
+
+  ```sh
+  docker run -itp 3000:3000 --name=docsify -v $(pwd):/docs docsify/demo 
+  ```
+
--- a/docs/embed-files.md
+++ b/docs/embed-files.md
@ -1,15 +1,16 @@
 # Embed files

 With docsify 4.6 it is now possible to embed any type of file.
+
 You can embed these files as video, audio, iframes, or code blocks, and even Markdown files can even be embedded directly into the document.

-For example, here embedded a Markdown file. You only need to do this:
+For example, here is an embedded Markdown file. You only need to do this:

 ```markdown
 [filename](_media/example.md ':include')
 ```

-Then the content of `example.md` will be displayed directly here
+Then the content of `example.md` will be displayed directly here;

 [filename](_media/example.md ':include')

@ -17,11 +18,13 @@ You can check the original content for [example.md](_media/example.md ':ignore')

 Normally, this will compiled into a link, but in docsify, if you add `:include` it will be embedded.

+External links can be used too - just replace the target. If you want to use a gist URL, see [Embed a gist](#embed-a-gist) section.
+
 ## Embedded file type

-Currently, file extension are automatically recognized and embedded in different ways.
+Currently, file extensions are automatically recognized and embedded in different ways.

-This is a supported embedding type:
+These types are supported:

 * **iframe** `.html`, `.htm`
 * **markdown** `.markdown`, `.md`
@ -29,13 +32,13 @@ This is a supported embedding type:
 * **video** `.mp4`, `.ogg`
 * **code** other file extension

-Of course, you can force the specified. For example, you want to Markdown file as code block embedded.
+Of course, you can force the specified type. For example, a Markdown file can be embedded as a code block by setting `:type=code`.

 ```markdown
 [filename](_media/example.md ':include :type=code')
 ```

-You will get it
+You will get:

 [filename](_media/example.md ':include :type=code')

@ -91,3 +94,78 @@ Embedding any type of source code file, you can specify the highlighted language
 [](_media/example.html ':include :type=code text')

 ?> How to set highlight? You can see [here](language-highlight.md).
+
+## Embed a gist
+
+You can embed a gist as markdown content or as a code block - this is based on the approach at the start of [Embed Files](#embed-files) section, but uses a raw gist URL as the target.
+
+?> **No** plugin or app config change is needed here to make this work. In fact, the "Embed" `script` tag that is copied from a gist will _not_ load even if you make plugin or config changes to allow an external script.
+
+### Identify the gist's metadata
+
+Start by viewing a gist on `gist.github.com`. For the purposes of this guide, we use this gist:
+
+- https://gist.github.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15
+
+Identify the following items from the gist:
+
+Field               | Example                            | Description
+---                 | ---                                | ---
+**Username**        | `anikethsaha`                      | The gist's owner.
+**Gist ID**         | `c2bece08f27c4277001f123898d16a7c` | Identifier for the gist. This is fixed for the gist's lifetime.
+**Filename**        | `content.md`                       | Select a name of a file in the gist. This needed even on a single-file gist for embedding to work.
+
+You will need those to build the _raw gist URL_ for the target file. This has the following format:
+
+- `https://gist.githubusercontent.com/USERNAME/GIST_ID/raw/FILENAME`
+
+Here are two examples based on the sample gist:
+
+- https://gist.githubusercontent.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15/raw/content.md
+- https://gist.githubusercontent.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15/raw/script.js
+
+?> Alternatively, you can get a raw URL directly clicking the _Raw_ button on a gist file. But, if you use that approach, just be sure to **remove** the revision number between `raw/` and the filename so that the URL matches the pattern above instead. Otherwise your embedded gist will **not** show the latest content when the gist is updated.
+
+Continue with one of the sections below to embed the gist on a Docsify page.
+
+### Render markdown content from a gist
+
+This is a great way to embed content **seamlessly** in your docs, without sending someone to an external link. This approach is well-suited to reusing a gist of say installation instructions across doc sites of multiple repos. This approach works equally well with a gist owned by your account or by another user.
+
+Here is the format:
+
+```markdown
+[LABEL](https://gist.githubusercontent.com/USERNAME/GIST_ID/raw/FILENAME ':include')
+```
+
+For example:
+
+```markdown
+[gist: content.md](https://gist.githubusercontent.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15/raw/content.md ':include')
+```
+
+Which renders as:
+
+[gist: content.md](https://gist.githubusercontent.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15/raw/content.md ':include')
+
+The `LABEL` can be any text you want. It acts as a _fallback_ message if the link is broken - so it is useful to repeat the filename here in case you need to fix a broken link. It also makes an embedded element easy to read at a glance.
+
+### Render a codeblock from a gist
+
+The format is the same as the previous section, but with `:type=code` added to the alt text. As with the [Embedded file type](#embedded-file-type) section, the syntax highlighting will be **inferred** from the extension (e.g. `.js` or `.py`), so you can leave the `type` set as `code`.
+ 
+Here is the format:
+
+```markdown
+[LABEL](https://gist.githubusercontent.com/USERNAME/GIST_ID/raw/FILENAME ':include :type=code')
+```
+
+For example:
+
+```markdown
+[gist: script.js](https://gist.githubusercontent.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15/raw/script.js ':include :type=code')
+```
+
+Which renders as:
+
+[gist: script.js](https://gist.githubusercontent.com/anikethsaha/f88893bb563bb7229d6e575db53a8c15/raw/script.js ':include :type=code')
--- a/docs/index.html
+++ b/docs/index.html
@ -2,39 +2,37 @@
 <html lang="en">

 <head>
-  <meta charset="UTF-8">
-  <title>docsify</title>
-  <link rel="icon" href="_media/favicon.ico">
-  <meta name="google-site-verification" content="6t0LoIeFksrjF4c9sqUEsVXiQNxLp2hgoqo0KryT-sE" />
-  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
-  <meta name="keywords" content="doc,docs,documentation,gitbook,creator,generator,github,jekyll,github-pages">
-  <meta name="description" content="A magical documentation generator.">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0">
-  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/vue.css" title="vue">
-  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/dark.css" title="dark" disabled>
-  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/buble.css" title="buble" disabled>
-  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/pure.css" title="pure" disabled>
+	<meta charset="UTF-8">
+	<title>docsify</title>
+	<link rel="icon" href="_media/favicon.ico">
+	<meta name="google-site-verification" content="6t0LoIeFksrjF4c9sqUEsVXiQNxLp2hgoqo0KryT-sE" />
+	<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
+	<meta name="keywords" content="doc,docs,documentation,gitbook,creator,generator,github,jekyll,github-pages">
+	<meta name="description" content="A magical documentation generator.">
+	<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0">
+	<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/vue.css" title="vue">
+	<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/dark.css" title="dark" disabled>
+	<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/buble.css" title="buble" disabled>
+	<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/pure.css" title="pure" disabled>

-  <script src="//cdn.jsdelivr.net/npm/docsify-plugin-codefund/index.js"></script>
-
-  <style>
-    nav.app-nav li ul {
-      min-width: 100px;
-    }
-  </style>
+	<style>
+		nav.app-nav li ul {
+			min-width: 100px;
+		}
+	</style>
 </head>

 <body>
-  <div id="app">Loading ...</div>
-  <script>
-    window.$docsify = {
+	<div id="app">Loading ...</div>
+	<script>
+		window.$docsify = {
      alias: {
        '.*?/awesome': 'https://raw.githubusercontent.com/docsifyjs/awesome-docsify/master/README.md',
        '.*?/changelog': 'https://raw.githubusercontent.com/docsifyjs/docsify/master/CHANGELOG.md',
        '/.*/_navbar.md': '/_navbar.md',
        '/zh-cn/(.*)': 'https://cdn.jsdelivr.net/gh/docsifyjs/docs-zh@master/$1',
        '/de-de/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-de/master/$1',
-        '/ru/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-ru/master/$1',
+        '/ru-ru/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-ru/master/$1',
        '/es/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-es/master/$1'
      },
      auto2top: true,
@ -80,14 +78,18 @@
              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'
              + '<a href="https://docsify.js.org" target="_blank" style="color: inherit; font-weight: normal; text-decoration: none;">Powered by docsify</a>'
+          }),
+          hook.afterEach(function (html){
+            if(vm.route.path === '/'){
+              return html
+            }
+            return `${html}<br/> <i>Vercel</i> has given us a Pro account <br/> <a href="https://vercel.com/?utm_source=docsifyjsdocs" target="_blank"><img src="_media/vercel_logo.svg" alt="Vercel" width="100" height="64"></a>`
          })
-        },
-        DocsifyCodefund.create('fae1f9a4-870c-4c25-b8e0-c80464f7a95c')
+        }
      ]
    }
  </script>
--- a/docs/more-pages.md
+++ b/docs/more-pages.md
@ -51,6 +51,18 @@ Create the `_sidebar.md`:

 You need to create a `.nojekyll` in `./docs` to prevent GitHub Pages from ignoring files that begin with an underscore.

+!> Docsify only looks for `_sidebar.md` in the current folder, and uses that, otherwise it falls back to the one configured using `window.$docsify.loadSidebar` config.
+
+Example file structure:
+
+```text
+└── docs/
+    ├── _sidebar.md
+    ├── index.md
+    ├── getting-started.md
+    └── running-services.md
+```
+
 ## Nested Sidebars

 You may want the sidebar to update with only navigation to reflect the current directory. This can be done by adding a `_sidebar.md` file to each folder.
--- a/docs/plugins.md
+++ b/docs/plugins.md
@ -168,22 +168,6 @@ Pagination for docsify. By [@imyelo](https://github.com/imyelo)
 <script src="//cdn.jsdelivr.net/npm/docsify-pagination/dist/docsify-pagination.min.js"></script>
 ```

-## codefund
-
-a [plugin](https://github.com/njleonzhang/docsify-plugin-codefund) to make it easy to join up [codefund](https://codefund.io/)
-
-> codefund is formerly known as "codesponsor"
-
-```
-<script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script>
-
-window.$docsify = {
-  plugins: [
-    DocsifyCodefund.create('xxxx-xxx-xxx') // change to your codefund id
-  ]
-}
-```
-
 ## Tabs

 A docsify.js plugin for displaying tabbed content from markdown.
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@ -47,7 +47,7 @@ If you don't like `npm` or have trouble installing the tool, you can manually cr
  <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/themes/vue.css">
+  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@4/themes/vue.css" />
 </head>
 <body>
  <div id="app"></div>
@ -56,11 +56,31 @@ If you don't like `npm` or have trouble installing the tool, you can manually cr
      //...
    }
  </script>
-  <script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script>
+  <script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
 </body>
 </html>
 ```

+### Specifying docsify versions
+
+?> Note that in both of the examples below, docsify URLs will need to be manually updated when a new major version of docsify is released (e.g. `v4.x.x` => `v5.x.x`). Check the docsify website periodically to see if a new major version has been released.
+
+Specifying a major version in the URL (`@4`) will allow your site will receive non-breaking enhancements (i.e. "minor" updates) and bug fixes (i.e. "patch" updates) automatically. This is the recommended way to load docsify resources.
+
+```html
+<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@4/themes/vue.css" />
+<script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
+```
+
+If you prefer to lock docsify to a specific version, specify the full version after the `@` symbol in the URL. This is the safest way to ensure your site will look and behave the same way regardless of any changes made to future versions of docsify.
+
+```html
+<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@4.11.4/themes/vue.css">
+<script src="//cdn.jsdelivr.net/npm/docsify@4.11.4"></script>
+```
+
+### Manually preview your site
+
 If you installed python on your system, you can easily use it to run a static server to preview your site.

 ```bash
@ -72,17 +92,17 @@ cd docs && python -m SimpleHTTPServer 3000
 If you want, you can show a loading dialog before docsify starts to render your documentation:

 ```html
-  <!-- index.html -->
+<!-- index.html -->

-  <div id="app">Please wait...</div>
+<div id="app">Please wait...</div>
 ```

 You should set the `data-app` attribute if you changed `el`:

 ```html
-  <!-- index.html -->
+<!-- index.html -->

-  <div data-app id="main">Please wait...</div>
+<div data-app id="main">Please wait...</div>

  <script>
    window.$docsify = {
--- a/index.html
+++ b/index.html
@ -26,7 +26,7 @@
        '/.*/_navbar.md': '/_navbar.md',
        '/zh-cn/(.*)': 'https://cdn.jsdelivr.net/gh/docsifyjs/docs-zh@master/$1',
        '/de-de/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-de/master/$1',
-        '/ru/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-ru/master/$1',
+        '/ru-ru/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-ru/master/$1',
        '/es/(.*)': 'https://raw.githubusercontent.com/docsifyjs/docs-es/master/$1'
      },
      auto2top: true,
--- a/src/core/render/tpl.js
+++ b/src/core/render/tpl.js
@ -1,4 +1,3 @@
-import { isMobile } from '../util/env';
 /**
 * Render github corner
 * @param  {Object} data URL for the View Source on Github link
@ -51,9 +50,8 @@ export function main(config) {
      : '') +
    '<div class="sidebar-nav"><!--sidebar--></div>' +
    '</aside>';
-
  return (
-    (isMobile ? `${aside}<main>` : `<main>${aside}`) +
+    `<main>${aside}` +
    '<section class="content">' +
    '<article class="markdown-section" id="main"><!--main--></article>' +
    '</section>' +
@ -74,8 +72,8 @@ export function cover() {

  return (
    `<section class="cover show" style="background: ${bgc}">` +
-    '<div class="cover-main"><!--cover--></div>' +
    '<div class="mask"></div>' +
+    '<div class="cover-main"><!--cover--></div>' +
    '</section>'
  );
 }
--- a/src/plugins/search/search.js
+++ b/src/plugins/search/search.js
@ -56,6 +56,7 @@ function getAllPaths(router) {

 function getTableData(token) {
  if (!token.text && token.type === 'table') {
+    token.cells.unshift(token.header);
    token.text = token.cells
      .map(function(rows) {
        return rows.join(' | ');
--- a/src/themes/basic/_coverpage.styl
+++ b/src/themes/basic/_coverpage.styl
@ -22,6 +22,7 @@ section.cover
    flex 1
    margin -20px 16px 0
    text-align center
+    position: relative

  a
    color inherit
				`@ -0,0 +1 @@`
				<svg width="283" height="64" viewBox="0 0 283 64" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M141.04 16c-11.04 0-19 7.2-19 18s8.96 18 20 18c6.67 0 12.55-2.64 16.19-7.09l-7.65-4.42c-2.02 2.21-5.09 3.5-8.54 3.5-4.79 0-8.86-2.5-10.37-6.5h28.02c.22-1.12.35-2.28.35-3.5 0-10.79-7.96-17.99-19-17.99zm-9.46 14.5c1.25-3.99 4.67-6.5 9.45-6.5 4.79 0 8.21 2.51 9.45 6.5h-18.9zM248.72 16c-11.04 0-19 7.2-19 18s8.96 18 20 18c6.67 0 12.55-2.64 16.19-7.09l-7.65-4.42c-2.02 2.21-5.09 3.5-8.54 3.5-4.79 0-8.86-2.5-10.37-6.5h28.02c.22-1.12.35-2.28.35-3.5 0-10.79-7.96-17.99-19-17.99zm-9.45 14.5c1.25-3.99 4.67-6.5 9.45-6.5 4.79 0 8.21 2.51 9.45 6.5h-18.9zM200.24 34c0 6 3.92 10 10 10 4.12 0 7.21-1.87 8.8-4.92l7.68 4.43c-3.18 5.3-9.14 8.49-16.48 8.49-11.05 0-19-7.2-19-18s7.96-18 19-18c7.34 0 13.29 3.19 16.48 8.49l-7.68 4.43c-1.59-3.05-4.68-4.92-8.8-4.92-6.07 0-10 4-10 10zm82.48-29v46h-9V5h9zM36.95 0L73.9 64H0L36.95 0zm92.38 5l-27.71 48L73.91 5H84.3l17.32 30 17.32-30h10.39zm58.91 12v9.69c-1-.29-2.06-.49-3.2-.49-5.81 0-10 4-10 10V51h-9V17h9v9.2c0-5.08 5.91-9.2 13.2-9.2z" fill="#000"/></svg>