リファレンス

https://www.emacsdocs.org/

https://ayatakesi.github.io/lispref/27.1/html/index.html
http://doc.endlessparentheses.com/

Emacsのビルドオプションの確認

emacs -nw -q --batch --eval '(message system-configuration-options)'
from: https://emacs.stackexchange.com/a/35512

macOS に Emacs を入れる場合

https://zenn.dev/armcore/articles/mac-program-emacs

init.el のリセット

以下の記事を参考に leaf.el ベースで一から設定を書き直す

• 以下の記事は Emacs そのものの入門も含まれる

https://emacs-jp.github.io/tips/emacs-in-2020

「leaf.el を使った設定方法」は以下の記事の方が詳しい

• leaf-* な関連コマンドの使い方が載っている

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

差分

https://github.com/zenwerk/.emacs.d/commit/789e00e8c1b72e6b25c666471ca6cc36fc0696e4

init.el 設定全般

https://emacs-jp.github.io/tips/debug-emacs-lisp

設定ファイル読み込み関連

• メジャーモードの選択

  • 拡張子から判定　→　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変更したので再起動、を楽に
https://github.com/iqbalansari/restart-emacs

タブ

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

https://qiita.com/toyboot4e/items/e2442690d1ace41b51a9

tab-bar-modeをいじるとglobal-mode-lineになる (from emacs 28)
http://ruzkuku.com/texts/emacs-global.html

centaur-tabs

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

awesome-tab

https://github.com/manateelazycat/awesome-tab

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

https://github.com/killdash9/buffer-flip.el

leaf.el 関連

README
https://github.com/conao3/leaf.el/blob/master/README.md

入門記事

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

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

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

(leaf magit :ensure t :require t)

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

use-package の設定流用

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

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

leaf 以外の設定を leaf化

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

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

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

https://www.grugrut.net/posts/201910141028/

Evil の設定

Evil の概要を掴むうえで現在も有効な記事
https://tarao.hatenablog.com/entry/20130304/evil_config

あとで読む
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

キーバインドの設定

キーマップ

1. すべてのバッファで有効　→　global-map
2. 特定のバッファで有効　→　current-local-map
3. 特定の{メジャー, マイナー}モードで有効　→　〇〇-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

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

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

装飾

カラーテーマを試す

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

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

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

