From e1a97b5fe61f7b239eb45bd037aa3800b0f241de Mon Sep 17 00:00:00 2001 From: azishio Date: Wed, 8 May 2024 21:57:34 +0900 Subject: [PATCH] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20=E3=83=AA=E3=83=B3?= =?UTF-8?q?=E3=82=AF=E3=81=AE=E3=82=BF=E3=82=A4=E3=83=9D=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 98 ++++++++++++++++++++++++++++++++++++------------------- 1 file changed, 64 insertions(+), 34 deletions(-) diff --git a/README.md b/README.md index 406bdb1..3b78e89 100644 --- a/README.md +++ b/README.md @@ -1,43 +1,49 @@ -日本語 | [English](README_en.md) +日本語 | [English](README.en.md) # Mozc Keymap Editor -　Mozcのキーマップ設定ファイルを楽に編集するためのツールです。 + +Mozcのキーマップ設定ファイルを楽に編集するためのツールです。 新規設定ファイルの作成だけでなく、既存の設定ファイルを読み込んで編集したり、複数の設定ファイルを統合することもできます。 ![Mozc Keymap Editor](https://github.com/azishio/mozc_keymap_editor/assets/127939746/6ca19970-a16e-47e1-9c88-6506810956ae) ## 使用方法 -　GitHub Pagesに公開しているので、以下のURLから使用できます。 + +GitHub Pagesに公開しているので、以下のURLから使用できます。 https://azishio.github.io/mozc_keymap_editor/ ## できること + + GUIを使用したキーマップの編集 - + キーとコマンドを、複数のモードに対して一括で設定できます。 + + キーとコマンドを、複数のモードに対して一括で設定できます。 + 複数の設定ファイルの統合 - + 「統合」ボタンからファイルを選択することで、設定ファイルを統合できます。 - + すでに同一の入力キーとコマンドのペアが存在する場合、その行のモードを追加します。 - + 入力キーとコマンドのペアが存在しない場合、新しい行を追加します。 + + 「統合」ボタンからファイルを選択することで、設定ファイルを統合できます。 + + すでに同一の入力キーとコマンドのペアが存在する場合、その行のモードを追加します。 + + 入力キーとコマンドのペアが存在しない場合、新しい行を追加します。 + 設定の並べ替え - + ドラッグアンドドロップで設定を並べ替えられます。 + + ドラッグアンドドロップで設定を並べ替えられます。 + 競合する設定の警告 - + モードと入力キーが重複する設定がある場合、警告を表示します。 + + モードと入力キーが重複する設定がある場合、警告を表示します。 + 設定ファイルのダウンロード - + 「ダウンロード」ボタンから、編集した設定ファイルをダウンロードできます。 - + クリップボードにコピーすることもできます。 + + 「ダウンロード」ボタンから、編集した設定ファイルをダウンロードできます。 + + クリップボードにコピーすることもできます。 ## できないこと + + 入力キーの正常性のチェック - + キー名の正しさは検証されません。 - + 例えば、読み込んだ設定ファイルのキー名が「Hoge」であった場合、UI上でも「Hoge」として表示され、警告は表示されません。 - + Mozcが対応しているかを問わず、任意のキーを設定できます。 - + キーがMozcに対応しているのかは、ユーザーが確認する必要があります。 - + Mozcが対応していないキーの設定を行った場合でも、警告は表示されません。 + + キー名の正しさは検証されません。 + + 例えば、読み込んだ設定ファイルのキー名が「Hoge」であった場合、UI上でも「Hoge」として表示され、警告は表示されません。 + + Mozcが対応しているかを問わず、任意のキーを設定できます。 + + キーがMozcに対応しているのかは、ユーザーが確認する必要があります。 + + Mozcが対応していないキーの設定を行った場合でも、警告は表示されません。 ## 入力キーについて -　入力キーは[キーボードイベントのkeyの値](https://developer.mozilla.org/ja/docs/Web/API/UI_Events/Keyboard_event_key_values)を読み取って取得しています。 + +入力キーは[キーボードイベントのkeyの値](https://developer.mozilla.org/ja/docs/Web/API/UI_Events/Keyboard_event_key_values) +を読み取って取得しています。 Mozcの設定ファイルで使用されるキー名とは一部異なるため、そのままでは正常に動作しません。 -　以下は開発者が認識しているキー名の対応表です。この表にないキー名は、プログラム上で自動的に置き換わりません。 +以下は開発者が認識しているキー名の対応表です。この表にないキー名は、プログラム上で自動的に置き換わりません。 このプログラムで対応していないキー名に気づいた方は、Issueを立てていただけると助かります。 | キーボードイベントのkeyの値 | Mozcのキー名 | @@ -50,50 +56,74 @@ Mozcの設定ファイルで使用されるキー名とは一部異なるため | ` ` (スペース) | `Space` | | `[A-Z]` (アルファベット) | `[a-z]` | -　また、本プログラムでコンビネーションキーとして表示するキーは`meta`,`ctrl`, `alt`, `shift`のみです。それ以外のキーは、そのままのキー名で表示されます。 +また、本プログラムでコンビネーションキーとして表示するキーは`meta`,`ctrl`, `alt`, `shift`のみです。それ以外のキーは、そのままのキー名で表示されます。 Mozcがそれ以外のコンビネーションキーに対応していることをご存知の方はIssueでお知らせください。 ## UI詳説 ### 編集タブ -　キーマップテーブル上のUIからキーマップの編集を行います。 + +キーマップテーブル上のUIからキーマップの編集を行います。 #### 「\#」 -　行番号です。他の行の設定と競合している(モードと入力キーが同一である)場合、警告が表示されます。 + +行番号です。他の行の設定と競合している(モードと入力キーが同一である)場合、警告が表示されます。 + #### モード -　この設定が適用されるモードを指定します。 + +この設定が適用されるモードを指定します。 複数のモードを指定できます。 + #### 入力キー -　キーボードからの入力を受け付けるキーを指定します。 + +キーボードからの入力を受け付けるキーを指定します。 このキーが押されたときに、コマンドが実行されます。 -　すでにブラウザやIMEなどがコンビネーションキーと通常キーの組み合わせを予約している場合、そのキーを一度に入力することができません。 +すでにブラウザやIMEなどがコンビネーションキーと通常キーの組み合わせを予約している場合、そのキーを一度に入力することができません。 その場合、「コンビネーションキーを保持」スイッチをオンにしてください。このスイッチをオンにすると、コンビネーションキーの入力を保持します。 これによって、コンビネーションキーと通常キーを個別に入力できます。 + #### コマンド -　入力キーが押されたときに実行されるコマンドを指定します。 + +入力キーが押されたときに実行されるコマンドを指定します。 コマンドは各カテゴリーごとにまとめられています。 + #### 「-」ボタン -　この行を削除します。 + +この行を削除します。 + #### 「+」ボタン -　新しい行を追加します。 + +新しい行を追加します。 ### 出力タブ -　編集タブで編集したキーマップの設定から生成した設定ファイルの内容を表示します。 + +編集タブで編集したキーマップの設定から生成した設定ファイルの内容を表示します。 ここから設定を書き換えることはできません。 ### ボタン類 + #### 新規 -　設定ファイルをローカルから読み込み、その内容を表示します。すでにキーマップテーブルに設定が存在する場合、それらは削除されます。 + +設定ファイルをローカルから読み込み、その内容を表示します。すでにキーマップテーブルに設定が存在する場合、それらは削除されます。 + #### 追加 -　設定ファイルをローカルから読み込み、その内容をキーマップテーブルに追加します。 + +設定ファイルをローカルから読み込み、その内容をキーマップテーブルに追加します。 入力キーとコマンドが同一で、モードが異なる設定が存在する場合、それらは統合されます。 + #### すべて削除 -　キーマップテーブルの内容をすべて削除します。 + +キーマップテーブルの内容をすべて削除します。 + #### クリップボードにコピー -　出力タブの内容をクリップボードにコピーします。 + +出力タブの内容をクリップボードにコピーします。 + #### ダウンロード -　出力タブの内容をファイル（`keymap.txt`）としてダウンロードします。 + +出力タブの内容をファイル（`keymap.txt`）としてダウンロードします。 ## ライセンス -　このプログラムはMITライセンスのもとで公開されています。 + +このプログラムはMITライセンスのもとで公開されています。