# emacs-config

**Repository Path**: rweiwu/emacs-config

## Basic Information

- **Project Name**: emacs-config
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-24
- **Last Updated**: 2025-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#+TITLE: Emacs 配置说明
#+AUTHOR: 用户
#+DATE: 2024
#+STARTUP: overview
#+OPTIONS: toc:2 num:t

* 概述

这是一个模块化的 Emacs 配置，专为提升编辑体验和工作效率而设计。配置采用模块化结构，使用 straight.el 作为包管理器，便于维护和扩展。

* 目录结构

#+BEGIN_EXAMPLE
.emacs.d/
├── init.el                    # 主配置文件
├── early-init.el              # 早期初始化配置
├── config/                    # 配置模块目录
│   ├── basic-config.el        # 基础界面配置
│   ├── theme-config.el        # 外观主题配置
│   ├── tools-config.el        # 增强工具配置
│   ├── org-config.el          # Org Mode 配置
│   └── bibliography-config.el # 文献管理配置
├── straight/                  # straight.el 包管理目录
│   ├── build-cache.el         # 构建缓存
│   ├── versions/              # 版本锁定文件
│   └── modified/              # 修改的包文件
└── README.org                 # 本说明文件
#+END_EXAMPLE

* 功能特性

** 启动优化
- 临时提高垃圾回收阈值，减少启动时间
- 优化文件处理机制
- 减少启动白屏时间

** 包管理
- 使用 **straight.el** 作为主要包管理器，支持 Git 仓库直接安装
- 版本锁定机制，确保配置的可重现性
- 支持从 GitHub、GitLab 等多种源安装包
- 集成 use-package 语法，便于配置管理
- 备用清华大学 ELPA 镜像源配置

** 基础界面配置
- 隐藏启动消息和欢迎屏幕
- 隐藏工具栏和菜单栏，提供简洁界面
- 全局显示行号
- 可选的滚动条隐藏
- UTF-8 编码配置，确保中文和特殊字符正确显示

** 外观主题
- *Doom Themes*: 现代化的主题包
  - 默认使用 =doom-one= 主题
  - 支持粗体和斜体字体
  - 集成 Treemacs 和 Org-mode 优化
- *Doom Modeline*: 美观的状态栏
- *Dashboard*: 启动欢迎面板
  - 显示最近文件和书签
- *Nerd Icons*: 图标支持
  - 支持 Dired 目录图标显示

** 增强工具
- *Helm*: 强大的补全和选择框架
  - 智能文件查找 (=C-x C-f=)
  - 缓冲区管理 (=C-x C-b=, =C-x b=)
  - 命令执行 (=M-x=)
  - 当前缓冲区搜索 (=C-c h o=)
  - 符号跳转 (=C-c h i=)
  - 支持模糊匹配和智能大小写
- *Magit*: 完整的 Git 集成工具
  - Git 状态管理和提交
  - 分支操作和合并
  - 日志查看和差异显示
- *Git 增强工具*:
  - Git Timemachine: 文件历史版本查看
  - Diff-hl: 边缘 Git 差异显示
- *Rime*: 强大的中文输入法引擎
  - 设置为默认输入法
  - 使用 posframe 显示候选词
  - 快捷键 =C-\= 切换输入法

** WSL 集成
- Windows 剪贴板集成支持（使用 wl-clipboard）
- 自定义键绑定:
  - =C-c w c=: 复制到 Windows 剪贴板
  - =C-c w x=: 剪切到 Windows 剪贴板
  - =C-c w v=: 从 Windows 剪贴板粘贴

** Org Mode 增强
- *Org Capture*: 快速笔记捕获系统
  - 日记模板配置 (=C-c c=)
  - 自定义捕获模板
- *远程图像支持*:
  - org-remoteimg: 远程图像显示和缓存
  - org-imgtog: 图像切换工具
- 基础 Org 配置和目录设置

** 文献管理
- *Helm-bibtex*: BibTeX 文献检索和管理
- *Org-ref*: Org-mode 文献引用支持
- 支持自定义 BibTeX 文件路径

* 安装的包

配置会自动安装以下包：

**主题和界面**:
- =doom-themes=: 现代化主题包
- =doom-modeline=: 美观状态栏
- =dashboard=: 启动欢迎面板
- =nerd-icons=: 图标字体支持
- =nerd-icons-dired=: Dired 目录图标