(disable-theme 'テーマ名)

VSCode デフォルトに似せたテーマ
https://github.com/ianpan870102/vscode-dark-plus-emacs-theme

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

• https://github.com/osener/emacs-afternoon-theme
• https://github.com/bbatsov/zenburn-emacs
• https://github.com/ogdenwebb/emacs-kaolin-themes
  • `kaolin-blossom'

モノクロ

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

SVGを使った図形描画

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

インデントレベルの図示

https://github.com/DarthFennec/highlight-indent-guides

Hydra 関連

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

• https://wikemacs.org/wiki/Discoverability

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

入門

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

https://medium.com/@mopemope/hydra-のススメ-88a4168f945c

設定
公式リポジトリの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

開発関連機能

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

ミニバッファ補完

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

orderless

consult-line を探したいとき line consl や con lin のような曖昧な入力でも候補に上がるようにする completion-style
https://github.com/oantolin/orderless

Vertico

Selectrum よりさらにシンプル・ミニマルな実装とのこと

https://github.com/minad/vertico

• https://scrapbox.io/tsuu32/Ivy_でも_Selectrum_でもなく_Vertico

プロジェクト管理

https://github.com/bbatsov/projectile

• https://projectile.mx/
  • https://docs.projectile.mx/projectile/index.html
• Projectileから無視するファイルの指定方法
  • https://emacs.stackexchange.com/a/16499

他の選択肢

• https://emacs.stackexchange.com/questions/53452/how-to-open-a-folder-as-project-in-emacs

  • company-gtags
  • counsel-git-grep

• https://www.reddit.com/r/emacs/comments/689hok/what_do_you_use_for_project_management_in_emacs/

• https://www.reddit.com/r/emacs/comments/54fkqr/how_do_people_manage_projects_in_emacs/

https://github.com/alphapapa/activities.el

ファイラ

Dired を強化する

https://taipapamotohus.com/post/dired/

• Dired を開いたときに Hydra を hook する
  • https://www.reddit.com/r/emacs/comments/b7eb9r/question_about_hydra_with_dired_mode/ejriwc1/

Dired 強化パッケージ

https://github.com/alexluigit/dirvish

• カスタマイズ集
  https://github.com/Fuco1/dired-hacks

treemacs

• https://github.com/Alexander-Miller/treemacs
  • README に記載の use-package を leaf-convert すればまず動く
• Treemacs で all-the-icons
  • https://tsuu32.hatenablog.com/entry/2020/08/19/004306

org-mode

まだよくわかってない。

使い方

• 入門記事

  • https://www.mhatta.org/wp/2018/08/16/org-mode-101-1/

• org-fileをパース

  • https://www.grugrut.net/posts/202001100849/

• org-capture を使ってコードリーディング

  • https://ladicle.com/post/20200625_123915/

• orgファイルからプレゼンテーション生成

  • https://github.com/coldnew/org-ioslide

• org-mode とコードブロックで文芸的ドキュメンテーション

  • https://www.kpassa.me/posts/literate2/

• org-modeでSVG作図

  • https://github.com/misohena/el-easydraw

• Wiki

  • https://github.com/Kungsgeten/org-brain
  • https://github.com/org-roam/org-roam-server
    • https://github.com/NicolasPetton/nroam

• org-mode互換性（？）あるスマートフォンアプリ

  • Android
    • https://github.com/orgzly/orgzly-android

• org-mode の見た目をモダンな感じにする

  • https://github.com/minad/org-modern

• org-mode でブログ

  • https://github.com/novoid/lazyblorg

ナビゲーション

intelliJのCtrl-Tab的な動作を期待したい
https://github.com/manateelazycat/snails

Window / バッファ内表示系

https://www.reddit.com/r/emacs/comments/ka1r24/quickpeek_vs_posframe/

http://blog.jenkster.com/2013/12/popup-help-in-emacs-lisp.html

peeking ライブラリ

• https://github.com/auto-complete/popup-el
• https://github.com/cpitclaudel/quick-peek
  • https://github.com/jpablobr/scrollable-quick-peek
  • https://github.com/iqbalansari/emacs-source-peek

*foo*や自分で指定したバッファをテンポラリなWindowに統一して表示できるようにする

1. popwin
   • https://www.emacswiki.org/emacs/PopWin
   • 昔からあるやつで広く使われているらしい
2. shackle
   • https://depp.brause.cc/shackle/
   • popwin の後発でいろいろ整備されているとのこと
3. popper
   • https://github.com/karthink/popper
   • 指定したバッファのウィンドウの出したり消したりを楽に行えて便利

Window操作関連

• https://github.com/dimitri/switch-window

• 現在どの Window にフォーカルしているかを視認しやすく

  • https://github.com/gonewest818/dimmer.el

各種開発環境

全般

• ヒント表示
  • https://github.com/rileyrg/el-docstring-sap

C言語

• ctags

  • https://github.com/universal-ctags/citre

• CMakeベースのC/C++開発環境

  • https://github.com/atilaneves/cmake-ide

Scheme

https://gitlab.com/emacs-geiser/geiser

Standard ML

https://qiita.com/keita44_f4/items/b15c3af240914345d0d3

Elisp で HTMLテンプレート

https://bitspook.in/blog/using-elisp-as-an/

Emacs -nw (ターミナル表示)

ASCIIコードテーブル
https://bestasciitable.com/
もしくは man ascii

端末エミュレータ上のEmacsで24-bit colorを表示する（Emacs 27以降でも） - つーさにブログ

https://mako-note.com/ja/emacs-in-terminal/

tmux で True Color

1. まず以下の設定を試みる
   • https://github.com/syl20bnr/spacemacs/wiki/Terminal
2. ダメだったら以下の issue を読んで調べてみる
   • https://github.com/syl20bnr/spacemacs/issues/12257

その他ツール

Docker上にEmacsをホストしてブラウザからアクセス
https://github.com/karlicoss/cloudmacs

VSCode Live Share 的な機能
https://elpa.gnu.org/packages/crdt.html

ウェブブラウジング

xwidget内にwebkitでレンダリング
https://github.com/kchanqvq/xwwp

company-mode

company-mode は補完機能を提供するためのフレームワークで、それ自体にコード解析や補完リスト提供のような機能はない。
その部分は、 backend が提供する。

• https://company-mode.github.io/
  • https://github.com/company-mode/company-mode/wiki
  • https://www.emacswiki.org/emacs/CompanyMode

capf は completion-at-point-function の意味

• https://www.gnu.org/software/emacs/manual/html_node/elisp/Completion-in-Buffers.html

https://braveam.com/archives/721

自作補完バックエンドを作る方法
https://ifritjp.github.io/documents/emacs/company-mode/

https://zenn.dev/sumisonic/articles/4eebb9ec083bf4

Emacsディストリビューション

spacemacs

• https://github.com/syl20bnr/spacemacs

doom emacs

• https://github.com/hlissner/doom-emacs

Centaur Emacs

• https://seagle0128.github.io/.emacs.d/

Prelude

• https://github.com/bbatsov/prelude

jcs-emacs

• https://github.com/jcs-emacs/jcs-emacs

scimax

科学技術向け Emacs設定ディストリ

• https://github.com/jkitchin/scimax