メジャーモードの選択
- 拡張子から判定　→　auto-mode-alist
- shebangから判定　→　interpreter-mode-alist
  - 優先順位　→　interpreter-mode-alist ＞ auto-mode-alist
設定ファイルの読み込み先　→　load-path変数
- (add-to-list 'load-path "/foo/bar")
設定ファイルの読み込み　→　(load "ファイル名") / .elは不要

カスタムファイルの切り出し

Emacs が自動で init.el に編集する内容を別ファイルに書き出すよう指示する

;; カスタムファイルを別ファイルにする
(setq custom-file (locate-user-emacs-file "custom.el"))
;; (カスタムファイルが存在しない場合は作成する
(unless (file-exists-p custom-file)
 (write-region "" nil custom-file))
;; カスタムファイルを読み込む
(load custom-file)

キーマップ関連

キー入力指定　→　(kbd "C-m")
キーバインドの置換　→　(define-key key-translation-map (kbd "C-h") (kbd "<DEL>"))
キーバインドの指定　→　(define-key global-map (kbd "C-x ?") 'help-command)
- global-set-key　→　(define-key global-map ...) の糖衣関数

環境変数

確認　→　(getenv "HOME")
全変数の確認　→　process-environment 変数に格納されている

init.el変更したので再起動、を楽に

zenwerk

タブ

Emacs27.1 からデフォルトで設定可能な `tab-bar-mode`

tab-bar-modeをいじるとglobal-mode-lineになる (from emacs 28)

centaur-tabs

https://github.com/ema2159/centaur-tabs

awesome-tab

バッファの並び順をよしなに変えてくれる

zenwerk

leaf.el 関連

README

入門記事

https://qiita.com/conao3/items/347d7e472afd0c58fbd7

とりあえずパッケージを試す

**scratch**バッファでおもむろに以下を Eval

(leaf magit :ensure t :require t)

あとは M-x でコマンドを試すなりする。

use-package の設定流用

ネット上の大抵のEmacsのパッケージ管理＆設定は use-package で書かれているので
以下の手順で流用する

(leaf use-package :ensure t :require t) で use-package をインストール
*scratch*バッファに試したい use-package の設定をコピペする
範囲選択して M-x leaf-convert-region-replace を実行して leaf の形式に変換
変換された設定を C-j なり C-x C-e で実行しインストール
あとは試すだけ。

`leaf` 以外の設定を `leaf`化

以下のように prog1 にパッケージ名を指定して leaf-convert-region-replace

(prog1 'package-foo
  (...)
  (...))

leaf の設定確認（とデバッグ）

zenwerk

Evil の設定

Evil の概要を掴むうえで現在も有効な記事

あとで読む
https://wikemacs.org/wiki/Evil
https://github.com/noctuid/evil-guide

Evil の設定記録
- https://qiita.com/toyboot4e/items/71a1b40486e67c431197
  - https://github.com/toyboot4e/evil-emacs-2020/blob/main/docs/guide.adoc

キーバインドの設定

キーマップ

すべてのバッファで有効　→　global-map
特定のバッファで有効　→　current-local-map
特定の{メジャー, マイナー}モードで有効　→　〇〇-mode-map

キーバインドの検索順

マイナーモード（〇〇-mode-map）
　　↓
バッファローカルマップ（current-local-map)
　　↓
メジャーモードマップ（〇〇-mode-map）
　　↓
グローバルマップ（global-map）
　　↓
未割り当て（エラー）

より詳細なキーマップ検索

https://ayatakesi.github.io/emacs/24.5/elisp_html/Searching-Keymaps.html

overriding-terminal-local-map
　　　↓
overriding-local-map
　　　↓
以下のいずれかのキーマップにキー定義が存在していれば、それを使う

カーソル位置の文字のkeymapプロパティ
emulation-mode-map-alists中のアクティブなmode-map（Evilの設定はここ）
minor-mode-overriding-map-alist中のアクティブなmode-map
minor-mode-map-alist中のアクティブなmode-map （通常のモードマップ設定はたぶんここ）
カーソル位置の文字のlocal-mapプロパティ
　　　↓
current-global-map

特定ステートでのキーバインドの設定

; 特定ステートのキーバインドを設定
(define-key evil-motion-state-map (kbd ";") #'evil-ex)
; キーバインドを削除
(define-key evil-insert-state-map (kbd "C-y") nil)
; 特定ステートのキーバインドを全削除
(setq evil-insert-state-map nil)

特定モードマップと特定ステートで有効なキーバインドの設定

; 'state(motion)をnilに設定すると全ステートで有効になる
(evil-define-key 'motion foo-mode-map
  (kbd "v") #'(lambda () (interactive) (view-mode 0)))

ステートの種類

ノーマルステート　　　　→　normal (motionも使える)
挿入ステート　　　　　　→　insert
範囲選択ステート　　　　→　visual (motionも使える)
オペレータステート　　　→　operator
置換ステート　　　　　　→　replace
編集を伴わないステート　→　motion

↑のどれかを選んで evil-state-state-map に define-key する。

引用元: https://tarao.hatenablog.com/entry/20130304/evil_config

キーバインドの割り当て関連

キー入力指定　→　(kbd "C-m")
キーバインドの置換　→　(define-key key-translation-map (kbd "C-h") (kbd "<DEL>"))
キーバインドの指定　→　(define-key global-map (kbd "C-x ?") 'help-command)
- global-set-key　→　(define-key global-map ...) の糖衣関数

evil使用者にも便利なキーバインドパッケージ

define-key のようなキーバインド関連を統一的に行うパッケージ
- evilとのインテグレーションが組み込まれている

https://github.com/noctuid/general.el

設定例
- https://sam217pa.github.io/2016/09/23/keybindings-strategies-in-emacs/
- https://randomeffect.net/post/2020/07/22/general-to-hydra/
evil-leader のような vim の Leaderキーの操作の定義方法がより洗練されているようだ。
- 操作感をより vim っぽく近づけたければ使ってみるのもよさそう

evil のキーバインド関連

公式のキーバインドコレクション
- https://github.com/emacs-evil/evil-collection
markdown編集向け
- https://github.com/Somelauw/evil-markdown
vim の text-object の範囲選択をカスタマイズ
- https://github.com/Cj-bc/evil-textobj-parameter/blob/master/JA_README.org

zenwerk

Yet another lightweight evil なパッケージがある
https://github.com/meow-edit/meow

zenwerk

Emacsに一生入門できねえ2020の原因考察

Lisp の基本について知っている前提の説明だから
- リスト、コンスセルの構造、クオート、マクロをすでに知っている前提
  - いわゆる手続き型言語しか経験のない人には完全に門外漢な知識
- alist, plist などのデータ構造の説明がない
  - 何に対して設定しているのかよくわからなくなる
バッファ、モードの概念
- それに関連するキーマップの概念
  - これらがどう影響しあうのかをふんわり知っている前提の説明
Emacsが本質的にLisp処理系（インタプリタ）であることの説明
- load とか package.el とか、require とか、単なるエディタの設定としてみると大袈裟すぎる
- やっていることは python/ruby 書いてるのと変わらないので、プログラミング言語を一つ覚えるくらいの学習コストが発生する。
- プログラミング入門するためにエディタを選んだら、エディタのためにプログラミング言語を一つ追加で覚える羽目になったの巻
  - ミニマルPerl のような、必要最低限なサブセット言語環境を用意しないと、学習コストがでかすぎる。

zenwerk

装飾

カラーテーマを試す

*scratch*バッファで以下のように試す

(leaf テーマ名 :ensure t :require t)
(load-theme 'テーマ名)

気に入らなかったときなどにデフォルトテーマに戻す

(disable-theme 'テーマ名)

VSCode デフォルトに似せたテーマ

ターミナルでも視認性の良いテーマ

モノクロ

https://github.com/cryon/almost-mono-themes

SVGを使った図形描画

https://github.com/rougier/svg-tag-mode

インデントレベルの図示

zenwerk

Hydra 関連

Emacsの「発見性」パッケージの一つ

https://wikemacs.org/wiki/Discoverability

~~そもそも evil と相性が良いか検討が必要。~~ / 適切な state のmode-map に hydra-foo/body を指定すれば問題なし。

入門

https://snap.wegh.net/tags/hydra/

設定
公式リポジトリのWikiに設定例が多くあるので、流用すれば楽になる

https://github.com/abo-abo/hydra/wiki/Hydras-by-Topic

Hydra 拡張

hint-doc を簡単にきれいに
- https://github.com/jerrypnz/major-mode-hydra.el#pretty-hydra
  - http://mugijiru.seesaa.net/article/475248601.html
which-key と Hydra の統合
- https://gitlab.com/jjzmajic/hercules.el

hydra が現れる前は smartrep という拡張が良く使われていたらしい。

https://github.com/myuhe/smartrep.el

zenwerk

開発関連機能

Xref

https://ayatakesi.github.io/emacs/25.1/Xref.html#Xref

プログラミング言語の識別子を検索したりするための「インターフェイス」
具体的にどのように動作するかは、各言語のメジャーモードの実装による。
LSPとの連携操作もxrefの関数呼び出しから使える。

imenu

TODO

https://github.com/rnkn/side-hustle
- imenu-list代替

ido

TODO

LSP

複数のLSPクライアントパッケージがある

https://github.com/zbelial/lspce

LSP関連のパッケージの動作速度を上げるらしい

https://github.com/blahgeek/emacs-lsp-booster

zenwerk

 ミニバッファ補完
 Selectrum（Ivyよりシンプルだが拡張性ありとのこと）https://github.com/raxod502/selectrum
https://scrapbox.io/tsuu32/君はselectrumとEmacsる？

 Selectrum と連携するパッケージ
 候補の並べ替え、絞り込み（同じ作者）https://github.com/raxod502/prescient.el

 Consult（検索、補完系の拡張（Swiper相当）https://github.com/minad/consult/blob/main/README.org

 orderlessconsult-line を探したいとき line consl や con lin のような曖昧な入力でも候補に上がるようにする completion-style

https://github.com/oantolin/orderless

 VerticoSelectrum よりさらにシンプル・ミニマルな実装とのこと
https://github.com/minad/vertico
https://scrapbox.io/tsuu32/Ivy_でも_Selectrum_でもなく_Vertico

 装飾系mode-line をエコーエリアに収める

https://github.com/liuyinz/mini-echo.el