chore: add changelog 4.5.9

There's nothing fancy on this commit

CHANGELOG.md

@@ -1,3 +1,67 @@
+<a name="4.5.9"></a>
+## [4.5.9](https://github.com/QingWei-Li/docsify/compare/v4.5.8...v4.5.9) (2018-02-07)
+
+
+### Bug Fixes
+
+* upgrade marked ([4157173](https://github.com/QingWei-Li/docsify/commit/4157173))
+
+
+
+<a name="4.5.8"></a>
+## [4.5.8](https://github.com/QingWei-Li/docsify/compare/v4.5.6...v4.5.8) (2018-02-07)
+
+
+### Bug Fixes
+
+* cover style, fixed [#381](https://github.com/QingWei-Li/docsify/issues/381) ([368754e](https://github.com/QingWei-Li/docsify/commit/368754e))
+* updated deps ([#337](https://github.com/QingWei-Li/docsify/issues/337)) ([a12d393](https://github.com/QingWei-Li/docsify/commit/a12d393))
+
+<a name="4.5.7"></a>
+## [4.5.7](https://github.com/QingWei-Li/docsify/compare/v4.5.6...v4.5.7) (2017-12-29)
+
+
+### Features
+
+* add navigation plugin, closed [#180](https://github.com/QingWei-Li/docsify/issues/180) ([f78be4c](https://github.com/QingWei-Li/docsify/commit/f78be4c))
+
+
+
+<a name="4.5.6"></a>
+## [4.5.6](https://github.com/QingWei-Li/docsify/compare/v4.5.3...v4.5.6) (2017-12-14)
+
+
+### Bug Fixes
+
+* **style:** increase the tap targets of menu button, fixed [#325](https://github.com/QingWei-Li/docsify/issues/325) ([888f217](https://github.com/QingWei-Li/docsify/commit/888f217))
+
+
+
+<a name="4.5.5"></a>
+## [4.5.5](https://github.com/QingWei-Li/docsify/compare/v4.5.4...v4.5.5) (2017-11-30)
+
+
+### Bug Fixes
+
+* disqus plugin issue ([#318](https://github.com/QingWei-Li/docsify/issues/318)) ([041b33e](https://github.com/QingWei-Li/docsify/commit/041b33e)), closes [#317](https://github.com/QingWei-Li/docsify/issues/317)
+
+
+
+<a name="4.5.4"></a>
+## [4.5.4](https://github.com/QingWei-Li/docsify/compare/v4.5.2...v4.5.4) (2017-11-29)
+
+
+### Bug Fixes
+
+* **compiler:** task lists style, fixed [#215](https://github.com/QingWei-Li/docsify/issues/215) ([e43ded4](https://github.com/QingWei-Li/docsify/commit/e43ded4))
+
+
+### Features
+
+* add gitalk plugin ([#306](https://github.com/QingWei-Li/docsify/issues/306)) ([9208e64](https://github.com/QingWei-Li/docsify/commit/9208e64))
+
+
+
 <a name="4.5.3"></a>
 ## [4.5.3](https://github.com/QingWei-Li/docsify/compare/v4.5.2...v4.5.3) (2017-11-11)
 
@@ -360,7 +424,7 @@
 
 ### Bug Fixes
 
-* **render:** ubtitle in side bar shows undefined, fixed [#182](https://github.com/QingWei-Li/docsify/issues/182) ([d087d57](https://github.com/QingWei-Li/docsify/commit/d087d57))
+* **render:** subtitle in side bar shows undefined, fixed [#182](https://github.com/QingWei-Li/docsify/issues/182) ([d087d57](https://github.com/QingWei-Li/docsify/commit/d087d57))
 
 
 

HISTORY.md

@@ -205,7 +205,7 @@
 ### Bug Fixes
 
 * **render:** custom cover background image ([8f9bf29](https://github.com/QingWei-Li/docsify/commit/8f9bf29))
-* **search:** dont search nameLink, fixed [#102](https://github.com/QingWei-Li/docsify/issues/102) ([507d9e8](https://github.com/QingWei-Li/docsify/commit/507d9e8))
+* **search:** don't search nameLink, fixed [#102](https://github.com/QingWei-Li/docsify/issues/102) ([507d9e8](https://github.com/QingWei-Li/docsify/commit/507d9e8))
 * **tpl:** extra character, fixed [#101](https://github.com/QingWei-Li/docsify/issues/101) ([d67d25f](https://github.com/QingWei-Li/docsify/commit/d67d25f))
 
 

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2016 - 2017 cinwell.li
+Copyright (c) 2016 - present cinwell.li
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <a href="https://docsify.js.org">
-    <img alt="docsify" src="./media/docsify.png">
+    <img alt="docsify" src="./docs/_media/icon.svg">
   </a>
 </p>
 
@@ -11,98 +11,58 @@
 <p align="center">
   <a href="https://travis-ci.org/QingWei-Li/docsify"><img alt="Travis Status" src="https://img.shields.io/travis/QingWei-Li/docsify/master.svg?style=flat-square"></a>
   <a href="https://www.npmjs.com/package/docsify"><img alt="npm" src="https://img.shields.io/npm/v/docsify.svg?style=flat-square"></a>
-  <a href="https://cdnjs.com/libraries/docsify"><img alt="cdnjs" src="https://img.shields.io/cdnjs/v/docsify.svg?style=flat-square"></a>
+  <a href="https://discord.gg/Yu2vxQ5"><img src="https://img.shields.io/badge/chat-on%20discord-7289da.svg?style=flat-square" alt="Chat"></a>
   <a href="https://github.com/QingWei-Li/donate"><img alt="donate" src="https://img.shields.io/badge/%24-donate-ff69b4.svg?style=flat-square"></a>
 </p>
 
-
-<a target='_blank' rel='nofollow' href='https://app.codesponsor.io/link/YdWAqnN2kHQmLtFQhEddaaPT/QingWei-Li/docsify'>  <img alt='Sponsor' width='888' height='68' src='https://app.codesponsor.io/embed/YdWAqnN2kHQmLtFQhEddaaPT/QingWei-Li/docsify.svg' /></a>
-
+<p align="center">Glod Sponsor via <a href="https://opencollective.com/docsify">Open Collective</a></p>
+<p align="center">
+<a href="https://opencollective.com/docsify/tiers/gold-sponsor/website">
+<img src="https://opencollective.com/docsify/tiers/gold-sponsor.svg?avatarHeight=36">
+</a>
+</p>
 
 ## Links
 
-- [Documentation](https://docsify.js.org)
-- [CLI](https://github.com/QingWei-Li/docsify-cli)
-- CDN: [UNPKG](https://unpkg.com/docsify/) | [jsDelivr](https://cdn.jsdelivr.net/npm/docsify/)
+* [Documentation](https://docsify.js.org)
+* [CLI](https://github.com/QingWei-Li/docsify-cli)
+* CDN: [UNPKG](https://unpkg.com/docsify/) | [jsDelivr](https://cdn.jsdelivr.net/npm/docsify/) | [cdnjs](https://cdnjs.com/libraries/docsify)
+* [Awesome docsify](https://github.com/QingWei-Li/awesome-docsify)
 
 ## Features
 
-- No statically built html files
-- Simple and lightweight (~18kB gzipped)
-- Smart full-text search plugin
-- Multiple themes
-- Useful plugin API
-- Compatible with IE10+
-- Support SSR ([example](https://github.com/QingWei-Li/docsify-ssr-demo))
+* No statically built html files
+* Simple and lightweight (~18kB gzipped)
+* Smart full-text search plugin
+* Multiple themes
+* Useful plugin API
+* Compatible with IE10+
+* Support SSR ([example](https://github.com/QingWei-Li/docsify-ssr-demo))
 
 ## Quick start
 
-Create an `index.html`.
-
-```html
-<!-- index.html -->
-
-<!DOCTYPE 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>
-<body>
-  <div id="app"></div>
-  <script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script>
-</body>
-</html>
-```
-
-## Browser Support
-
-Modern browsers and Internet Explorer 10+.
+Look at [this tutorial](https://docsify.js.org/#/quickstart) or [online demo](https://jsfiddle.net/7ztb8qsr/1/).
 
 ## Showcase
 
 These projects are using docsify to generate their sites. Pull requests welcome :blush:
 
-| Project | Description |
-|---|---|
-| [Snipaste](https://docs.snipaste.com/) | Snip & Paste |
-| [puck](https://puck.zz173.com/) | A small & magical php framework. |
-| [Samaritan](http://samaritan.stockdb.org) | An Algorithmic Trading Framework for Digital Currency. |
-| [Vudash](http://vudash.github.io/vudash/) | Powerful, Flexible, Open Source dashboards for anything |
-| [Trilogy](http://trilogy.js.org) | No-hassle SQLite with a Promise-based, document store style API. |
-| [Mybatis-Plus](http://mp.baomidou.com/) | An enhanced toolkit of Mybatis to simplify development |
-| [JS MythBusters](https://mythbusters.js.org) | An optimization handbook from a high level point of view. |
-| [hire-me](https://fvcproductions.github.io/hire-me) | A path to getting an awesome tech gig. |
-| [vue-amap](https://elemefe.github.io/vue-amap/) | A Map Component Library Base on Vue 2.x and Gaode Map. |
-| [samlify](https://samlify.js.org) | Node.js SAML2 library |
-| [palettify](https://dobromir-hristov.github.io/palettify/) | A color palette effects assistant |
-| [commitlint](https://marionebl.github.io/commitlint/) | Lint commit messages |
-| [vue-data-tables](https://github.com/njleonzhang/vue-data-tables/) | A simple and customizable data table，based on vue2 and element-ui. |
-| [Noty](http://ned.im/noty/) | A Dependency-free notification library |
-| [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. |
+Move to [awesome-docsify](https://github.com/QingWei-Li/awesome-docsify)
 
 ## Similar projects
 
-| Project | Description |
-|---|---|
-| [docute](https://github.com/egoist/docute) | 📜 Effortlessly documentation done right |
-| [docpress](https://github.com/docpress/docpress) | Documentation website generator |
+| Project                                          | Description                              |
+| ------------------------------------------------ | ---------------------------------------- |
+| [docute](https://github.com/egoist/docute)       | 📜 Effortlessly documentation done right |
+| [docpress](https://github.com/docpress/docpress) | Documentation website generator          |
 
 ## Contributing
 
-- Fork it!
-- Create your feature branch: `git checkout -b my-new-feature`
-- Commit your changes: `git commit -am 'Add some feature'`
-- Push to the branch: `git push origin my-new-feature`
-- Submit a pull request
-
+* Fork it!
+* Create your feature branch: `git checkout -b my-new-feature`
+* Commit your changes: `git commit -am 'Add some feature'`
+* Push to the branch: `git push origin my-new-feature`
+* Submit a pull request
 
 ## Development
 
@@ -111,9 +71,29 @@ npm run bootstrap && npm run dev
 open http://localhost:3000
 ```
 
+## Backers
+
+Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/docsify#backers)]
+
+<a href="https://opencollective.com/docsify#backers" target="_blank"><img src="https://opencollective.com/docsify/backers.svg?width=890"></a>
+
+## Sponsors
+
+Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/docsify#silver-sponsors)]
+
+<a href="https://opencollective.com/docsify/silver-sponsors/0/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/0/avatar.svg"></a>
+<a href="https://opencollective.com/docsify/silver-sponsors/1/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/1/avatar.svg"></a>
+<a href="https://opencollective.com/docsify/silver-sponsors/2/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/2/avatar.svg"></a>
+<a href="https://opencollective.com/docsify/silver-sponsors/3/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/3/avatar.svg"></a>
+<a href="https://opencollective.com/docsify/silver-sponsors/4/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/4/avatar.svg"></a>
+<a href="https://opencollective.com/docsify/silver-sponsors/5/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/5/avatar.svg"></a>
+<a href="https://opencollective.com/docsify/silver-sponsors/6/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/6/avatar.svg"></a>
+<a href="https://opencollective.com/docsify/silver-sponsors/7/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/7/avatar.svg"></a>
+<a href="https://opencollective.com/docsify/silver-sponsors/8/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/8/avatar.svg"></a>
+<a href="https://opencollective.com/docsify/silver-sponsors/9/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/9/avatar.svg"></a>
+
 ## License
 
 MIT
 
 [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2FQingWei-Li%2Fdocsify.svg?type=large)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2FQingWei-Li%2Fdocsify?ref=badge_large)
-

build/build.js

@@ -48,7 +48,6 @@ 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: 'disqus', entry: 'disqus.js' },
   { name: 'gitalk', entry: 'gitalk.js' }
 ]

docs/_coverpage.md

@@ -1,6 +1,6 @@
 ![logo](_media/icon.svg)
 
-# docsify <small>4.5.3</small>
+# docsify <small>4.5.9</small>
 
 > A magical documentation site generator.
 

docs/_sidebar.md

@@ -20,4 +20,5 @@
   - [Offline Mode(PWA)](pwa.md)
   - [Server-client renderer(SSR)](ssr.md)
 
+- [Awesome docsify](awesome.md)
 - [Changelog](changelog.md)

docs/configuration.md

@@ -257,7 +257,8 @@ window.$docsify = {
   alias: {
     '/foo/(+*)': '/bar/$1', // supports regexp
     '/zh-cn/changelog': '/changelog',
-    '/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG'
+    '/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG',
+    '/.*/_sidebar.md': '/_sidebar.md' // See #301
   }
 }
 ```
@@ -342,7 +343,7 @@ window.$docsify = {
 ## external-link-target
 
 - type: `String`
-- default: `_self`
+- default: `_blank`
 
 Target to open external links. Default `'_blank'` (new window/tab)
 

docs/de-de/_sidebar.md

@@ -20,4 +20,5 @@
   - [Offline Modus (PWA)](de-de/pwa.md)
   - [Server-client renderer (SSR)](de-de/ssr.md)
 
+- [Awesome docsify](de-de/awesome.md)
 - [Changelog](de-de/changelog.md)

docs/de-de/configuration.md

@@ -257,7 +257,8 @@ window.$docsify = {
   alias: {
     '/foo/(+*)': '/bar/$1', // supports regexp
     '/zh-cn/changelog': '/changelog',
-    '/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG'
+    '/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG',
+    '/.*/_sidebar.md': '/_sidebar.md' // See #301
   }
 }
 ```

docs/de-de/more-pages.md

@@ -53,6 +53,19 @@ Als Zweites erstellst du eine Datei namens `_sidebar.md`:
 
 `_sidebar.md` wird in jedem Verzeichnislevel geladen. Sollte das aktuelle Verzeichnis keine Datei namens `_sidebar.md` haben, so sucht **docsify** in den übergeordneten Ordnern. Wenn du z.B. im Moment im Verzeichnis `/guide/quick-start` bist,  so wird `_sidebar.md` von der Datei `/guide/_sidebar.md` geladen.
 
+You can specify `alias` to avoid unnecessary fallback.
+
+```html
+<script>
+  window.$docsify = {
+    loadSidebar: true,
+    alias: {
+      '/.*/_sidebar.md': '/_sidebar.md'
+    }
+  }
+</script>
+```
+
 ## Inhaltsverzeichnis
 
 Eine angepasste Seitenleist kann auch automatisch ein Inhaltsverzeichnis generieren, indem ein `subMaxLevel` gesetzt wird, vergleiche [sub-max-level Einstellungen](configuration.md#sub-max-level).

docs/de-de/plugins.md

@@ -103,22 +103,81 @@ Exclude the special image
 ![](image.png ':no-zoom')
 ```
 
+## Demo code with instant preview and jsfiddle integration
+
+With this plugin, sample code can be rendered on the page instantly, so that the readers can see the preview immediately.
+When readers expand the demo box, the source code and description are shown there. if they click the button `Try in Jsfiddle`,
+`jsfiddle.net` will be open with the code of this sample, which allow readers to revise the code and try on their own.
+
+[Vue](https://njleonzhang.github.io/docsify-demo-box-vue/) and [React](https://njleonzhang.github.io/docsify-demo-box-react/) are both supported.
+
+
 ## 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)
+Add `Edit on github` button on every pages. Provided by [@njleonzhang](https://github.com/njleonzhang), check [document](https://github.com/njleonzhang/docsify-edit-on-github)
+
+## Copy to Clipboard
+
+Add a simple `Click to copy` button to all preformatted code blocks to effortlessly allow users to copy example code from your docs. Provided by [@jperasmus](https://github.com/jperasmus)
+
+```html
+<link rel="stylesheet" href="//unpkg.com/docsify-copy-code/styles.css">
+<script src="//unpkg.com/docsify-copy-code/index.js"></script>
+```
+
+```javascript
+window.$docsify = {
+  plugins: [
+    window.DocsifyCopyCodePlugin.init()
+  ]
+}
+```
+
+See [here](https://github.com/jperasmus/docsify-copy-code/blob/master/README.md) for more details.
 
 
-## CodeSponsor
 
-See https://codesponsor.io
+## Disqus
 
+Disqus comments. https://disqus.com/
 
 ```html
 <script>
   window.$docsify = {
-    codesponsor: 'id'
+    disqus: 'shortname'
   }
 </script>
-<script src="//unpkg.com/docsify/lib/plugins/codesponsor.min.js"></script>
+<script src="//unpkg.com/docsify/lib/plugins/disqus.min.js"></script>
 ```
 
+
+## Gitalk
+
+[Gitalk](https://github.com/gitalk/gitalk) is a modern comment component based on Github Issue and Preact. 
+
+```html
+<link rel="stylesheet" href="//unpkg.com/gitalk/dist/gitalk.css">
+
+<script src="//unpkg.com/docsify/lib/plugins/gitalk.min.js"></script>
+<script src="//unpkg.com/gitalk/dist/gitalk.min.js"></script>
+<script>
+  const gitalk = new Gitalk({
+    clientID: 'Github Application Client ID',
+    clientSecret: 'Github Application Client Secret',
+    repo: 'Github repo',
+    owner: 'Github repo owner',
+    admin: ['Github repo collaborators, only these guys can initialize github issues'],
+    // facebook-like distraction free mode
+    distractionFreeMode: false
+  })
+</script>
+```
+
+## Navigation
+
+Pagination for docsify. By [@imyelo](https://github.com/imyelo)
+
+```html
+<script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
+<script src="//unpkg.com/docsify-pagination/dist/docsify-pagination.min.js"></script>
+```

docs/de-de/quickstart.md

@@ -51,8 +51,13 @@ Wenn du `npm` nicht verwenden möchtest, oder Probleme bei der Installation des
 </head>
 <body>
   <div id="app"></div>
+  <script>
+    window.$docsify = {
+      //...
+    }
+  </script>
+  <script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
 </body>
-<script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
 </html>
 ```
 

docs/deploy.md

@@ -15,6 +15,7 @@ It is recommended that you save your files to the `./docs` subfolder of the `mas
 ![github pages](_images/deploy-github-pages.png)
 
 !> You can also save files in the root directory and select `master branch`.
+You'll need to place a `.nojekyll` file in the deploy location (such as `/docs` or the gh-pages branch
 
 ## GitLab Pages
 
@@ -38,6 +39,28 @@ pages:
 
 !> You can replace script with `- cp -r docs/. public`, if `./docs` is your Docsify subfolder.
 
+## Firebase Hosting
+
+!> You'll need to install the Firebase CLI using `npm i -g firebase-tools` after signing into the [Firebase Console](https://console.firebase.google.com) using a Google Account.  
+
+Using Terminal determine and navigate to the directory for your Firebase Project - this could be `~/Projects/Docs` etc. From there, run `firebase init`, choosing `Hosting` from the menu (use **space** to select, **arrow keys** to change options and **enter** to confirm). Follow the setup instructions.
+
+You should have your `firebase.json` file looking similar to this (I changed the deployment directory from `public` to `site`):
+```json
+{
+  "hosting": {
+    "public": "site",
+    "ignore": [
+      "firebase.json",
+      "**/.*",
+      "**/node_modules/**"
+    ]
+  }
+}
+```
+
+Once finished, build the starting template by running `docsify init ./site` (replacing site with the deployment directory you determined when running `firebase init` - public by default). Add/edit the documentation, then run `firebase deploy` from the base project directory.
+
 ## VPS
 
 Try following nginx config.

docs/helpers.md

@@ -78,7 +78,7 @@ You will get `<a href="/demo/">link</a>`html. Do not worry, you can still set ti
 * [ ] foo
  * bar
  * [x] baz
- * [] bam
+ * [ ] bam
    * [ ] bim
    * [ ] lim
 

docs/index.html

@@ -23,7 +23,8 @@
   <script>
     window.$docsify = {
       alias: {
-        '.*?/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG',
+        '.*?/awesome': 'https://raw.githubusercontent.com/QingWei-Li/awesome-docsify/master/README.md',
+        '.*?/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG.md',
         '/.*/_navbar.md': '/_navbar.md'
       },
       auto2top: true,
@@ -34,7 +35,6 @@
       mergeNavbar: true,
       maxLevel: 4,
       subMaxLevel: 2,
-      codesponsor: '7c9Ms7xRs-j_y_8abU03DA',
       ga: 'UA-106147152-1',
       name: 'docsify',
       search: {
@@ -56,7 +56,7 @@
           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'
@@ -69,7 +69,6 @@
   </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>

docs/more-pages.md

@@ -23,9 +23,9 @@ docs/zh-cn/README.md  => http://domain.com/zh-cn/
 docs/zh-cn/guide.md   => http://domain.com/zh-cn/guide
 ```
 
-## Custom sidebar
+## Sidebar
 
-By default, the table of contents in the sidebar is automatically generated based on your markdown files. If you need a custom sidebar, then you can create your own `_sidebar.md` (see [this documentation's sidebar](https://github.com/QingWei-Li/docsify/blob/master/docs/_sidebar.md) for an example):
+In order to have sidebar, then you can create your own `_sidebar.md` (see [this documentation's sidebar](https://github.com/QingWei-Li/docsify/blob/master/docs/_sidebar.md) for an example):
 
 First, you need to set `loadSidebar` to **true**. Details are available in the [configuration paragraph](configuration.md#load-sidebar).
 
@@ -49,12 +49,27 @@ Create the `_sidebar.md`:
 - [Guide](guide.md)
 ```
 
-!> You need to create a `.nojekyll` in `./docs` to prevent GitHub Pages from ignoring files that begin with an underscore.
+You need to create a `.nojekyll` in `./docs` to prevent GitHub Pages from ignoring files that begin with an underscore.
 
 `_sidebar.md` is loaded from each level directory. If the current directory doesn't have `_sidebar.md`, it will fall back to the parent directory. If, for example, the current path is `/guide/quick-start`,  the `_sidebar.md` will be loaded from `/guide/_sidebar.md`.
 
+You can specify `alias` to avoid unnecessary fallback.
+
+```html
+<script>
+  window.$docsify = {
+    loadSidebar: true,
+    alias: {
+      '/.*/_sidebar.md': '/_sidebar.md'
+    }
+  }
+</script>
+```
+
 ## Table of Contents
 
+Once you've created `_sidebar.md`, the sidebar content is automatically generated based on the headers in the markdown files.
+
 A custom sidebar can also automatically generate a table of contents by setting a `subMaxLevel`, compare [sub-max-level configuration](configuration.md#sub-max-level).
 
 ```html

docs/plugins.md

@@ -106,7 +106,7 @@ Exclude the special image
 
 ## 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)
+Add `Edit on github` button on every pages. Provided by [@njleonzhang](https://github.com/njleonzhang), check [document](https://github.com/njleonzhang/docsify-edit-on-github)
 
 ## Demo code with instant preview and jsfiddle integration
 
@@ -116,22 +116,10 @@ When readers expand the demo box, the source code and description are shown ther
 
 [Vue](https://njleonzhang.github.io/docsify-demo-box-vue/) and [React](https://njleonzhang.github.io/docsify-demo-box-react/) are both supported.
 
-## CodeSponsor
-
-See https://codesponsor.io
-
-```html
-<script>
-  window.$docsify = {
-    codesponsor: 'id'
-  }
-</script>
-<script src="//unpkg.com/docsify/lib/plugins/codesponsor.min.js"></script>
-```
 
 ## Copy to Clipboard
 
-Add a simple `Click to copy` button to all preformatted code blocks to effortlessly allow users to copy example code from your docs.
+Add a simple `Click to copy` button to all preformatted code blocks to effortlessly allow users to copy example code from your docs. Provided by [@jperasmus](https://github.com/jperasmus)
 
 ```html
 <link rel="stylesheet" href="//unpkg.com/docsify-copy-code/styles.css">
@@ -164,7 +152,7 @@ Disqus comments. https://disqus.com/
 
 ## Gitalk
 
-Gitalk is a modern comment component based on Github Issue and Preact. https://github.com/gitalk/gitalk
+[Gitalk](https://github.com/gitalk/gitalk) is a modern comment component based on Github Issue and Preact. 
 
 ```html
 <link rel="stylesheet" href="//unpkg.com/gitalk/dist/gitalk.css">
@@ -182,4 +170,14 @@ Gitalk is a modern comment component based on Github Issue and Preact. https://g
     distractionFreeMode: false
   })
 </script>
-```
+```
+
+## Navigation
+
+Pagination for docsify. By [@imyelo](https://github.com/imyelo)
+
+```html
+<script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
+<script src="//unpkg.com/docsify-pagination/dist/docsify-pagination.min.js"></script>
+```
+

docs/quickstart.md

@@ -51,8 +51,13 @@ If you don't like `npm` or have trouble installing the tool, you can manually cr
 </head>
 <body>
   <div id="app"></div>
+  <script>
+    window.$docsify = {
+      //...
+    }
+  </script>
+  <script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
 </body>
-<script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
 </html>
 ```
 

docs/ssr.md

@@ -30,7 +30,7 @@ Edit `package.json`. If the documentation in `./docs` subdirectory.
   ],
   "docsify": {
     "config": {
-      "basePath": 'https://docsify.js.org/',
+      "basePath": "https://docsify.js.org/",
       "loadSidebar": true,
       "loadNavbar": true,
       "coverpage": true,
@@ -60,7 +60,7 @@ Now, You have a support for SSR the docs site.
 
 ## Custom template
 
-You can provide a templte for entire page's HTML. such as
+You can provide a template for entire page's HTML. such as
 
 ```html
 <!DOCTYPE html>
@@ -74,12 +74,12 @@ You can provide a templte for entire page's HTML. such as
 <body>
   <!--inject-app-->
   <!--inject-config-->
+  <script src="//unpkg.com/docsify/lib/docsify.js"></script>
+  <script src="//unpkg.com/docsify/lib/plugins/search.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>
-<script src="//unpkg.com/docsify/lib/docsify.js"></script>
-<script src="//unpkg.com/docsify/lib/plugins/search.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>
 </html>
 ```
 
@@ -94,6 +94,7 @@ You can configure it in a special config file, or `package.json`.
 ```js
 module.exports = {
   template: './ssr.html',
+  maxAge: 60 * 60 * 1000, // lru-cache config
   config: {
    // docsify config
   }

docs/zh-cn/_sidebar.md

@@ -20,4 +20,5 @@
  - [离线模式(PWA)](zh-cn/pwa.md)
   - [服务端渲染 (SSR)](zh-cn/ssr.md)
 
+- [Awesome docsify](zh-cn/awesome.md)
 - [Changelog](zh-cn/changelog.md)

docs/zh-cn/configuration.md

@@ -266,7 +266,8 @@ window.$docsify = {
   alias: {
     '/foo/(+*)': '/bar/$1', // supports regexp
     '/zh-cn/changelog': '/changelog',
-    '/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG'
+    '/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG',
+    '/.*/_sidebar.md': '/_sidebar.md' // See #301
   }
 }
 ```
@@ -329,7 +330,7 @@ window.$docsify = {
 
 ## format-updated
 
-我们可以显示文档更新日期通过 **{docsify-updated<span>}</span>** 变量. 并且格式化日期通过 `formatUpdated`.
+我们可以显示文档更新日期通过 **{docsify-updated<span>}</span>** 变量. 并且格式化日期通过 `formatUpdated`。
 参考 https://github.com/lukeed/tinydate#patterns
 ```js
 window.$docsify = {
@@ -345,7 +346,7 @@ window.$docsify = {
 
 ## external-link-target
 
-Currently it defaults to _blank, would be nice if configurable:
+当前默认为 _blank, 配置一下就可以：
 
 ```js
 window.$docsify = {
@@ -356,10 +357,10 @@ window.$docsify = {
 
 ## noCompileLinks
 
-- type: `Array`
+- 类型: `Array`
 
 
-Sometimes we do not want docsify to handle our links. See [#203](https://github.com/QingWei-Li/docsify/issues/203)
+有时我们不希望 docsify 处理我们的链接。 参考 [#203](https://github.com/QingWei-Li/docsify/issues/203)
 
 
 ```js

docs/zh-cn/deploy.md

@@ -18,9 +18,9 @@ GitHub Pages 支持从三个地方读取文件
 
 ## GitLab Pages
 
-If you are deploying your master branch, include `.gitlab-ci.yml` with the following script:
+如果你正在部署你的主分支, 在 `.gitlab-ci.yml` 中包含以下脚本：
 
-?> The `.public` workaround is so `cp` doesn't also copy `public/` to itself in an infinite loop.
+?> `.public` 的解决方法是这样的，`cp` 不会无限循环的将 `public/` 复制到自身。
 
 ``` YAML
 pages:
@@ -36,7 +36,7 @@ pages:
   - master
 ```
 
-!> You can replace script with `- cp -r docs/. public`, if `./docs` is your Docsify subfolder.
+!> 你可以用 `- cp -r docs/. public` 替换脚本, 如果 `./docs` 是你的 docsify 子文件夹。
 
 
 ## VPS

docs/zh-cn/helpers.md

@@ -25,23 +25,23 @@ docsify 扩展了一些 Markdown 语法，可以让文档更易读。
 ?> *TODO* 完善示例
 
 
-## Ignore to compile link
+## 忽略编译链接
 
-Some time we will put some other relative path to the link, you have to need to tell docsify you don't need to compile this link. For example
+有时候我们会把其他一些相对路径放到链接上，你必须告诉 docsify 你不需要编译这个链接。 例如：
 
 ```md
 [link](/demo/)
 ```
 
 
-It will be compiled to `<a href="/#/demo/">link</a>` and will be loaded `/demo/README.md`. Maybe you want to jump to `/demo/index.html`.
+它将被编译为 `<a href="/#/demo/">link</a>` 并将加载 `/demo/README.md`. 可能你想跳转到 `/demo/index.html`。
 
-Now you can do that
+现在你可以做到这一点
 
 ```md
 [link](/demo/ ":ignore")
 ```
-You will get `<a href="/demo/">link</a>`html. Do not worry, you can still set title for link.
+即将会得到 `<a href="/demo/">link</a>` html 代码。不要担心，你仍然可以为链接设置标题。
 
 ```md
 [link](/demo/ ":ignore title")
@@ -50,7 +50,7 @@ You will get `<a href="/demo/">link</a>`html. Do not worry, you can still set ti
 ```
 
 
-## Set target attribute for link
+## 设置链接的 target 属性
 
 ```md
 [link](/demo ":target=_blank")
@@ -58,7 +58,7 @@ You will get `<a href="/demo/">link</a>`html. Do not worry, you can still set ti
 ```
 
 
-## Github Task Lists
+## Github 任务列表
 
 ```md
 

docs/zh-cn/markdown.md

@@ -30,7 +30,7 @@ window.$docsify = {
 ```
 
 
-## Supports mermaid
+## 支持 mermaid
 
 ```js
 // Import mermaid

docs/zh-cn/more-pages.md

@@ -49,6 +49,19 @@ docs/zh-cn/guide.md   => http://domain.com/zh-cn/guide
 
 `_sidebar.md` 的加载逻辑是从每层目录下获取文件，如果当前目录不存在该文件则回退到上一级目录。例如当前路径为 `/zh-cn/more-pages` 则从 `/zh-cn/_sidebar.md` 获取文件，如果不存在则从 `/_sidebar.md` 获取。
 
+当然你也可以配置 `alias` 避免不必要的回退过程。
+
+```html
+<script>
+  window.$docsify = {
+    loadSidebar: true,
+    alias: {
+      '/.*/_sidebar.md': '/_sidebar.md'
+    }
+  }
+</script>
+```
+
 ## 显示目录
 
 自定义侧边栏同时也可以开启目录功能。设置 `subMaxLevel` 配置项，具体介绍见 [配置项#sub-max-level](zh-cn/configuration#sub-max-level)。
@@ -63,25 +76,25 @@ docs/zh-cn/guide.md   => http://domain.com/zh-cn/guide
 <script src="//unpkg.com/docsify"></script>
 ```
 
-## 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.
+当设置了 `subMaxLevel` 时，默认情况下每个标题都会自动添加到目录中。如果你想忽略特定的标题，可以给它添加 `{docsify-ignore}` 。
 
 ```markdown
 # Getting Started
 
 ## 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.
+要忽略特定页面上的所有标题，你可以在页面的第一个标题上使用 `{docsify-ignore-all}` 。
 
 ```markdown
 # 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.
+在使用时， `{docsify-ignore}` 和 `{docsify-ignore-all}` 都不会在页面上呈现。
 

docs/zh-cn/plugins.md

@@ -83,6 +83,15 @@
 <script src="//unpkg.com/docsify/lib/plugins/external-script.js"></script>
 ```
 
+## Demo code with instant preview and jsfiddle integration
+
+With this plugin, sample code can be rendered on the page instantly, so that the readers can see the preview immediately.
+When readers expand the demo box, the source code and description are shown there. if they click the button `Try in Jsfiddle`,
+`jsfiddle.net` will be open with the code of this sample, which allow readers to revise the code and try on their own.
+
+[Vue](https://njleonzhang.github.io/docsify-demo-box-vue/) and [React](https://njleonzhang.github.io/docsify-demo-box-react/) are both supported.
+
+
 ## 图片缩放 - Zoom image
 
 Medium's 风格的图片缩放插件. 基于 [medium-zoom](https://github.com/francoischalifour/medium-zoom)。
@@ -100,22 +109,73 @@ Medium's 风格的图片缩放插件. 基于 [medium-zoom](https://github.com/fr
 
 
 
-## Edit on github
+## 在 Github 上编辑
 
-Add `Edit on github` button on every pages. provided by 3rd party, check [document](https://github.com/njleonzhang/docsify-edit-on-github)
+在每一页上添加 `Edit on github` 按钮. 由第三方库提供, 查看 [document](https://github.com/njleonzhang/docsify-edit-on-github)
 
 
-## CodeSponsor
+## Copy to Clipboard
 
-See https://codesponsor.io
+Add a simple `Click to copy` button to all preformatted code blocks to effortlessly allow users to copy example code from your docs. Provided by [@jperasmus](https://github.com/jperasmus)
 
+```html
+<link rel="stylesheet" href="//unpkg.com/docsify-copy-code/styles.css">
+<script src="//unpkg.com/docsify-copy-code/index.js"></script>
+```
+
+```javascript
+window.$docsify = {
+  plugins: [
+    window.DocsifyCopyCodePlugin.init()
+  ]
+}
+```
+
+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 = {
-    codesponsor: 'id'
+    disqus: 'shortname'
   }
 </script>
-<script src="//unpkg.com/docsify/lib/plugins/codesponsor.min.js"></script>
+<script src="//unpkg.com/docsify/lib/plugins/disqus.min.js"></script>
 ```
 
+
+## Gitalk
+
+[Gitalk](https://github.com/gitalk/gitalk) is a modern comment component based on Github Issue and Preact. 
+
+```html
+<link rel="stylesheet" href="//unpkg.com/gitalk/dist/gitalk.css">
+
+<script src="//unpkg.com/docsify/lib/plugins/gitalk.min.js"></script>
+<script src="//unpkg.com/gitalk/dist/gitalk.min.js"></script>
+<script>
+  const gitalk = new Gitalk({
+    clientID: 'Github Application Client ID',
+    clientSecret: 'Github Application Client Secret',
+    repo: 'Github repo',
+    owner: 'Github repo owner',
+    admin: ['Github repo collaborators, only these guys can initialize github issues'],
+    // facebook-like distraction free mode
+    distractionFreeMode: false
+  })
+</script>
+```
+
+## Navigation
+
+Pagination for docsify. By [@imyelo](https://github.com/imyelo)
+
+```html
+<script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
+<script src="//unpkg.com/docsify-pagination/dist/docsify-pagination.min.js"></script>
+```

docs/zh-cn/quickstart.md

@@ -51,8 +51,13 @@ docsify serve docs
 </head>
 <body>
   <div id="app"></div>
+  <script>
+    window.$docsify = {
+      //...
+    }
+  </script>
+  <script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
 </body>
-<script src="//unpkg.com/docsify"></script>
 </html>
 ```
 

lib/docsify.js

@@ -578,6 +578,7 @@ var marked = createCommonjsModule(function (module, exports) {
  */
 
 (function() {
+'use strict';
 
 /**
  * Block-Level Grammar
@@ -1024,21 +1025,21 @@ Lexer.prototype.token = function(src, top, bq) {
 
 var inline = {
   escape: /^\\([\\`*{}\[\]()#+\-.!_>])/,
-  autolink: /^<([^ >]+(@|:\/)[^ >]+)>/,
+  autolink: /^<([^ <>]+(@|:\/)[^ <>]+)>/,
   url: noop,
-  tag: /^<!--[\s\S]*?-->|^<\/?\w+(?:"[^"]*"|'[^']*'|[^'">])*?>/,
+  tag: /^<!--[\s\S]*?-->|^<\/?\w+(?:"[^"]*"|'[^']*'|[^<'">])*?>/,
   link: /^!?\[(inside)\]\(href\)/,
   reflink: /^!?\[(inside)\]\s*\[([^\]]*)\]/,
   nolink: /^!?\[((?:\[[^\]]*\]|[^\[\]])*)\]/,
   strong: /^__([\s\S]+?)__(?!_)|^\*\*([\s\S]+?)\*\*(?!\*)/,
   em: /^\b_((?:[^_]|__)+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
-  code: /^(`+)\s*([\s\S]*?[^`])\s*\1(?!`)/,
+  code: /^(`+)([\s\S]*?[^`])\1(?!`)/,
   br: /^ {2,}\n(?!\s*$)/,
   del: noop,
   text: /^[\s\S]+?(?=[\\<!\[_*`]| {2,}\n|$)/
 };
 
-inline._inside = /(?:\[[^\]]*\]|[^\[\]]|\](?=[^\[]*\]))*/;
+inline._inside = /(?:\[[^\]]*\]|\\[\[\]]|[^\[\]]|\](?=[^\[]*\]))*/;
 inline._href = /\s*<?([\s\S]*?)>?(?:\s+['"]([\s\S]*?)['"])?\s*/;
 
 inline.link = replace(inline.link)
@@ -1155,9 +1156,11 @@ InlineLexer.prototype.output = function(src) {
     if (cap = this$1.rules.autolink.exec(src)) {
       src = src.substring(cap[0].length);
       if (cap[2] === '@') {
-        text = cap[1].charAt(6) === ':'
+        text = escape(
+          cap[1].charAt(6) === ':'
           ? this$1.mangle(cap[1].substring(7))
-          : this$1.mangle(cap[1]);
+          : this$1.mangle(cap[1])
+        );
         href = this$1.mangle('mailto:') + text;
       } else {
         text = escape(cap[1]);
@@ -1238,7 +1241,7 @@ InlineLexer.prototype.output = function(src) {
     // code
     if (cap = this$1.rules.code.exec(src)) {
       src = src.substring(cap[0].length);
-      out += this$1.renderer.codespan(escape(cap[2], true));
+      out += this$1.renderer.codespan(escape(cap[2].trim(), true));
       continue;
     }
 
@@ -1450,12 +1453,15 @@ Renderer.prototype.link = function(href, title, text) {
         .replace(/[^\w:]/g, '')
         .toLowerCase();
     } catch (e) {
-      return '';
+      return text;
     }
-    if (prot.indexOf('javascript:') === 0 || prot.indexOf('vbscript:') === 0) {
-      return '';
+    if (prot.indexOf('javascript:') === 0 || prot.indexOf('vbscript:') === 0 || prot.indexOf('data:') === 0) {
+      return text;
     }
   }
+  if (this.options.baseUrl && !originIndependentUrl.test(href)) {
+    href = resolveUrl(this.options.baseUrl, href);
+  }
   var out = '<a href="' + href + '"';
   if (title) {
     out += ' title="' + title + '"';
@@ -1465,6 +1471,9 @@ Renderer.prototype.link = function(href, title, text) {
 };
 
 Renderer.prototype.image = function(href, title, text) {
+  if (this.options.baseUrl && !originIndependentUrl.test(href)) {
+    href = resolveUrl(this.options.baseUrl, href);
+  }
   var out = '<img src="' + href + '" alt="' + text + '"';
   if (title) {
     out += ' title="' + title + '"';
@@ -1677,8 +1686,8 @@ function escape(html, encode) {
 }
 
 function unescape(html) {
-	// explicitly match decimal, hex, and named HTML entities 
-  return html.replace(/&(#(?:\d+)|(?:#x[0-9A-Fa-f]+)|(?:\w+));?/g, function(_, n) {
+	// explicitly match decimal, hex, and named HTML entities
+  return html.replace(/&(#(?:\d+)|(?:#x[0-9A-Fa-f]+)|(?:\w+));?/ig, function(_, n) {
     n = n.toLowerCase();
     if (n === 'colon') { return ':'; }
     if (n.charAt(0) === '#') {
@@ -1702,6 +1711,30 @@ function replace(regex, opt) {
   };
 }
 
+function resolveUrl(base, href) {
+  if (!baseUrls[' ' + base]) {
+    // we can ignore everything in base after the last slash of its path component,
+    // but we might need to add _that_
+    // https://tools.ietf.org/html/rfc3986#section-3
+    if (/^[^:]+:\/*[^/]*$/.test(base)) {
+      baseUrls[' ' + base] = base + '/';
+    } else {
+      baseUrls[' ' + base] = base.replace(/[^/]*$/, '');
+    }
+  }
+  base = baseUrls[' ' + base];
+
+  if (href.slice(0, 2) === '//') {
+    return base.replace(/:[\s\S]*/, ':') + href;
+  } else if (href.charAt(0) === '/') {
+    return base.replace(/(:\/*[^/]*)[\s\S]*/, '$1') + href;
+  } else {
+    return base + href;
+  }
+}
+var baseUrls = {};
+var originIndependentUrl = /^$|^[a-z][a-z0-9+.-]*:|^[?#]/i;
+
 function noop() {}
 noop.exec = noop;
 
@@ -1805,7 +1838,7 @@ function marked(src, opt, callback) {
   } catch (e) {
     e.message += '\nPlease report this to https://github.com/chjj/marked.';
     if ((opt || marked.defaults).silent) {
-      return '<p>An error occured:</p><pre>'
+      return '<p>An error occurred:</p><pre>'
         + escape(e.message + '', true)
         + '</pre>';
     }
@@ -1838,7 +1871,8 @@ marked.defaults = {
   smartypants: false,
   headerPrefix: '',
   renderer: new Renderer,
-  xhtml: false
+  xhtml: false,
+  baseUrl: null
 };
 
 /**
@@ -2851,7 +2885,7 @@ var Compiler = function Compiler (config, router) {
 };
 
 Compiler.prototype.matchNotCompileLink = function matchNotCompileLink (link) {
-  var links = this.config.noCompileLinks;
+  var links = this.config.noCompileLinks || [];
 
   for (var i = 0; i < links.length; i++) {
     var n = links[i];
@@ -2982,7 +3016,7 @@ Compiler.prototype._initRenderer = function _initRenderer () {
     if (checked) {
       text = text.replace(CHECKED_RE, ("<input type=\"checkbox\" " + (checked[1] === 'x' ? 'checked' : '') + " />"));
     }
-    return ("<li>" + text + "</li>\n")
+    return ("<li" + (checked ? " class=\"task-list-item\"" : '') + ">" + text + "</li>\n")
   };
 
   renderer.origin = origin;
@@ -3101,7 +3135,7 @@ function getAndActive (router, el, isParent, autoTitle) {
   el = getNode(el);
 
   var links = findAll(el, 'a');
-  var hash = router.toURL(router.getCurrentPath());
+  var hash = decodeURI(router.toURL(router.getCurrentPath()));
   var target;
 
   links.sort(function (a, b) { return b.href.length - a.href.length; }).forEach(function (a) {
@@ -4063,7 +4097,7 @@ initGlobalAPI();
 /**
  * Version
  */
-Docsify.version = '4.5.3';
+Docsify.version = '4.5.9';
 
 /**
  * Run Docsify

lib/plugins/codesponsor.js

@@ -1,64 +0,0 @@
-(function () {
-'use strict';
-
-var DEFAULT_OPTIONS = {
-  theme: 'light',
-  image: 'show'
-};
-
-function tpl (id, options) {
-  var qs = [];
-
-  for (var key in options) {
-    qs.push((key + "=" + (options[key])));
-  }
-
-  var div = Docsify.dom.create('div');
-
-  Docsify.dom.toggleClass(div, 'codesponsor');
-  div.innerHTML = "<iframe\n      scrolling=0\n      frameborder=0\n      width=250\n      height=auto\n      style=\"max-height: 250px;\"\n      id=\"code-sponsor-embed-iframe\"\n      src=\"https://app.codesponsor.io/widgets/" + id + "?" + (qs.join('&')) + "\">\n    </iframe>";
-
-  return div
-}
-
-function appIframe (id, opts) {
-  var html = tpl(id, opts);
-
-  Docsify.dom.before(Docsify.dom.find('section.content'), html);
-}
-
-function appendStyle () {
-  Docsify.dom.style("\n    .codesponsor {\n      position: relative;\n      float: right;\n      right: 10px;\n      top: 10px;\n    }\n\n    @media screen and (min-width: 1600px) {\n      body.sticky .codesponsor {\n        position: fixed;\n      }\n\n      .codesponsor {\n        position: absolute;\n        bottom: 10px;\n        top: auto;\n        float: none;\n      }\n    }\n  ");
-}
-
-var install = function (hook, vm) {
-  var config = vm.config.codesponsor;
-  var id;
-
-  if (typeof config === 'string') {
-    id = config;
-    config = {};
-  } else {
-    id = config.id;
-  }
-
-  var opts = Docsify.util.merge(DEFAULT_OPTIONS, config);
-
-  if (!id) {
-    throw Error('codesponsor plugin need id')
-  }
-
-  if (Docsify.util.isMobile) {
-    return
-  }
-
-  // Append style
-  hook.ready(function () {
-    appendStyle();
-    appIframe(id, opts);
-  });
-};
-
-window.$docsify.plugins = [].concat(install, window.$docsify.plugins);
-
-}());

lib/plugins/codesponsor.min.js

@@ -1 +0,0 @@
-!function(){"use strict";function o(o,n){var i=[];for(var e in n)i.push(e+"="+n[e]);var s=Docsify.dom.create("div");return Docsify.dom.toggleClass(s,"codesponsor"),s.innerHTML='<iframe\n      scrolling=0\n      frameborder=0\n      width=250\n      height=auto\n      style="max-height: 250px;"\n      id="code-sponsor-embed-iframe"\n      src="https://app.codesponsor.io/widgets/'+o+"?"+i.join("&")+'">\n    </iframe>',s}function n(n,i){var e=o(n,i);Docsify.dom.before(Docsify.dom.find("section.content"),e)}function i(){Docsify.dom.style("\n    .codesponsor {\n      position: relative;\n      float: right;\n      right: 10px;\n      top: 10px;\n    }\n\n    @media screen and (min-width: 1600px) {\n      body.sticky .codesponsor {\n        position: fixed;\n      }\n\n      .codesponsor {\n        position: absolute;\n        bottom: 10px;\n        top: auto;\n        float: none;\n      }\n    }\n  ")}var e={theme:"light",image:"show"},s=function(o,s){var t,r=s.config.codesponsor;"string"==typeof r?(t=r,r={}):t=r.id;var c=Docsify.util.merge(e,r);if(!t)throw Error("codesponsor plugin need id");Docsify.util.isMobile||o.ready(function(){i(),n(t,c)})};window.$docsify.plugins=[].concat(s,window.$docsify.plugins)}();

lib/plugins/disqus.js

@@ -1,7 +1,10 @@
 (function () {
 'use strict';
 
-location.href = location.href.replace('/-/', '/#/');
+var fixedPath = location.href.replace('/-/', '/#/');
+if (fixedPath !== location.href) {
+  location.href = fixedPath;
+}
 
 function install (hook, vm) {
   var dom = Docsify.dom;

lib/plugins/disqus.min.js

@@ -1 +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)}();
+!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}})})}var t=location.href.replace("/-/","/#/");t!==location.href&&(location.href=t),$docsify.plugins=[].concat(i,$docsify.plugins)}();

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "docsify",
-  "version": "4.5.3",
+  "version": "4.5.9",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
@@ -4229,9 +4229,9 @@
       "dev": true
     },
     "marked": {
-      "version": "0.3.6",
-      "resolved": "https://registry.npmjs.org/marked/-/marked-0.3.6.tgz",
-      "integrity": "sha1-ssbGGPzOzk74bE/Gy4p8v1rtqNc="
+      "version": "0.3.12",
+      "resolved": "https://registry.npmjs.org/marked/-/marked-0.3.12.tgz",
+      "integrity": "sha512-k4NaW+vS7ytQn6MgJn3fYpQt20/mOgYM5Ft9BYMfQJDz2QT6yEeS9XJ8k2Nw8JTeWK/znPPW2n3UJGzyYEiMoA=="
     },
     "math-expression-evaluator": {
       "version": "1.2.17",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "docsify",
-  "version": "4.5.3",
+  "version": "4.5.9",
   "description": "A magical documentation generator.",
   "author": {
     "name": "qingwei-li",
@@ -30,7 +30,7 @@
     "pub": "sh build/release.sh"
   },
   "dependencies": {
-    "marked": "^0.3.6",
+    "marked": "^0.3.12",
     "medium-zoom": "^0.2.0",
     "prismjs": "^1.6.0",
     "tinydate": "^1.0.0",

packages/docsify-server-renderer/package-lock.json

@@ -37,5 +37,5 @@
       "integrity": "sha1-6DWIAbhrg7F1YNTjw4LXrvIQCUQ="
     }
   },
-  "version": "4.5.3"
+  "version": "4.5.9"
 }

packages/docsify-server-renderer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docsify-server-renderer",
-  "version": "4.5.3",
+  "version": "4.5.9",
   "description": "docsify server renderer",
   "author": {
     "name": "qingwei-li",

src/core/event/sidebar.js

@@ -51,7 +51,7 @@ export function getAndActive (router, el, isParent, autoTitle) {
   el = dom.getNode(el)
 
   const links = dom.findAll(el, 'a')
-  const hash = router.toURL(router.getCurrentPath())
+  const hash = decodeURI(router.toURL(router.getCurrentPath()))
   let target
 
   links.sort((a, b) => b.href.length - a.href.length).forEach(a => {

src/core/render/compiler.js

@@ -61,7 +61,7 @@ export class Compiler {
   }
 
   matchNotCompileLink (link) {
-    const links = this.config.noCompileLinks
+    const links = this.config.noCompileLinks || []
 
     for (var i = 0; i < links.length; i++) {
       const n = links[i]
@@ -181,7 +181,7 @@ export class Compiler {
       if (checked) {
         text = text.replace(CHECKED_RE, `<input type="checkbox" ${checked[1] === 'x' ? 'checked' : ''} />`)
       }
-      return `<li>${text}</li>\n`
+      return `<li${checked ? ` class="task-list-item"` : ''}>${text}</li>\n`
     }
 
     renderer.origin = origin

src/plugins/codesponsor.js

@@ -1,87 +0,0 @@
-const DEFAULT_OPTIONS = {
-  theme: 'light',
-  image: 'show'
-}
-
-function tpl (id, options) {
-  const qs = []
-
-  for (const key in options) {
-    qs.push(`${key}=${options[key]}`)
-  }
-
-  const div = Docsify.dom.create('div')
-
-  Docsify.dom.toggleClass(div, 'codesponsor')
-  div.innerHTML = `<iframe
-      scrolling=0
-      frameborder=0
-      width=250
-      height=auto
-      style="max-height: 250px;"
-      id="code-sponsor-embed-iframe"
-      src="https://app.codesponsor.io/widgets/${id}?${qs.join('&')}">
-    </iframe>`
-
-  return div
-}
-
-function appIframe (id, opts) {
-  const html = tpl(id, opts)
-
-  Docsify.dom.before(Docsify.dom.find('section.content'), html)
-}
-
-function appendStyle () {
-  Docsify.dom.style(`
-    .codesponsor {
-      position: relative;
-      float: right;
-      right: 10px;
-      top: 10px;
-    }
-
-    @media screen and (min-width: 1600px) {
-      body.sticky .codesponsor {
-        position: fixed;
-      }
-
-      .codesponsor {
-        position: absolute;
-        bottom: 10px;
-        top: auto;
-        float: none;
-      }
-    }
-  `)
-}
-
-const install = function (hook, vm) {
-  let config = vm.config.codesponsor
-  let id
-
-  if (typeof config === 'string') {
-    id = config
-    config = {}
-  } else {
-    id = config.id
-  }
-
-  const opts = Docsify.util.merge(DEFAULT_OPTIONS, config)
-
-  if (!id) {
-    throw Error('codesponsor plugin need id')
-  }
-
-  if (Docsify.util.isMobile) {
-    return
-  }
-
-  // Append style
-  hook.ready(() => {
-    appendStyle()
-    appIframe(id, opts)
-  })
-}
-
-window.$docsify.plugins = [].concat(install, window.$docsify.plugins)

src/plugins/disqus.js

@@ -1,4 +1,7 @@
-location.href = location.href.replace('/-/', '/#/')
+const fixedPath = location.href.replace('/-/', '/#/')
+if (fixedPath !== location.href) {
+  location.href = fixedPath
+}
 
 function install (hook, vm) {
   const dom = Docsify.dom

src/themes/basic/_coverpage.css

@@ -14,6 +14,7 @@ section.cover {
     background-color: $color-bg;
     opacity: 0.8;
     position: absolute;
+    top: 0;
     size: 100%;
   }
 

src/themes/basic/_layout.css

@@ -91,6 +91,10 @@ kbd {
   vertical-align: middle;
 }
 
+.task-list-item {
+  list-style-type: none;
+}
+
 li input[type=checkbox] {
   margin: 0 0.2em 0.25em -1.6em;
   vertical-align: middle;
@@ -503,6 +507,7 @@ body.close {
   .sidebar-toggle {
     background-color: transparent;
     width: auto;
+    padding: 30px 30px 10px 10px;
   }
 
   body.close {
@@ -514,6 +519,7 @@ body.close {
       background-color: rgba($color-bg, 0.8);
       transition: 1s background-color;
       width: calc($sidebar-width - 16px);
+      padding: 10px;
     }
 
     .content {