diff options
| author |  Alexandre Alapetite <alexandre@alapetite.fr>
| 2022-06-02 08:41:08 +0200 |
|---|---|---|
| committer |  GitHub <noreply@github.com>
| 2022-06-02 08:41:08 +0200 |
| commit | f85c510ed49be031145f6b35e815ce890cd4f9aa (patch) | |
| tree | c7ac947ba5ddacf85dc5d97330f38f7d91b0964c /docs/en/users/03_Main_view.md | |
| parent | f988b996ab69104bc45b222fa88d34b5c78f98b3 (diff) | |
New search engine (#4378)
* New possibility to invoke user queries from a search expression
From the search field: `S:"My query"`.
Can be combined with other filters such as `S:"My query" date:P3d` as long as the user queries do not contain `OR`.
A use-case is to have an RSS filter with a stable address or an external API call with the ability to update the user query.
* Draft of parenthesis logic
* More draft
* Working parenthesis (a OR b) (c OR d)
* Working (A) OR (B)
* Support nested parentheses + unit tests + documentation
* search:MySearch and S:3
Diffstat (limited to 'docs/en/users/03_Main_view.md')
| -rw-r--r-- | docs/en/users/03_Main_view.md | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/en/users/03_Main_view.md b/docs/en/users/03_Main_view.md index 2e278fb61..a5a2afe34 100644 --- a/docs/en/users/03_Main_view.md +++ b/docs/en/users/03_Main_view.md @@ -222,6 +222,8 @@ You can use the search field to further refine results: * by custom label name `label:label`, `label:"my label"` or any label name from a list (*or*): `labels:"my label,my other label"` * by several label names (*and*): `label:"my label" label:"my other label"` * by entry (article) ID: `e:1639310674957894` or multiple entry IDs (*or*): `e:1639310674957894,1639310674957893` +* by user query (saved search) name: `search:myQuery`, `search:"My query"` or saved search ID: `S:3` + * internally, those references are replaced by the corresponding user query in the search expression Be careful not to enter a space between the operator and the search value. @@ -237,6 +239,11 @@ can be used to combine several search criteria with a logical *or* instead: `aut You don’t have to do anything special to combine multiple negative operators. Writing `!intitle:'thing1' !intitle:'thing2'` implies AND, see above. For more pointers on how AND and OR interact with negation, see [this GitHub comment](https://github.com/FreshRSS/FreshRSS/issues/3236#issuecomment-891219460). Additional reading: [De Morgan's laws](https://en.wikipedia.org/wiki/De_Morgan%27s_laws). +Finally, parentheses may be used to express more complex queries: + +* `(author:Alice OR intitle:hello) (author:Bob OR intitle:world)` +* `(author:Alice intitle:hello) OR (author:Bob intitle:world)` + ### By sorting by date You can change the sort order by clicking the toggle button available in the header. |