Skip to content

YU000jp/logseq-plugin-hierarchy-tool

Repository files navigation

Logseq Plugin: Hierarchy Tool (TOC)

A powerful tool for managing hierarchical pages in Logseq

Warning

This plugin is NOT compatible with Logseq DB version and will remain incompatible.

✨ Key Features

  1. Smart Page Search

    • Quick incremental search across all pages
    • Find pages instantly as you type
  2. Intelligent Page Connections

    • View related pages in a clean interface
    • Navigate hierarchies (Namespaces) and tags efficiently
  3. Enhanced Table of Contents

    • Seamlessly integrate with sub-pages
    • Smart block zoom navigation
    • Quick sub-page creation and block management

Getting Started

Install from Logseq Marketplace

  • Press [---] on the top right toolbar to open [Plugins]. Select Marketplace. Type sub in the search field, select it from the search results and install.

Usage

  • The button on the toolbar is the first toggle.
    • While the pop-up is displayed, if the user navigates to a page, it switches to the table of contents for that page.

    Initially, this button is hidden by Logseq. This button on the toolbar (アイコン) on the toolbar. Click on it and then click on this image . The 🏢 button will then appear on the toolbar.

  • In the table of contents, the block is opened by zooming in, but within Page Connections, the page does not open directly for moving up or down the hierarchy. (Ctrl+click to open as a page).

🚀 Quick Tips

  1. Create Sub-pages: Click ➕ next to page names for quick sub-page creation
  2. Smart Block Movement: Ctrl+click headers to move blocks to sub-pages
  3. Quick Access: Use Ctrl/Cmd + F1 to toggle the popup
  4. Block Promotion: Right-click any bullet to promote it to a page

⚠️ Important Notes

  • Plugin auto-hides hierarchy/tags display to prevent conflicts
  • Close popup when using sidebars to avoid overlap
  • Performance may vary with page size and embedded content
  • Disable other TOC plugins for best experience
  • Compatible with Side Block plugin (add #.side(-[a-z])? in settings)

Note

  • Due to content conflicts, the display of hierarchy and page tags in the page content is hidden in the plugin settings beforehand.
  • Sidebars and pop-ups are displayed overlapping. To use the sidebar, close the pop-up.
  • Loading may be slow if the amount of information on the page is too large or if there are too many page embeds in the content.
  • If you have other plug-ins with table of contents functionality, be sure to turn it off.
  • When using this plugin, be sure to turn off the 'Page View UI' functionality of Page-tags and Hierarchy plugin.
  • If using the Side Block plugin, in the plugin settings, add "#.side(-[a-z])? " in the input field.
  • In table of contents
    • Only headers on the first level are detected.
    • For automatic headers, the "heading:: true" property is used. In this case, they are not displayed in there.

Demo

HierarchyTool

Showcase / Questions / Ideas / Help

Go to the Discussions tab to ask and find this kind of things.

TODO

  1. Porting of table of contents functionality
  2. Currently implemented in pop-up view.
  3. Display of subordinate levels within the table of contents
  4. Support for zoomed pages (block zoom instead of scrolling)
  5. Added ability to search for pages using pattern matching by page name. (Incremental Page Search)
  6. add ability to turn blocks with headers into sub-pages (Ctrl-click on header in table of contents) 1.
  7. Added button to create a sub-page.
  8. Added support for displaying a list of page tags and hierarchies (replaces the display of page tags and hierarchies in the page content).
  9. Incremental Page Search in dialog that create sub-page
  10. Shortcut to enable toggling of the pop-up
  11. Sticky Heading Style https://github.com/zhouhua/obsidian-sticky-headings
  12. Adjustments need to be made after the db version of Logseq is released. ("heading:: true" and other properties).

Prior art & Credit

About

Powerful tool for users who use ''hierarchy'' in Logseq.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Contributors 3

  •  
  •  
  •