Plugin: Inline Tag Navigator [v1.2.2, 2024-08-23]

djsudduth · 2024-05-08T19:45:22.911Z

@shikuz - really enjoying your inline tag navigator! Thanks for the awesome tool!

shikuz · 2024-05-10T02:54:07.650Z

v0.7.0

new: mobile app support
- this includes many changes and improvements under the hood, that may also improve the desktop experience.
- all features should be supported. scroll to line works when the editor is open.
new: [x]it! style TODOs (see screenshot)
- it's not a complete implementation, but adds support for the 5 types of checkboxes.
- I first learned about this text format on the Inline TODOs plugin repo, thanks!
new: settings
- Search: Colorize todos in results: toggle custom checkboxes (and [x]it! support) on / off.
- Search: Update inline tags DB after sync
- Search: Periodic update of results display in notes: you may disable this on a Joplin client to avoid conflicts with another client. the same time interval as above applies.
- Search: Show note mentions section and Search: Show results filter section: hide elements on the panel, for a better mobile / small screen experience.
misc improvements
- skip conflict notes
- remove saved query from note when saving an empty query
- respect user sort choice after panel hide
misc fixes
- remove tag command supports tags with special chars
- checkbox toggle next to links and inline code
- avoid updating note when nothing changed
- word-wrapping in search results

Tips on setting tag highlighting in the mobile editor appear here.

Screenshot: [x]it! TODOs

shikuz · 2024-05-11T23:47:06.468Z

v0.7.1

fix: load search filter more robustly and preserve its value when toggling the panel
improve: checkbox style for easier customization
- you may increase the size of checkboxes by entering in the Search: Panel style setting: .itags-search-checkbox { width: 15px; height: 15px; font-size: 15px } (requires restart)

v0.7.2

fix: regression in tag exclusion regex
fix: regression in updating CSS on panel toggle
fix: update tags / notes lists on db update
improve: checkbox + tag spacing style

v0.7.3

new: tag context menu commands Search tag and Extend query (see screenshot)

image738×570 63.8 KB

shikuz · 2024-05-23T03:48:11.612Z

v0.7.4

various fixes to improve plugin stability and reduce its footprint considerably
new: blocked-task style checkbox - [!] (not officially part of the [x]it! specs)
improve: set a constant level for headings (h3) rendered on the panel
fix: AND logic for empty tags

shikuz · 2024-06-26T01:48:02.825Z

v0.8.0

enhanced tag search
- new: tag range queries (see screenshot)
  - check the Enter, Esc, ArrowUp key presses while editing ranges in the panel
- new: #today date tag, with support for date arithmetic (e.g., #today+1)
  - this special tag can be used both to tag and to search (see screenshot)
- new: Enter key press can add multi-tags to query
- new: optional regex support in filters
enhanced tag editing (see screenshot)
- new: context menu command Replace all to edit all instances of a tag
- new: context menu command Remove all to remove all instances of a tag
other
- new: follow links to notes from the panel
new settings
- new: Search: Use regex for tag / note / content filtering
- new: Search: Show tag range section
- new: Date tags: Today
  - customise the #today tag
- new: Date tags: Date format
misc fixes & improvements
- fix: skip note when tag conversion fails
- improve: default tag regex (stop at quotation marks)
- fix: update database and tag list while editing notes
- improve: results highlighting
- fix: toggle checklist items with markdown formatting
- fix: load results filter on load query command
- improve: more compact panel UX

image 1: tag ranges

image 2: date tags & date ranges
note how #today is used to tag a paragraph, and to search for dates

image 3: new tag editing commands

shikuz · 2024-07-13T12:09:48.183Z

v1.0.0

