fantasia-archive/src/documents/advancedSearchGuide.md

98 lines
6.8 KiB
Markdown
Raw Normal View History

2021-03-06 08:08:55 +13:00
# Advanced search guide
---
## Introduction
Fantasia Archive comes with a fairly advanced search-engine present in most of the search fields that look up through either all or at least one type of document - these are for example the multiple and single relationship fields on each document page and the quick-search popup.
---
## Intelligent search matching & sorting
The search itself works the following: You can search any amount of words and the software will process them individually as long as they are separated by whitespace.
### The search follows these rules
- **The search is case-insensitive, which means that you can type everything in UPPER or lower case, it won't matter**
- **Words can be in any order**
- Example: `Dark scary castle` will be found even if you type `scary castle dark`
- **Even parts of words will result in successful search**
- Example: `Dark scary castle` will be found even if you type `sca tle ark`
- **Documents will sort based on the following rules:**
- **Direct match has priority over everything else**
- Example: `Dark scary castle` is a direct match for a search containing `dark scary castle`
- **Full word match has priority over fragments**
- Each fully matched word counts individually; the more full-matches the document has, the higher it will be in the list
- Example: `Dark scary castle` has 2 full word matches from `dark scary tle`
- **Fragments are at the bottom of the list**
- Each fragment matched counts individually; the more fragments the document has, the higher it will be in the list
- Example: `Dark scary castle` has 2 fragment matches from `sca tle`
- **It is possible to include `Other names` into the search as well, by prefixing `@` in front of the search string**
- Example: `@Vampire lair` (if your `Dark scary castle` had other name filled as `Vampire lair`, the search will find it this way)
2021-03-06 08:08:55 +13:00
---
## Filtering
Except for the advanced search functionality, Fantasia Archive also offers instant filtering via multiple attributes for further narrowing search results.
2021-03-18 10:26:08 +13:00
- **NOTE: All of the following filter values (including the Full-search filtering in the next section) support matching any part of the search-text with any part of the search-term**
- Example: `>nada` will match with `Continent > North America > Canada > Toronto`
2021-03-06 08:08:55 +13:00
### The filtering works in the following ways and follows these rules
- **Any of the following filter terms will not conflict with the normal word search**
- **It is possible to only filter by one instance of each of the following filters at once, however, each individual instance may present at the same time**
- **The filter is case-insensitive, which means that you can type everything in UPPER or lower case, it won't matter**
- **If your filter-term contained whitespaces, replace them with the `-` symbol**
- Example: You wish to search for a tag called `Player Characters`, to fully match this tag, you will need to type `#player-characters`
- **Hierarchical path auto-replaces all `>` symbols in the path, this result in their omission from the filter string**
- Example: You wish to search for a hierarchical path containing the following `USA > Virginia > Richmond`, to fully match this hierarchical path, you will need to type `>usa-virginia-richmond`
- **The following filter terms may be used**
- `$` - Symbol for document type search
- `#` - Symbol for tag search
- `>` - Symbol for hierarchical path search
- `^` - Symbol for switch search (limited values below)
- `^c` - Displays only documents with `Is a category` ticked on
- `^d` - Displays only documents with `Is Dead/Gone/Destroyed` ticked on
- `^f` - Displays only documents with `Is finished` ticked on
- `^m` - Displays only documents with `Is a minor document` ticked on that are normally invisible and filtered out
2021-03-18 10:26:08 +13:00
## Full-search filtering
This feature is meant mostly for those in need of full-scale search that can crawl through any field in any document to match any value field in almost anywhere. Full-search filtering allows the user to narrow down the search marginally by digging through the whole document database and pinpointing exactly what is needed.
### A few words of caution
**The full-search is a very powerful, but also demanding tool - the more your project will grow, the more demanding it will become. This means that if you for example have 2000+ documents in your project and the search algorithm will have to go crawl through all of them, then the full-search might take a few second to reload your search results - please keep this in mind when using this feature: It can potentially be A LOT of data.**
### The filtering works in the following ways and follows these rules
- **The full-search can be used in combination with any other filters and/or normal search terms**
- **It is possible to have only a single instance of the full-search present in the search at once**
- **The filter is case-insensitive, which means that you can type everything in UPPER or lower case, it won't matter**
- **In the case of lists and multi-relationships, all the entered values get converted to one big text-line for the sake of searching**
- Example with a field called `Local currencies`:
- Original values: `Canadian Dollar` `American Dollar` `Euro` `Klingon Darsek`
- Converted values: `canadian-dollar-american-dollar-euro-klingon-darsek`
- **The following filter terms must be used inside of the search term**
- `%` - Symbol for the beginning full-search
- `:` - Symbol for the division between the field-name and field value
- **Is possible to use precise searching**
- Both the field name and its value can be wrapped inside invidual limiters
- Example for both precise: `%"local-currencies":"some-currency"
- Example for precise field name: `%"local-currencies":some-currency
- Example for precise field value: `%local-currencies:"some-currency"
2021-03-18 10:26:08 +13:00
- **If your filter-term contained whitespaces, replace them with the `-` symbol**
- Example: You wish to search for a field called `Local Currencies` that contains `Canadian Dollars` as value, to fully match this tag, you will need to type `%local-currencies:canadian-dollars`
2021-04-03 12:33:49 +13:00
- **It is possible to do a full-text search, checking all fields for the desired text by doing the following: `%:canadian-dollars`**
2021-03-18 10:26:08 +13:00
- **A list of fields/field types the full-search doesn't work with:**
- The `Break` field type (these are the big titles present throughout the document)
- The `Tags` field type (this one is covered with a more sophisticated tag filter)
- The `Switch` field type (this one doesn't contain any text values to even filter and is partially covered by the switch search option)
2021-03-18 10:26:08 +13:00
- The `Name` field (this one is the main concern of the search and the normal search is far more advanced for searching through this one)
- The `Belongs under` field (this one is covered by a much more advanced hierarchical path search)