**编辑增强**:
- =helm=: 强大的补全框架
- =rime=: 中文输入法引擎

**Git 工具**:
- =magit=: 完整的 Git 集成
- =git-timemachine=: Git 历史查看
- =diff-hl=: Git 差异高亮显示

**文献管理**:
- =helm-bibtex=: BibTeX 文献检索
- =org-ref=: Org 文献引用支持

**Org Mode 增强**:
- =org-remoteimg=: 远程图像支持
- =org-imgtog=: 图像切换工具

* 快速开始

1. 确保已安装 Emacs 28+ 版本
2. 将配置文件放置到 =~/.emacs.d/= 目录
3. 启动 Emacs，straight.el 会自动下载并安装所需包
4. 首次启动可能需要较长时间来克隆 Git 仓库和编译包
5. 安装完成后，可使用 =M-x straight-freeze-versions= 锁定当前版本

* 自定义配置

** 修改主题
在 =config/theme-config.el= 中修改：
#+BEGIN_SRC emacs-lisp
(load-theme 'doom-one t)  ; 更改为其他 doom 主题
#+END_SRC

** 配置文献管理
在 =config/bibliography-config.el= 中设置 BibTeX 文件路径：
#+BEGIN_SRC emacs-lisp
(setq bibtex-completion-bibliography 
      '("/path/to/your/bibliography.bib"))
#+END_SRC

** 版本管理
- 使用 =M-x straight-freeze-versions= 锁定当前包版本
- 使用 =M-x straight-thaw-versions= 解锁版本限制
- 版本信息保存在 =straight/versions/default.el= 文件中

** 配置 Org Capture
在 =config/org-config.el= 中自定义捕获模板：
#+BEGIN_SRC emacs-lisp
(setq org-capture-templates
      '(("j" "日记" entry (file+datetree "~/org/journal.org")
         "* %?\n  %U\n  %i" :empty-lines 1)))
#+END_SRC


** 添加新的配置模块
1. 在 =config/= 目录下创建新的 =.el= 文件
2. 在文件末尾添加 =(provide 'module-name)=
3. 在 =init.el= 中添加 =(require 'module-name)=

* 常用快捷键

** 基础操作
| 快捷键    | 功能                 |
|-----------+----------------------|
| =M-x=     | 执行命令             |
| =C-x C-f= | 查找文件             |
| =C-x C-b= | 缓冲区和最近文件     |
| =C-x b=   | 缓冲区列表           |
| =C-c h o= | 当前缓冲区搜索       |
| =C-c h i= | 符号跳转             |

** Org Mode 操作
| 快捷键    | 功能                 |
|-----------+----------------------|
| =C-c c=   | Org Capture 快速捕获 |

** Git 操作
| 快捷键      | 功能                 |
|-------------+----------------------|
| =C-x g=     | Git 状态             |
| =C-x M-g=   | Magit 调度器         |
| =C-c g c=   | 克隆仓库             |
| =C-c g s=   | Git 状态             |
| =C-c g b=   | Git blame            |
| =C-c g l=   | 当前分支日志         |
| =C-c g f=   | 当前文件日志         |
| =C-c g t=   | Git 时间机器         |

** WSL 剪贴板
| 快捷键    | 功能                 |
|-----------+----------------------|
| =C-c w c= | 复制到 Windows 剪贴板 |
| =C-c w x= | 剪切到 Windows 剪贴板 |
| =C-c w v= | 从 Windows 剪贴板粘贴 |

** 输入法
| 快捷键    | 功能                 |
|-----------+----------------------|
| =C-\=     | 切换中文输入法       |

* 故障排除

** 包下载失败
- 检查网络连接和 Git 配置
- 尝试手动执行 =M-x straight-pull-all= 更新包
- 使用 =M-x straight-rebuild-all= 重新编译所有包
- 检查 =straight/build-cache.el= 是否存在问题

** 字体显示问题
- 确保系统已安装 Nerd Font 字体
- 在 =config/theme-config.el= 中调整字体设置

** WSL 剪贴板不工作
- 确保已安装 =wl-clipboard= 工具
- 检查 WSL 版本是否支持剪贴板集成

* 许可证

本配置基于 GPL-3.0 许可证发布。

* 贡献

欢迎提交 Issue 和 Pull Request 来改进这个配置。