For everyone — 設定
Obsidian の 設定 → コミュニティプラグイン Universal Cursor Hotkeys を選択 → 上部タブ For everyone を開きます。
設定画面は大きく「Hotkey settings (ホットキー設定)」と「Key upgrades (基本操作のアップグレード)」、「Behavior options (挙動オプション)」で構成されています。
通常、プラグインのホットキー割り当ては Obsidian 標準のホットキー設定画面で行いますが、このプラグインではプラグイン設定画面の中でホットキー割り当て状態の確認と推奨設定の一括割り当てが行えます。
Hotkey settings (ホットキー設定)
ここには 1 つのコマンドグループ (→解説) と「Displaced commands」(→解説) の計 2 つのブロックがあります。
Apply recommended ボタン
コマンドグループ Add cursor の見出しの右側に Apply recommended ボタンがあります。これを押すとコマンドグループの推奨ホットキーを一括で割り当てます。
インストール直後の Obsidian であればそのまま Apply recommended を押して構いません。macOS では初期状態でのホットキー競合はありません。Windows では推奨ホットキーと重なる既定のホットキー (Ctrl + P のコマンドパレットなど) が Displaced commands に送られますが、これらはすべて Restore で元に戻せます。(→Displaced commands 解説)
すでにホットキーを自分でカスタマイズしている場合は、他のホットキーが残るコマンド (🔵Used など) から外れたホットキーは Displaced commands に載らず Restore で戻せません。気になる場合は押す前に各行の Status を確認してください。(→Status 解説)
一括割り当ての対象は、そのコマンドグループのうちホットキーがまだ 1 つも割り当てられていないコマンドです (→例外あり)。すでに割り当てられているコマンド (✅Set、🟢Custom) と、推奨ホットキーがないコマンド (—) には影響しません。 推奨ホットキーを別のコマンドが使用中の場合 (🔵Used、🟡Used、推奨ホットキーが別の複数のコマンドに割り当てられている 🔴Conflict) は、それらのコマンドから推奨ホットキーを外して、代わりにこちらのコマンドに推奨ホットキーを割り当てます。ホットキーが 1 つも残らなくなったコマンドは Displaced commands に送られます。
画面の見方
各コマンドグループは次の項目を持つ表になっています。
| 項目 | 説明 |
|---|---|
| Command | このプラグインが提供するコマンド名です。Obsidian 標準のホットキー設定画面で表示される名称です。 |
| Recommended Hotkey | Emacs 風の最低限の推奨ホットキーです。 Apply recommended で割り当てる内容を示します。 |
| Current Hotkey | 現在割り当てられているホットキーです。複数ある場合には一部省略表示されることがあります。すべて表示する場合にはキーチップをクリックしてください。 |
| Status | このコマンドのホットキー割り当て状態を示します。(後述) |
| ▶Individual | 個々のコマンドを細かく調整するためのアクションボタンを表示します。(後述) ▶Individual をクリックしてこの列に調整用のボタンを表示させてください。(デフォルト非表示) |
コマンド名またはキーチップをクリックすると、そのコマンド名またはキーで絞り込んだ状態で Obsidian 標準のホットキー設定画面に遷移します。
コマンドグループ
プラグインが提供するコマンドとテーブル関連コマンドを 5 つのグループに分けて表示しています。
| コマンドグループ | コマンド数 (うち推奨ホットキー数) | 説明 |
|---|---|---|
| Add cursor | 2 (2) | マルチカーソルを追加するホットキーです。 Obsidian 標準にも同様のコマンドがありますが挙動が不安定な場面があるため代替コマンドを用意しました。 |
コマンドグループ名はコマンドリファレンスの該当部分にリンクしています。各コマンドと推奨ホットキーはコマンドリファレンスを参照ください。
Status 一覧
| ステータス | 意味 | Individual ボタン |
|---|---|---|
| ✅Set | 推奨ホットキーが割り当てられています。 | Open → |
| 🟢Custom | 推奨ではないホットキーが割り当てられていて、競合はありません。 | Open → |
| 🔵Available | 推奨ホットキーが未割り当てで、別のコマンドでも使われていないので安全に割り当て可能です。 | Set |
| 🔵Used | 推奨ホットキーは別のコマンドで現在使用中です。 推奨ホットキーを割り当てるとそのコマンドから推奨ホットキーを割り当て解除します。(Override ボタン) そのコマンドには複数のホットキーが割り当てられているので、割り当て解除してもそのコマンドが起動できなくなることはありません。 | Override |
| 🟡Used | 推奨ホットキーは別のコマンドで現在使用中です。 推奨ホットキーを割り当てるとそのコマンドから推奨ホットキーを割り当て解除します。(Override ボタン) そのコマンドにはこの推奨ホットキーしか割り当てられていないので、割り当て解除するとそのコマンドを起動するホットキーがなくなってしまいます。 (割り当てると、そのコマンドは Displaced commands に送られます) | Override |
| 🔴Conflict | 競合状態になっています。 次の 2 つのパターンがあります: (1) このコマンドにホットキーが割り当てられているが、同時に別のコマンドにも同じホットキーが割り当てられている場合。 (2) このコマンドにはホットキーが割り当てられていないものの、推奨ホットキーが別の複数のコマンドに割り当てられている場合。 Override ボタンで推奨ホットキーを割り当てると、ホットキーが 1 つも残らなくなったコマンドは Displaced commands に送られます。 | (1) Open → または (2) Override |
| — | 推奨ホットキーがなく、コマンドにホットキーが割り当てられていない場合は「—」と表示されます。 | Open → |
Individual ボタン一覧
ホットキーの割り当て状況に応じて、割り当ての実行または状況確認を行うための次の 3 種類のボタンが表示されます。
| Individual ボタン | 説明 |
|---|---|
| Set | 推奨ホットキーが空いている状態です。 Set ボタンを押すと推奨ホットキーが割り当てられます。 |
| Override | 現在、推奨ホットキーは別のコマンドに割り当てられています。使用中のコマンド名がインラインで表示されます。 Override ボタンを押すと、使用中のコマンドから推奨ホットキーを外して、このコマンドに割り当てます。 ホットキーが 1 つも残らなくなったコマンドは Displaced commands に送られます。(🟡Used は必ずこれにあたります) |
| Open → | コマンド名で絞り込んだ状態で Obsidian 標準のホットキー設定画面に遷移します。 |
Displaced commands (退避されたコマンド)
推奨ホットキーの適用によって、割り当てられていた唯一のホットキーを失ったコマンドの一覧です。各項目には Obsidian 標準のホットキー設定画面から再割り当てするための Assign ボタンと、推奨ホットキーの割り当てを取り消して元のコマンドにキーを戻す Restore ボタンがあります。
| 項目 | 説明 |
|---|---|
| Command | 推奨ホットキーの適用によりホットキーを失ったコマンドの名前です。クリックするとコマンド名で絞り込んだ Obsidian 標準のホットキー設定画面が開きます。 |
| Assign ボタン | 上と同じくホットキー設定画面を開きます。新しいホットキーを割り当て直すために使います。 |
| Hotkey | 推奨ホットキーの適用により失われたホットキーです。クリックするとキーで絞り込んだ Obsidian 標準のホットキー設定画面が開きます。 |
| Displaced by | Command 欄のコマンドが「Displaced commands」に送られた理由となった、このプラグインのコマンド名です。クリックするとコマンド名で絞り込んだ Obsidian 標準のホットキー設定画面が開きます。 元々「Command のコマンド → Hotkey キー」だったところを、 「Displaced by のコマンド → Hotkey キー」 「Command のコマンド → 割り当て解除」 のように Displaced by のコマンドが Hotkey を奪い取った格好です。 |
| Restore ボタン | 現状「Displaced by のコマンド → Hotkey キー」ですが、これを 「Command のコマンド → Hotkey キー」 「Displaced by のコマンド → 割り当て解除」 として、Hotkey が奪われる前の元の状態に戻します。 |
この Restore ボタンにより、Apply recommended による一括割り当ての後でも比較的安全に元のホットキー状態を復元できます。
Assign ボタンや Restore ボタン、あるいは標準のホットキー設定画面によって Command 欄のコマンドにホットキーが割り当てられると、この表からは消えます。「なにかしらのホットキーによって当該コマンドが起動できるならば問題ない」という考え方によるもので、「ホットキーを割り当てて表から消すべき」という意味ではありません。 マウス操作で実行可能であったり、利用頻度が低ければコマンドパレットからの実行で十分であるものについては Displaced commands に残ったままにしておいても良いでしょう。
Key upgrades (キーのアップグレード)
Apply all ボタン
これより下にあるすべての設定トグルを ON にします。(Upgrade navigation basics × 8 つ、Upgrade word commands × 4 つ、Behavior options × 6 つ)
ただし、競合可能性があるもの (🔴Used ステータス) はスキップされます。
Upgrade navigation basics (基本操作のアップグレード)
各キー設定は単純な ON / OFF トグルです。各キー設定の挙動変化の詳細は キーのアップグレード (基本操作のアップグレード) を参照してください。
ON にするとそのキーが対象コマンドのホットキーに追加されます。すでに対象コマンドにホットキーが割り当てられている場合は、それらはそのままに、このキーが追加登録されます。
OFF にするとそのキーの割り当てだけが削除されます。他のホットキー割り当ては変化しません。
各設定行の見方
| ステータス | トグル | 意味 |
|---|---|---|
| (表示なし) | OFF | キーは標準挙動そのままで変更されていません。アップグレード挙動が割り当て可能な状態です。 |
| (表示なし) | ON | キーがこのプラグインのアップグレード挙動に割り当てられています。 |
| 🔴Used | OFF (disable) | このキーはすでに別のコマンドで使用されています。このため、このコマンドを追加で割り当てることができません。(ON にすることはできません) キーチップあるいはステータスをクリックすると Obsidian のホットキー設定画面に遷移するので、そこで割り当て中のコマンドを確認してください。 |
| 🔴Conflict | ON | このキーにはアップグレードコマンドとそれ以外のコマンドの両方が割り当てられていて、現状すでに競合状態です。 キーチップあるいはステータスをクリックしてホットキー設定画面に移動し、競合状態を整理してください。なおトグルスイッチを OFF にすると 🔴Used ステータスに変化し、そのままでは ON にできません。 |
Upgrade word commands (単語操作のアップグレード)
各キー設定は単純な ON / OFF トグルです。各キー設定の挙動変化の詳細は キーのアップグレード (単語操作のアップグレード) を参照してください。
各設定行の見方
Behavior options (挙動オプション)
各種挙動を調整するトグルボタンです。
同じ名称の設定項目は「For everyone」「Vim mode」「macOS (Emacs) style」で連動していて、一方で ON (または OFF) にすると他方でも連動して ON (または OFF) になります。
| 設定 | デフォルト | 説明 |
|---|---|---|
| Smart home (standard) | ON | ON: Home キーが先頭の Markdown 記法 (リスト、番号付きリスト、チェックボックス、インデント、引用) の手前、本文テキストの先頭に移動します。Windows の Home / macOS の command + ← と同様の挙動です。OFF: Home キーは Markdown 記法を考慮せず、行の先頭に直接移動します。macOS / Emacs の Ctrl + A と同様の挙動です。 |
| Smart home (advanced) | ON | ON: Smart home (standard) の挙動に加えて、見出し (#)、脚注 ([^1]:)、コールアウトの種類マーカー ([!type]) も追加で考慮します。Smart home (standard) が ON の場合のみ ON にできます。OFF: 見出し行・脚注・コールアウトを考慮しません。(素の Home と同等に論理行頭に移動します) |
| Visual line movement | ON | ON: 折り返しのある長い行で Home / End を押した際、1 段階目は表示行の先頭 / 末尾に移動します。OFF: 折り返し行であっても Home / End は表示行を考慮しません。Home は行の先頭 (Smart home 設定により、論理行の先頭または本文テキストの先頭)、End は論理行の末尾に移動します。 |
| Cross-row navigation | ON | テーブル内での Home / End の挙動を調整します。ON: 左端セルの先頭で Home を押すと、上の行の右端セル末尾に移動します。同様に、右端セル末尾で End を押すと下の行の左端セル先頭に移動します。行がない場合にはテーブルの外に脱出します。 (← / → の挙動相当です) OFF: Home / End でテーブル行移動せず、左端セル先頭または右端セル末尾で停止します。 |
| Double-click word select | ON | マウスのダブルクリックによる単語選択の挙動を調整します。 ON: 辞書ベース単語分割により、マウスダブルクリック時に日本語の単語単位で範囲選択します。 ダブルクリック後にドラッグすると、単語単位で選択範囲が拡張します。 OFF: Obsidian 標準のダブルクリック挙動です。日本語は漢字ひらがなを区別せずひとまとまりで選択されます。 |
| Table-aware Source Mode editing | ON | ON: ソースモードのテーブル内で、HOME / END、Kill line、Kill region / Copy region、Yank、Delete char、Transpose chars、Uppercase / Lowercase / Capitalize word、Kill word left / right、Select all の各コマンドがテーブル構造 (| / <br>) を考慮して動作します。OFF: テーブル行を単純なテキストとして扱い、これらのコマンドはテーブル構造を一切考慮しません。 |