enhanced tag search
- nested tags / tag hierarchy: this feature request has been floating around for some time. when using nested tags like #parent/child, searching for #parent will bring up all its child tags as well (including #parent/child, #parent/child2, etc.). this format / style is common in many note apps such as Bear, Obsidian, Notable, Foam, Amplenote, and allows one to group tags by projects and contexts. you may use the Replace All command to rename your existing tags and turn them into nested tags.
  - example: when date tagging using the following format #2024/07/13, searching for #2024 will return all dates from 2024, and searching for #2024/07 will return all dates from July 2024.
new commands
- show / hide panel sections (tag ranges, note mentions, results filters) by right-clicking anywhere on the panel.
- edit tags also by right-clicking on the tag list or the search query.
new settings
- Search: When multiple tags are matched, select: "First" / "All" (behaviour in v0.8.0) / "None" (behaviour before v0.8.0).
  - example: when selecting "All" here, and selecting Search: Use regex for tag / note / content filtering, you could come up with filter patterns to add multiple tags at once to the query and search for all of them.
- Search: Tag sort by: "Name" / "Count".
  - example: when selecting "Count" here and "First" in the setting above, the most popular tag will be selected by default when pressing Enter in the query builder.
misc fixes
- toggle checklist items with markdown formatting.
- case insensitive tag ranges.
- case insensitive tag replace / remove all.
- checkbox style.

shikuz · 2024-07-20T00:44:57.734Z

v1.1.0

commands
- new: toggle task checkboxes between 6 different states via a context menu. (see screenshot)
  - open, in question, ongoing, blocked, obsolete, done
- new: note toolbar button to load query from a note, which is available on mobile in the 3-dot note menu.
- new: editor toolbar button to toggle note view, which is available on mobile on the editor toolbar.
note mentions
- new: wikilinks can open notes from the panel.
- fix: regression in wikilink search.
- fix: add notes to query by title and ID to handle notes with duplicate titles.
- improve: search only by note ID when available to handle notes with duplicate titles.
misc fixes & improvements
- fix: remove empty notes from note view.
- fix: avoid multiple context menus.
- improve: content margins style.

Benjamin-Watson0 · 2024-07-24T03:31:17.915Z

Hello, how do I search for all the to-dos? I don't know anything about it.Thank you.

shikuz · 2024-07-24T14:59:43.025Z

Hi! I was about to say that since this plugin is based on tags it's a little different from a task-centered plugin, and checkboxes that aren't tagged won't appear in the panel. Nevertheless, it's actually possible to define every checkbox / inline TODO as a tagged line (in addition to standard inline tags). Here's the recommended setup to turn the Tag Navigator into an all-task manager:

