Skip to content

Commit c62cf40

Browse files
claremacraeclaremacrae
committed
docs: Add more links in Filters & Quick Reference
1 parent 7b532b0 commit c62cf40

File tree

2 files changed

+20
-4
lines changed

2 files changed

+20
-4
lines changed

‎docs/Queries/Filters.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ Use `next tuesday` instead if you mean "next tuesday".
4949
> [!released]
5050
Date range searches were introduced in Tasks 2.0.0.
5151

52-
Tasks allows date searches to specify a pair of dates, `<date range>` .
52+
Tasks allows date searches to specify a pair of dates, `<date range>`.
5353

5454
These searches are inclusive: the dates at either end are found by the search.
5555

@@ -190,6 +190,8 @@ For full details of combining filters with boolean operators, see [[Combining Fi
190190
- `(YYYY-Www|YYYY-mm|YYYY-Qq|YYYY)`
191191
- `done date is invalid`
192192

193+
For more information, see [[Dates#Done date|Done date]].
194+
193195
> [!released]
194196
>
195197
> - `no done date` and `has done date` were introduced in Tasks 1.7.0.
@@ -208,6 +210,8 @@ For full details of combining filters with boolean operators, see [[Combining Fi
208210
- `(YYYY-Www|YYYY-mm|YYYY-Qq|YYYY)`
209211
- `due date is invalid`
210212

213+
For more information, see [[Dates#Due date|Due date]].
214+
211215
> [!released]
212216
>
213217
> - `has due date` was introduced in Tasks 1.6.0.
@@ -226,6 +230,8 @@ For full details of combining filters with boolean operators, see [[Combining Fi
226230
- `(YYYY-Www|YYYY-mm|YYYY-Qq|YYYY)`
227231
- `scheduled date is invalid`
228232

233+
For more information, see [[Dates#Scheduled date|Scheduled date]].
234+
229235
> [!released]
230236
>
231237
> - `has scheduled date` was introduced in Tasks 1.6.0.
@@ -244,6 +250,8 @@ For full details of combining filters with boolean operators, see [[Combining Fi
244250
- `(YYYY-Www|YYYY-mm|YYYY-Qq|YYYY)`
245251
- `start date is invalid`
246252

253+
For more information, see [[Dates#Start date|Start date]].
254+
247255
> [!released]
248256
>
249257
> - `has start date` was Introduced in Tasks 1.6.0.
@@ -327,7 +335,7 @@ because the tasks starts before tomorrow. Only one of the dates needs to match.
327335
328336
### Troubleshooting date searches
329337
330-
If your date searches are giving unexpected results, add an [[Explaining Queries|`explain`]] line to your query.
338+
If your date searches are giving unexpected results, add an [[Explaining Queries|explain]] line to your query.
331339
332340
This will help you identify common mistakes such as:
333341
@@ -455,7 +463,7 @@ The available priorities are (from high to low):
455463
3. use no signifier to indicate no priority (searched for with 'none')
456464
4. 🔽 for low priority
457465
458-
For more information, see [[Priority|Priorities]] .
466+
For more information, see [[Priority|Priorities]].
459467
460468
#### Examples
461469
@@ -485,6 +493,8 @@ For more information, see [[Priority|Priorities]] .
485493
- Does regular expression match (case-sensitive by default).
486494
- Essential reading: [[Regular Expressions|Regular Expression Searches]].
487495
496+
For more information, see [[Recurring Tasks]].
497+
488498
> [!released]
489499
`recurrence` text searching was introduced in Tasks 1.22.0.
490500

‎docs/Quick Reference.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,28 +10,34 @@ This table summarizes the filters and other options available inside a `tasks` b
1010

1111
| [[Filters]] | [[Sorting\|Sort]] | [[Grouping\|Group]] | [[Layout\|Display]] |
1212
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | ---------------------- | ---------------------- |
13+
| **[[Filters#Filters for Dates in Tasks\|Status]]** and **[[Filters#Done Date\|done date]]** | | | |
1314
| `done`<br>`not done` | `sort by status` | `group by status` | |
1415
| `done (before, after, on) <date>`<br>`done (before, after, in) ...`<br>`... YYYY-MM-DD YYYY-MM-DD`<br>`... (last, this, next) (week, month, quarter, year)`<br>`... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)`<br>`has done date`<br>`no done date`<br>`done date is invalid` | `sort by done` | `group by done` | `hide done date` |
1516
| `status.name (includes, does not include) <string>`<br>`status.name (regex matches, regex does not match) /regex/i` | `sort by status.name` | `group by status.name` | |
1617
| `status.type (is, is not) (TODO, DONE, IN_PROGRESS, CANCELLED, NON_TASK)` | `sort by status.type` | `group by status.type` | |
18+
| **[[Filters#Filters for Dates in Tasks\|Other dates]]** | | | |
1719
| `created (before, after, on) <date>`<br>`created (before, after, in) ...`<br>`... YYYY-MM-DD YYYY-MM-DD`<br>`... (last, this, next) (week, month, quarter, year)`<br>`... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)`<br>`has created date`<br>`no created date`<br>`created date is invalid` | `sort by created` | `group by created` | `hide created date` |
1820
| `starts (before, after, on) <date>`<br>`starts (before, after, in) ...`<br>`... YYYY-MM-DD YYYY-MM-DD`<br>`... (last, this, next) (week, month, quarter, year)`<br>`... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)`<br>`has start date`<br>`no start date`<br>`start date is invalid` | `sort by start` | `group by start` | `hide start date` |
1921
| `scheduled (before, after, on) <date>`<br>`scheduled (before, after, in) ...`<br>`... YYYY-MM-DD YYYY-MM-DD`<br>`... (last, this, next) (week, month, quarter, year)`<br>`... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)`<br>`has scheduled date`<br>`no scheduled date`<br>`scheduled date is invalid` | `sort by scheduled` | `group by scheduled` | `hide scheduled date` |
2022
| `due (before, after, on) <date>`<br>`due (before, after, in) ...`<br>`... YYYY-MM-DD YYYY-MM-DD`<br>`... (last, this, next) (week, month, quarter, year)`<br>`... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)`<br>`has due date`<br>`no due date`<br>`due date is invalid` | `sort by due` | `group by due` | `hide due date` |
2123
| `happens (before, after, on) <date>`<br>`happens (before, after, in) ...`<br>`... YYYY-MM-DD YYYY-MM-DD`<br>`... (last, this, next) (week, month, quarter, year)`<br>`... (YYYY-Www,YYYY-mm, YYYY-Qq, YYYY)`<br>`has happens date`<br>`no happens date` | `sort by happens` | `group by happens` | |
24+
| **[[Filters#Recurrence\|Recurrence]]** | | | |
2225
| `is recurring`<br>`is not recurring` | `sort by recurring` | `group by recurring` | |
2326
| `recurrence (includes, does not include) <string>`<br>`recurrence (regex matches, regex does not match) /regex/i` | | `group by recurrence` | `hide recurrence rule` |
27+
| **[[Filters#Priority\|Priority]]** and **[[Urgency\|urgency]]** | | | |
2428
| `priority is (above, below, not)? (low, none, medium, high)` | `sort by priority` | `group by priority` | `hide priority` |
2529
| | `sort by urgency` | `group by urgency` | `show urgency` |
30+
| **[[Filters#Filters for File Properties\|File properties]]** | | | |
2631
| `path (includes, does not include) <path>`<br>`path (regex matches, regex does not match) /regex/i` | `sort by path` | `group by path` | |
2732
| `root (includes, does not include) <root>`<br>`root (regex matches, regex does not match) /regex/i` | | `group by root` | |
2833
| `folder (includes, does not include) <folder>`<br>`folder (regex matches, regex does not match) /regex/i` | | `group by folder` | |
2934
| `filename (includes, does not include) <filename>`<br>`filename (regex matches, regex does not match) /regex/i` | `sort by filename` | `group by filename` | |
3035
| `heading (includes, does not include) <string>`<br>`heading (regex matches, regex does not match) /regex/i` | `sort by heading` | `group by heading` | |
3136
| | | `group by backlink` | `hide backlink` |
37+
| **[[Filters#Description\|Description]]** and **[[Filters#Tags\|Tags]]** | | | |
3238
| `description (includes, does not include) <string>`<br>`description (regex matches, regex does not match) /regex/i` | `sort by description` | | |
3339
| `has tags`<br>`no tags`<br>`tag (includes, does not include) <tag>`<br>`tags (include, do not include) <tag>`<br>`tag (regex matches, regex does not match) /regex/i`<br>`tags (regex matches, regex does not match) /regex/i` | `sort by tag`<br>`sort by tag <tag_number>` | `group by tags` | |
34-
| [[Combining Filters]] | | | |
40+
| **[[Combining Filters]]** | | | |
3541
| `(filter 1) AND (filter 2)` | | | |
3642
| `(filter 1) OR (filter 2)` | | | |
3743
| `NOT (filter 1)` | | | |

0 commit comments

Comments
 (0)