feat(src): add alias feature

QingWei-Li · QingWei-Li · commit 24412cdaf0db · 2017-02-11T10:17:05.000+08:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -15,6 +15,7 @@
 <script src="//unpkg.com/docsify" data-ga="UA-XXXXX-Y"></script>
 <script src="//unpkg.com/docsify/lib/plugins/ga.js"></script>
 ```
+
 ## 2.1.0
 ### Features
 - Add search plugin
diff --git a/dev.html b/dev.html
@@ -7,13 +7,17 @@
 </head>
 <body>
   <nav>
-    <a href="#/">En</a>
+    <a href="#/">en</a>
     <a href="#/zh-cn">中文</a>
+    <a href="#/changelog">Changlog</a>
   </nav>
   <div id="app"></div>
 </body>
 <script>
   window.$docsify = {
+    alias: {
+      '/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG'
+    },
     search: {
       maxAge: 0
     }
diff --git a/docs/index.html b/docs/index.html
@@ -12,9 +12,17 @@
   <nav>
     <a href="#/">En</a>
     <a href="#/zh-cn">中文</a>
+    <a href="#/changelog">Changlog</a>
   </nav>
   <div id="app"></div>
 </body>
+<script>
+  window.$docsify = {
+    alias: {
+      '/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG'
+    }
+  }
+</script>
 <script
   src="//unpkg.com/docsify/lib/docsify.min.js"
   data-max-level="4"
diff --git a/src/index.js b/src/index.js
@@ -47,18 +47,24 @@ let cacheRoute = null
 let cacheXhr = null
 
 const mainRender = function (cb) {
-  const route = OPTIONS.basePath + utils.getRoute()
+  let page
+  let route = utils.getRoute()
   if (cacheRoute === route) return cb()
 
-  let basePath = cacheRoute = route
+  let basePath = cacheRoute = OPTIONS.basePath + route
 
   if (!/\//.test(basePath)) {
     basePath = ''
   } else if (basePath && !/\/$/.test(basePath)) {
     basePath = basePath.match(/(\S*\/)[^\/]+$/)[1]
   }
 
-  let page
+  // replace route
+  if (OPTIONS.alias && OPTIONS.alias['/' + route]) {
+    route = OPTIONS.alias['/' + route]
+  } else {
+    route = OPTIONS.basePath + route
+  }
 
   if (!route) {
     page = OPTIONS.homepage || 'README.md'
diff --git a/src/plugins/search.js b/src/plugins/search.js
@@ -44,8 +44,7 @@ const getAllPaths = function () {
 /**
  * return file path
  */
-const genFilePath = function (path) {
-  const basePath = window.$docsify.basePath
+const genFilePath = function (path, basePath = window.$docsify.basePath) {
   let filePath = /\/$/.test(path) ? `${path}README.md` : `${path}.md`
 
   filePath = basePath + filePath
@@ -294,15 +293,24 @@ const searchPlugin = function () {
   const paths = isAuto ? getAllPaths() : CONFIG.paths
   const len = paths.length
   const { load, marked, slugify } = window.Docsify.utils
+  const alias = window.$docsify.alias
   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++
+    let route
 
-    load(genFilePath(path)).then(content => {
+    // replace route
+    if (alias && alias[path]) {
+      route = genFilePath(alias[path] || path, '')
+    } else {
+      route = genFilePath(path)
+    }
+
+    load(route).then(content => {
       genIndex(path, marked(content))
       slugify.clear()
       count++
