doom-literate-config について
Org mode で記述する Doom Emacs 設定を保守するスキルです。生成ファイルの元となる config.org を確認し、既存設定を把握したうえで Doom の作法に沿って変更します。
主な機能
- 01生成先とタンブル先の確認
- 02設定とパッケージ宣言の棚卸し
- 03ソース内でのコメント保持
- 04Doom 標準マクロの使用
- 05ツールごとの Org セクション整理
活用シーン
- 01Doom 設定の安全な変更
- 02packages.el へのパッケージ宣言追加
- 03キー割り当てやパッケージ設定の変更
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/doom-literate-configを入力して読み込まれたか確認します。
詳細
Doom リテラル設定
リテラル形式のセットアップでは、config.org がソースであり、それ以外はすべて 展開 されます。つまり、エクスポート時に生成され、上書きされます。編集はすべてソースで行ってください。展開先ファイルを編集しても、次回の展開時に変更は失われます。
1. 展開先を確認する
init.el、config.org、config.el、packages.el を読みます。
init.elの:config literateにより、config.orgがソースになります。- 通常の
emacs-lispブロックはconfig.elに展開されます。 :tangle packages.elが付いたブロックはpackages.elに展開されます。package!宣言にはこのマーカーが必要です。
変更する各ブロックについて、ソースファイルと展開先を説明できれば完了です。
2. 現在の設定を把握する
最初に編集する前に、config.el の有効な設定をすべて、packages.el の package! 宣言をすべて一覧にし、それぞれが config.org に記載されていることを確認します。
再生成後も保持されるよう、パッケージファイルのコメントは packages.el に展開される config.org のブロックに移します。
展開先ファイルにある有効な設定、宣言、コメントがすべてソースに反映されており、それぞれがソース内に保持されているか、意図的に削除されていれば完了です。
3. 変更は最小限にし、Doom 標準の方法を使う
生の Emacs Lisp よりも、Doom のマクロを使います。
| タスク | 使用するもの |
|---|---|
| 外部パッケージを宣言する | package!（packages.el ブロック内） |
| パッケージを設定する | use-package! |
| キーを割り当てる | map! |
| デフォルトのフォントを設定する | doom-font |
| 新しいフレームのジオメトリを設定する | default-frame-alist |
各ツールについて、専用の config.org セクションとコードブロックを用意し、設定の前に必要な前提条件を記述します。
変更した各行が、ユーザーの明示した希望に基づいていることを確認できれば完了です。