Skip to content

Commit a0f9ed5

Browse files
committed
Minor Search page tweaks after further review.
1 parent 5da1c62 commit a0f9ed5

File tree

1 file changed

+7
-8
lines changed

1 file changed

+7
-8
lines changed

docs/Search.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ parent: Features
55
---
66

77
{: .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.
99
1010
## Table of contents
1111
{: .no_toc .text-delta }
@@ -21,7 +21,7 @@ A search query consists of one or more keywords, of which there are 3 types:
2121

2222
* <a id="keyword-text"></a> **Text**
2323
* 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),
2525
which supports [word stemming](#word-stemming) and [logical operators](#logical-operators).
2626
* <a id="keyword-field"></a> **Field**
2727
* 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:
3636
* `tag:true`, `tag:false`, `tag:sometag`, `tag:"two words"` - match articles with any tag, no tag, or having the specified tag (exact-string match)
3737
* <a id="keyword-date"></a> **Date**
3838
* 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.
3940
* Examples:
4041
* `@2025-10-28` (formatted as `@YYYY-MM-DD`)
4142
* `@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:
4647
* `@yesterday`
4748
* `@"2 days ago"`
4849
* `@"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.
5150

5251

5352
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
5857
AND containing the phrase _"tree flower"_ (with [stemming](#word-stemming)) AND having any note AND having a title not containing the phrase _"orange color"_.
5958

6059
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)
6261
does not support those PostgreSQL [logical operators](#logical-operators).
6362

6463

@@ -92,7 +91,7 @@ so comparing them may lead to unexpected results.
9291
In Tiny Tiny RSS there is a special language named _Simple_. Word stemming in the _Simple_ language is almost equivalent to exact string matching.
9392
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.
9493

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`).
9695

9796
### Logical operators
9897

@@ -125,8 +124,8 @@ For example: `ocean & ( ( pacific | atlantic ) & ! "black sea" )`
125124
{: .note }
126125
> When a search query contains [Field keywords](#keyword-field) or [Date keywords](#keyword-date) _and_ [Text keywords](#keyword-text) using logical operators,
127126
> 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).
130129
131130
{: .note }
132131
> Due to current parser limitations, the `-` negation does not work before a parenthesis (only before a [Text keyword](#keyword-text)).

0 commit comments

Comments
 (0)