Charu3 SE Wiki (日本語)
Charu3 SEはWindows用のテキスト入力支援ツールです。キー操作で呼び出すことができ、あらかじめ定義されツリー構造に登録された定型文を選択して貼り付けることができます。その他にもいくつかの機能があります。
Microsoft Windows Vista 以降
ビルド済みのバイナリーリリースは https://github.com/itagagaki/charu3-SE/releases にあります。
zipファイルをお好きな場所に展開してください。インストーラーはありません。システムのリポジトリは使用しません。
展開した場所の Charu3.exe を実行してください。
※旧バージョン（3.8.0 から 3.8.2 まで）には設定の初期化の不具合があり、誤った設定となってしまっている可能性があります。 これらのバージョンを実行したことのある方は、一度下記の手順で設定をリセットしてください。 ご不便おかけし申し訳ありません。
デフォルトの設定にリセットするには、Shiftキーを押したまま Charu3 を起動し、表示されるダイアログで [はい] を選択してください。
初めて起動すると、データファイルを作るか既存のデータファイルを読み込むことを求めるダイアログが出ます。 お好きなフォルダにご自分のデータファイルを作成してください。 Charu3 SE のデータファイルの形式は Charu3 と同じでまったく変えていないので、Charu3 のデータをお持ちの方はそれを指定することもできます。
データファイルが正常に設定できたら、次回の起動からはダイアログは出ません。 データファイルはメニューで切り替えることができます。
メニューを開くには通知領域アイコン
を右クリックしてください。
ユーザーは、自分がよく入力する定型テキストをデータとして登録しておくことができます。
このデータは木構造のリストの形になっていて、「データツリービュー」ウィンドウで選択したり編集することができます。
データツリービューウィンドウは任意のホットキーでポップアップ表示させることができます。
（または、初期設定では通知領域アイコン左クリックで開くことができます）。
どのホットキーでポップアップさせるかは [設定] メニューの [全般] タブで設定することができます。
初期設定では Alt+X となっています。
データツリービューで左クリックするとコンテキストメニューが表示されます。[新規作成] で新しいデータやフォルダを追加することができます。
データツリービューで項目を選んでEneterをタイプするか項目をダブルクリックすると、その項目のデータ（テキスト）が現在アクティブなウィンドウにペーストされます。
これは、テキストを一旦システムのクリップボードにセットして、貼り付けのためのキー（典型的には Ctrl+V）を Charu3 SE が自動でタイプするという仕組みで実現されています。
アプリによっては、貼り付けのために Ctrl+V とは異なるキーを使うものもあるでしょう。（たとえば Emacs なら Ctrl+Y ですね）。
そのため、アクティブなウィンドウのキャプション（タイトル）別にコピーや貼り付けのキーをコンフィグレーションすることもできます。
[設定] メニューの [キーイベント設定] タブの [特定のウィンドウでの設定] に設定を追加してください。
データツリービューウィンドウは以下の場合に閉じます。
- 項目を確定したとき
-
ESCキーを押したとき - 他のウィンドウにフォーカスが移動するなどして、データツリービューウィンドウがフォーカスを失ったとき
- クリックでの項目の選択や名前変更、フォルダの展開／折りたたみ、ドラッグ＆ドロップでの項目の移動、ホイールでの選択の移動など、一般的な操作を行えます。
- 右クリックでメニューが表示されます。
- データ項目をダブルクリックすると、データをクリップボードに入れ、ペーストしてウィンドウを閉じます。
-
Shiftキーを押しながらデータ項目をダブルクリックすると、データをクリップボードに入れ、ペーストせずにウィンドウを閉じます。
| キー | 機能 |
|---|---|
ESC |
ウィンドウを閉じる |
Alt |
メニュー |
Enter |
(選択項目がデータなら)データをクリップボードに入れ、ペーストしてウィンドウを閉じる; (選択項目がフォルダなら)展開; (項目の名前の入力中なら)入力完了 |
Shift+Enter
|
(選択項目がデータなら)データをクリップボードに入れ、ペーストせずにウィンドウを閉じる; それ以外は Enter と同じ |
↑ または Shift+Space
|
前の項目に移動 |
↓ または Space
|
次の項目に移動 |
Shift+↑
|
前のフォルダ(無ければ前の項目)に移動 |
Shift+↓
|
次のフォルダ(無ければ次の項目)に移動 |
→ |
(選択項目が折りたたまれたフォルダなら)展開; (選択項目が展開されているフォルダなら)子項目に移動 |
← |
選択項目が展開されているフォルダなら折りたたみ、それ以外の場合は親項目に移動(もしあれば) |
Shift+←
|
選択項目のすべての祖先を折りたたむ |
Ctrl+Shift+←
|
すべて折りたたむ |
Home End PgUp PgDn
|
移動 |
Delete |
選択項目を削除 |
Tab または Ctrl+Space
|
複数項目を選択 |
Ctrl+F
|
検索ダイアログを開く |
F1 |
マウスポインターを選択項目に合わせる -- ツールチップを表示させるのに便利です |
F2 |
選択項目の名前の変更 |
F3 |
次を検索 |
Shift+F3
|
前を検索 |
データには「恒久データ」と「ワンタイムデータ」の2種類があります。
ワンタイムデータは、データツリーから読み出してペーストされたら自動的にデータツリーから削除されるデータです。 ストックモードでデータツリーに自動的に追加されるデータはワンタイムデータとなります。
データツリービューでワンタイムデータ項目のアイコンをクリックすると恒久データに変わります。
フォルダーには「通常フォルダー」と「履歴フォルダー」の2種類があります。
データツリービューのメニューで [新規作成] → [フォルダー] を実行すると、通常フォルダーが作成されます。 フォルダーを選択してメニューで [編集] を実行すると、編集ダイアログで通常フォルダーとするか履歴フォルダーとするか切り替えることができます。
履歴フォルダーには、クリップボードにコピーされたテキストが自動的に蓄積されます。
デフォルトでは最近コピーされた2個までが蓄積され、それ以前の履歴は自動的に削除されます。
この個数はフォルダーごとのオプショナルプロパティ Count=<個数> で設定できます。
ストックモードは、クリップボードにコピーされたテキストをCharu3のデータツリーにワンタイムデータとして自動的に追加していき、ペースト操作が行われたときにはそこから順番に1つずつ取り出してペーストを行う機能です。
どういう順番で取り出すかは、[設定] メニューの [ストックモード] タブで、先に入れたものから順に取り出す「先入れ先出し（FIFO: First-In First-Out）」か、最後に入れたものから逆順に取り出す「先入れ後出し（LIFO: Last-In First-Out）」かを選択することができます。
(要記述)
(要記述)
旧Charu3のプラグインはそのまま使えます。実行する Charu3.exe のあるフォルダーにサブフォルダー rw_plugin を作成し、その中にCharu3プラグインを置いておけば自動的に認識されます。
ただし、Charu3プラグインのサンプルソースコードにはバグがあり、過去のプラグインにもバグが残っている可能性があるため、完全に安全に使用できるとは考えていません。 また、将来的にはプラグインのインターフェイスを変更することも検討しています。
データツリービューのメニューまたはCtrl+Fでデータの検索を開始できます。
この通常の検索のほかに、「項目の名前をタイピングすることで選択」する機能があります。
データツリービューでたとえばpをタイプすると「p」で始まる名前の項目に移動します。
次にすかさずiをタイプすると「pi」で始まる名前の項目に移動します。
このように時間を置かずに項目の名前をタイピングすることでその項目に移動することができます。
この機能は [設定] メニューの [データツリー] タブで調整することができます。
(要記述)
[設定] → [スタイル] の「アイコンセットファイル」に指定できるのは、18×18ピクセルのアイコンを横に22個並べた、高さ18ピクセル、幅396ピクセルのBMP画像ファイルです。 アイコンは左から順に以下のデータまたはフォルダーを表します。
- 通常フォルダー（閉じている）
- 通常フォルダー（開いている）
- 履歴フォルダー（閉じている）
- 履歴フォルダー（開いている）
- ワンタイムデータ（閉じている）
- ワンタイムデータ（開いている）
- 一般データ（閉じている）
- 一般データ（開いている）
- 日付や時間を含むデータ（閉じている）
- 日付や時間を含むデータ（開いている）
- アプリを実行するデータ（閉じている）
- アプリを実行するデータ（開いている）
- ファイルを既定のプログラムで開くデータ（閉じている）
- ファイルを既定のプログラムで開くデータ（開いている）
- 選択中のテキストを含むデータ（閉じている）
- 選択中のテキストを含むデータ（開いている）
- クリップボードのテキストを含むデータ（閉じている）
- クリップボードのテキストを含むデータ（開いている）
- プラグイン実行を含むデータ（閉じている）
- プラグイン実行を含むデータ（開いている）
- キー入力を行うデータ（閉じている）
- キー入力を行うデータ（開いている）
緑色（#00FF00）のピクセルは透明として扱われます。
通常では、ユーザー設定保存ファイル settings.json と状態保存ファイル state.json の場所は %AppData%\Charu3 フォルダーです。
Windows 10では %AppData% は一般的には C:\Users\(user name)\AppData\Roaming です。
通常 AppData は隠しフォルダになっていますので、エクスプローラーで表示するにはエクスプローラーの「表示」タブで隠しファイルを表示する選択をしてください。
実行する Charu3.exe のフォルダーに、FORCE_INTO_PORTABLE_MODE という名前の通常ファイル（内容は空でも何でもかまいません）を置いて
Charu3 を実行するとポータブルモードとなり、ユーザー設定保存ファイルおよび状態保存ファイルの場所は %AppData%\Charu3 フォルダではなく
Charu3.exe のあるフォルダとなります。
Windows ロゴ キー + R キーを押し、 shell:startup と入力して [OK] を選択します。これにより、[スタートアップ] フォルダーが開きます。
そこに Charu3.exe のショートカットを貼り付けてください。
Ctrl+Tab キーでタブを入力することができます。
ダイアログのボーダーをドラッグしてデータ編集欄を拡大することができます。
コピーとペーストでの待ち時間を設定する項目があります。これらの値を小さくするほどペースト処理が速くなり快適になります。しかし短すぎるとペーストが正常に行われなくなる可能性があります。初期値は50ミリ秒になっていますが、これはオリジナルのCharu3でのデフォルト値を踏襲しているに過ぎず、この時間があなたのシステムにおいて適切かどうかはわかりません。ペースト処理が正常に行われる範囲内で調整してみてください。
Emacsのウィンドウタイトルのデフォルト設定は (multiple-frames "%b" ("" invocation-name "@" system-name)) ですが、私はこれを次のように変更しています。
;; frame title
(setq frame-title-format '(multiple-frames ("%b - Emacs@" system-name) ("Emacs@" system-name)))
これでフレームが1つのときも複数のときもウィンドウキャプションに Emacs@ が確実に含まれることになります。
そして、Charu3の [設定] メニューの [キーイベント設定] タブの [特定のウィンドウでの設定] で、「ウィンドウの名前が Emacs@ を含む」ウィンドウに対するキー設定を追加すると、EmacsでもCharu3が使えるはずです。
貼り付けに使うキーは Ctrl+Y を設定すると良いでしょう。
（あなたがEmacsのキーバインドを変更しているなら別ですが）
コピーに使うキーに関しては、ちょっと考える必要があります。
まず思いつくのは Alt+W (kill-ring-save) ですが、このコマンドは選択範囲が存在しない場合（マークが設定されていない場合）にはエラーとなってしまいます。
そこで私はCharu3へのコピー用に独自の関数を作り、次のように Ctrl+Alt+X に割り当てています。
;; copy region for charu
(global-set-key (kbd "C-M-x") '(lambda ()
(interactive)
(if (use-region-p)
(let ((str (filter-buffer-substring (region-beginning) (region-end)))) (kill-new str))
(kill-new ""))))
これでEmacs対応は完璧です👍