スニペット

スニペットのしくみ

スニペットは、ショートカットとそれが表すテキストの組です。ノートでショートカットを入力すると、最後の文字を入力した瞬間に完全なテキストになります。押すキーもメニューもありません。意図したものでなければ、すぐに ⌘Z を押すと入力したとおりに戻ります。Expand snippets as you type は最初からオンで、Settings ▸ Snippets でオフにできます。

スニペットを作る

1. サイドバーの Snippets（⌃8）を開き、ヘッダーの + をクリックします。
2. ショートカットを入力します。新しいショートカットは :addr のようにコロンで始まり、ふつうの語の途中で展開されないようになっています。
3. 必要なら説明を追加し、カテゴリを選んで、テキストを書きます。テキストは Markdown で、複数行にわたってもかまいません。
4. スニペットを展開したあとにカーソルを置きたい位置に $|$ を入れ、Save をクリックします。

ショートカットがすでにある場合や、ほかのショートカットの先頭部分になっている場合は、MindLake が警告します。短いほうが常に先に展開されるため、長いほうは使えなくなるからです。

どの App からでも、コマンドバーで作ることもできます。/newsnippet ;sig Kind regards と入力して ↩ を押すとその場で保存され、⌘↩ を押すと代わりに Snippets で開きます。

並べ替えとカテゴリ

Snippets のページは All Notes と同じように、左にリスト、右にプレビューがあります。並べ替えボタンで、Shortcut、Type、Category、Newest First、Oldest First の順にリストを並べます。種類やカテゴリで並べ替えると、各グループに見出しが付きます。各スニペットには作成日時が表示されます。MindLake が作成日を保存するようになる前に作られたものには、「before」と日付が表示されます。

カテゴリはご自身で決めます。スニペットに直接入力すると、入力に合わせて既存のカテゴリが候補として表示され、⇥ で補完します。スニペットの右クリックメニュー（Edit、Duplicate、Delete もあります）や、プレビューのヘッダーからも設定できます。ヘッダーのカテゴリボタンで、1 つのカテゴリだけを表示したり、カテゴリの名前を変えたりできます。カテゴリのないスニペットをすべて種類別に整理することも提案でき、何かを移動する前に件数を示します。

種類と色

各スニペットのアイコンは、MindLake がテキストから読み取った種類を示します。コマンド、コード、リンク、メールアドレス、電話番号、住所、数値、リスト、プレーンテキストです。種類はその都度判断され、保存されることはありません。Settings ▸ Theme ▸ Colour snippet types individually で、種類ごとに色を付けられます。

コマンドバーからペーストする

スニペットは ⌘K やコマンドバーで検索すると表示され、/snippet ですべて一覧表示されます。↩ を押すと、入力していた App にテキストをペーストします。スニペットが展開されない場所でも使えます。アクセシビリティへのアクセスが必要で、ない場合はテキストがコピーされるので、⌘V でペーストします。

ほかの App で展開する

スニペットは MindLake だけでなく、すべての App で展開できます。Settings ▸ Snippets で Expand in every app, not just MindLake をオンにし、macOS に尋ねられたらアクセシビリティへのアクセスを許可します。MindLake は入力内容を見るためにこれを必要とします。オンにするまではオフです。

• MindLake はテキストをペーストし、少しあとにクリップボードを元に戻します。
• パスワードのフィールドでは、何も監視も展開もしません。
• MindLake が動いている必要があります。MindLake の外では $|$ は無視され、カーソルはテキストのあとに置かれます。

読み込みと同期

スニペットは保管庫の最上位にある snippets.json に保存されるので、ノートと一緒に移動します。すでにあるライブラリを取り込むには、Snippets のヘッダーにある読み込みボタンをクリックします。ウインドウには、この Mac で見つかったスニペットのライブラリ（espanso、Alfred、TextExpander、macOS のユーザ辞書）が、それぞれのスニペットの数と新しいものの数とともに表示され、クリックすると読み込みます。

• Raycast と Typinator はスニペットを外から読めない形で保持しているので、App から書き出し（Raycast：Export Snippets、Typinator：セットを CSV として書き出す）、そのファイルをウインドウにドロップします。
• aText や上記の App の書き出しファイル、またはショートカットとテキストの CSV や TSV ファイルを、ドロップするか選ぶこともできます。ドロップは読み込みのウインドウだけでなく、Snippets のページ自体でも使えます。Settings ▸ Snippets ▸ Import from another app ▸ Choose file… でも同じことができます。
• ライブラリではないテキストをドロップすると、新しいスニペットになります。
• MindLake は形式を自分で判断し、既存のショートカットを上書きすることはなく、TextExpander のグループをカテゴリに変換します。
• この Mac で espanso を使っていた場合、スニペットがまだない保管庫には、そのスニペットが自動的に取り込まれます。