From d6bddf1d335dd3b7a4777d18f34c839addb260fa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Robson=20Ten=C3=B3rio?= <robsontenorio@me.com>
Date: Wed, 12 Dec 2018 14:44:36 -0300
Subject: [PATCH] feat($plugin-search): searchable paths with test RegExp
 (#1032)

---
 .../@vuepress/plugin-search/SearchBox.vue     | 21 +++++++++++-
 packages/@vuepress/plugin-search/index.js     |  3 +-
 packages/@vuepress/theme-blog/index.js        |  3 +-
 .../docs/plugin/official/plugin-search.md     | 32 ++++++++++++++++++-
 4 files changed, 55 insertions(+), 4 deletions(-)

diff --git a/packages/@vuepress/plugin-search/SearchBox.vue b/packages/@vuepress/plugin-search/SearchBox.vue
index da95e10c40..74e696107c 100644
--- a/packages/@vuepress/plugin-search/SearchBox.vue
+++ b/packages/@vuepress/plugin-search/SearchBox.vue
@@ -36,7 +36,7 @@
 </template>
 
 <script>
-/* global SEARCH_MAX_SUGGESTIONS */
+/* global SEARCH_MAX_SUGGESTIONS, SEARCH_PATHS */
 export default {
   data () {
     return {
@@ -76,6 +76,12 @@ export default {
         if (this.getPageLocalePath(p) !== localePath) {
           continue
         }
+
+        // filter out results that do not match searchable paths
+        if (!this.isSearchable(p)) {
+          continue
+        }
+
         if (matches(p)) {
           res.push(p)
         } else if (p.headers) {
@@ -112,6 +118,19 @@ export default {
       return '/'
     },
 
+    isSearchable (page) {
+      let searchPaths = SEARCH_PATHS
+
+      // all paths searchables
+      if (searchPaths === null) { return true }
+
+      searchPaths = Array.isArray(searchPaths) ? searchPaths : new Array(searchPaths)
+
+      return searchPaths.filter(path => {
+        return page.path.match(path)
+      }).length > 0
+    },
+
     onUp () {
       if (this.showSuggestions) {
         if (this.focusIndex > 0) {
diff --git a/packages/@vuepress/plugin-search/index.js b/packages/@vuepress/plugin-search/index.js
index c0ffe03d7c..1cfb3565e7 100644
--- a/packages/@vuepress/plugin-search/index.js
+++ b/packages/@vuepress/plugin-search/index.js
@@ -6,6 +6,7 @@ module.exports = (options) => ({
       path.resolve(__dirname, 'SearchBox.vue')
   },
   define: {
-    SEARCH_MAX_SUGGESTIONS: options.searchMaxSuggestions || 5
+    SEARCH_MAX_SUGGESTIONS: options.searchMaxSuggestions || 5,
+    SEARCH_PATHS: options.test || null
   }
 })
diff --git a/packages/@vuepress/theme-blog/index.js b/packages/@vuepress/theme-blog/index.js
index 19e95fffaf..48d7a1647f 100644
--- a/packages/@vuepress/theme-blog/index.js
+++ b/packages/@vuepress/theme-blog/index.js
@@ -4,7 +4,8 @@ module.exports = {
     '@vuepress/pagination',
     '@vuepress/medium-zoom',
     ['@vuepress/search', {
-      searchMaxSuggestions: 10
+      searchMaxSuggestions: 10,
+      test: null
     }]
   ]
 }
diff --git a/packages/docs/docs/plugin/official/plugin-search.md b/packages/docs/docs/plugin/official/plugin-search.md
index e98a1eae97..488cc29f68 100644
--- a/packages/docs/docs/plugin/official/plugin-search.md
+++ b/packages/docs/docs/plugin/official/plugin-search.md
@@ -27,7 +27,7 @@ Note that this plugin has been included in **default theme**, the search box you
 module.exports = {
   plugins: [
     ['@vuepress/search', {
-      searchMaxSuggestions: 10
+      searchMaxSuggestions: 10      
     }]
   ]
 }
@@ -65,6 +65,36 @@ export default {
 
 Set the maximum number of results for search.
 
+### test
+
+- Type: `RegExp` | `Array<RegExp>`
+- Default: `null`
+
+Set up searchable paths with regular expressions. If no test expression is provided it will search on all paths. Considering you have this structure:
+
+```bash
+docs/
+├── .vuepress/            
+│    └── ...
+│
+├── master/               
+│    └── ...
+│
+├── 1.0/               
+│    └── ...
+│
+└── 2.0/               
+     └── ...                       
+```
+
+You can set up searchable paths with `test` as:
+
+- RegExp: `'/1\.0/'`
+- Array of RegExp: `['/1\.0/', '/2\.0/']`
+
+
+Otherwise,  the default search will return duplicates, once you can have similar content between folders `/master/`, `/1.0/` and `/2.0/`.
+
 ## Tips
 
 ### Tweak the default colors.