DOM Distiller 项目使用教程

1. 项目目录结构及介绍

DOM Distiller 项目的目录结构如下：

dom-distiller/
├── AUTHORS
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── build/
├── dom_distiller/
│   ├── core/
│   ├── proto/
│   ├── test/
│   └── ui/
├── out/
├── scripts/
└── tools/

目录介绍：

• AUTHORS: 项目贡献者列表。
• CONTRIBUTING.md: 贡献指南，包含如何为项目贡献代码的说明。
• LICENSE: 项目许可证文件。
• README.md: 项目的基本介绍和使用说明。
• build/: 构建相关文件和脚本。
• dom_distiller/: 核心代码目录，包含项目的核心功能实现。
  • core/: 核心功能模块。
  • proto/: 协议缓冲区定义文件。
  • test/: 测试代码和测试用例。
  • ui/: 用户界面相关代码。
• out/: 构建输出目录，包含编译后的文件。
• scripts/: 项目脚本文件，包含自动化脚本等。
• tools/: 项目工具文件，包含辅助工具和实用程序。

2. 项目启动文件介绍

DOM Distiller 项目的启动文件主要位于 dom_distiller/core/ 目录下。以下是主要的启动文件：

• dom_distiller_service.cc: 这是 DOM Distiller 服务的主要实现文件，负责处理 DOM 解析和提取的核心逻辑。
• dom_distiller_viewer.cc: 这是 DOM Distiller 的视图实现文件，负责将提取的内容呈现给用户。

启动流程：

1. 初始化服务: 在 dom_distiller_service.cc 中初始化 DOM Distiller 服务。
2. 加载配置: 根据配置文件加载相关设置。
3. 启动视图: 在 dom_distiller_viewer.cc 中启动视图，开始处理用户请求。

3. 项目配置文件介绍

DOM Distiller 项目的配置文件主要位于 dom_distiller/ 目录下。以下是主要的配置文件：

• dom_distiller_options.json: 这是 DOM Distiller 的主要配置文件，包含项目的各种配置选项，如提取规则、视图设置等。

配置文件内容：

{
  "extractionRules": {
    "title": "h1",
    "content": "div.article-content"
  },
  "viewSettings": {
    "theme": "light",
    "fontSize": "14px"
  }
}

配置项说明：

• extractionRules: 定义了 DOM 提取的规则，如标题和内容的提取规则。
• viewSettings: 定义了视图的显示设置，如主题和字体大小。

通过以上配置文件，可以灵活调整 DOM Distiller 的行为和显示效果。