joplin-plugin-tag-navigator 0.7.4 → 1.0.0

package/README.md

@@ -4,6 +4,8 @@
 
 Type inline #tags in the note editor. View your tagged paragraphs and list items in an advanced search panel, or in a generated note. Convert inline and Obsidian tags into Joplin tags, and vice versa.
 
+[Community discussion thread](https://discourse.joplinapp.org/t/plugin-inline-tag-navigator-v0-8-0-2024-06-26/35726)
+
 - [Features](#features)
 - [Demos](#demos)
 - [Tips](#tips)
@@ -16,10 +18,13 @@ Type inline #tags in the note editor. View your tagged paragraphs and list items
 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)).
-    - Save favourite search queries in notes and sync them across devices ([video](https://www.youtube.com/watch?v=xIBZl2Ala9A)).
-    - Tag-by-notes: Search for links or [[wikilinks]] to notes (including backlinks to the current note).
-    - Add, replace and remove inline tags via the panel context menu (right-click on a tag).
-    - Toggle checkboxes / TODOs from the panel, including [[x]it! style](https://xit.jotaen.net) checkboxes.
+    - **Save search queries** in notes and sync them across devices ([video](https://www.youtube.com/watch?v=xIBZl2Ala9A)).
+    - **Tag-by-notes:** Search for links or [[wikilinks]] to notes (including backlinks to the current note).
+    - **Edit tags:** Add, replace and remove inline tags via the panel context menu (right-click on a tag).
+    - **Toggle checkboxes** / TODOs from the panel, including [[x]it! style](https://xit.jotaen.net) checkboxes.
+    - **Nested tags** hierarchy: Search parent tags to find the locations of their children. Example: #parent/child.
+    - Search for a **range of tags**, according to their lexicographic order. Example: #2024/07 -> #2024/08
+    - Search tags by **today's date**. Examples: #today, #today+1 (tomorrow), #today-10 (ten days ago)
 2. It can generate a note with all tagged paragaraphs that match a saved query (dynamically updated).
     - Save a query in a note, and switch note view on: `Tools --> Tag Navigator --> Toggle search results display in note` 
 3. It adds a panel for quickly navigating between inline tags that appear in the current note.
@@ -45,12 +50,17 @@ After installing the plugin, check the commands listed under `Tag Navigator` in
     - For example, every word in the text may be defined as a tag using a custom regex such as `[A-Za-z0-9]+[\w]*`.
 - 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#@'\"]*\w)`.
+- Supported additional checkbox styles
+
+![custom checkboxes](img/checkboxes.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).
 - Tag / note filter keyboard shortcuts:
 
 | Key | Action |
 | --- | ------ |
-| Enter | Add tag / note to query |
+| Enter | Add tag(s) / note to query |
 | 2nd Enter | Search notes based on current query |
 | Delete | Remove last added tag / note from query |
 | Esc | Clear the filter (display all tags / notes) |
@@ -63,7 +73,7 @@ After installing the plugin, check the commands listed under `Tag Navigator` in
 - 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#'\"]*\\w)"}]
     ```
     - In `Joplin settings --> Appearance --> Custom stylesheet for Joplin-wide app styles` add the following to the style sheet:
     ```
@@ -75,13 +85,13 @@ After installing the plugin, check the commands listed under `Tag Navigator` in
         display: inline;
     }
     ```
-    - On the mobile app, since it is impossible to edit the stylesheet, one could instead define the name of the tag class to be `"name": "searchMatch"`. This will use the same highlighting style as Joplin search results.
+    - On the mobile app, since it is impossible to edit the stylesheet, one could install this [Rich Markdown fork](https://github.com/alondmnt/joplin-rich-markdown/releases/tag/v0.15-mobile-style-v4) (with predefined support for tags and checkboxes) or instead define the name of the tag class to be `"name": "searchMatch"`. This will use the same highlighting style as Joplin search results.
 
 ## Motivation
 
 - Notes are arguably the atomic blocks of information in [Joplin](https://joplinapp.org). They can be linked to, tagged, and come up in search results. Joplin is optimised for this, and these features are pretty efficient.
 - However, among 100s-1000s of long-form notes (that are hardly "atomic"), it remains challenging to find a small piece of information, idea, or memory.
-- Tags can be especially helpful in distinguishing between the content of a text (what it's about) and its form or function (what type of text it is or what purpose it serves). The first is more easily captured by traditional or [semantic search](https://github.com/alondmnt/joplin-plugin-jarvis). The latter can be conveniently captured by tags, such as #concept, #plan, #memory, #realization, #idea, #review, #bug, #feature, and others.
+- Tags can be especially helpful in distinguishing between the content of a text (what it's about) and its form or function (what type of text it is or what purpose it serves). The first is more easily captured by traditional or [semantic search](https://github.com/alondmnt/joplin-plugin-jarvis). The latter can be conveniently captured by tags, such as #concept, #plan, #memory, #realisation, #idea, #review, #bug, #feature, and others.
 - I'd like to experiment here with information retrieval from single paragraphs, or outline items, as atomic blocks of information, using inline tags.
 
 ## Objectives

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "joplin-plugin-tag-navigator",
-  "version": "0.7.4",
+  "version": "1.0.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",
@@ -29,6 +29,7 @@
     "webpack-cli": "^4.10.0"
   },
   "dependencies": {
+    "date-fns": "^3.6.0",
     "lodash.debounce": "^4.0.8",
     "markdown-it": "^14.0.0",
     "markdown-it-task-lists": "^2.1.1"

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

@@ -6,7 +6,7 @@
 		"desktop",
 		"mobile"
 	],
-	"version": "0.7.4",
+	"version": "1.0.0",
 	"name": "Inline Tag Navigator",
 	"description": "Type inline #tags in the note editor. View your tagged paragraphs and list items in an advanced search panel, or in a generated note. Convert inline and Obsidian tags into Joplin tags, and vice versa.",
 	"author": "Alon Diament",
@@ -24,6 +24,6 @@
 	],
 	"screenshots": [],
 	"icons": {},
-	"_publish_hash": "sha256:eb316a04434cce687946f02354dc55bac7d7245c00a34a728c4010d795a6e43b",
-	"_publish_commit": "main:5a2e7fa02fc811c55849a0939779133f91f44b85"
+	"_publish_hash": "sha256:515fe86bc4de9928e34c571085d4abd24963ea202ebbbb17851c9b01f400eefe",
+	"_publish_commit": "main:6d36bbc0566b267d41ce9cc990dfe86a6b53c2db"
 }