Wombat：轻量级Ruby网络爬虫与数据提取器使用手册

---

1. 目录结构及介绍

Wombat作为一个Ruby库，其项目结构清晰地反映了它的功能和开发组织方式。以下是主要的目录结构及其简介：

.
├── examples                   # 示例代码，展示如何使用Wombat进行网页抓取和数据提取
├── fixtures                   # 包含测试固定数据，如VCR（Video Cassette Recorder）磁带模拟网络请求和响应
├── lib                        # 核心代码库，存放所有类和模块实现
│   └── wombat.rb              # 主入口文件，定义了Wombat的主要工作流程和类
├── spec                       # 测试套件，确保代码质量
│   ├── spec_helper.rb         # 测试帮助器，设置测试环境
├── .gitignore                 # 忽略提交的文件列表
├── CHANGELOG.md               # 更新日志，记录版本间的变动
├── Gemfile                    # 定义项目所需的gem依赖
├── Gemfile.lock               # 锁定具体版本的依赖关系
├── Guardfile                  # Guard工具配置，自动运行测试等
├── LICENSE.txt                # 许可证文件，说明软件使用的MIT协议
├── README.md                  # 项目简介和快速入门指南
├── Rakefile                   # 自定义Rake任务
├── Travis.yml                 # Travis CI配置文件，用于自动化测试
└── wombat.gemspec             # gem规范文件，描述如何构建和发布该gem包

2. 项目的启动文件介绍

在Wombat项目中，并没有一个传统意义上的“启动文件”，因为这是一个Ruby Gem，通常通过在Ruby环境中引入gem的方式开始使用。但你可以从examples目录下的示例脚本开始体验，例如，一个基本的启动样例可以通过这样的命令来体现：

require 'wombat'

Wombat.crawl do
  # ... 爬虫配置和数据提取逻辑在这里
end

这段代码需要放在你的应用程序中，以调用Wombat的功能并执行网页抓取。

3. 项目的配置文件介绍

Wombat本身并不直接提供一个特定的配置文件路径或格式，它更多是通过代码块的形式接受配置和设定。这意味着，配置通常是动态的，直接嵌入在你使用Wombat的地方，如上述代码示例所示。然而，对于复杂的项目，开发者可能会选择将配置项（如基础URL、路径、提取规则等）存储在一个单独的Ruby文件或者YAML文件中，然后在启动时读取这些配置并传给Wombat的API，这样便于管理和维护。

例如，如果你创建了一个config/wombat_settings.yml，则可以这样加载配置：

require 'yaml'
settings = YAML.load_file('config/wombat_settings.yml')

Wombat.crawl do
  base_url settings['base_url']
  # ... 其他配置基于settings变量
end

请注意，这种方式并非Wombat的内置特性，而是常见的一种实践，可以根据个人或团队的需要定制实施。