readme.ja.md

Logseq プラグイン: Hierarchy Tool (TOC)

• Logseqで「階層」を使用するユーザーのための強力なツール。
  1. ヘッダーごとに分割し、情報量の増えてしまった包括的なページを、サブページに分割するワークフローを提供します。
  2. 階層やヘッダーが使われている包括的なページを、表示または分割するために最適化された目次機能があります！

Warning

現在、このプラグインはLogseq dbバージョンでは動作しません。このプラグインが機能するように修正する予定です。

English / 日本語

概要

ページを開かずに、階層を頼りに目的のページを探します。 Incremental Page Search ページ検索機能。文字入力にマッチするページを一覧表示 Page Connection 現在開いているページに関連するページを一覧表示 ページコンテンツの下側ではなく、ポップアップに、下位階層へのリンク(Namespace)とページタグの表示。 Table of Contents with Sub-pages サブページも統合された目次機能。 ※ページ内でのスクロールではなく、ブロックへのズームインとして機能します。 サブページの作成とブロックの移動をサポート

---

始めに

Logseq マーケットプレイスからインストール

• 右上のツールバーで[---]をクリックして[プラグイン]を開きます。マーケットプレイスを選択し、検索フィールドにHeadersと入力し、検索結果から選択してインストールします。

使用方法

• ツールバーのボタンが、最初のトグルになっています。
  • ポップアップが表示されている間、ユーザーがページを移動したら、そのページの目次に切り替わります。

  最初、このボタンはLogseqによって非表示にされています。ツールバーのこのボタン () をクリックし、その後、この を選択します。その後、ツールバーに 🏢 ボタンが表示されます。

• 目次では、ブロックをズームインで開きますが、ページコネクション内では、階層の上下移動のために、ページが直接開かないようになっています。(Ctrl+クリックでページとして開きます)

Tip

1. ページ名の隣にある➕ボタンを押すと、サブページの作成がおこなえます。類似するページ名が候補として表示されます。
2. 目次のヘッダーをCtrl+クリックして、そのヘッダーがあるブロックとそのサブブロックを、サブページに移設することが可能です。

   注: ブロックの移設後に、ブロック背景色を示す"backgroundcolor"プロパティが残ってしまい、色が適用されない場合があります。"backgroundcolor"ページにアクセスし、"background-color"に名称を変更してください。

3. ポップアップをトグルするショートカット (デフォルト: Ctrl/Cmd + F1)
4. 箇条書き(ブロック)のコンテキストメニュー項目「ブロックをページに昇格させる」
   • サブブロックを含めて、新しいページに移設することができます。

注意事項

• 内容が競合するため、あらかじめ、ページコンテンツ内の階層やページタグの表示を、プラグイン設定で非表示になっています。
• サイドバーとポップアップが重なることがあります。サイドバーを使う場合は、ポップアップを閉じてください。
• ページの情報量があまりに膨大な場合や、ページ埋め込みがコンテンツ内に多く存在する場合に、読み込みが遅くなる可能性があります。
• ほかの目次機能をもつプラグインがある場合、その機能は必ずオフにしてください。
• このプラグインを使う際は、Page-tags and Hierarchy プラグインの Page View UI機能を必ずオフにしてください。
• Side Block プラグインを使っている方は、プラグイン設定で、目次の文字列削除の入力欄に、「#.side(-[a-z])?」を追加してください
• 目次では、1階層目にあるヘッダーのみが検出されます。
• 自動ヘッダーの場合は、"heading:: true" プロパティが使われます。その場合、目次には表示されません。

Demo

---

ショーケース / 質問 / アイデア / ヘルプ

ディスカッションタブにアクセスして、この種の質問をするか見つけます。

TODO

1. 目次機能の移植
2. 現在はポップアップ表示で実装されています。
3. 目次の中に、下位階層を表示
4. ズームページに対応 (スクロールではなく、ブロックズームにする)
5. ページ名でパターンマッチをおこなってページを検索する機能を追加 (インクリメンタルサーチ)
6. ヘッダーをもつブロックを、サブページ化する機能を追加 (目次のヘッダーでCtrlクリックをする)
7. サブページを作成するボタンを追加
8. ページタグや階層の一覧表示に対応 (ページコンテンツ内のページタグや階層の表示を代替する役割をもつ)
9. サブページを作成するダイアログでのインクリメンタルサーチ (類似ページの検索)
10. ショートカットで、ポップアップをトグル可能にする
11. Sticky Heading スタイル https://github.com/zhouhua/obsidian-sticky-headings
12. Logseqのdbバージョンがリリースされた後に、調整が必要。("heading:: true"などのプロパティを使用しなくなる)

先行技術とクレジット

• TOC > Page-level TOC プラグイン
• TOC > TOC Generator プラグイン
• 左サイドバーの目次機能 > Left Sidebar Enhance プラグイン
• アイコン > icooon-mono.com
• 製作者 > @YU000jp