-
-
Notifications
You must be signed in to change notification settings - Fork 493
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
60 additions
and
49 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -44,32 +44,13 @@ I'm really happy that FlexSearch is getting so much positive feedback and also f | |
| Thanks a lot, | ||
| Thomas (ts-thomas) | ||
|
|
||
| <!-- | ||
| ### FlexSearch v0.7.0 | ||
| The new version is finally available. FlexSearch v0.7.0 is a modern re-implementation and was newly developed from the ground up. The result is an improvement in every single aspect and covers tons of enhancements and improvements which was collected over the last 3 years. | ||
| This new version has a good compatibility with the old generation, but it might require some migrations steps in your code. | ||
| Read the documentation of new features and changes:<br> | ||
| <a href="https://github.com/nextapps-de/flexsearch/blob/master/doc/0.7.0.md">https://github.com/nextapps-de/flexsearch/blob/master/doc/0.7.0.md</a> | ||
| Read the documentation of new language encoding features:<br> | ||
| <a href="https://github.com/nextapps-de/flexsearch/blob/master/doc/0.7.0-lang.md">https://github.com/nextapps-de/flexsearch/blob/master/doc/0.7.0-lang.md</a> | ||
| --> | ||
|
|
||
| <h1></h1> | ||
|
|
||
| When it comes to raw search speed <a href="https://nextapps-de.github.io/flexsearch/bench/" target="_blank">FlexSearch outperforms every single searching library out there</a> and also provides flexible search capabilities like multi-field search, phonetic transformations or partial matching. | ||
|
|
||
| Depending on the used <a href="#options">options</a> it also provides the <a href="#memory">most memory-efficient index</a>. FlexSearch introduce a new scoring algorithm called <a href="#contextual">"contextual index"</a> based on a <a href="#dictionary">pre-scored lexical dictionary</a> architecture which actually performs queries up to 1,000,000 times faster compared to other libraries. | ||
| FlexSearch also provides you a non-blocking asynchronous processing model as well as web workers to perform any updates or queries on the index in parallel through dedicated balanced threads. | ||
|
|
||
| <!-- | ||
| FlexSearch Server is available here: | ||
| <a target="_blank" href="https://github.com/nextapps-de/flexsearch-server">https://github.com/nextapps-de/flexsearch-server</a>. | ||
| --> | ||
|
|
||
| Supported Platforms: | ||
| - Browser | ||
| - Node.js | ||
|
|
@@ -89,7 +70,7 @@ Plugins (extern projects): | |
| - Vue: https://github.com/Noction/vue-use-flexsearch | ||
| - Gatsby: https://www.gatsbyjs.org/packages/gatsby-plugin-flexsearch/ | ||
|
|
||
| ### Get Latest Stable Build (Recommended) | ||
| ### Get Latest | ||
|
|
||
| <table> | ||
| <tr><td colspan="3"></td></tr> | ||
|
|
@@ -137,10 +118,6 @@ Plugins (extern projects): | |
| npm install flexsearch | ||
| ``` | ||
|
|
||
| #### Get Latest Nightly (Do not use for production!) | ||
|
|
||
| Just exchange the version number from the URLs above with "master", e.g.: "/flexsearch/__0.7.31__/dist/" into "/flexsearch/__master__/dist". | ||
|
|
||
| ### Compare Web-Bundles | ||
|
|
||
| > The Node.js package includes all features from `flexsearch.bundle.js`. | ||
|
|
@@ -447,45 +424,69 @@ There are 3 types of indexes: | |
|
|
||
| The most of you probably need just one of them according to your scenario. | ||
|
|
||
| ### ESM / ES6 Modules (Browser): | ||
| ### Browser | ||
|
|
||
| ```js | ||
| import Index from "flexsearch/dist/module"; | ||
| import Worker from "flexsearch/dist/module/worker"; | ||
| import Document from "flexsearch/dist/module/document"; | ||
| #### Legacy ES5 Script Tag (Bundled) | ||
|
|
||
| const index = new Index(options); | ||
| const document = new Document(options); | ||
| const worker = new WorkerIndex(options); | ||
| ```html | ||
| <script src="node_modules/flexsearch/dist/flexsearch.bundle.min.js"></script> | ||
| <script> | ||
| // FlexSearch is available on window.FlexSearch | ||
| // Access FlexSearch static methods via bundled export (static class methods of FlexSearch) | ||
| const index = FlexSearch.Index(options); | ||
| const document = FlexSearch.Document(options); | ||
| const worker = FlexSearch.Worker(options); | ||
| </script> | ||
| ``` | ||
|
|
||
| ### Bundle (Browser) | ||
| ### ESM/ES6 Modules: | ||
|
|
||
| ```html | ||
| <html> | ||
| <head> | ||
| <script src="js/flexsearch.bundle.js"></script> | ||
| </head> | ||
| ... | ||
| <script type="module"> | ||
| // FlexSearch is NOT available on window.FlexSearch | ||
| // Access FlexSearch static methods by importing them explicitly | ||
| import Index from "./node_modules/flexsearch/dist/module/index"; | ||
| import Document from "./node_modules/flexsearch/dist/module/document"; | ||
| import Worker from "./node_modules/flexsearch/dist/module/worker"; | ||
| const index = new Index(options); | ||
| const document = new Document(options); | ||
| const worker = new Worker(options); | ||
| </script> | ||
| ``` | ||
|
|
||
| Or via CDN: | ||
| #### ESM/ES6 Bundled Module: | ||
|
|
||
| ```html | ||
| <script src="https://cdn.jsdelivr.net/gh/nextapps-de/[email protected]/dist/flexsearch.bundle.js"></script> | ||
| ``` | ||
| <script type="module"> | ||
| AMD: | ||
| // FlexSearch is NOT available on window.FlexSearch | ||
| // Access FlexSearch static methods via bundled export (static class methods of FlexSearch) | ||
| ```javascript | ||
| var FlexSearch = require("./flexsearch.js"); | ||
| import FlexSearch from "./node_modules/flexsearch/dist/flexsearch.bundle.module.min.js"; | ||
| const index = FlexSearch.Index(options); | ||
| const document = FlexSearch.Document(options); | ||
| const worker = FlexSearch.Worker(options); | ||
| </script> | ||
| ``` | ||
|
|
||
| Load one of the builds from the folder <a href="https://github.com/nextapps-de/flexsearch/tree/0.7.31/dist">dist</a> within your html as a script and use as follows: | ||
| Or via CDN: | ||
| ```html | ||
| <script src="https://cdn.jsdelivr.net/gh/nextapps-de/[email protected]/dist/flexsearch.bundle.min.js"></script> | ||
| ``` | ||
|
|
||
| ```js | ||
| var index = new FlexSearch.Index(options); | ||
| var document = new FlexSearch.Document(options); | ||
| var worker = new FlexSearch.Worker(options); | ||
| AMD / CommonJS: | ||
|
|
||
| ```javascript | ||
| var FlexSearch = require("./node_modules/flexsearch/dist/flexsearch.bundle.min.js"); | ||
| ``` | ||
|
|
||
| ### Node.js | ||
|
|
@@ -504,6 +505,16 @@ const document = new Document(options); | |
| const worker = new Worker(options); | ||
| ``` | ||
|
|
||
| Or: | ||
|
|
||
| ```js | ||
| const FlexSearch = require("flexsearch"); | ||
|
|
||
| const index = new FlexSearch.Index(options); | ||
| const document = new FlexSearch.Document(options); | ||
| const worker = new FlexSearch.Worker(options); | ||
| ``` | ||
|
|
||
| ## Basic Usage and Variants | ||
|
|
||
| ```js | ||
|
|
||