joplin-plugin-tag-navigator 2.6.2 → 2.7.0

package/README.md

@@ -6,6 +6,7 @@ Type inline tags or frontmatter in the note editor. View your tagged paragraphs
 
 - [Community discussion thread](https://discourse.joplinapp.org/t/plugin-inline-tag-navigator-v0-8-0-2024-06-26/35726)
 - [Release notes](CHANGELOG.md)
+- [Quick Start](#quick-start)
 - [Features](#features)
 - [Demos](#demos)
 - [Tips](#tips)
@@ -13,6 +14,16 @@ Type inline tags or frontmatter in the note editor. View your tagged paragraphs
 - [Motivation](#motivation)
 - [Objectives](#objectives)
 
+## Quick Start
+
+Get started in 3 steps:
+
+1. **Add tags to your notes**: Type `#project`, `#todo`, `#idea`, or any `#tag-name` in your note text.
+2. **Search your tags**: In the search panel, click a tag to add it to your query, then press Enter to search. Results show all matching paragraphs across your notes.
+3. **Interact with results**: Click checkboxes to toggle task states, or right-click on tags and results for more options (edit tags, switch between 6 task states, show/hide panel sections).
+
+For video tutorials, see the [Demos](#demos) section or the [full playlist](https://www.youtube.com/playlist?list=PLV4DhNiuF20XCdqNEo1a190dkNFo69rd-).
+
 ## Features
 
 This plugin adds inline tag support (such as #inline-tag) to [Joplin](https://joplinapp.org) in six ways:
@@ -29,8 +40,9 @@ This plugin adds inline tag support (such as #inline-tag) to [Joplin](https://jo
     - **Nested tags** hierarchy: Search parent tags to find the locations of their children. Example: #parent/child. ([video](https://www.youtube.com/watch?v=h-HdX7npbIw))
     - **Tag values**: Assign values to tags. Example: #tag=value. ([tips](#tag-values))
     - **Tag ranges**: Search for a range of tags, according to their lexicographic order. Example: #2024/07 -> #2024/08. ([tips](#tag-ranges))
-    - **Today's date**: Search tags by today's date. Examples: #today, #today+1 (tomorrow), #today-10 (ten days ago). ([tips](#tag-ranges))
+    - **Date tags**: Search tags by today's date, this month, or a day in the current week. Examples: #today, #today+1 (tomorrow), #week+1 (Monday). ([tips](#date-tags))
     - **Colour tags**: Use colour tags to highlight results in the search panel. Example: #color=red. ([tips](#colour-tags))
+    - **Context expansion**: Reveal surrounding lines around search results to see more context. ([tips](#context-expansion))
 2. It can generate a note with all tagged paragaraphs that match a saved query (dynamically updated). ([video](https://www.youtube.com/watch?v=GuzCwYxyYZ0), [tips](#saved-queries))
     - Save a query in a note, and switch note view on: `Tools --> Tag Navigator --> Toggle search results display in note` .
     - Display results:
@@ -84,6 +96,7 @@ After installing the plugin, check the commands listed under `Tag Navigator` in
 - [Table views](#table-views)
 - [Kanban views](#kanban-views)
 - [Filtering results](#filtering-results)
+- [Context expansion](#context-expansion)
 - [Inline TODOs](#inline-todos)
 - [Colour tags](#colour-tags)
 - [Styling inline tags](#styling-inline-tags)
@@ -128,6 +141,12 @@ Date tags provide flexible ways to work with dates in your notes, supporting bot
 - **Week tags**: Use `#week` for the start of the current week, or add arithmetic like `#week+7` (next week).
     - Example: `#week` becomes `#2025-01-13` (if the current week starts on January 13, 2025)
     - The start day of the week can be configured in settings
+- **Nested date tags**: Date arithmetic works in nested tag structures, enabling dynamic date ranges with semantic context.
+    - Example query: `#deadline/#today -> #deadline/#today+30` finds all deadlines in the next 30 days
+    - Results like: `#deadline/2025-11-09`, `#deadline/2025-12-09` (date prefix is stripped from nested parts)
+    - Example query: `#project/milestone/#week -> #project/milestone/#week+14` finds project milestones in the coming two weeks
+    - In notes, write absolute dates directly: `#deadline/2025-12-09`
+    - **Note**: To use date arithmetic in nested tags directly in notes (e.g., `#deadline/#today+30`), customize the tag pattern in Settings → Tag Navigator → Tag regex by removing `#` from the exclusion list: `(?<=^|\s)#([^\s'",.()\[\]:;\?\\]+)`
 
 #### Converting relative to absolute dates
 
@@ -347,6 +366,16 @@ This example searches for paragraphs that have both `#artist` AND `#album` tags,
     - Example: `"!references/"` excludes notebooks containing "references" in their path.
 - You may also enable `Search: Use regex for tag / note / content filtering` to filter using regular expressions.
 
+### Context expansion
+
+Context expansion lets you reveal surrounding lines around search results to see more context without opening the note.
+
+- Click the **↑** arrow on any search result section to show more lines above and below the matched content.
+- Click again to expand further (up to 3 levels).
+- When fully expanded, click **↓** to collapse back to the original view.
+- The expanded context is dimmed to help distinguish it from the core matched lines.
+- Configure the number of lines revealed per click in the setting `Search: Context expansion (show surrounding lines)`. Set to 0 to disable.
+
 ### Inline TODOs
 
 - Filter results by pending tasks (`"- [ ]"`) or ones done (`"- [x]"`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "joplin-plugin-tag-navigator",
-  "version": "2.6.2",
+  "version": "2.7.0",
   "scripts": {
     "dist": "webpack --env joplin-plugin-config=buildMain && webpack --env joplin-plugin-config=buildExtraScripts && webpack --env joplin-plugin-config=createArchive",
     "prepare": "npm run dist",

package/publish/joplin.plugin.alondmnt.tag-navigator.json

@@ -6,7 +6,7 @@
 		"desktop",
 		"mobile"
 	],
-	"version": "2.6.2",
+	"version": "2.7.0",
 	"name": "Inline Tag Navigator",
 	"description": "Type inline tags or frontmatter in the note editor. View your tagged paragraphs and tasks / TODOs in a search panel, or in a generated note / kanban. Build a table view / database from notes and tags. Convert between Obsidian tags and Joplin tags.",
 	"author": "Alon Diament",
@@ -24,6 +24,6 @@
 	],
 	"screenshots": [],
 	"icons": {},
-	"_publish_hash": "sha256:9b5c436e59f6344deccc4679e81e16da3274c03faf907b212a27f4062e3a4e5b",
-	"_publish_commit": "main:54cee43045971b2543bcb5789d2593f158f3b732"
+	"_publish_hash": "sha256:436d648da02ddcb47fd0b3022cfbbd0428b01ce5c38c67847ae9c62e65056c60",
+	"_publish_commit": "main:ce71183111c9487a1b4ce5d8f36a4453f9e55442"
 }