メリットの割にデメリット(リスク)が多いものの、[[Evergreen Notes]]の追求という次なる至上命題に切り出すための重要なアクションとなる他、情報量が多くなり判断速度が下がりがちな[[MOC]]や検索結果の可読性向上というメリットに投資する価値があると判断した。 ## 経緯 ### Procedure noteの目的 [[Procedure note]]は以下の目的で書いている。 - 手順をノートにまとめる - (理想的には) [[Evergreen Notes]]のように自然な形で文章に挿入する ### 課題 1つ目の目的は問題ないが、2つ目の目的にはハードルがある。現状、[[Procedure note]]は以下のような命名になることが多い。 - Obsidian Publishでfaviconを指定する これを文中にそのまま埋め込むのは困難である。例を考えてみよう。 ```markdown Obsidian Publishをインストールしてpublishしたら、まずはfaviconを指定してみましょう。 ``` 単純に埋め込むと以下のようになり文章として成り立たない。 ```markdown Obsidian Publishをインストールしてpublishしたら、まずは[[Obsidian Publishでfaviconを指定する]]してみましょう。 ``` 問題は2つ。 - prefixにコンテキストがついており冗長である - 動詞の変化に追従できない [[エイリアス (Obsidian)|エイリアス]]を使うとすべて解決するように見えるが、新たに **エイリアスを都度設定するのが面倒** という課題が発生する。 ## 提案内容 [[Procedure note]]は以下のルールで作成する。 - タイトルは体言止めにする - コンテキストは末尾にカッコで記載する 2つ目ついては以下の[[ADR]]とほぼ一緒だ。 <div class="link-card"> <div class="link-card-header"> <img src="https://publish-01.obsidian.md/access/35d05cd1bf5cc500e11cc8ba57daaf88/favicon-64.png" class="link-card-site-icon"/> <span class="link-card-site-name">minerva.mamansoft.net</span> </div> <div class="link-card-body"> <div class="link-card-content"> <p class="link-card-title">💿MIN-0021 異なるコンテキストで同じ名前のノートはsuffixをつける</p> <p class="link-card-description">メリットがPKMとして更なる高みを目指すために必要な本質であり、仕組みを追加すればデメリットもクリティカルなものにはならなそうだから。</p> </div> <img src="https://publish-01.obsidian.md/access/35d05cd1bf5cc500e11cc8ba57daaf88/%F0%9F%92%BFADR%2Fattachments%2Fowl.webp" class="link-card-image" /> </div> <a class="internal-link" data-href="💿ADR/💿MIN-0021 異なるコンテキストで同じ名前のノートはsuffixをつける.md"></a> </div> たとえば、先ほどの例の場合、以下のように[[ノート]]のタイトルを変更する。 ```diff - Obsidian Publishでfaviconを指定する + faviconを指定 (Obsidian) ``` そうすることにより、以下のように自然に本文へ挿入できるようになる。 ```diff - Obsidian Publishをインストールしてpublishしたら、まずは[[Obsidian Publishでfaviconを指定する]]してみましょう。 + Obsidian Publishをインストールしてpublishしたら、まずは[[faviconを指定 (Obsidian)|faviconを指定]]してみましょう。 ``` また、[[曖昧さ回避ページ]]は不要。 ## 承諾した場合の結果 ### メリット - [[Evergreen Notes]]のようにイケてる[[PKM]]っぽくなる - 自己満足の部分も多い... が真剣に取り組んだことないので挑戦する価値はある - [[Procedure note]]のタイトルがシンプルになる (くどくならない) - すべてに `Obsidian Publishで` というprefixがつくよりは、すべてに ` (Obsidian Publish)` というsuffixが付く方が、見栄えもよく情報も判断しやすい - [[ノート]]のタイトルがもつ情報量は変わらない - 検索でヒットしにくくなるというリスクはほぼない ### デメリット - [[エイリアス (Obsidian)|エイリアス]]の指定が都度面倒 - `[[faviconを指定 (Obsidian)|faviconを指定]]` のような記載が必要 - [[🦉Various Complements]] の [Insert an alias that is transformed from the displayed internal link](https://tadashi-aikawa.github.io/docs-obsidian-various-complements-plugin/4.%20Options/4.7.%20Internal%20link%20complement/%E2%9A%99%EF%B8%8F%20Insert%20an%20alias%20that%20is%20transformed%20from%20the%20displayed%20internal%20link/) 機能があれば、[[エイリアス (Obsidian)|エイリアス]]を手動で打ち込む必要はなくなるので問題ない - [[Procedure note]]の名称が変わったときにリネームが面倒 - [[ノート]]のタイトル変更だけだと、`[[faviconを指定 (Obsidian)|faviconを指定]]` が `[[お気に入りアイコンを指定 (Obsidian)|faviconを指定]]` となってしまい、見た目で`favicon`というキーワードが残ってしまう - `[[お気に入りアイコンを指定 (Obsidian)|お気に入りアイコンを指定]]` と都度リネームが必要 - 本[[ADR]]に限らず、[[エイリアス (Obsidian)|エイリアス]]を使用する場合全般の課題なので、必ずしもここで議論する必要はない - ... が、何か良い策を検討はしてみたい - [[エイリアス (Obsidian)|エイリアス]]が増えてしまう - [[エイリアス (Obsidian)|エイリアス]]を使わないに越したことはないので... 編集と表示の差分もなくなるし - ただ、メリットと天秤にかけると妥協してもいいポイントな気はする - [[ファジー検索]]でひっかからなくなる可能性がある - `Obsidian Publishでfaviconを指定` なら `obsidianpublishfavicon`でもヒットしたが、`faviconを指定 (Obsidian Publish)`だとヒットしない - ただ、これは順序をどう扱うかという違いであり、ルール変更後はコンテキストに値する`obsidian`を最後につけるようにすればいいだけ. 慣れの問題 - また、[[🦉Another Quick Switcher]]であれば半角スペース区切りすることで順不同になるため影響はない ## 参考 - [[📓異なるコンテキストで同名なノートの扱い]] - [[💿MIN-0021 異なるコンテキストで同じ名前のノートはsuffixをつける]]