トラブルシューティング

この章の使い方

機能ではなく「症状」から引いてください。

Erya の反応はほぼすべて最終行に出ます。うまくいかないときにまずすべきことは、その行を最後まで読むことです。たいてい原因が書いてあり、押すべきキーまで書いてあることも少なくありません。

1. 最終行を読む。黄は報告、白は入力待ち、赤は判断待ちです（1.3.6 参照）。
2. 2 行目を読む。いま使えるキーが並んでいます。見慣れないキーなら、別の画面にいるか別のプロファイルです。
3. Esc を押す。どこにいるか分からないとき、必ず 1 階層戻り、何も壊しません。
4. F1 を押す。機能のキーを探すなら、この一覧が目次です。

起動できない

Erya の画面が出る前の問題です。

ファイルが開けない

あるいは、思っていたのと違う形で開く場合です。

保存できない

失敗の代償がいちばん大きい場面なので、Erya は厳しめです。

キーが効かない

可能性は 4 つ。ありがちな順に。

1. その操作に既定のキーがない。定型文、マクロ、矩形の埋め・移動、段落の再整形、「カーソル位置の表示」は既定プロファイルで未割り当てです（2.4.8、2.2.6）。F1 でキー欄が空欄かどうか見てください。
2. 編集画面にいない。画面ごとに使えるキーが違います。2 行目を確認してください（1.3.3）。
3. そのモードで禁止されている。大容量ファイル読み取り専用は編集系を止め（3.2.2）、テキストファイルの 16 進数表示は読み取り専用です（3.3.1）。メッセージ行に理由が出ます。
4. ターミナルが送っていない。Alt 組み合わせと修飾付き矢印でよく起きます（4.1.1）。押せるキーに割り当て直してください（4.1.4）。

画面の表示がおかしい

たいていは Erya ではなくターミナル側の問題です。

文字化けする

まず「文字コード違い」か「フォントに字が無い」かを切り分けます。

機能が丸ごと見当たらない

メニューが無いので、「見つからない」はたいてい「未割り当て」か「ここでは非対応」です。

それでも解決しないとき

報告に次の情報を添えると、解決がぐっと早くなります。

1. バージョン：erya --version の出力。
2. 環境：OS とバージョン、uname -m のアーキテクチャ、使っているターミナル。
3. キープロファイル：F2 に出ている名前、または自分の keymap.toml。
4. メッセージ行の文言：一字一句そのまま。いちばん有力な手がかりです。
5. 再現手順：erya ファイル名 から、押したキーを順に。
6. ファイルの特徴：サイズ、文字コード、改行コード。すべてステータス行に出ています。