joplin-plugin-tag-navigator 1.2.2 → 1.3.0

package/README.md

@@ -19,17 +19,19 @@ This plugin adds inline tag support (such as #inline-tag) to [Joplin](https://jo
 
 1. It adds a panel for searching and viewing tagged paragraphs across all your notes ([video](https://www.youtube.com/watch?v=im0zjQFoXb0)).
     - **Save search queries** in notes and sync them across devices ([video](https://www.youtube.com/watch?v=GuzCwYxyYZ0)).
+    - **Display results in a table** or a list ([video](https://www.youtube.com/watch?v=J7h8c6iW4rU)).
     - **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 (click, or right-click for 6 task states).
-    - **Nested tags** hierarchy: Search parent tags to find the locations of their children. Example: #parent/child.
+    - **Insert tags** from the panel into the note editor ([video](#tag-insertion)).
+    - **Toggle checkboxes** / TODOs from the panel, including [[x]it! style](https://xit.jotaen.net) checkboxes (click, or right-click for 6 task states). See also [tips](#inline-todos).
+    - **Nested tags** hierarchy: Search parent tags to find the locations of their children ([video](https://www.youtube.com/watch?v=h-HdX7npbIw)). 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).
+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)).
     - 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, or in all notes ([video](https://www.youtube.com/watch?v=h-HdX7npbIw)).
 4. It can convert your existing inline tags to native Joplin tags, so that they are accessible using Joplin's built-in tag search.
-5. It can convert your existing native Joplin tags to inline tags, so that they are accessible using inline tag search (this plugin).
+5. It can convert your existing native Joplin tags to inline tags, so that they are accessible using inline tag search (this plugin). See also [tips](#converting-joplin-tags).
 
 After installing the plugin, check the commands listed under `Tag Navigator` in the `Tools` menu, as well as the corresponding settings section.
 
@@ -37,6 +39,7 @@ After installing the plugin, check the commands listed under `Tag Navigator` in
 
 - [Inline tag search](#inline-tag-search)
 - [Saved search queries](#saved-search-queries)
+- [Table view / database](#table-view--database)
 - [Navigation panel](#navigation-panel)
 - [Tag insertion](#tag-insertion)
 
@@ -48,6 +51,10 @@ After installing the plugin, check the commands listed under `Tag Navigator` in
 
 <img src="img/tag-navigator-queries.gif" width="80%" title="saved search queries demo">
 
+### Table view / database
+
+<img src="img/tag-navigator-table.gif" width="80%" title="table view demo">
+
 ### Navigation panel
 
 <img src="img/tag-navigator-panel.gif" width="80%" title="navigation panel demo">
@@ -62,6 +69,7 @@ After installing the plugin, check the commands listed under `Tag Navigator` in
 - [Custom tag definitions](#custom-tag-definitions)
 - [Inline TODOs](#inline-todos)
 - [Keyboard shortcuts](#keyboard-shortcuts)
+- [Converting Joplin tags](#converting-joplin-tags)
 
 ### Troubleshooting
 
@@ -115,6 +123,21 @@ After installing the plugin, check the commands listed under `Tag Navigator` in
 | Arrow-Down | Toggle negation of last tag / note in query |
 | Arrow-Up | Toggle last operator AND <--> OR |
 
+### Converting Joplin tags
+
+1. It is recommended (as for any other plugin), before converting all notes:
+    - Test a few individual notes (one command above the all-note conversion).
+    - Backup your note database.
+2. If you would like organise your tags hierarchically (using nested tags) rename your Joplin tags first, before the conversion.
+    - Example: `#child` -> `#parent/child`
+    - You may also choose to rename your inline tags after the conversion, using the plugin's `Replace all` command. However, this will create a divergence between your inline and Joplin tags.
+3. Select your preferred conversion settings.
+    - Converted inline tags will appear at the top / bottom depending on the `Location` advanced setting.
+    - Converted inline tags will have the prefix # depending on the `Tag prefix` advanced setting.
+    - The list of converted inline tags will begin with the text 'tags: ' depending on the `List prefix` advanced setting.
+    - Spaces in Joplin tags will be converted to inline tags depending on the `Space replacement` advanced setting. When converting inline tags back to Joplin spaces will be introduced back to tags. For example: [Joplin: `tag with space`] -> [inline: `#tag_with_space`] -> [Joplin: `tag with space`]
+4. After the conversion all Joplin tags remain assigned to their notes. They are not deleted, and only a single line of text is added to each note.
+
 ## Companion plugins
 
 - The excellent [Inline Tags](https://github.com/roman-r-m/joplin-inline-tags-plugin) plugin can autocomplete tags while typing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "joplin-plugin-tag-navigator",
-  "version": "1.2.2",
+  "version": "1.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": "1.2.2",
+	"version": "1.3.0",
 	"name": "Inline Tag Navigator",
 	"description": "Type inline #tags in the note editor. View your tagged paragraphs and tasks / TODOs 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:e5d61471add6a477eb69c6815fd493e0b8c7fd9df7daac8103c2f7b8d6d3026a",
-	"_publish_commit": "main:fd02fc3bdb3c33271e636befab59b847aa9082e3"
+	"_publish_hash": "sha256:0f9c856c963e137b628bfdac1d7b51caaa13970b3560ea777c3f3bc44d48aeba",
+	"_publish_commit": "main:97f994a0a8d96c057917faa40e612018d2e4eaf3"
 }