-> v2.2.0

bump: 2.2.0
feat(plugins): add Google Analytics plugin (#66 )
2026-08-09 13:26:34 +10:00 · 2017-02-09 22:17:29 +08:00 · 2017-02-09 22:17:23 +08:00 · 2017-02-09 22:16:15 +08:00 · 2017-02-09 21:26:57 +08:00 · 2017-02-09 21:26:49 +08:00
31 changed files with 1093 additions and 109 deletions
@@ -1,7 +1,9 @@
 {
  "extends": ["vue"],
+  "env": {
+    "browser": true
+  },
  "globals": {
-    "XMLHttpRequest": true,
-    "__docsify__": true
+    "$docsify": true
  }
 }
@@ -1,3 +1,33 @@
+## 2.2.0
+
+### Features
+- Add `Google Analytics` plugin.
+
+## 2.1.0
+### Features
+- Add search plugin
+```html
+<script src="//unpkg.com/docsify/lib/docsify.js"></script>
+<script src="//unpkg.com/docsify/lib/plugins/search.js"></script>
+```
+
+### Bug fixes
+- fix sidebar style
+
+## 2.0.3
+### Bug fixes
+- fix: rendering emojis
+- fix: css var polyfill
+
+## 2.0.2
+
+### Bug fixes
+- fix button style in cover page.
+
+## 2.0.1
+### Bug fixes
+- border style.
+
 ## 2.0.0
 ### Features
 - Customize the theme color
@@ -76,13 +76,12 @@ These open-source projects are using docsify to generate their sites. Pull reque

 ## Development

-### prepare
 ```bash
 npm i && npm run dev
 open http://localhost:3000
 ```

-### More Language Highlight
+## More Language Highlight

 ```html
 <script src="//unpkg.com/docsify"></script>
@@ -2,6 +2,7 @@ var fs = require('fs')
 var cssnano = require('cssnano').process
 var resolve = require('path').resolve
 var postcss = require('postcss')
+var isProd = process.argv[process.argv.length - 1] !== '--dev'

 var processor = postcss([require('postcss-salad')({
  features: {
@@ -34,7 +35,7 @@ list.forEach(function (file) {
    .then(function (result) {
      save(file, result.css)
      console.log('salad - ' + file)
-      cssnano(loadLib(file))
+      isProd && cssnano(loadLib(file))
        .then(function (result) {
          saveMin(file, result.css)
          console.log('cssnao - ' + file)
@@ -3,6 +3,7 @@ var buble = require('rollup-plugin-buble')
 var commonjs = require('rollup-plugin-commonjs')
 var nodeResolve = require('rollup-plugin-node-resolve')
 var uglify = require('rollup-plugin-uglify')
+var isProd = process.argv[process.argv.length - 1] !== '--dev'

 var build = function (opts) {
  rollup
@@ -16,7 +17,7 @@ var build = function (opts) {
      console.log(dest)
      bundle.write({
        format: 'iife',
-        moduleName: opts.moduleName || 'Docsify',
+        moduleName: opts.moduleName || 'D',
        dest: dest
      })
    })
@@ -30,8 +31,30 @@ build({
  output: 'docsify.js',
  plugins: [commonjs(), nodeResolve()]
 })
-build({
+isProd && build({
  entry: 'index.js',
  output: 'docsify.min.js',
  plugins: [commonjs(), nodeResolve(), uglify()]
 })
+build({
+  entry: 'plugins/search.js',
+  output: 'plugins/search.js',
+  moduleName: 'D.Search'
+})
+isProd && build({
+  entry: 'plugins/search.js',
+  output: 'plugins/search.min.js',
+  moduleName: 'D.Search',
+  plugins: [uglify()]
+})
+build({
+  entry: 'plugins/ga.js',
+  output: 'plugins/ga.js',
+  moduleName: 'D.GA'
+})
+isProd && build({
+  entry: 'plugins/ga.js',
+  output: 'plugins/ga.min.js',
+  moduleName: 'D.GA',
+  plugins: [uglify()]
+})
@@ -6,7 +6,24 @@
  <link rel="stylesheet" href="/themes/vue.css">
 </head>
 <body>
+  <nav>
+    <a href="#/">En</a>
+    <a href="#/zh-cn">中文</a>
+  </nav>
  <div id="app"></div>
 </body>
-<script src="/lib/docsify.js" data-repo="qingwei-li/docsify" data-name="docsify" data-auto2top></script>
+<script>
+  window.$docsify = {
+    search: {
+      maxAge: 0
+    }
+  }
+</script>
+<script
+  src="/lib/docsify.js"
+  data-repo="qingwei-li/docsify"
+  data-name="docsify"
+  data-base-path="docs/"
+  data-auto2top></script>
+<script src="/lib/plugins/search.js"></script>
 </html>
@@ -381,7 +381,7 @@ window.$docsify = {
 ```


-### basePath
+### base-path

 If your HTML entry file and the markdown files are in different directories, we can use:

@@ -430,7 +430,7 @@ window.$docsify = {
 }
 ```

-### nameLink
+### name-link

 Name link. The default value is `window.location.pathname`.

@@ -459,3 +459,56 @@ window.$docsify = {
  themeColor: '#3F51B5'
 }
 ```
+
+## Plugins
+
+### Full Text Search
+
+If a document can have a search, can enhance some user experience. Installing the search plugin is easy. Such as
+
+
+```html
+<script src="//unpkg.com/docsify"></script>
+<script src="//unpkg.com/docsify/lib/plugins/search.js"></script>
+```
+
+By default, the hyperlink on the current page is recognized and the content is saved in `localStorage`. You can also specify the path to the files.
+
+!> Configure the content before the plugin is installed.
+
+```js
+window.$docsify = {
+  search: 'auto', // default
+
+  search : [
+    '/',            // => /README.md
+    '/guide',       // => /guide.md
+    '/get-started', // => /get-started.md
+    '/zh-cn/',      // => /zh-cn/README.md
+  ],
+
+  // Full configuration
+  search: {
+    maxAge: 86400000, // Expiration time, the default one day
+    paths: [], // or 'auto'
+    placeholder: 'Type to search'
+  }
+}
+```
+
+### Google Analytics
+
+Install the plugin and configure the track id.
+
+```html
+<script src="//unpkg.com/docsify" data-ga="UA-XXXXX-Y"></script>
+<script src="//unpkg.com/docsify/lib/plugins/ga.js"></script>
+```
+
+or
+
+```js
+window.$docsify = {
+  ga: 'UA-XXXXX-Y'
+}
+```
@@ -1,6 +1,6 @@
 ![logo](_media/icon.svg)

-# docsify <small>2.0</small>
+# docsify <small>2.2.0</small>

 > A magical documentation site generator.

@@ -20,6 +20,7 @@
  data-max-level="4"
  data-coverpage
  data-name="docsify"></script>
+<script src="//unpkg.com/docsify/lib/plugins/search.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>
 </html>
@@ -387,7 +387,7 @@ window.$docsify = {
 }
 ```

-### basePath
+### base-path

 指定加载文档的路径，如果你的 HTML 入口文件和文档是放在不同地方，你可以设置：

@@ -438,7 +438,7 @@ window.$docsify = {
 }
 ```

-### nameLink
+### name-link

 项目名链接，默认为 `window.location.pathname`。

@@ -452,7 +452,7 @@ window.$docsify = {
 }
 ```

-### themeColor
+### theme-color

 自定义主题色。

@@ -466,3 +466,55 @@ window.$docsify = {
  themeColor: '#3F51B5'
 }
 ```
+
+## Plugins
+
+### 全文检索 - search
+
+一份文档如果能有搜索功能会提升一些用户体验，加载搜索插件也很简单，直接引入就自动安装并启用。默认情况下会自动分析当前页面上的超链接，获取内容后建立索引并存储在 `localStorage` 里，默认过期时间为一天，当然这是可配置的。
+
+自动识别的方式不一定能识别完整或者如果你想指定某些文件可索引，你可以自己指定文件的路径。
+
+```html
+<script src="//unpkg.com/docsify/lib/docsify.js"></script>
+<script src="//unpkg.com/docsify/lib/plugins/search.js"></script>
+```
+
+!> 配置要在 docsify 引入之前
+
+```js
+window.$docsify = {
+  search: 'auto', // default
+
+  search : [
+    '/',            // => /README.md
+    '/guide',       // => /guide.md
+    '/get-started', // => /get-started.md
+    '/zh-cn/',      // => /zh-cn/README.md
+  ],
+
+  // Full configuration
+  search: {
+    maxAge: 86400000, // Expiration time, the default one day
+    paths: [], // or 'auto'
+    placeholder: 'Type to search'
+  }
+}
+```
+
+### Google Analytics
+
+安装插件并且配置 track id。
+
+```html
+<script src="//unpkg.com/docsify" data-ga="UA-XXXXX-Y"></script>
+<script src="//unpkg.com/docsify/lib/plugins/ga.js"></script>
+```
+
+或者
+
+```js
+window.$docsify = {
+  ga: 'UA-XXXXX-Y'
+}
+```
@@ -1,4 +1,4 @@
-var Docsify = (function () {
+var D = (function () {
 'use strict';

 /**
@@ -97,7 +97,7 @@ function getRoute () {
  var loc = window.location;
  if (cacheHash === loc.hash && !isNil(cacheRoute$1)) { return cacheRoute$1 }

-  var route = loc.hash.match(/^#\/([^#]+)/);
+  var route = loc.hash.replace(/%23/g, '#').match(/^#\/([^#]+)/);

  if (route && route.length === 2) {
    route = route[1];
@@ -170,10 +170,25 @@ var merge = Object.assign || function (to) {

 function emojify (text) {
  return text
+    .replace(/<(pre|template)[^>]*?>([\s\S]+)<\/(pre|template)>/g, function (match) { return match.replace(/:/g, '__colon__'); })
    .replace(/:(\w*?):/ig, '<img class="emoji" src="https://assets-cdn.github.com/images/icons/emoji/$1.png" alt="$1" />')
    .replace(/__colon__/g, ':')
 }

+
+
+var utils = Object.freeze({
+	load: load,
+	genTree: genTree,
+	camel2kebab: camel2kebab,
+	isNil: isNil,
+	getRoute: getRoute,
+	isMobile: isMobile,
+	slugify: slugify,
+	merge: merge,
+	emojify: emojify
+});
+
 /**
 * Active sidebar when scroll
 * @link https://buble.surge.sh/
@@ -183,7 +198,7 @@ function scrollActiveSidebar () {

  var hoveredOverSidebar = false;
  var anchors = document.querySelectorAll('.anchor');
-  var sidebar = document.querySelector('aside.sidebar');
+  var sidebar = document.querySelector('.sidebar');
  var sidebarHeight = sidebar.clientHeight;

  var nav = {};
@@ -298,7 +313,7 @@ function bindToggle (dom) {
  dom.addEventListener('click', function () { return body.classList.toggle('close'); });

  if (isMobile()) {
-    var sidebar = document.querySelector('aside.sidebar');
+    var sidebar = document.querySelector('.sidebar');
    sidebar.addEventListener('click', function () {
      body.classList.toggle('close');
      setTimeout(function () { return activeLink(sidebar, true); }, 0);
@@ -2448,7 +2463,7 @@ function corner (data) {
 * Render main content
 */
 function main () {
-  var aside = (toggle()) + "<aside class=\"sidebar\"></aside>";
+  var aside = (toggle()) + "<aside class=\"sidebar\"><div class=\"sidebar-nav\"></div></aside>";

  return (isMobile() ? (aside + "<main>") : ("<main>" + aside)) +
    "<section class=\"content\">\n      <article class=\"markdown-section\"></article>\n    </section>\n    </main>"
@@ -2498,7 +2513,7 @@ function theme (color) {
 }

 function replaceVar (block) {
-  block.innerHTML = block.innerHTML.replace(/var\(\s*--theme-color.*?\)/g, __docsify__.themeColor);
+  block.innerHTML = block.innerHTML.replace(/var\(\s*--theme-color.*?\)/g, $docsify.themeColor);
 }

 function cssVars () {
@@ -2509,14 +2524,17 @@ function cssVars () {
    if (block.nodeName === 'STYLE') {
      replaceVar(block);
    } else if (block.nodeName === 'LINK') {
-      load(block.getAttribute('href'))
-        .then(function (res) {
-          var style = document.createElement('style');
+      var href = block.getAttribute('href');

-          style.innerHTML = res;
-          document.head.appendChild(style);
-          replaceVar(style);
-        });
+      if (!/\.css$/.test(href)) { return }
+
+      load(href).then(function (res) {
+        var style = document.createElement('style');
+
+        style.innerHTML = res;
+        document.head.appendChild(style);
+        replaceVar(style);
+      });
    }
  });
 }
@@ -2557,11 +2575,11 @@ function init () {

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

-    return ("<pre v-pre data-lang=\"" + lang + "\"><code class=\"lang-" + lang + "\">" + (hl.replace(/:/g, '__colon__')) + "</code></pre>")
+    return ("<pre v-pre data-lang=\"" + lang + "\"><code class=\"lang-" + lang + "\">" + hl + "</code></pre>")
  };
  renderer.link = function (href, title, text) {
    if (!/:/.test(href)) {
-      href = ("#/" + href).replace(/\/\//g, '/');
+      href = ("#/" + href).replace(/\/+/g, '/');
    }

    return ("<a href=\"" + href + "\" title=\"" + (title || '') + "\">" + text + "</a>")
@@ -2575,16 +2593,22 @@ function init () {
    return ("<p>" + text + "</p>")
  };

-  if (typeof __docsify__.markdown === 'function') {
+  if (typeof $docsify.markdown === 'function') {
    markdown.setOptions({ renderer: renderer });
-    markdown = __docsify__.markdown.call(this, markdown);
+    markdown = $docsify.markdown.call(this, markdown);
  } else {
-    markdown.setOptions(merge({ renderer: renderer }, __docsify__.markdown));
+    markdown.setOptions(merge({ renderer: renderer }, $docsify.markdown));
  }

  var md = markdown;

  markdown = function (text) { return emojify(md(text)); };
+
+  window.Docsify.utils.marked = function (text) {
+    var result = markdown(text);
+    toc = [];
+    return result
+  };
 }

 /**
@@ -2592,27 +2616,35 @@ function init () {
 */
 function renderApp (dom, replace) {
  var nav = document.querySelector('nav') || document.createElement('nav');
+  var body = document.body;
+  var head = document.head;

-  if (!__docsify__.repo) { nav.classList.add('no-badge'); }
+  if (!$docsify.repo) { nav.classList.add('no-badge'); }

-  dom[replace ? 'outerHTML' : 'innerHTML'] = corner(__docsify__.repo) +
-    (__docsify__.coverpage ? cover() : '') +
+  dom[replace ? 'outerHTML' : 'innerHTML'] = corner($docsify.repo) +
+    ($docsify.coverpage ? cover() : '') +
    main();
-  document.body.insertBefore(nav, document.body.children[0]);
+  body.insertBefore(nav, body.children[0]);

  // theme color
-  if (__docsify__.themeColor) {
-    document.head.innerHTML += theme(__docsify__.themeColor);
+  if ($docsify.themeColor) {
+    head.innerHTML += theme($docsify.themeColor);
    cssVars();
  }

+  // render name
+  if ($docsify.name) {
+    var aside = document.querySelector('.sidebar');
+    aside.innerHTML = "<h1><a href=\"" + ($docsify.nameLink) + "\">" + ($docsify.name) + "</a></h1>" + aside.innerHTML;
+  }
+
  // bind toggle
  bindToggle('button.sidebar-toggle');
  // bind sticky effect
-  if (__docsify__.coverpage) {
+  if ($docsify.coverpage) {
    !isMobile() && window.addEventListener('scroll', sticky);
  } else {
-    document.body.classList.add('sticky');
+    body.classList.add('sticky');
  }
 }

@@ -2621,7 +2653,7 @@ function renderApp (dom, replace) {
 */
 function renderArticle (content) {
  renderTo('article', content ? markdown(content) : 'not found');
-  if (!__docsify__.loadSidebar) { renderSidebar(); }
+  if (!$docsify.loadSidebar) { renderSidebar(); }

  if (content && typeof Vue !== 'undefined') {
    CACHE.vm && CACHE.vm.$destroy();
@@ -2638,7 +2670,7 @@ function renderArticle (content) {
      : new Vue({ el: 'main' }); // eslint-disable-line
    CACHE.vm && CACHE.vm.$nextTick(function (_) { return scrollActiveSidebar(); });
  }
-  if (__docsify__.auto2top) { setTimeout(function () { return scroll2Top(__docsify__.auto2top); }, 0); }
+  if ($docsify.auto2top) { setTimeout(function () { return scroll2Top($docsify.auto2top); }, 0); }
 }

 /**
@@ -2663,12 +2695,11 @@ function renderSidebar (content) {
    // find url tag
    html = html.match(/<ul[^>]*>([\s\S]+)<\/ul>/g)[0];
  } else {
-    html = tree(genTree(toc, __docsify__.maxLevel), '<ul>');
+    html = tree(genTree(toc, $docsify.maxLevel), '<ul>');
  }

-  html = (__docsify__.name ? ("<h1><a href=\"" + (__docsify__.nameLink) + "\">" + (__docsify__.name) + "</a></h1>") : '') + html;
-  renderTo('aside.sidebar', html);
-  var target = activeLink('aside.sidebar', true);
+  renderTo('.sidebar-nav', html);
+  var target = activeLink('.sidebar-nav', true);
  if (target) { renderSubSidebar(target); }
  toc = [];

@@ -2676,8 +2707,8 @@ function renderSidebar (content) {
 }

 function renderSubSidebar (target) {
-  if (!__docsify__.subMaxLevel) { return }
-  target.parentNode.innerHTML += tree(genTree(toc, __docsify__.subMaxLevel), '<ul>');
+  if (!$docsify.subMaxLevel) { return }
+  target.parentNode.innerHTML += tree(genTree(toc, $docsify.subMaxLevel), '<ul>');
 }

 /**
@@ -2768,7 +2799,8 @@ var OPTIONS = merge({
  auto2top: false,
  name: '',
  themeColor: '',
-  nameLink: window.location.pathname
+  nameLink: window.location.pathname,
+  ga: ''
 }, window.$docsify);
 var script = document.currentScript || [].slice.call(document.getElementsByTagName('script')).pop();

@@ -2786,10 +2818,14 @@ if (script) {
 }

 // utils
-window.__docsify__ = OPTIONS;
+window.$docsify = OPTIONS;
+window.Docsify = {
+  installed: true,
+  utils: merge({}, utils)
+};

 // load options
-init(OPTIONS);
+init();

 var cacheRoute = null;
 var cacheXhr = null;
@@ -2807,6 +2843,7 @@ var mainRender = function (cb) {
  }

  var page;
+
  if (!route) {
    page = OPTIONS.homepage || 'README.md';
  } else if (/\/$/.test(route)) {
@@ -2851,7 +2888,8 @@ var Docsify = function () {
  var main = function () {
    mainRender(function (_) {
      scrollIntoView();
-      activeLink('nav');
+      activeLink('nav')
+      ;[].concat(window.$docsify.plugins).forEach(function (fn) { return fn && fn(); });
    });
  };

@@ -0,0 +1,50 @@
+this.D = this.D || {};
+this.D.GA = (function () {
+'use strict';
+
+// From https://github.com/egoist/vue-ga/blob/master/src/index.js
+
+function appendScript () {
+  var script = document.createElement('script');
+  script.async = true;
+  script.src = 'https://www.google-analytics.com/analytics.js';
+  document.body.appendChild(script);
+}
+
+function init (id) {
+  if (!window.ga) {
+    appendScript();
+    window.ga = window.ga || function () {
+      (window.ga.q = window.ga.q || []).push(arguments);
+    };
+    window.ga.l = Number(new Date());
+    window.ga('create', id, 'auto');
+  }
+}
+
+function collect () {
+  init(window.$docsify.ga);
+  window.ga('set', 'page', location.href);
+  window.ga('send', 'pageview');
+}
+
+var install = function () {
+  if (!window.Docsify || !window.Docsify.installed) {
+    console.error('[Docsify] Please load docsify.js first.');
+    return
+  }
+
+  if (!window.$docsify.ga) {
+    console.error('[Docsify] ga is required.');
+    return
+  }
+
+  collect();
+  window.$docsify.plugins = [].concat(window.$docsify.plugins, collect);
+};
+
+var ga = install();
+
+return ga;
+
+}());
@@ -0,0 +1 @@
+this.D=this.D||{},this.D.GA=function(){"use strict";function o(){var o=document.createElement("script");o.async=!0,o.src="https://www.google-analytics.com/analytics.js",document.body.appendChild(o)}function i(i){window.ga||(o(),window.ga=window.ga||function(){(window.ga.q=window.ga.q||[]).push(arguments)},window.ga.l=Number(new Date),window.ga("create",i,"auto"))}function n(){i(window.$docsify.ga),window.ga("set","page",location.href),window.ga("send","pageview")}var w=function(){return window.Docsify&&window.Docsify.installed?window.$docsify.ga?(n(),void(window.$docsify.plugins=[].concat(window.$docsify.plugins,n))):void console.error("[Docsify] ga is required."):void console.error("[Docsify] Please load docsify.js first.")},s=w();return s}();
@@ -0,0 +1,284 @@
+this.D = this.D || {};
+this.D.Search = (function () {
+'use strict';
+
+var INDEXS = {};
+var CONFIG = {
+  placeholder: 'Type to search',
+  paths: 'auto',
+  maxAge: 86400000 // 1 day
+};
+
+var isObj = function (obj) {
+  return Object.prototype.toString.call(obj) === '[object Object]'
+};
+
+var escapeHtml = function (string) {
+  var entityMap = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+    '/': '&#x2F;'
+  };
+
+  return String(string).replace(/[&<>"'\/]/g, function (s) { return entityMap[s]; })
+};
+
+/**
+ * find all filepath from A tag
+ */
+var getAllPaths = function () {
+  var paths = [];[].slice.call(document.querySelectorAll('a'))
+    .map(function (node) {
+      var href = node.href;
+      if (/#\/[^#]*?$/.test(href)) {
+        var path = href.replace(/^[^#]+#/, '');
+
+        if (paths.indexOf(path) <= 0) { paths.push(path); }
+      }
+    });
+
+  return paths
+};
+
+/**
+ * return file path
+ */
+var genFilePath = function (path) {
+  var basePath = window.$docsify.basePath;
+  var filePath = /\/$/.test(path) ? (path + "README.md") : (path + ".md");
+
+  filePath = basePath + filePath;
+
+  return filePath.replace(/\/+/g, '/')
+};
+
+/**
+ * generate index
+ */
+var genIndex = function (path, content) {
+  if ( content === void 0 ) content = '';
+
+  INDEXS[path] = { slug: '', title: '', body: '' };
+  var slug;
+
+  content
+    // remove PRE and TEMPLATE tag
+    .replace(/<template[^>]*?>[\s\S]+?<\/template>/g, '')
+    // find all html tag
+    .replace(/<(\w+)([^>]*?)>([\s\S]+?)<\//g, function (match, tag, attr, html) {
+      // remove all html tag
+      var text = html.replace(/<[^>]+>/g, '');
+
+      // tag is headline
+      if (/^h\d$/.test(tag)) {
+        // <h1 id="xxx"></h1>
+        var id = attr.match(/id="(\S+)"/)[1];
+
+        slug = ("#/" + path + "#" + id).replace(/\/+/, '/');
+        INDEXS[slug] = { slug: slug, title: text, body: '' };
+      } else {
+        // other html tag
+        if (!INDEXS[slug]) {
+          INDEXS[slug] = {};
+        } else {
+          if (INDEXS[slug].body && INDEXS[slug].body.length) {
+            INDEXS[slug].body += '\n' + text;
+          } else {
+            INDEXS[slug].body = text;
+          }
+        }
+      }
+    });
+};
+
+/**
+ * component
+ */
+var SearchComponent = function SearchComponent () {
+  if (this.rendered) { return }
+
+  this.style();
+
+  var el = document.createElement('div');
+  var aside = document.querySelector('aside');
+
+  el.classList.add('search');
+  aside.insertBefore(el, aside.children[0]);
+  this.render(el);
+  this.rendered = true;
+  this.bindEvent();
+};
+
+SearchComponent.prototype.style = function style () {
+  var code = "\n      .sidebar {\n        padding-top: 0;\n      }\n\n      .search {\n        margin-bottom: 20px;\n        padding: 6px;\n        border-bottom: 1px solid #eee;\n      }\n\n      .search .results-panel {\n        display: none;\n      }\n\n      .search .results-panel.show {\n        display: block;\n      }\n\n      .search input {\n        outline: none;\n        border: none;\n        width: 100%;\n        padding: 7px;\n        line-height: 22px;\n        font-size: 14px;\n      }\n\n      .search h2 {\n        font-size: 17px;\n        margin: 10px 0;\n      }\n\n      .search a {\n        text-decoration: none;\n        color: inherit;\n      }\n\n      .search .matching-post {\n        border-bottom: 1px solid #eee;\n      }\n\n      .search .matching-post:last-child {\n        border-bottom: 0;\n      }\n\n      .search p {\n        font-size: 14px;\n        overflow: hidden;\n        text-overflow: ellipsis;\n        display: -webkit-box;\n        -webkit-line-clamp: 2;\n        -webkit-box-orient: vertical;\n      }\n\n      .search p.empty {\n        text-align: center;\n      }\n    ";
+  var style = document.createElement('style');
+
+  style.innerHTML = code;
+  document.head.appendChild(style);
+};
+
+SearchComponent.prototype.render = function render (dom) {
+  dom.innerHTML = "<input type=\"search\" placeholder=\"" + (CONFIG.placeholder) + "\" /><div class=\"results-panel\"></div>";
+};
+
+SearchComponent.prototype.bindEvent = function bindEvent () {
+    var this$1 = this;
+
+  var input = document.querySelector('.search input');
+  var panel = document.querySelector('.results-panel');
+
+  input.addEventListener('input', function (e) {
+    var target = e.target;
+
+    if (target.value.trim() !== '') {
+      var matchingPosts = this$1.search(target.value);
+      var html = '';
+
+      matchingPosts.forEach(function (post, index) {
+        html += "\n          <div class=\"matching-post\">\n            <h2><a href=\"" + (post.url) + "\">" + (post.title) + "</a></h2>\n            <p>" + (post.content) + "</p>\n          </div>\n          ";
+      });
+      if (panel.classList.contains('results-panel')) {
+        panel.classList.add('show');
+        panel.innerHTML = html || '<p class="empty">No Results!</p>';
+      }
+    } else {
+      if (panel.classList.contains('results-panel')) {
+        panel.classList.remove('show');
+        panel.innerHTML = '';
+      }
+    }
+  });
+};
+
+// From [weex website] https://weex-project.io/js/common.js
+SearchComponent.prototype.search = function search (keywords) {
+  var matchingResults = [];
+  var data = Object.keys(INDEXS).map(function (key) { return INDEXS[key]; });
+
+  keywords = keywords.trim().split(/[\s\-\，\\/]+/);
+
+  var loop = function ( i ) {
+    var post = data[i];
+    var isMatch = false;
+    var resultStr = '';
+    var postTitle = post.title && post.title.trim();
+    var postContent = post.body && post.body.trim();
+    var postUrl = post.slug || '';
+
+    if (postTitle !== '' && postContent !== '') {
+      keywords.forEach(function (keyword, i) {
+        var regEx = new RegExp(keyword, 'gi');
+        var indexTitle = -1;
+        var indexContent = -1;
+
+        indexTitle = postTitle.search(regEx);
+        indexContent = postContent.search(regEx);
+
+        if (indexTitle < 0 && indexContent < 0) {
+          isMatch = false;
+        } else {
+          isMatch = true;
+          if (indexContent < 0) { indexContent = 0; }
+
+          var start = 0;
+          var end = 0;
+
+          start = indexContent < 11 ? 0 : indexContent - 10;
+          end = start === 0 ? 70 : indexContent + keyword.length + 60;
+
+          if (end > postContent.length) { end = postContent.length; }
+
+          var matchContent = '...' +
+            postContent
+              .substring(start, end)
+              .replace(regEx, ("<em class=\"search-keyword\">" + keyword + "</em>")) +
+              '...';
+
+          resultStr += matchContent;
+        }
+      });
+
+      if (isMatch) {
+        var matchingPost = {
+          title: escapeHtml(postTitle),
+          content: resultStr,
+          url: postUrl
+        };
+
+        matchingResults.push(matchingPost);
+      }
+    }
+  };
+
+    for (var i = 0; i < data.length; i++) loop( i );
+
+  return matchingResults
+};
+
+var searchPlugin = function () {
+  var isAuto = CONFIG.paths === 'auto';
+  var isExpired = localStorage.getItem('docsify.search.expires') < Date.now();
+
+  INDEXS = JSON.parse(localStorage.getItem('docsify.search.index'));
+
+  if (isExpired) {
+    INDEXS = {};
+  } else if (!isAuto) {
+    return
+  }
+
+  var count = 0;
+  var paths = isAuto ? getAllPaths() : CONFIG.paths;
+  var len = paths.length;
+  var ref = window.Docsify.utils;
+  var load = ref.load;
+  var marked = ref.marked;
+  var slugify = ref.slugify;
+  var done = function () {
+    localStorage.setItem('docsify.search.expires', Date.now() + CONFIG.maxAge);
+    localStorage.setItem('docsify.search.index', JSON.stringify(INDEXS));
+  };
+
+  paths.forEach(function (path) {
+    if (INDEXS[path]) { return count++ }
+
+    load(genFilePath(path)).then(function (content) {
+      genIndex(path, marked(content));
+      slugify.clear();
+      count++;
+
+      if (len === count) { done(); }
+    });
+  });
+};
+
+var install = function () {
+  if (!window.Docsify || !window.Docsify.installed) {
+    console.error('[Docsify] Please load docsify.js first.');
+    return
+  }
+
+  window.$docsify.plugins = [].concat(window.$docsify.plugins, searchPlugin);
+
+  var userConfig = window.$docsify.search;
+  var isNil = window.Docsify.utils.isNil;
+
+  if (Array.isArray(userConfig)) {
+    CONFIG.paths = userConfig;
+  } else if (isObj(userConfig)) {
+    CONFIG.paths = Array.isArray(userConfig.paths) ? userConfig.paths : 'auto';
+    CONFIG.maxAge = isNil(userConfig.maxAge) ? CONFIG.maxAge : userConfig.maxAge;
+    CONFIG.placeholder = userConfig.placeholder || CONFIG.placeholder;
+  }
+
+  new SearchComponent();
+};
+
+var search = install();
+
+return search;
+
+}());
@@ -0,0 +1 @@
+this.D=this.D||{},this.D.Search=function(){"use strict";var e={},n={placeholder:"Type to search",paths:"auto",maxAge:864e5},t=function(e){return"[object Object]"===Object.prototype.toString.call(e)},r=function(e){var n={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;","/":"&#x2F;"};return String(e).replace(/[&<>"'\/]/g,function(e){return n[e]})},i=function(){var e=[];return[].slice.call(document.querySelectorAll("a")).map(function(n){var t=n.href;if(/#\/[^#]*?$/.test(t)){var r=t.replace(/^[^#]+#/,"");e.indexOf(r)<=0&&e.push(r)}}),e},a=function(e){var n=window.$docsify.basePath,t=/\/$/.test(e)?e+"README.md":e+".md";return t=n+t,t.replace(/\/+/g,"/")},o=function(n,t){void 0===t&&(t=""),e[n]={slug:"",title:"",body:""};var r;t.replace(/<template[^>]*?>[\s\S]+?<\/template>/g,"").replace(/<(\w+)([^>]*?)>([\s\S]+?)<\//g,function(t,i,a,o){var s=o.replace(/<[^>]+>/g,"");if(/^h\d$/.test(i)){var c=a.match(/id="(\S+)"/)[1];r=("#/"+n+"#"+c).replace(/\/+/,"/"),e[r]={slug:r,title:s,body:""}}else e[r]?e[r].body&&e[r].body.length?e[r].body+="\n"+s:e[r].body=s:e[r]={}})},s=function(){if(!this.rendered){this.style();var e=document.createElement("div"),n=document.querySelector("aside");e.classList.add("search"),n.insertBefore(e,n.children[0]),this.render(e),this.rendered=!0,this.bindEvent()}};s.prototype.style=function e(){var n="\n      .sidebar {\n        padding-top: 0;\n      }\n\n      .search {\n        margin-bottom: 20px;\n        padding: 6px;\n        border-bottom: 1px solid #eee;\n      }\n\n      .search .results-panel {\n        display: none;\n      }\n\n      .search .results-panel.show {\n        display: block;\n      }\n\n      .search input {\n        outline: none;\n        border: none;\n        width: 100%;\n        padding: 7px;\n        line-height: 22px;\n        font-size: 14px;\n      }\n\n      .search h2 {\n        font-size: 17px;\n        margin: 10px 0;\n      }\n\n      .search a {\n        text-decoration: none;\n        color: inherit;\n      }\n\n      .search .matching-post {\n        border-bottom: 1px solid #eee;\n      }\n\n      .search .matching-post:last-child {\n        border-bottom: 0;\n      }\n\n      .search p {\n        font-size: 14px;\n        overflow: hidden;\n        text-overflow: ellipsis;\n        display: -webkit-box;\n        -webkit-line-clamp: 2;\n        -webkit-box-orient: vertical;\n      }\n\n      .search p.empty {\n        text-align: center;\n      }\n    ",e=document.createElement("style");e.innerHTML=n,document.head.appendChild(e)},s.prototype.render=function(e){e.innerHTML='<input type="search" placeholder="'+n.placeholder+'" /><div class="results-panel"></div>'},s.prototype.bindEvent=function(){var e=this,n=document.querySelector(".search input"),t=document.querySelector(".results-panel");n.addEventListener("input",function(n){var r=n.target;if(""!==r.value.trim()){var i=e.search(r.value),a="";i.forEach(function(e,n){a+='\n          <div class="matching-post">\n            <h2><a href="'+e.url+'">'+e.title+"</a></h2>\n            <p>"+e.content+"</p>\n          </div>\n          "}),t.classList.contains("results-panel")&&(t.classList.add("show"),t.innerHTML=a||'<p class="empty">No Results!</p>')}else t.classList.contains("results-panel")&&(t.classList.remove("show"),t.innerHTML="")})},s.prototype.search=function(n){var t=[],i=Object.keys(e).map(function(n){return e[n]});n=n.trim().split(/[\s\-\，\\\/]+/);for(var a=function(e){var a=i[e],o=!1,s="",c=a.title&&a.title.trim(),l=a.body&&a.body.trim(),d=a.slug||"";if(""!==c&&""!==l&&(n.forEach(function(e,n){var t=new RegExp(e,"gi"),r=-1,i=-1;if(r=c.search(t),i=l.search(t),r<0&&i<0)o=!1;else{o=!0,i<0&&(i=0);var a=0,d=0;a=i<11?0:i-10,d=0===a?70:i+e.length+60,d>l.length&&(d=l.length);var p="..."+l.substring(a,d).replace(t,'<em class="search-keyword">'+e+"</em>")+"...";s+=p}}),o)){var p={title:r(c),content:s,url:d};t.push(p)}},o=0;o<i.length;o++)a(o);return t};var c=function(){var t="auto"===n.paths,r=localStorage.getItem("docsify.search.expires")<Date.now();if(e=JSON.parse(localStorage.getItem("docsify.search.index")),r)e={};else if(!t)return;var s=0,c=t?i():n.paths,l=c.length,d=window.Docsify.utils,p=d.load,h=d.marked,u=d.slugify,f=function(){localStorage.setItem("docsify.search.expires",Date.now()+n.maxAge),localStorage.setItem("docsify.search.index",JSON.stringify(e))};c.forEach(function(n){return e[n]?s++:void p(a(n)).then(function(e){o(n,h(e)),u.clear(),s++,l===s&&f()})})},l=function(){if(!window.Docsify||!window.Docsify.installed)return void console.error("[Docsify] Please load docsify.js first.");window.$docsify.plugins=[].concat(window.$docsify.plugins,c);var e=window.$docsify.search,r=window.Docsify.utils.isNil;Array.isArray(e)?n.paths=e:t(e)&&(n.paths=Array.isArray(e.paths)?e.paths:"auto",n.maxAge=r(e.maxAge)?n.maxAge:e.maxAge,n.placeholder=e.placeholder||n.placeholder),new s},d=l();return d}();
@@ -1,6 +1,6 @@
 {
  "name": "docsify",
-  "version": "2.0.0",
+  "version": "2.2.0",
  "description": "A magical documentation generator.",
  "main": "lib/docsify.js",
  "files": [
@@ -10,7 +10,8 @@
  ],
  "scripts": {
    "build": "rm -rf lib themes && node build/build.js && mkdir lib/themes && mkdir themes && node build/build-css.js",
-    "dev": "node app.js & nodemon -w src -e js,css --exec 'npm run build'",
+    "dev:build": "rm -rf lib themes && mkdir themes && node build/build.js --dev && node build/build-css.js --dev",
+    "dev": "node app.js & nodemon -w src -e js,css --exec 'npm run dev:build'",
    "test": "eslint src test"
  },
  "repository": {
@@ -9,7 +9,7 @@ export function scrollActiveSidebar () {

  let hoveredOverSidebar = false
  const anchors = document.querySelectorAll('.anchor')
-  const sidebar = document.querySelector('aside.sidebar')
+  const sidebar = document.querySelector('.sidebar')
  const sidebarHeight = sidebar.clientHeight

  const nav = {}
@@ -126,7 +126,7 @@ export function bindToggle (dom) {
  dom.addEventListener('click', () => body.classList.toggle('close'))

  if (isMobile()) {
-    const sidebar = document.querySelector('aside.sidebar')
+    const sidebar = document.querySelector('.sidebar')
    sidebar.addEventListener('click', () => {
      body.classList.toggle('close')
      setTimeout(() => activeLink(sidebar, true), 0)
@@ -1,8 +1,8 @@
-import { load, camel2kebab, isNil, getRoute, merge } from './util'
+import * as utils from './util'
 import { scrollIntoView, activeLink } from './event'
 import * as render from './render'

-const OPTIONS = merge({
+const OPTIONS = utils.merge({
  el: '#app',
  repo: '',
  maxLevel: 6,
@@ -15,15 +15,16 @@ const OPTIONS = merge({
  auto2top: false,
  name: '',
  themeColor: '',
-  nameLink: window.location.pathname
+  nameLink: window.location.pathname,
+  ga: ''
 }, window.$docsify)
 const script = document.currentScript || [].slice.call(document.getElementsByTagName('script')).pop()

 // load configuration for script attribute
 if (script) {
  for (const prop in OPTIONS) {
-    const val = script.getAttribute('data-' + camel2kebab(prop))
-    OPTIONS[prop] = isNil(val) ? OPTIONS[prop] : (val || true)
+    const val = script.getAttribute('data-' + utils.camel2kebab(prop))
+    OPTIONS[prop] = utils.isNil(val) ? OPTIONS[prop] : (val || true)
  }
  if (OPTIONS.loadSidebar === true) OPTIONS.loadSidebar = '_sidebar.md'
  if (OPTIONS.loadNavbar === true) OPTIONS.loadNavbar = '_navbar.md'
@@ -33,16 +34,20 @@ if (script) {
 }

 // utils
-window.__docsify__ = OPTIONS
+window.$docsify = OPTIONS
+window.Docsify = {
+  installed: true,
+  utils: utils.merge({}, utils)
+}

 // load options
-render.init(OPTIONS)
+render.init()

 let cacheRoute = null
 let cacheXhr = null

 const mainRender = function (cb) {
-  const route = OPTIONS.basePath + getRoute()
+  const route = OPTIONS.basePath + utils.getRoute()
  if (cacheRoute === route) return cb()

  let basePath = cacheRoute = route
@@ -54,6 +59,7 @@ const mainRender = function (cb) {
  }

  let page
+
  if (!route) {
    page = OPTIONS.homepage || 'README.md'
  } else if (/\/$/.test(route)) {
@@ -64,12 +70,12 @@ const mainRender = function (cb) {

  // Render Cover page
  if (OPTIONS.coverpage && page === OPTIONS.homepage) {
-    load(OPTIONS.coverpage).then(render.renderCover)
+    utils.load(OPTIONS.coverpage).then(render.renderCover)
  }

  cacheXhr && cacheXhr.abort && cacheXhr.abort()
  // Render markdown file
-  cacheXhr = load(page, 'GET', render.renderLoading)
+  cacheXhr = utils.load(page, 'GET', render.renderLoading)
  cacheXhr.then(result => {
    render.renderArticle(result)
    // clear cover
@@ -78,8 +84,8 @@ const mainRender = function (cb) {
    if (OPTIONS.loadSidebar) {
      const renderSidebar = result => { render.renderSidebar(result); cb() }

-      load(basePath + OPTIONS.loadSidebar).then(renderSidebar,
-        _ => load(OPTIONS.loadSidebar).then(renderSidebar))
+      utils.load(basePath + OPTIONS.loadSidebar).then(renderSidebar,
+        _ => utils.load(OPTIONS.loadSidebar).then(renderSidebar))
    } else {
      cb()
    }
@@ -87,8 +93,8 @@ const mainRender = function (cb) {

  // Render navbar
  if (OPTIONS.loadNavbar) {
-    load(basePath + OPTIONS.loadNavbar).then(render.renderNavbar,
-      _ => load(OPTIONS.loadNavbar).then(render.renderNavbar))
+    utils.load(basePath + OPTIONS.loadNavbar).then(render.renderNavbar,
+      _ => utils.load(OPTIONS.loadNavbar).then(render.renderNavbar))
  }
 }

@@ -99,6 +105,7 @@ const Docsify = function () {
    mainRender(_ => {
      scrollIntoView()
      activeLink('nav')
+      ;[].concat(window.$docsify.plugins).forEach(fn => fn && fn())
    })
  }

@@ -0,0 +1,42 @@
+// From https://github.com/egoist/vue-ga/blob/master/src/index.js
+
+function appendScript () {
+  const script = document.createElement('script')
+  script.async = true
+  script.src = 'https://www.google-analytics.com/analytics.js'
+  document.body.appendChild(script)
+}
+
+function init (id) {
+  if (!window.ga) {
+    appendScript()
+    window.ga = window.ga || function () {
+      (window.ga.q = window.ga.q || []).push(arguments)
+    }
+    window.ga.l = Number(new Date())
+    window.ga('create', id, 'auto')
+  }
+}
+
+function collect () {
+  init(window.$docsify.ga)
+  window.ga('set', 'page', location.href)
+  window.ga('send', 'pageview')
+}
+
+const install = function () {
+  if (!window.Docsify || !window.Docsify.installed) {
+    console.error('[Docsify] Please load docsify.js first.')
+    return
+  }
+
+  if (!window.$docsify.ga) {
+    console.error('[Docsify] ga is required.')
+    return
+  }
+
+  collect()
+  window.$docsify.plugins = [].concat(window.$docsify.plugins, collect)
+}
+
+export default install()
@@ -0,0 +1,334 @@
+let INDEXS = {}
+const CONFIG = {
+  placeholder: 'Type to search',
+  paths: 'auto',
+  maxAge: 86400000 // 1 day
+}
+
+const isObj = function (obj) {
+  return Object.prototype.toString.call(obj) === '[object Object]'
+}
+
+const escapeHtml = function (string) {
+  const entityMap = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+    '/': '&#x2F;'
+  }
+
+  return String(string).replace(/[&<>"'\/]/g, s => entityMap[s])
+}
+
+/**
+ * find all filepath from A tag
+ */
+const getAllPaths = function () {
+  const paths = []
+
+  ;[].slice.call(document.querySelectorAll('a'))
+    .map(node => {
+      const href = node.href
+      if (/#\/[^#]*?$/.test(href)) {
+        const path = href.replace(/^[^#]+#/, '')
+
+        if (paths.indexOf(path) <= 0) paths.push(path)
+      }
+    })
+
+  return paths
+}
+
+/**
+ * return file path
+ */
+const genFilePath = function (path) {
+  const basePath = window.$docsify.basePath
+  let filePath = /\/$/.test(path) ? `${path}README.md` : `${path}.md`
+
+  filePath = basePath + filePath
+
+  return filePath.replace(/\/+/g, '/')
+}
+
+/**
+ * generate index
+ */
+const genIndex = function (path, content = '') {
+  INDEXS[path] = { slug: '', title: '', body: '' }
+  let slug
+
+  content
+    // remove PRE and TEMPLATE tag
+    .replace(/<template[^>]*?>[\s\S]+?<\/template>/g, '')
+    // find all html tag
+    .replace(/<(\w+)([^>]*?)>([\s\S]+?)<\//g, (match, tag, attr, html) => {
+      // remove all html tag
+      const text = html.replace(/<[^>]+>/g, '')
+
+      // tag is headline
+      if (/^h\d$/.test(tag)) {
+        // <h1 id="xxx"></h1>
+        const id = attr.match(/id="(\S+)"/)[1]
+
+        slug = `#/${path}#${id}`.replace(/\/+/, '/')
+        INDEXS[slug] = { slug, title: text, body: '' }
+      } else {
+        // other html tag
+        if (!INDEXS[slug]) {
+          INDEXS[slug] = {}
+        } else {
+          if (INDEXS[slug].body && INDEXS[slug].body.length) {
+            INDEXS[slug].body += '\n' + text
+          } else {
+            INDEXS[slug].body = text
+          }
+        }
+      }
+    })
+}
+
+/**
+ * component
+ */
+class SearchComponent {
+  constructor () {
+    if (this.rendered) return
+
+    this.style()
+
+    const el = document.createElement('div')
+    const aside = document.querySelector('aside')
+
+    el.classList.add('search')
+    aside.insertBefore(el, aside.children[0])
+    this.render(el)
+    this.rendered = true
+    this.bindEvent()
+  }
+
+  style () {
+    const code = `
+      .sidebar {
+        padding-top: 0;
+      }
+
+      .search {
+        margin-bottom: 20px;
+        padding: 6px;
+        border-bottom: 1px solid #eee;
+      }
+
+      .search .results-panel {
+        display: none;
+      }
+
+      .search .results-panel.show {
+        display: block;
+      }
+
+      .search input {
+        outline: none;
+        border: none;
+        width: 100%;
+        padding: 7px;
+        line-height: 22px;
+        font-size: 14px;
+      }
+
+      .search h2 {
+        font-size: 17px;
+        margin: 10px 0;
+      }
+
+      .search a {
+        text-decoration: none;
+        color: inherit;
+      }
+
+      .search .matching-post {
+        border-bottom: 1px solid #eee;
+      }
+
+      .search .matching-post:last-child {
+        border-bottom: 0;
+      }
+
+      .search p {
+        font-size: 14px;
+        overflow: hidden;
+        text-overflow: ellipsis;
+        display: -webkit-box;
+        -webkit-line-clamp: 2;
+        -webkit-box-orient: vertical;
+      }
+
+      .search p.empty {
+        text-align: center;
+      }
+    `
+    const style = document.createElement('style')
+
+    style.innerHTML = code
+    document.head.appendChild(style)
+  }
+
+  render (dom) {
+    dom.innerHTML = `<input type="search" placeholder="${CONFIG.placeholder}" /><div class="results-panel"></div>`
+  }
+
+  bindEvent () {
+    const input = document.querySelector('.search input')
+    const panel = document.querySelector('.results-panel')
+
+    input.addEventListener('input', e => {
+      const target = e.target
+
+      if (target.value.trim() !== '') {
+        const matchingPosts = this.search(target.value)
+        let html = ''
+
+        matchingPosts.forEach(function (post, index) {
+          html += `
+          <div class="matching-post">
+            <h2><a href="${post.url}">${post.title}</a></h2>
+            <p>${post.content}</p>
+          </div>
+          `
+        })
+        if (panel.classList.contains('results-panel')) {
+          panel.classList.add('show')
+          panel.innerHTML = html || '<p class="empty">No Results!</p>'
+        }
+      } else {
+        if (panel.classList.contains('results-panel')) {
+          panel.classList.remove('show')
+          panel.innerHTML = ''
+        }
+      }
+    })
+  }
+
+  // From [weex website] https://weex-project.io/js/common.js
+  search (keywords) {
+    const matchingResults = []
+    const data = Object.keys(INDEXS).map(key => INDEXS[key])
+
+    keywords = keywords.trim().split(/[\s\-\，\\/]+/)
+
+    for (let i = 0; i < data.length; i++) {
+      const post = data[i]
+      let isMatch = false
+      let resultStr = ''
+      const postTitle = post.title && post.title.trim()
+      const postContent = post.body && post.body.trim()
+      const postUrl = post.slug || ''
+
+      if (postTitle !== '' && postContent !== '') {
+        keywords.forEach((keyword, i) => {
+          const regEx = new RegExp(keyword, 'gi')
+          let indexTitle = -1
+          let indexContent = -1
+
+          indexTitle = postTitle.search(regEx)
+          indexContent = postContent.search(regEx)
+
+          if (indexTitle < 0 && indexContent < 0) {
+            isMatch = false
+          } else {
+            isMatch = true
+            if (indexContent < 0) indexContent = 0
+
+            let start = 0
+            let end = 0
+
+            start = indexContent < 11 ? 0 : indexContent - 10
+            end = start === 0 ? 70 : indexContent + keyword.length + 60
+
+            if (end > postContent.length) end = postContent.length
+
+            const matchContent = '...' +
+              postContent
+                .substring(start, end)
+                .replace(regEx, `<em class="search-keyword">${keyword}</em>`) +
+                '...'
+
+            resultStr += matchContent
+          }
+        })
+
+        if (isMatch) {
+          const matchingPost = {
+            title: escapeHtml(postTitle),
+            content: resultStr,
+            url: postUrl
+          }
+
+          matchingResults.push(matchingPost)
+        }
+      }
+    }
+
+    return matchingResults
+  }
+}
+
+const searchPlugin = function () {
+  const isAuto = CONFIG.paths === 'auto'
+  const isExpired = localStorage.getItem('docsify.search.expires') < Date.now()
+
+  INDEXS = JSON.parse(localStorage.getItem('docsify.search.index'))
+
+  if (isExpired) {
+    INDEXS = {}
+  } else if (!isAuto) {
+    return
+  }
+
+  let count = 0
+  const paths = isAuto ? getAllPaths() : CONFIG.paths
+  const len = paths.length
+  const { load, marked, slugify } = window.Docsify.utils
+  const done = () => {
+    localStorage.setItem('docsify.search.expires', Date.now() + CONFIG.maxAge)
+    localStorage.setItem('docsify.search.index', JSON.stringify(INDEXS))
+  }
+
+  paths.forEach(path => {
+    if (INDEXS[path]) return count++
+
+    load(genFilePath(path)).then(content => {
+      genIndex(path, marked(content))
+      slugify.clear()
+      count++
+
+      if (len === count) done()
+    })
+  })
+}
+
+const install = function () {
+  if (!window.Docsify || !window.Docsify.installed) {
+    console.error('[Docsify] Please load docsify.js first.')
+    return
+  }
+
+  window.$docsify.plugins = [].concat(window.$docsify.plugins, searchPlugin)
+
+  const userConfig = window.$docsify.search
+  const isNil = window.Docsify.utils.isNil
+
+  if (Array.isArray(userConfig)) {
+    CONFIG.paths = userConfig
+  } else if (isObj(userConfig)) {
+    CONFIG.paths = Array.isArray(userConfig.paths) ? userConfig.paths : 'auto'
+    CONFIG.maxAge = isNil(userConfig.maxAge) ? CONFIG.maxAge : userConfig.maxAge
+    CONFIG.placeholder = userConfig.placeholder || CONFIG.placeholder
+  }
+
+  new SearchComponent()
+}
+
+export default install()
@@ -1,7 +1,7 @@
 import { load } from './util'

 function replaceVar (block) {
-  block.innerHTML = block.innerHTML.replace(/var\(\s*--theme-color.*?\)/g, __docsify__.themeColor)
+  block.innerHTML = block.innerHTML.replace(/var\(\s*--theme-color.*?\)/g, $docsify.themeColor)
 }

 export function cssVars () {
@@ -14,14 +14,17 @@ export function cssVars () {
    if (block.nodeName === 'STYLE') {
      replaceVar(block)
    } else if (block.nodeName === 'LINK') {
-      load(block.getAttribute('href'))
-        .then(res => {
-          const style = document.createElement('style')
+      const href = block.getAttribute('href')

-          style.innerHTML = res
-          document.head.appendChild(style)
-          replaceVar(style)
-        })
+      if (!/\.css$/.test(href)) return
+
+      load(href).then(res => {
+        const style = document.createElement('style')
+
+        style.innerHTML = res
+        document.head.appendChild(style)
+        replaceVar(style)
+      })
    }
  })
 }
@@ -39,11 +39,11 @@ export function init () {
  renderer.code = function (code, lang = '') {
    const hl = Prism.highlight(code, Prism.languages[lang] || Prism.languages.markup)

-    return `<pre v-pre data-lang="${lang}"><code class="lang-${lang}">${hl.replace(/:/g, '__colon__')}</code></pre>`
+    return `<pre v-pre data-lang="${lang}"><code class="lang-${lang}">${hl}</code></pre>`
  }
  renderer.link = function (href, title, text) {
    if (!/:/.test(href)) {
-      href = `#/${href}`.replace(/\/\//g, '/')
+      href = `#/${href}`.replace(/\/+/g, '/')
    }

    return `<a href="${href}" title="${title || ''}">${text}</a>`
@@ -57,16 +57,22 @@ export function init () {
    return `<p>${text}</p>`
  }

-  if (typeof __docsify__.markdown === 'function') {
+  if (typeof $docsify.markdown === 'function') {
    markdown.setOptions({ renderer })
-    markdown = __docsify__.markdown.call(this, markdown)
+    markdown = $docsify.markdown.call(this, markdown)
  } else {
-    markdown.setOptions(merge({ renderer }, __docsify__.markdown))
+    markdown.setOptions(merge({ renderer }, $docsify.markdown))
  }

  const md = markdown

  markdown = text => emojify(md(text))
+
+  window.Docsify.utils.marked = text => {
+    const result = markdown(text)
+    toc = []
+    return result
+  }
 }

 /**
@@ -74,27 +80,35 @@ export function init () {
 */
 export function renderApp (dom, replace) {
  const nav = document.querySelector('nav') || document.createElement('nav')
+  const body = document.body
+  const head = document.head

-  if (!__docsify__.repo) nav.classList.add('no-badge')
+  if (!$docsify.repo) nav.classList.add('no-badge')

-  dom[replace ? 'outerHTML' : 'innerHTML'] = tpl.corner(__docsify__.repo) +
-    (__docsify__.coverpage ? tpl.cover() : '') +
+  dom[replace ? 'outerHTML' : 'innerHTML'] = tpl.corner($docsify.repo) +
+    ($docsify.coverpage ? tpl.cover() : '') +
    tpl.main()
-  document.body.insertBefore(nav, document.body.children[0])
+  body.insertBefore(nav, body.children[0])

  // theme color
-  if (__docsify__.themeColor) {
-    document.head.innerHTML += tpl.theme(__docsify__.themeColor)
+  if ($docsify.themeColor) {
+    head.innerHTML += tpl.theme($docsify.themeColor)
    polyfill.cssVars()
  }

+  // render name
+  if ($docsify.name) {
+    const aside = document.querySelector('.sidebar')
+    aside.innerHTML = `<h1><a href="${$docsify.nameLink}">${$docsify.name}</a></h1>` + aside.innerHTML
+  }
+
  // bind toggle
  event.bindToggle('button.sidebar-toggle')
  // bind sticky effect
-  if (__docsify__.coverpage) {
+  if ($docsify.coverpage) {
    !isMobile() && window.addEventListener('scroll', event.sticky)
  } else {
-    document.body.classList.add('sticky')
+    body.classList.add('sticky')
  }
 }

@@ -103,7 +117,7 @@ export function renderApp (dom, replace) {
 */
 export function renderArticle (content) {
  renderTo('article', content ? markdown(content) : 'not found')
-  if (!__docsify__.loadSidebar) renderSidebar()
+  if (!$docsify.loadSidebar) renderSidebar()

  if (content && typeof Vue !== 'undefined') {
    CACHE.vm && CACHE.vm.$destroy()
@@ -120,7 +134,7 @@ export function renderArticle (content) {
      : new Vue({ el: 'main' }) // eslint-disable-line
    CACHE.vm && CACHE.vm.$nextTick(_ => event.scrollActiveSidebar())
  }
-  if (__docsify__.auto2top) setTimeout(() => event.scroll2Top(__docsify__.auto2top), 0)
+  if ($docsify.auto2top) setTimeout(() => event.scroll2Top($docsify.auto2top), 0)
 }

 /**
@@ -145,12 +159,11 @@ export function renderSidebar (content) {
    // find url tag
    html = html.match(/<ul[^>]*>([\s\S]+)<\/ul>/g)[0]
  } else {
-    html = tpl.tree(genTree(toc, __docsify__.maxLevel), '<ul>')
+    html = tpl.tree(genTree(toc, $docsify.maxLevel), '<ul>')
  }

-  html = (__docsify__.name ? `<h1><a href="${__docsify__.nameLink}">${__docsify__.name}</a></h1>` : '') + html
-  renderTo('aside.sidebar', html)
-  const target = event.activeLink('aside.sidebar', true)
+  renderTo('.sidebar-nav', html)
+  const target = event.activeLink('.sidebar-nav', true)
  if (target) renderSubSidebar(target)
  toc = []

@@ -158,8 +171,8 @@ export function renderSidebar (content) {
 }

 export function renderSubSidebar (target) {
-  if (!__docsify__.subMaxLevel) return
-  target.parentNode.innerHTML += tpl.tree(genTree(toc, __docsify__.subMaxLevel), '<ul>')
+  if (!$docsify.subMaxLevel) return
+  target.parentNode.innerHTML += tpl.tree(genTree(toc, $docsify.subMaxLevel), '<ul>')
 }

 /**
@@ -72,7 +72,9 @@ section.cover {

  .cover-main p:last-child a {
    border-radius: 2em;
-    border: 1px solid var(--theme-color, $color-primary);
+    border-width: 1px;
+    border-style: solid;
+    border-color: var(--theme-color, $color-primary);
    box-sizing: border-box;
    color: var(--theme-color, $color-primary);
    font-size: 1.05em;
@@ -24,6 +24,15 @@
  z-index: 999999;
 }

+.search a:hover {
+  color: var(--theme-color, $color-primary);
+}
+
+.search .search-keyword {
+  color: var(--theme-color, $color-primary);
+  font-style: normal;
+}
+
 html, body {
  height: 100%;
 }
@@ -103,7 +112,9 @@ nav {
    ul {
      border-radius: 2px;
      background-color: rgba($color-bg, .6);
-      border: 1px solid var(--theme-color, $color-primary);
+      border-width: 1px;
+      border-style: solid;
+      border-color: var(--theme-color, $color-primary);
      opacity: 0;
      overflow: hidden;
      padding: 0;
@@ -224,6 +235,23 @@ main {
  ul li ul {
    padding-left: 20px;
  }
+
+  &::-webkit-scrollbar {
+    width: 4px;
+  }
+
+  &::-webkit-scrollbar-thumb {
+    background: transparent;
+    border-radius: 4px;
+  }
+
+  &:hover::-webkit-scrollbar-thumb {
+    background: rgba(136, 136, 136, 0.4);
+  }
+
+  &:hover::-webkit-scrollbar-track {
+    background: rgba(136, 136, 136, 0.1);
+  }
 }

 /* sidebar toggle */
@@ -22,11 +22,12 @@ body {
  }

  ul li a {
-    color: #7f8c8d;
+    color: #505d6b;
    text-overflow: ellipsis;
    overflow: hidden;
    white-space: nowrap;
    text-decoration: none;
+    font-size: 14px;

    &:hover {
      text-decoration: underline;
@@ -23,7 +23,7 @@ export function corner (data) {
 * Render main content
 */
 export function main () {
-  const aside = `${toggle()}<aside class="sidebar"></aside>`
+  const aside = `${toggle()}<aside class="sidebar"><div class="sidebar-nav"></div></aside>`

  return (isMobile() ? `${aside}<main>` : `<main>${aside}`) +
    `<section class="content">
@@ -89,7 +89,7 @@ export function getRoute () {
  const loc = window.location
  if (cacheHash === loc.hash && !isNil(cacheRoute)) return cacheRoute

-  let route = loc.hash.match(/^#\/([^#]+)/)
+  let route = loc.hash.replace(/%23/g, '#').match(/^#\/([^#]+)/)

  if (route && route.length === 2) {
    route = route[1]
@@ -160,6 +160,7 @@ export const merge = Object.assign || function (to) {

 export function emojify (text) {
  return text
+    .replace(/<(pre|template)[^>]*?>([\s\S]+)<\/(pre|template)>/g, match => match.replace(/:/g, '__colon__'))
    .replace(/:(\w*?):/ig, '<img class="emoji" src="https://assets-cdn.github.com/images/icons/emoji/$1.png" alt="$1" />')
    .replace(/__colon__/g, ':')
 }
Author	SHA1	Message	Date
qingwei.li	5b25e7daca	-> v2.2.0	2017-02-09 22:17:29 +08:00
qingwei.li	a4bd5fd295	bump: 2.2.0	2017-02-09 22:17:23 +08:00
cinwell.liandGitHub	ac61bb0e75	feat(plugins): add Google Analytics plugin (#66 )	2017-02-09 22:16:15 +08:00
qingwei.li	9605c18fff	-> v2.1.0	2017-02-09 21:26:57 +08:00
qingwei.li	dc35b051d3	bump: 2.1.0	2017-02-09 21:26:49 +08:00
qingwei.li	0ca1ece188	docs(README): fix typo	2017-02-09 21:24:14 +08:00
qingwei.li	fc140ef957	fix(vue.css): update sidebar style	2017-02-09 21:24:14 +08:00
qingwei.li	e1da2f8a84	docs(README): add search	2017-02-09 21:24:14 +08:00
qingwei.li	eb5ff3e987	feat: add search, close #43	2017-02-09 21:24:14 +08:00
qingwei.li	12e2479014	fix: render name	2017-02-09 21:24:14 +08:00
qingwei.li	168d8475d5	-> v2.0.3	2017-02-07 20:18:28 +08:00
qingwei.li	7ba434e61d	bump: 2.0.3	2017-02-07 20:18:25 +08:00
qingwei.li	8cd386ae49	fix: css var polyfill	2017-02-07 20:17:54 +08:00
qingwei.li	8c7e4d7866	fix: rendering emojis	2017-02-07 20:17:12 +08:00
qingwei.li	cbaee21ded	fix: css var polyfill	2017-02-07 19:54:09 +08:00
qingwei.li	543cbbce81	-> v2.0.2	2017-02-05 14:50:09 +08:00
qingwei.li	72c34152d4	bump: 2.0.2	2017-02-05 14:50:04 +08:00
qingwei.li	44708554f7	fix: button style in cover page	2017-02-05 14:48:57 +08:00
qingwei.li	6e35f6481a	docs: update api	2017-02-05 13:53:36 +08:00
qingwei.li	115c80b2f2	-> v2.0.1	2017-02-05 13:50:36 +08:00
qingwei.li	addb34d38a	bump: 2.0.1	2017-02-05 13:47:32 +08:00
qingwei.li	1f12009a98	fix border style.	2017-02-05 13:47:03 +08:00
				`@@ -0,0 +1 @@`
				this.D=this.D\|\|{},this.D.GA=function(){"use strict";function o(){var o=document.createElement("script");o.async=!0,o.src="https://www.google-analytics.com/analytics.js",document.body.appendChild(o)}function i(i){window.ga\|\|(o(),window.ga=window.ga\|\|function(){(window.ga.q=window.ga.q\|\|[]).push(arguments)},window.ga.l=Number(new Date),window.ga("create",i,"auto"))}function n(){i(window.$docsify.ga),window.ga("set","page",location.href),window.ga("send","pageview")}var w=function(){return window.Docsify&&window.Docsify.installed?window.$docsify.ga?(n(),void(window.$docsify.plugins=[].concat(window.$docsify.plugins,n))):void console.error("[Docsify] ga is required."):void console.error("[Docsify] Please load docsify.js first.")},s=w();return s}();
				`@@ -0,0 +1 @@`
				this.D=this.D\|\|{},this.D.Search=function(){"use strict";var e={},n={placeholder:"Type to search",paths:"auto",maxAge:864e5},t=function(e){return"[object Object]"===Object.prototype.toString.call(e)},r=function(e){var n={"&":"&","<":"<",">":">",'"':""","'":"'","/":"/"};return String(e).replace(/[&<>"'\/]/g,function(e){return n[e]})},i=function(){var e=[];return[].slice.call(document.querySelectorAll("a")).map(function(n){var t=n.href;if(/#\/[^#]?$/.test(t)){var r=t.replace(/^[^#]+#/,"");e.indexOf(r)<=0&&e.push(r)}}),e},a=function(e){var n=window.$docsify.basePath,t=/\/$/.test(e)?e+"README.md":e+".md";return t=n+t,t.replace(/\/+/g,"/")},o=function(n,t){void 0===t&&(t=""),e[n]={slug:"",title:"",body:""};var r;t.replace(/<template[^>]?>[\s\S]+?<\/template>/g,"").replace(/<(\w+)([^>]*?)>([\s\S]+?)<\//g,function(t,i,a,o){var s=o.replace(/<[^>]+>/g,"");if(/^h\d$/.test(i)){var c=a.match(/id="(\S+)"/)[1];r=("#/"+n+"#"+c).replace(/\/+/,"/"),e[r]={slug:r,title:s,body:""}}else e[r]?e[r].body&&e[r].body.length?e[r].body+="\n"+s:e[r].body=s:e[r]={}})},s=function(){if(!this.rendered){this.style();var e=document.createElement("div"),n=document.querySelector("aside");e.classList.add("search"),n.insertBefore(e,n.children[0]),this.render(e),this.rendered=!0,this.bindEvent()}};s.prototype.style=function e(){var n="\n .sidebar {\n padding-top: 0;\n }\n\n .search {\n margin-bottom: 20px;\n padding: 6px;\n border-bottom: 1px solid #eee;\n }\n\n .search .results-panel {\n display: none;\n }\n\n .search .results-panel.show {\n display: block;\n }\n\n .search input {\n outline: none;\n border: none;\n width: 100%;\n padding: 7px;\n line-height: 22px;\n font-size: 14px;\n }\n\n .search h2 {\n font-size: 17px;\n margin: 10px 0;\n }\n\n .search a {\n text-decoration: none;\n color: inherit;\n }\n\n .search .matching-post {\n border-bottom: 1px solid #eee;\n }\n\n .search .matching-post:last-child {\n border-bottom: 0;\n }\n\n .search p {\n font-size: 14px;\n overflow: hidden;\n text-overflow: ellipsis;\n display: -webkit-box;\n -webkit-line-clamp: 2;\n -webkit-box-orient: vertical;\n }\n\n .search p.empty {\n text-align: center;\n }\n ",e=document.createElement("style");e.innerHTML=n,document.head.appendChild(e)},s.prototype.render=function(e){e.innerHTML='<input type="search" placeholder="'+n.placeholder+'" /><div class="results-panel"></div>'},s.prototype.bindEvent=function(){var e=this,n=document.querySelector(".search input"),t=document.querySelector(".results-panel");n.addEventListener("input",function(n){var r=n.target;if(""!==r.value.trim()){var i=e.search(r.value),a="";i.forEach(function(e,n){a+='\n <div class="matching-post">\n <h2><a href="'+e.url+'">'+e.title+"</a></h2>\n <p>"+e.content+"</p>\n </div>\n "}),t.classList.contains("results-panel")&&(t.classList.add("show"),t.innerHTML=a\|\|'<p class="empty">No Results!</p>')}else t.classList.contains("results-panel")&&(t.classList.remove("show"),t.innerHTML="")})},s.prototype.search=function(n){var t=[],i=Object.keys(e).map(function(n){return e[n]});n=n.trim().split(/[\s\-\，\\\/]+/);for(var a=function(e){var a=i[e],o=!1,s="",c=a.title&&a.title.trim(),l=a.body&&a.body.trim(),d=a.slug\|\|"";if(""!==c&&""!==l&&(n.forEach(function(e,n){var t=new RegExp(e,"gi"),r=-1,i=-1;if(r=c.search(t),i=l.search(t),r<0&&i<0)o=!1;else{o=!0,i<0&&(i=0);var a=0,d=0;a=i<11?0:i-10,d=0===a?70:i+e.length+60,d>l.length&&(d=l.length);var p="..."+l.substring(a,d).replace(t,'<em class="search-keyword">'+e+"</em>")+"...";s+=p}}),o)){var p={title:r(c),content:s,url:d};t.push(p)}},o=0;o<i.length;o++)a(o);return t};var c=function(){var t="auto"===n.paths,r=localStorage.getItem("docsify.search.expires")<Date.now();if(e=JSON.parse(localStorage.getItem("docsify.search.index")),r)e={};else if(!t)return;var s=0,c=t?i():n.paths,l=c.length,d=window.Docsify.utils,p=d.load,h=d.marked,u=d.slugify,f=function(){localStorage.setItem("docsify.search.expires",Date.now()+n.maxAge),localStorage.setItem("docsify.search.index",JSON.stringify(e))};c.forEach(function(n){return e[n]?s++:void p(a(n)).then(function(e){o(n,h(e)),u.clear(),s++,l===s&&f()})})},l=function(){if(!window.Docsify\|\|!window.Docsify.installed)return void console.error("[Docsify] Please load docsify.js first.");window.$docsify.plugins=[].concat(window.$docsify.plugins,c);var e=window.$docsify.search,r=window.Docsify.utils.isNil;Array.isArray(e)?n.paths=e:t(e)&&(n.paths=Array.isArray(e.paths)?e.paths:"auto",n.maxAge=r(e.maxAge)?n.maxAge:e.maxAge,n.placeholder=e.placeholder\|\|n.placeholder),new s},d=l();return d}();