joplin-plugin-tag-navigator 2.1.4 → 2.3.0

package/README.md

@@ -18,6 +18,7 @@ Type inline #tags or front matter in the note editor. View your tagged paragraph
 This plugin adds inline tag support (such as #inline-tag) to [Joplin](https://joplinapp.org) in five ways:
 
 1. It adds a panel for searching and viewing tagged paragraphs across all your notes. ([video](https://www.youtube.com/watch?v=im0zjQFoXb0))
+    - **Search queries**: Search tags using logical operators (AND, OR, NOT), and using free text in the note, title, or notebook name / path.
     - **Save search queries** in notes and sync them across device. ([video](https://www.youtube.com/watch?v=GuzCwYxyYZ0))
     - **Tag-by-notes:** Search for links or [[wikilinks]] to notes (including backlinks to the current note).
     - **Tag in front matter:** All Markdown front matter fields can be treated as tags. ([video](https://www.youtube.com/watch?v=L3zHletRk54), [tips](#front-matter-tags))
@@ -71,6 +72,7 @@ After installing the plugin, check the commands listed under `Tag Navigator` in
 - [Tag values](#tag-values)
 - [Front matter tags](#front-matter-tags)
 - [Table views](#table-views)
+- [Filtering results](#filtering-results)
 - [Inline TODOs](#inline-todos)
 - [Colour tags](#colour-tags)
 - [Keyboard shortcuts](#keyboard-shortcuts)
@@ -82,9 +84,9 @@ After installing the plugin, check the commands listed under `Tag Navigator` in
 
 ### Custom tag definitions
 
-- The definition of a "tag" can be adjusted with user-defined regular expressions.
+- The definition of a "tag" can be adjusted with user-defined regular expressions (see the advanced setting `Tag regex`).
     - Example: Every word in the text may be defined as a tag using a custom regex such as `[A-Za-z0-9]+[\w]*`.
-- You may also define an exclusion rule to ignore certain tags.
+- You may also define an exclusion rule to ignore certain tags (see the advanced setting `Exclude regex`).
     - Example: Numeric (`#123`) or hexanumeric (`#C0FF1E`) tags can be filtered using an exclusion regex such as `#(\d+|[a-fA-F0-9]{6})$`.
 
 ### Tag insertion
@@ -189,10 +191,18 @@ These tags will be accessible in the search panel / notes / tables like standard
 }
 ```
 
+### Filtering results
+
+- Text entered in the results filter (on the panel or in a saved query) can be used to search within title of the notes, their notebook name / path, or the content of the displayed results.
+- To gain more control over filtering by notebook, you may enable the setting `Search: Extract the full notebook path`.
+    - Example: Limit results to a notebook that appears in the top level by searching for `|/topNotebook`.
+    - Example: Search for `topNotebook/childNotebook` to show only result from childNotebook.
+- You may enable `Search: Use regex for tag / note / content filtering` to filter using regular expressions.
+
 ### Inline TODOs
 
 - Filter results by pending tasks (`"- [ ]"`) or ones done (`"- [x]"`).
-- Add support for [additional tags](https://github.com/CalebJohn/joplin-inline-todo?tab=readme-ov-file#confluence-style) for @mentions, +projects and //due-dates using a custom tag regex such as `(?<=^|\s)([#@+]|\/\/)([^\s#@'\"]*\w)`.
+- Add support for [additional tags](https://github.com/CalebJohn/joplin-inline-todo?tab=readme-ov-file#confluence-style) for @mentions, +projects and //due-dates using a custom tag regex such as `(?<=^|\s)([#@+]|\/\/)([^\s#@+'",.()\[\]:;\?\\]+)`.
 - Supported additional checkbox styles (inspired by `[x]it!`).
     - Set any of them to done by clicking the checkbox in the search panel.
 
@@ -203,7 +213,7 @@ These tags will be accessible in the search panel / notes / tables like standard
 ![checkbox commands](img/checkboxes-commands.png)
 
 - You may increase the checkbox size on smaller screens by setting `Search: Panel style` with the CSS `.itags-search-checkbox { width: 18px; height: 18px; font-size: 18px }` (adjust as needed).
-- Furthermore, every checkbox in the text (even ones that are not tagged by any inline #tag) may be defined as a tag using a custom regex such as `(?<=^|\s)([#]|\-\s\[[x\s@\?!~]\])([^\s#'\"]*\w)?`.
+- Furthermore, every checkbox in the text (even ones that are not tagged by any inline #tag) may be defined as a tag using a custom regex such as `(?<=^|\s)(#([^\s#'",.()\[\]:;\?\\]+)|(\-\s\[[x\s@\?!~]\]))`.
     - You may then use queries to search for tag-tasks based on their state (`- [ ]`, `- [x]`, `- [@]`, ...).
 
 ### Colour tags
@@ -265,7 +275,7 @@ These tags will be accessible in the search panel / notes / tables like standard
 - You can highlight tags in the Markdown editor using [Rich Markdown](https://github.com/CalebJohn/joplin-rich-markdown) (version ≥ 0.14).
     - In `Joplin settings --> Rich Markdown --> Advanced Settings --> Custom classes JSON` enter:
     ```
-    [{"name": "rm-tag", "regex": "(?<=^|\\s)#([^\\s#'\"]*\\w)"}]
+    [{"name": "rm-tag", "regex": "(?<=^|\\s)#([^\\s#'\",.()\\[\\]:;\\?\\\\]+)"}]
     ```
     - In `Joplin settings --> Appearance --> Custom stylesheet for Joplin-wide app styles` add the following to the style sheet:
     ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "joplin-plugin-tag-navigator",
-  "version": "2.1.4",
+  "version": "2.3.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.1.4",
+	"version": "2.3.0",
 	"name": "Inline Tag Navigator",
 	"description": "Type inline tags or front matter in the note editor. View your tagged paragraphs and tasks / TODOs in a search panel, or in a generated note. 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:4dd47429d6b774b4213cddfe32234d4d1479ebf0e528836f7069aecae9d9c02b",
-	"_publish_commit": "main:4bc9eb7ce8d7bd6481cf05a27228678f6bc83028"
+	"_publish_hash": "sha256:3d80ed589eb8e48fa51094d60f68b10ffc1885fb3425be3c25b14f545b076f55",
+	"_publish_commit": "main:94f9258d26e4b1770e454b1eca5b1af1a1d8c248"
 }