Skip to content

Commit 0a69749

Browse files
committed
docs: Divide up level-2 headings with HR
This should really be in a style.
1 parent 6f14380 commit 0a69749

File tree

3 files changed

+48
-0
lines changed

3 files changed

+48
-0
lines changed

docs/Queries/Filters.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ publish: true
44

55
# Filters
66

7+
---
8+
79
## Contents
810

911
This page is long. Here are some links to the main sections:
@@ -17,6 +19,8 @@ This page is long. Here are some links to the main sections:
1719
- [[#Filters for File Properties]]
1820
- [[#Appendix: Tasks 2.0.0 improvements to date filters]]
1921

22+
---
23+
2024
## Searching for dates
2125

2226
Tasks allows a lot of flexibility in the dates inside query blocks.
@@ -241,6 +245,8 @@ Find any tasks that have status symbols you have not yet added to your Tasks set
241245
group by path
242246
```
243247

248+
---
249+
244250
## Filters for Dates in Tasks
245251

246252
### Done Date
@@ -434,6 +440,8 @@ to the incorrect line, and fixing it by directly typing in the new date.
434440
If you use the 'Create or edit Task' Modal, it will discard the broken date, and there will be no information about
435441
the original, incorrect value.
436442
443+
---
444+
437445
## Filters for Other Task Properties
438446
439447
As well as the date-related searches above, these filters search other properties in individual tasks.
@@ -557,6 +565,8 @@ Introduced in Tasks 1.6.0.
557565
- The trailing `i` means case-insensitive.
558566
- Searches for tags such as `#book`, `#Book`, `#BOOK` and the `$` prevents matching of `#books`, `#book/literature`, etc.
559567
568+
---
569+
560570
## Filters for File Properties
561571
562572
These filters allow searching for tasks in particular files and sections of files.
@@ -629,6 +639,8 @@ Note that the file name includes the `.md` extension.
629639
> [!released]
630640
`regex matches` and `regex does not match` were introduced in Tasks 1.12.0.
631641
642+
---
643+
632644
## Appendix: Tasks 2.0.0 improvements to date filters
633645
634646
Tasks 2.0.0 introduced the concept of filtering for date ranges.

docs/Queries/Grouping.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ publish: true
44

55
# Grouping
66

7+
---
8+
79
## Contents
810

911
This page is long. Here are some links to the main sections:
@@ -19,6 +21,8 @@ This page is long. Here are some links to the main sections:
1921
- [[#Screenshots]
2022
- [[#Examples]
2123

24+
---
25+
2226
## Basics
2327

2428
> [!released]
@@ -28,6 +32,8 @@ By default, Tasks displays tasks in a single list.
2832

2933
To divide the matching tasks up with headings, you can add `group by` lines to the query.
3034

35+
---
36+
3137
## Group by Task Statuses
3238

3339
For more information, including adding your own customised statuses, see [[Statuses]].
@@ -60,6 +66,8 @@ For more information, including adding your own customised statuses, see [[Statu
6066
> [!released]
6167
`group by status.type` was introduced in Tasks 1.23.0.
6268

69+
---
70+
6371
## Group by Dates in Tasks
6472

6573
### Done Date
@@ -114,6 +122,8 @@ For more information, including adding your own customised statuses, see [[Statu
114122
> [!released]
115123
`happens` grouping option was introduced in Tasks 1.11.0.
116124

125+
---
126+
117127
## Group by Other Task Properties
118128

119129
### Priority
@@ -163,6 +173,8 @@ For more information, including adding your own customised statuses, see [[Statu
163173
>
164174
> - `tags` grouping option was introduced in Tasks 1.10.0.
165175
176+
---
177+
166178
## Group by File Properties
167179

168180
### File Path
@@ -193,6 +205,8 @@ For more information, including adding your own customised statuses, see [[Statu
193205

194206
- `group by heading` (the heading preceding the task, or `(No heading)` if there are no headings in the file)
195207

208+
---
209+
196210
## Multiple groups
197211

198212
You can add multiple `group by` query options, each on an extra line.
@@ -210,6 +224,8 @@ See the [screenshots below](#screenshots) for how this looks in practice.
210224
> [!info]
211225
> Headings are displayed in case-sensitive alphabetical order, not the original order.
212226
227+
---
228+
213229
## Refining groups
214230

215231
### Reversing groups
@@ -240,6 +256,8 @@ You can limit the number of tasks in each group, perhaps to work on the most imp
240256

241257
See [[Limiting#Limit number of tasks in each group|Limit number of tasks in each group]].
242258

259+
---
260+
243261
## Notes
244262

245263
> [!info]

docs/Queries/Sorting.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ publish: true
44

55
# Sorting
66

7+
---
8+
79
## Contents
810

911
This page is long. Here are some links to the main sections:
@@ -18,12 +20,16 @@ This page is long. Here are some links to the main sections:
1820
- [[#Reverse sorting]]
1921
- [[#Examples]]
2022

23+
---
24+
2125
## Basics
2226

2327
By default Tasks sorts tasks by [[Urgency|a calculated score we call "urgency"]].
2428

2529
To sort the results of a query different from the default, you must add at least one `sort by` line to the query.
2630

31+
---
32+
2733
## Sort by Task Statuses
2834

2935
For more information, including adding your own customised statuses, see [[Statuses]].
@@ -46,6 +52,8 @@ For more information, including adding your own customised statuses, see [[Statu
4652
> [!released]
4753
`sort by status.type` was introduced in Tasks 1.23.0.
4854

55+
---
56+
4957
## Sort by Dates in Tasks
5058

5159
### Done Date
@@ -78,6 +86,8 @@ For more information, including adding your own customised statuses, see [[Statu
7886
> [!released]
7987
`sort by happens` was introduced in Tasks 1.21.0.
8088

89+
---
90+
8191
## Sort by Other Task Properties
8292

8393
### Description
@@ -111,6 +121,8 @@ For example this query will sort by the second tag found in the description.
111121
> [!released]
112122
Tag sorting was introduced in Tasks 1.6.0.
113123

124+
---
125+
114126
## Sort by File Properties
115127

116128
### File Path
@@ -140,12 +152,16 @@ It is not currently possible to sort by the folder that contains the task.
140152
> [!released]
141153
`sort by heading` was introduced in Tasks 1.21.0.
142154

155+
---
156+
143157
## Multiple sort criteria
144158

145159
You can add multiple `sort by` query options, each on an extra line.
146160
The first sort has the highest priority.
147161
Each subsequent `sort` will sort within the existing sorting.
148162

163+
---
164+
149165
## Notes
150166

151167
> [!info]
@@ -165,6 +181,8 @@ add the following `sort` expressions to your queries:
165181
It should also take into account `*italics*` and `==highlights==`.
166182
It sorts by the text that's visible in preview mode.
167183

184+
---
185+
168186
## Reverse sorting
169187

170188
After the name of the property that you want to sort by, you can add the `reverse` keyword.

0 commit comments

Comments
 (0)