You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/Search.md
+7-8Lines changed: 7 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ parent: Features
5
5
---
6
6
7
7
{: .note }
8
-
> This page's content only applies to the built-in search. Plugins may override the default search behavior.
8
+
> This page's content only applies to Tiny Tiny RSS's built-in search. Plugins may provide alternative search behavior.
9
9
10
10
## Table of contents
11
11
{: .no_toc .text-delta }
@@ -21,7 +21,7 @@ A search query consists of one or more keywords, of which there are 3 types:
21
21
22
22
* <aid="keyword-text"></a> **Text**
23
23
* A Text keyword may be a single word such as `ocean` or successive words enclosed in quotes such as `"pacific ocean"`.
24
-
* These keywords are searched using the PostgreSQL [Full Text Search](#postgresql-full-text-search) engine,
24
+
* These keywords are searched using the PostgreSQL [Full Text Search engine](#postgresql-full-text-search),
25
25
which supports [word stemming](#word-stemming) and [logical operators](#logical-operators).
26
26
* <aid="keyword-field"></a> **Field**
27
27
* A Field keyword allows filtering articles by supported fields (shown below).
@@ -36,6 +36,7 @@ A search query consists of one or more keywords, of which there are 3 types:
36
36
*`tag:true`, `tag:false`, `tag:sometag`, `tag:"two words"` - match articles with any tag, no tag, or having the specified tag (exact-string match)
37
37
* <aid="keyword-date"></a> **Date**
38
38
* A Date keyword allows filtering articles by their publication (or last updated) date.
39
+
* A Date keyword has to represent a fixed day. For example `@"last week"`, `@2023-11` or `@2024` cannot be used because they represent a range of several days.
39
40
* Examples:
40
41
*`@2025-10-28` (formatted as `@YYYY-MM-DD`)
41
42
*`@2025/10/28` (formatted as `@YYYY/MM/DD`)
@@ -46,8 +47,6 @@ A search query consists of one or more keywords, of which there are 3 types:
46
47
*`@yesterday`
47
48
*`@"2 days ago"`
48
49
*`@"last Monday"`
49
-
* {: .note }
50
-
> A Date keyword has to represent a fixed day. For example `@"last week"`, `@2023-11` or `@2024` cannot be used because they represent a range of several days.
51
50
52
51
53
52
A keyword starting with `-` (negative sign) represents a negative match. `-` can be applied before any type of keyword.
@@ -58,7 +57,7 @@ For example: `ocean "tree flower" note:true -title:"orange color"` searches for
58
57
AND containing the phrase _"tree flower"_ (with [stemming](#word-stemming)) AND having any note AND having a title not containing the phrase _"orange color"_.
59
58
60
59
Other [logical operators](#logical-operators) are only supported around a [Text keyword](#keyword-text), as they're processed by the
61
-
PostgreSQL [Full Text Search](#postgresql-full-text-search) engine. A [Field keyword](#keyword-field) or [Date keyword](#keyword-date)
60
+
PostgreSQL [Full Text Search engine](#postgresql-full-text-search). A [Field keyword](#keyword-field) or [Date keyword](#keyword-date)
62
61
does not support those PostgreSQL [logical operators](#logical-operators).
63
62
64
63
@@ -92,7 +91,7 @@ so comparing them may lead to unexpected results.
92
91
In Tiny Tiny RSS there is a special language named _Simple_. Word stemming in the _Simple_ language is almost equivalent to exact string matching.
93
92
With the _Simple_ language only punctuation such as commas are removed. The power of word stemming isn't applied, but _Simple_ works well when dealing with multiple languages.
94
93
95
-
It's also possible to search for a word with a specific prefix using the syntax `prefix:*` (e.g. `secu:*` matches every word starting with `secu`).
94
+
It's also possible to search for a word with a specific prefix using the syntax `prefix:*` (e.g. `secu:*` matches every word starting with `secu`, such as `security`).
> When a search query contains [Field keywords](#keyword-field) or [Date keywords](#keyword-date)_and_[Text keywords](#keyword-text) using logical operators,
127
126
> it's recommended to write the [Text keywords](#keyword-text) at the end (or the beginning) and to surround them with parentheses.
128
-
> For example: when reading `-title:submarine @yesterday ( pacific | atlantic )` one can easily understand that the parentheses contains a complex fragment
129
-
> that has to be well formatted with no missing operator.
127
+
> For example: when reading `-title:submarine @yesterday ( pacific | atlantic )` one can easily understand that the parentheses contain a complex fragment
128
+
> that has to be well formatted (with no missing operators).
130
129
131
130
{: .note }
132
131
> Due to current parser limitations, the `-` negation does not work before a parenthesis (only before a [Text keyword](#keyword-text)).
0 commit comments