[[ノート]]数が増えたときの影響が気にはなるが、[[プロパティ (Obsidian)|プロパティ]]には将来性もあり、現時点では利便性が確実に上がるため。入力の手間も[[🦉Carnelian]]で最小化できる上、不要と判断したときの削除は比較的簡単なので。 ## 経緯 [[Minerva]]の検索は基本的に以下の方針を想定してきた。 | プラットフォーム | ノートタイトル | タグ | エイリアス | | -------------------- | -------------- | ---- | ---------- | | [[Obsidian]] | ◎ | O | O | | [[Obsidian Publish]] | ◎ | | O | [[エイリアス (Obsidian)|エイリアス]]は実質[[ノート]]タイトルのようなものなので自然。[[タグ (Obsidian)|タグ]]は分類の意味合いで使われることが一般的だが、ここでは検索ワードのような意味合いで利用している。ただし、検索だけを目的にはせず、あくまで[[タグ (Obsidian)|タグ]]として登録して違和感がない場合に限る。 タイトルが文になるノート、たとえば以下のようなものであれば、検索ワードがタイトルに入っていることも多く見つけやすい。 - [[Procedure note]] - [[Activity note]] - [[Troubleshooting note]] 一方、[[Glossary note]]のように単語/名称がタイトルとなる[[ノート]]は検索でヒットしにくい。もちろん、探しているモノの名前が分かっていれば問題ないが、実際に検索するシーンでは『〇〇ができるツール』や『〇〇なときに必要なもの』のように抽象的な要件が検索ワードとなることが多い。 [[ノート]]の検索には[[🦉Another Quick Switcher]]を使っており、[[Search by]]設定には`Tag`を追加している。そのため、[[タグ (Obsidian)|タグ]]を検索対象に含めることはできる。[[内部リンク]] (ファイル) や[[ヘッダ (Obsidian)|ヘッダ]]を検索対象に含むことも可能だが、ノイズやパフォーマンスの観点からできれば使いたくない。(その2つは検索ワードとしての目的で設定はしないので) ## 提案内容 [[Glossary note]]には[[descriptionプロパティ (Obsidian)|descriptionプロパティ]]をつける。 - 情報量が増える場合は必ずつける - 逆に言うと、情報量が変わらない場合はつけなくてもよい - [[Glossary note]]以外の[[ノート]]は任意 (この[[ADR]]では触れない) - [[descriptionプロパティ (Obsidian)|descriptionプロパティ]]の内容は、基本的に[[ノート]]の最初に記載された内容とあわせる - [[🦉Carnelian]]の`Add description property`コマンドを使う ## 承諾した場合の結果 ### メリット - [[🦉Another Quick Switcher]]の検索対象に含まれる - 検索ワードが説明文にマッチするのでヒット率が上がる - [[プロパティ (Obsidian)|プロパティ]]のメリットと将来性 - [[Dataview]]などの[[プロパティ (Obsidian)|プロパティ]]を利用するエコシステムが使える - [[Obsidian Publish]]で特殊な表現や自作の検索などに利用できる - [[Obsidian]]では[[メタデータ (Obsidian)|メタデータ]]として扱えるためFileIOが発生しない - [[OGP]]としても使える - [[Minerva]]がWeb検索でもヒットしやすくなる (そこまで重要じゃないけど) ### デメリット - [[🦉Another Quick Switcher]]の検索に対するノイズになる可能性がある - これはやってみないと分からないので様子見でいい - ノイズにならない程度の説明になるよう心掛けるのも大事 - [[Obsidian]]の[[プロパティ (Obsidian)|プロパティ]]欄(高さ)が広がってしまう - 概要ならせいぜい2行程度のプラグなので大きな問題ではない - エディタをスクロールすれば関係ないし - [[メタデータ (Obsidian)|メタデータ]]に関する処理が全体的に重くなる (`description`の分だけ) - これもやってみないと分からない。微妙なら削除すればいい - あとから[[descriptionプロパティ (Obsidian)|descriptionプロパティ]]を一括削除するのは追加に比べて難しくない - 本文と[[プロパティ (Obsidian)|プロパティ]]で内容が重複する - [[リンク]]関係を正確に表現したいなら必須 - [[プロパティ (Obsidian)|プロパティ]]では[[内部リンク]]を含めた文字列を指定できなそう - 内部リンクのみなら可能 - [[リンク]]関係不要なら削除するという選択肢もある - ただ、[[Obsidian Publish]]で閲覧できなくなるのは困る - [[descriptionプロパティ (Obsidian)|descriptionプロパティ]]を拾って表示することも可能だがそこまでやるか... - [[ノート]]の1段落目を自動でdescriptionとみなす案もあった - [[🦉Another Quick Switcher]]の検索対象として1段落目を含めると、都度fileIOが走るので無理 (そのために独自キャッシュ管理するのも嫌だ) - [[descriptionプロパティ (Obsidian)|descriptionプロパティ]]作成時にそうするなら、[[🦉Carnelian]]の`Add description property`で十分 - 入力が大変 - 本文と[[プロパティ (Obsidian)|プロパティ]]で内容が重複しているうちは、[[🦉Carnelian]]の`Add description property`があるからそうでもない