joplin-plugin-tag-navigator 2.5.0 → 2.5.2

package/README.md

@@ -71,6 +71,8 @@ After installing the plugin, check the commands listed under `Tag Navigator` in
 
 - [Troubleshooting](#troubleshooting)
 - [Custom tag definitions](#custom-tag-definitions)
+- [Tag inheritance](#tag-inheritance)
+- [Date tags](#date-tags)
 - [Tag insertion](#tag-insertion)
 - [Tag ranges](#tag-ranges)
 - [Tag values](#tag-values)
@@ -95,6 +97,54 @@ After installing the plugin, check the commands listed under `Tag Navigator` in
 - 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 inheritance
+
+- Tag inheritance allows tags to be automatically applied to related content based on document structure, making it easier to organize and find information without manually tagging every line.
+- When the `Tag inheritance` setting is enabled (by default), tags are automatically inherited in three ways:
+    1. **Outline/indentation inheritance**: Tags are inherited from parent items to their children based on indentation levels.
+        - Example: If `#project/website` appears on a parent line, all indented child lines will also be tagged with `#project/website`
+    2. **Heading inheritance**: Tags are inherited from headings to all content under that heading.
+        - Example: If `## Meeting Notes #urgent` appears as a heading, all other *tagged lines* under that heading will also be tagged with `#urgent`
+    3. **Top of the note inheritance**: Tags are inherited from the first 2 lines of the note.
+        - Example: If the first line in the note has `tags: #project/website #urgent`, all other *tagged lines* in the note will also be tagged with both tags.
+        - Example: If a tag appears in the YAML [front matter](#front-matter-tags) of the note, all other *tagged lines* in the note will have front matter tags.
+
+### Date tags
+
+Date tags provide flexible ways to work with dates in your notes, supporting both relative dates that update automatically and absolute dates that remain fixed.
+
+#### Relative date tags
+
+- **Today tags**: Use `#today` for the current date, or add arithmetic like `#today+7` (one week from today) or `#today-10` (ten days ago).
+    - Example: `#today` becomes `#2025-01-15` (if today is January 15, 2025)
+    - Example: `#today+20` becomes `#2025-02-04` (twenty days from today)
+- **Month tags**: Use `#month/01` for the 1st of the current month, `#month/15` for the 15th, etc.
+    - Example: `#month/01` becomes `#2025-07-01` (if the current month is July 2025)
+    - Useful for recurring monthly deadlines like reports or reviews
+- **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
+
+#### Converting relative to absolute dates
+
+- Use the **Replace date tags command** (`Ctrl+Alt+D`) to convert relative date tags to absolute ones in the current lines.
+    - Example: `#today+20` becomes `#2025-02-04` (fixed date that won't change)
+    - Useful when you need permanent deadlines for project planning
+    - Found in `Tools --> Tag Navigator --> Replace date tags in current lines`
+
+#### Customising date tag settings
+
+- **Tag patterns**: You can customise the date tag patterns in the advanced settings:
+    - `Date tags: Today` - Change from `#today` to your preferred pattern (e.g., `#today`, `#now`, `#date`)
+    - `Date tags: Month` - Change from `#month` to your preferred pattern (e.g., `#month`, `#monthly`)
+    - `Date tags: Week` - Change from `#week` to your preferred pattern (e.g., `#week`, `#weekly`)
+- **Date formats**: Customise how dates are formatted using [date-fns format strings](https://date-fns.org/docs/format):
+    - `Date tags: Date format` - Default: `#yyyy-MM-dd` (e.g., `#2025-01-15`)
+    - `Date tags: Month format` - Default: `#yyyy-MM` (e.g., `#2025-01`)
+    - `Date tags: Week format` - Default: `#yyyy-MM-dd` (e.g., `#2025-01-13`)
+    - Tip: Use a nested date structure to make dates hierarchical and sortable, such as `#yyyy/MM/dd`
+- **Week start day**: Configure which day starts the week (Sunday through Saturday) in `Date tags: Week start day`
+
 ### Tag insertion
 
 - You may insert a tag into the note editor by:
@@ -259,6 +309,7 @@ This example searches for paragraphs that have both `#artist` AND `#album` tags,
     - `Note view: Table view columns`: Set the default number of columns (most common ones) to display in the table view.
     - `Search: Extract the full notebook path`: Enable this to display the notebook path in the table view, and to allow [filtering results](#filtering-results) by this path.
     - `Note view: Note view: Tag case in table view`: Set to "Title Case" / "lowercase".
+- Table views, like any other type of note view, can be updated periodically using the settings: `Note view: Periodic update of tag search view in notes` and `Database / Note view: Update after sync`.
 - Tables can be customised per note using with table-specific options. See the [saved queries](#saved-queries) section for complete specifications and examples.
 
 ### Kanban views
@@ -276,7 +327,9 @@ This example searches for paragraphs that have both `#artist` AND `#album` tags,
     - Like other note views, it updates automatically as you modify tasks in your notes.
         - When you open the kanban note;
         - Or when you press `Note view: Refresh` (Ctrl + Shift + R).
-- You may use the [YesYouKan](https://joplinapp.org/plugins/plugin/org.joplinapp.plugins.YesYouKan/) plugin to visualise the note as a kanban board.
+- Sub-task logic: For tasks with sub-tasks, the kanban column is determined by the parent checkbox if it exists, otherwise by the completion status of the sub-tasks. For example, `- [ ] Deploy to production` with completed sub-tasks appears in the Open column because the parent task isn't checked. But `- Website launch preparation` (no parent checkbox) with all sub-tasks completed appears in the Done column.
+- Kanban views, like any other type of note view, can be updated periodically using the settings: `Note view: Periodic update of tag search view in notes` and `Database / Note view: Update after sync`.
+- You may use the [YesYouKan](https://github.com/joplin/plugin-yesyoukan) plugin to visualise the note as a kanban board.
 
 ### Filtering results
 
@@ -329,6 +382,7 @@ This example searches for paragraphs that have both `#artist` AND `#album` tags,
 | Ctrl + Shift + I | Focus on search panel (search tag / insert tag) |
 | Ctrl + Shift + R | Refresh the current note view |
 | Ctrl + Shift + D | Update tag database |
+| Ctrl + Alt + D   | Replace date tags in current lines |
 | Ctrl + Shift + L | Load search query from current note |
 
 - Tag / note filter (search panel) shortcuts
@@ -357,11 +411,13 @@ This example searches for paragraphs that have both `#artist` AND `#album` tags,
     - 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`]
+    - Enable the `Tag conversion tracking` setting to intelligently track converted tags for automatic cleanup when removing or modifying Joplin and inline tags. This helps maintain consistency between your Joplin tags and inline tags when you make changes to either system.
 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.
+- Use [YesYouKan](https://github.com/joplin/plugin-yesyoukan) to visualize kanban views generated by Tag Navigator as interactive kanban boards.
 - 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:
     ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "joplin-plugin-tag-navigator",
-  "version": "2.5.0",
+  "version": "2.5.2",
   "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.5.0",
+	"version": "2.5.2",
 	"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:d501b27ff7e3e068c175b988e09c61d719baec9481d0fa2bb5f1b4299361d69e",
-	"_publish_commit": "main:1fe4d5b6d461d2ab8c92a1bcedc07c94a69a580c"
+	"_publish_hash": "sha256:f34eb817a9074d87ca7b896d56bb8ad174bdfcf24e5cb0557bc7975a2e0da919",
+	"_publish_commit": "main:293f8cc829ccc6b40528d07546e3cb853a367ef3"
 }