Gumbo HTML5解析库使用教程（Qt版）

"Gumbo使用指南(Qt版).pdf" Gumbo是一个开源的HTML5解析库，由C语言编写，提供了一种解析HTML文档为抽象语法树（AST）的方式，便于进行进一步的处理和分析。本指南详细介绍了如何在Qt环境下使用Gumbo库。 1. Gumbo概述 - **目标和特性**: Gumbo设计的目标是能够解析不规范的HTML，如同浏览器一样处理HTML5的错误。其主要特性包括支持HTML5标准、生成易于遍历和操作的AST以及良好的错误处理能力。 - **非目标**: Gumbo不是用于生成可执行代码或者渲染HTML的工具，而是专注于解析和理解HTML文档的结构。 - **愿望清单**: 除了现有功能外，Gumbo的开发可能还包含对更多HTML5特性的支持和性能优化。 - **其他封装库**: Gumbo库还有其他语言的封装版本，如Python、Ruby等，方便不同语言环境下的使用。 - **API/ABI兼容性**: Gumbo致力于保持稳定的API和ABI，使得升级库时可以无缝对接旧代码。 2. Gumbo安装 - **从源码安装**: 用户需要下载Gumbo源码，配置编译环境，然后编译并安装到系统路径。 - **pkg-config支持**: 安装完成后，可以使用`pkg-config`命令检查Gumbo的安装情况及链接参数。 - **构建示例程序**: Gumbo提供了示例程序帮助用户了解如何使用库，需要通过编译脚本来构建。 - **单元测试**: Gumbo的测试框架基于libgtest，可以通过源码或包管理器安装，确保库的功能正确性。 3. 示例 - **简单用法**: 展示了如何初始化解析器，读取HTML数据并调用gumbo_parse进行解析。 - **获取网页标题**: 通过遍历AST找到`<title>`标签来提取网页标题。 - **获取href属性值**: 搜索`<a>`标签，提取`href`属性，适用于链接提取和分析。 - **获取所有标签内的纯文本**: 遍历所有文本节点，合并得到HTML文档的纯文本内容。 4. 结构体 - **GumboVector**: 用于存储和管理数组的结构体，常用于表示节点列表或属性数组。 - **GumboOutput**: 解析后的结果，包含整个HTML文档的AST和相关信息。 - **GumboNode**: 表示HTML文档中的一个节点，包括文档、元素、文本节点等。 - **GumboNodeType**: 定义了节点的不同类型，如元素节点、文本节点、注释节点等。 - **GumboParseFlags**: 描述解析过程中遇到的特殊情况，如是否在怪异模式下解析。 - **GumboDocument**: 表示整个HTML文档，包括文档类型声明、quirks模式等。 - **GumboElement**: 表示HTML元素，包含标签、命名空间、属性等信息。 - **GumboTag**: HTML标签的枚举，如`TAG_DIV`、`TAG_A`等。 - **GumboNamespaceEnum**: HTML元素的命名空间，如HTML、SVG或MathML。 - **GumboStringPiece**: 用于表示字符串片段的结构，通常用于表示属性值或文本内容。 - **GumboSourcePosition**: 描述源代码中的位置信息，包括行号、列号等。 - **GumboAttribute**: 存储元素的属性，如属性名和值。 5. 函数 - **解析相关**: - `gumbo_parse`: 基础的HTML解析函数，接收HTML字符串并返回AST。 - `gumbo_parse_with_options`: 提供自定义解析选项的解析函数，如忽略错误或指定编码。 - `gumbo_destroy_output`: 释放解析结果占用的内存，防止内存泄漏。 - **节点相关**: - `gumbo_get_attribute`: 从元素节点中查找并返回指定名称的属性。 - `gumbo_normalize_name`: 标准化属性名，以便与规范进行比较。 通过学习和实践这个指南，开发者可以掌握如何在Qt项目中集成和使用Gumbo库来解析HTML文档，从而实现各种基于HTML的数据处理任务，例如内容提取、结构分析和自动化测试。