Puni 项目使用教程

Puni 项目使用教程

puni Structured editing (soft deletion, expression navigating & manipulating) that supports many major modes out of the box. 项目地址: https://gitcode.com/gh_mirrors/pu/puni

1. 项目的目录结构及介绍

Puni 项目的目录结构如下：

puni/
├── .gitignore
├── LICENSE
├── Makefile
├── README.md
├── puni.el
└── scripts/
    └── github/
        └── img/

目录结构介绍

• .gitignore: 用于指定 Git 版本控制系统忽略的文件和目录。
• LICENSE: 项目的开源许可证文件，Puni 使用 GPL-3.0 许可证。
• Makefile: 用于自动化构建和测试的 Makefile 文件。
• README.md: 项目的说明文档，包含项目的介绍、安装方法、使用说明等内容。
• puni.el: Puni 项目的主要源代码文件，包含了所有的功能实现。
• scripts/: 包含一些辅助脚本和工具。
  • github/: 包含与 GitHub 相关的脚本和资源。
    • img/: 包含项目文档中使用的图片资源。

2. 项目的启动文件介绍

Puni 项目的启动文件是 puni.el。这个文件包含了 Puni 的所有功能实现，包括软删除、表达式导航和操作等功能。

启动文件介绍

• puni.el: 这是 Puni 项目的主要源代码文件，包含了所有的功能实现。用户可以通过加载这个文件来启用 Puni 的功能。

3. 项目的配置文件介绍

Puni 项目没有专门的配置文件，所有的配置都是通过 Emacs 的配置文件（如 .emacs 或 init.el）来完成的。

配置文件介绍

• Emacs 配置文件: 用户可以在 Emacs 的配置文件中添加以下代码来启用 Puni：

(add-to-list 'load-path "/path/to/puni/")
(require 'puni)
(puni-global-mode)

• puni-global-mode: 启用 Puni 的全局模式，使得 Puni 的功能在所有支持的模式中生效。
• puni-disable-puni-mode: 可以在特定的模式钩子中禁用 Puni 模式，例如在 term-mode 中：

(add-hook 'term-mode-hook #'puni-disable-puni-mode)

通过以上配置，用户可以自定义 Puni 的行为，以适应不同的使用场景。

puni Structured editing (soft deletion, expression navigating & manipulating) that supports many major modes out of the box. 项目地址: https://gitcode.com/gh_mirrors/pu/puni