Waldo 技术文档

Waldo 是 TextMate 的 Find-in-Project 功能的移植版本，专为 MacVim.app 设计。以下为安装指南、使用说明以及项目 API 使用文档。

1. 安装指南

• 下载 Waldo.zip 文件，并将其 .app 文件放入应用程序文件夹中。
• 打开 Waldo.app 以安装 Vim 插件。
• 打开 MacVim.app 并使用 <leader>f 映射触发 Waldo。

注意：<leader> 是一个可编程的前缀，默认为 \（反斜杠），您可以在 .vimrc 文件中更改它。

注意：如果您的 .vim/ 文件夹不在主目录中，您必须手动将 Waldo.vim（位于 .app 包内）放入 .vim/plugins 目录中。

注意：确保您 cd 到要搜索的目录。

2. 项目使用说明

• 下载 Waldo.zip 文件，并将其 .app 文件放入应用程序文件夹中。
• 打开 Waldo.app。
• 打开 MacVim.app。
• 使用 <leader>f 映射触发 Waldo。

3. 项目 API 使用文档

Waldo 的 API 使用目前集中在通过 <leader>f 映射在 MacVim 中触发搜索功能。用户可以通过修改 .vimrc 文件来自定义 <leader> 的键绑定。

4. 项目安装方式

• 下载 Waldo.zip 文件。
• 解压文件，将 Waldo.app 移动到应用程序文件夹中。
• 打开 Waldo.app 以安装 Vim 插件。
• 打开 MacVim.app，确保 .vim/ 文件夹在主目录中，如果不是，请手动移动 Waldo.vim 文件到 .vim/plugins 目录。

更新日志

版本 0.4

• 修复了 0.2 版本引入的崩溃问题。
• 将 "literal match" 重命名为 "regex"。
• 将 "case sensitive" 重命名为 "ignore case"。
• 代码重构。
• 如果没有在命令行中指定项目路径，打开 Waldo 将显示 "Open" 对话框。
• 仅作为菜单项启动。

版本 0.3

• 将项目重命名为 Waldo（之前称为 VimAck）。
• 在首次启动时自动安装 Vim 插件。
• 添加对区分大小写搜索的支持。
• 添加对正则表达式搜索的支持。
• 作为菜单项启动 Waldo。

版本 0.2

• 在单独的线程上执行 ack 子进程。
• 支持使用 Sparkle.framework 自动发布更新。
• 防止触发 <leader>f 时打开多个 Waldo 实例。

路线图

版本 0.5

• 添加搜索字段的历史记录。
• 添加忽略目录的功能。
• 添加键盘导航。

贡献者

• Zef Houssney
• James Chen
• Martin Schürrer

许可

版权所有 (C) 2011 by Majd Taby

此软件及其相关文档文件（以下简称 "软件"）的副本，未经收费，许可任何个人或组织以不受限制的方式使用该软件，包括但不限于权利使用、复制、修改、合并、发布、分发、再许可和/或销售软件的副本，并允许提供给软件的任何人以同样的方式做。

上述版权声明和本许可声明应包含在所有副本或软件的实质性部分中。

软件按 "原样" 提供，不提供任何形式的明示或暗示的保证，包括但不限于对适销性和特定目的的适用性以及侵犯性的保证。在任何情况下，作者或版权持有者对任何由本软件或其使用或其他交易引起的任何索赔、损害或其他责任概不负责。