关于 doom-literate-config
这项技能用于维护以 Org mode 编写的 Doom Emacs 配置,帮助开发者从生成文件追溯到 config.org、盘点现有设置,并按 Doom 约定进行修改。
主要功能
- 01识别代码块的生成文件和目标位置
- 02盘点设置与软件包声明
- 03在源文件中保留注释
- 04使用 Doom 原生配置宏
- 05按工具组织 Org 章节
适用场景
- 01安全修改 Doom 配置
- 02在 packages.el 中添加软件包声明
- 03调整按键绑定或软件包设置
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ tejas-kale/ skills --skill doom-literate-config安装后在 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 中的注释移入缠结到 packages.el 的 config.org 代码块,使其在重新生成后得以保留。
完成标准:缠结文件中的每个生效设置、声明和注释,都能在源文件中找到对应内容——要么保留,要么有意删除。
3. 采用最精简的 Doom 原生改动
优先使用 Doom 宏,而不是原始 Emacs Lisp:
| 任务 | 使用 |
|---|---|
| 声明外部包 | package!(位于 packages.el 代码块中) |
| 配置包 | use-package! |
| 绑定按键 | map! |
| 设置默认字体 | doom-font |
| 设置新窗口框架的几何参数 | default-frame-alist |
为每个工具单独创建一个 config.org 章节和代码块,并在配置代码块之前添加其前置条件代码块。
完成标准:每个修改过的行都对应用户明确表达的偏好。
评论
支持 Markdown