Vertico 使用教程

Vertico 使用教程

vertico :dizzy: vertico.el - VERTical Interactive COmpletion 项目地址: https://gitcode.com/gh_mirrors/ve/vertico

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

Vertico 是一个基于 Emacs 的垂直交互式补全界面。它的目录结构相对简单，主要包括以下几个部分：

• vertico.el：Vertico 的主要 Elisp 文件，包含了所有的核心功能。
• extensions：包含了一些可选的扩展模块。
• .gitignore：指定 Git 忽略的文件。
• CHANGELOG.org：记录了 Vertico 的更新日志。
• LICENSE：Vertico 使用的是 GPL-3.0 许可证。
• README.org：项目的详细说明文档。

2. 项目的启动文件介绍

Vertico 的启动非常简单。你可以通过以下两种方式安装：

1. 通过 GNU ELPA 直接安装：

   在 Emacs 中运行 M-x package-install RET vertico RET。

2. 通过 Git 克隆仓库：

克隆仓库后，通常需要将 vertico.el 文件添加到你的 Emacs 配置文件（通常是 ~/.emacs.d/init.el）中。

安装完成后，你需要在 Emacs 中启用 Vertico 模式，可以通过以下命令：

(M-x vertico-mode)

这将全局激活 Vertico 模式。

3. 项目的配置文件介绍

Vertico 提供了多种配置选项，你可以通过修改 init.el 文件来进行配置。以下是一些常用的配置：

• 设置滚动边距：

  (setq vertico-scroll-margin 0)
  

• 显示更多候选项：

  (setq vertico-count 20)
  

• 启用自动调整迷你缓冲区大小：

  (setq vertico-resize t)
  

• 启用循环滚动：

  (setq vertico-cycle t)
  

此外，Vertico 还支持与其他包的集成，如 savehist 用于在 Emacs 重启之间持久化历史记录，orderless 提供更灵活的补全风格等。以下是一个示例配置：

(use-package vertico
  :custom
  (vertico-scroll-margin 0)
  (vertico-count 20)
  (vertico-resize t)
  (vertico-cycle t)
  :init
  (vertico-mode))

(use-package savehist
  :init
  (savehist-mode))

(use-package emacs
  :custom
  (enable-recursive-minibuffers t)
  (read-extended-command-predicate #'command-completion-default-include-p)
  (minibuffer-prompt-properties '(read-only t cursor-intangible t face minibuffer-prompt)))

(use-package orderless
  :custom
  (completion-styles '(orderless basic))
  (completion-category-defaults nil)
  (completion-category-overrides '((file (styles partial-completion)))))

通过上述配置，你可以根据自己的需求定制 Vertico 的行为。更多配置选项和细节，可以参考 Vertico 的官方文档和 Wiki 页面。

vertico :dizzy: vertico.el - VERTical Interactive COmpletion 项目地址: https://gitcode.com/gh_mirrors/ve/vertico