Nokogiri-Diff 技术文档

1. 安装指南

在开始使用 nokogiri-diff 项目之前，您需要确保系统已安装以下依赖：

• Ruby（版本 >= 1.8.7）
• tdiff（版本 >= 0.3.2）
• nokogiri（版本 >= 1.5）

安装 nokogiri-diff 最简单的方式是使用 Ruby 的包管理器 gem。在终端中执行以下命令：

$ gem install nokogiri-diff

确保安装成功后，您可以通过以下命令检查安装的版本：

$ nokogiri-diff -v

2. 项目使用说明

nokogiri-diff 是一个 Ruby 库，它提供了计算两个 XML/HTML 文档之间差异（添加或删除的节点）的能力。以下是 nokogiri-diff 的主要特性：

• 使用广度优先搜索比较子节点。
• 支持比较 XML/HTML 元素、属性、文本节点和 DTD 节点。
• 允许计算两个文档之间的差异，或者仅枚举添加或删除的节点。

以下是一个使用 nokogiri-diff 比较两个 HTML 文档差异的示例：

require 'nokogiri/diff'

doc1 = Nokogiri::HTML('<div><p>one</p> two </div>')
doc2 = Nokogiri::HTML('<div><p id="1">one</p> <p>three</p></div>')

doc1.diff(doc2) do |change,node|
  puts "#{change} #{node.to_html}".ljust(30) + node.parent.path
end

此代码段将输出两个文档之间的差异，包括节点变化和其路径。

3. 项目API使用文档

nokogiri-diff 提供了一个 diff 方法，用于计算两个文档之间的差异。以下是一些基本用法：

• 比较两个文档的全部差异：

doc1.diff(doc2) do |change,node|
  puts "#{change} #{node.to_html}".ljust(30) + node.parent.path
end

• 仅查找添加的节点：

doc1.diff(doc2, :added => true) do |change,node|
  puts node.to_html.ljust(30) + node.parent.path
end

• 仅查找删除的节点：

doc1.diff(doc2, :removed => true) do |change,node|
  puts node.to_html.ljust(30) + node.parent.path
end

4. 项目安装方式

nokogiri-diff 的安装方式已在“安装指南”部分详细说明。以下是简要回顾：

通过 Ruby gem 包管理器安装：

$ gem install nokogiri-diff

确保已安装所有依赖项，并检查安装的版本以确保成功安装。