In the plugin settings
- Set "Tag regex" (Advanced Settings) to (?<=^|\s)([#]|\-\s\[[x\s@\?!~]\])([^\s'\"]*\w)?
- Set "Search: Highlight results" to off
In the plugin's search panel
- Search for - [ ] OR - [x] to list all TODOs
- You may also search for combinations of a checkbox and a tag such as #today, #next-action, #important, etc.

EDIT: Improved regex to support extended checkbox states.

artis · 2024-07-31T10:02:00.232Z

shikuz:

Supported additional checkbox styles

Hello,
how do you set up additional checkbox styles (or which plugin does provide them)?
Thanks!

shikuz · 2024-08-01T05:28:55.002Z

Hi @artis, checkbox styling is supported in the plugin panel. In the note editor you write (and see) just plain text. Copy the text below and paste it in any note. Then, search for the tags #checkbox AND #test. You should see all the checkbox styles displayed and colored in the panel. Click on any of them to change their state to "done", or right-click on them to select a task status.

(You may use the Rich Markdown plugin to style checkboxes in the note editor.)

- #checkbox #test
    - [ ] this is open
    - [?] this is in question
    - [@] this is ongoing
    - [!] this is blocked / paused
    - [~] this is obsolete
    - [x] this is done

artis · 2024-08-01T05:46:16.734Z

Thank you for your answer.
I understand that styling is supported in the plugin panel.
I was interested in the part on how to style it in the note editor. As I now understand it's done through the Rich Markdown plugin.
Can you please share your styling code for the checkbox styles in the example?

shikuz · 2024-08-01T06:00:18.174Z

I linked to the relevant post in the Rich Markdown forum thread. For the mobile, I use this forked release of the plugin with predefined styles. Hopefully this will help.

shikuz · 2024-08-14T02:33:07.269Z

v1.2.0

navigation panel
- new: navigation panel view of all tags, with nested tags support (see video)
misc fixes & improvements
- improve: display tooltip for note title in query
- fix: tag name sort to be locale aware
- fix: open range queries
- fix: save over badly formatted queries

Isaac · 2024-08-14T07:47:22.649Z

shikuz:

nested tags support

Finally nested tags support

For a new plugin user starting from scratch what I have to do to bring my many many tags to your panel (nested)?

Rename the tags I have now which should be nested from e.g. € clothing, € shoe,... to invoices/€ clothing, invoices/€ shoe,...
Then rearrange the tag navigation panel to the bottom left (under the default tag section from jopling)
Can I make your tag navigation panel look more like the default one (dark background etc.)?

Another thing I've noticed is when using your plugin the Slash Commands plugin doesn't work anymore, does it

Is there a way to change the hotkeys?

shikuz · 2024-08-14T14:46:55.437Z

Isaac:

Can I make your tag navigation panel look more like the default one (dark background etc.)?

Yes, there is an advanced setting for Tag Navigator, Navigation: Panel style. Enter the following setting to style it like Joplin's default tag panel (assuming that you're using the light theme).

html * {color: white; background-color: #313640;} .itags-nav-noteTag, .itags-nav-globalTag {color: white;}

Isaac:

Is there a way to change the hotkeys?

Go to Joplin's settings -> Keyboard Shortcuts -> Search for "itags".

Isaac:

Another thing I've noticed is when using your plugin the Slash Commands plugin doesn't work anymore, does it

AFAIK, Slash Commands does not work in the new note editor (the default editor since Joplin v3.1). Perhaps this is what you're experiencing?

shikuz · 2024-08-16T01:49:42.781Z

v1.2.1

new: insert tags into the note editor (Markdown / Rich Text) with auto-completion
- in the settings, set Search: When multiple tags are matched: to Insert first in editor, and follow these steps:
1. press Ctrl+Shift+I to change focus to the tag search panel.
2. type part of a tag.
3. press Enter to insert the first tag at the current cursor position, and return to the editor.
4. or, press Esc to return to the note editor.
- this also works on mobile, if the note editor is open.

tag-navigator-insert

Isaac · 2024-08-20T12:38:05.041Z

@shikuz Can I somehow avoid that your plugin finds/recognizes such source code / html code as an inline tag?

So in words: Don't recognize the #words which are in between <>

shikuz · 2024-08-20T13:15:38.409Z

Wrote this in a different thread, but I also added the following tip to the plugin docs. If you're worried about hexadecimal tags like the ones in the example, utilising the Exclude regex setting can help here (see the link above). If you'd like to be more strict and ignore anything within brackets, you could try to modify the Tag regex setting to something like (?<!<[^>]*)(?<=^|\s)#([^\s#'"]*\w)(?![^<]*>). BTW, notes that are defined as html notes are ignored altogether by default (and so do code blocks).

Isaac · 2024-08-21T07:50:44.201Z

Can you please explain in detail what those two convert variants (from joplin tag to inline tag and vice versa) do exactly?

E.g. I have now >100 native Joplin tags - what happens exactly when I would do Convert all notes' Joplin tags to inline tags? Is your plugin writing the assigned Joplin tag as text #<native_joplin_tag_name> into the note itself at the bottom/top ?

So from Joplin tag | to inline tag is this correct:
Invoice ➜ #invoice
Tag with space ➜ ? (#tag_with_space or #tagwithspace or...?)
After converting will all (old) Joplin tags still be there and still assinged to the note as before the conversion?

Thanks