Skip to content

Commit 858ec59

Browse files
committed
docs: Improve the start of Query File Defaults.md
1 parent cea4d70 commit 858ec59

File tree

1 file changed

+26
-7
lines changed

1 file changed

+26
-7
lines changed

docs/Queries/Query File Defaults.md

Lines changed: 26 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,35 @@ publish: true
77
> [!released]
88
> Introduced in Tasks X.Y.Z.
99
10+
## Benefits
11+
12+
This is a somewhat specialised facility that enables you to:
13+
14+
1. **Modify [[layout]] options in a Tasks Query without editing the `tasks` code block source.**
15+
- This could save you switching repeatedly between Reading and Editing modes.
16+
- Perhaps you usually like to see your Tasks search results with certain [[Layout]] options, but sometimes it is nice to see more detail, perhaps turning `show tree` on and off, depending on your mood.
17+
2. **Automatically insert one or more instructions in to all the `tasks` code blocks in a file.**
18+
- You have multiple Tasks queries in a Markdown file, and they have a lot of text in common.
19+
- You would like to avoid repeating those common instructions in each one, because keeping them consistent is tedious and error-prone.
20+
3. **Remind yourself what all `tasks` code blocks in a file do.**
21+
- Quickly turn [[Explaining Queries|explain]] on and off, for when you need a reminder, or are wondering why some tasks are not included in a search.
22+
1023
## Summary
1124

12-
Scenarios:
25+
**Query File Defaults** are like the [[Global Query]] only more specific:
26+
27+
- The Global Query:
28+
- applies to **all queries in the vault**,
29+
- is defined in the **Tasks Settings**.
30+
- Query File Defaults:
31+
- apply to **all queries in a file**,
32+
- is defined in **one or more standard [[#Supported Query File Defaults property values|named properties]] at the start of the file**.
33+
34+
Structure of this page:
1335

14-
- You have multiple Tasks queries in a Markdown file, and they have a lot of
15-
text in common. You would like to avoid repeating those common instructions in
16-
each one.
17-
- Usually you like to see your Tasks search results with certain [[Layout]]
18-
options, but sometimes it is nice to see more detail, perhaps turning
19-
`show tree` on and off, depending on your mood.
36+
- This page uses [[#examples]] to demonstrate the mechanism.
37+
- It then shows how to easily adjust a file's Query File Defaults using the [[#Obsidian-native user interface]] and a [[#Meta Bind user interface]].
38+
- Finally, it gives [[#technical details]] and records [[#Limitations of Query File Defaults|limitations]].
2039

2140
## Examples
2241

0 commit comments

Comments
 (0)