mf2 / tests
Microformats 测试套件
This package is auto-updated.
Last update: 2024-09-11 20:59:32 UTC
README
这个测试组是为了测试 microformats 解析器而构建的。每个测试都是包含 HTML 片段的文件。还有一个相应的 JSON 文件,其中包含预期的输出。
这些测试被拆分成了此项目测试目录内的集合。它们首先按版本分组。一些解析器只支持 microformats 的一个版本。然后根据 microformats 的类型进行细分,例如 h-card。
NPM
要使用 npm 将最新的 microformats 测试套件添加到您的项目中,请运行以下命令
npm install microformats/tests --save-dev
使用以下命令更新到最新的 microformats 测试套件
npm update microformats/tests
贡献新的测试或更新测试
这个测试集属于 microformats 社区。如果您在当前测试中找到任何错误或您认为应该包含在新测试套件中的新模式,请随时发送 pull request。
创建新测试的注意事项
测试由两部分组成:一个包含要解析的 HTML 片段的 HTML 文件,以及一个包含解析器预期输出的 JSON 文件。
-
在此项目的“test”目录中选择测试所属的 microformats 版本的正确目录。如果您正在创建针对新 microformats 功能的测试或探索问题,请将这些测试添加到“experimental”目录。
-
在正确的目录中,将您的新测试添加到以格式名称(例如
h-card
)或新功能名称命名的子目录中。 -
创建 HTML 文件。添加可以的最小且清晰的示例。不需要添加 head 或 body 标签等。
-
创建与 HTML 文件同名的一个 JSON 文件。JSON 应该是解析器的预期输出。
-
创建测试后,请更新 change-log.html。添加一个包含测试详情的
h-entry
。在页面底部,请在作者列表中添加自己作为贡献者。
测试目的的日期格式
在测试中,日期时间格式基于 HTML5 配置文件,它是 ISO8601 的子集,并允许空格分隔日期和时间。为了让我们能够比较日期,请提供一种方法,让您的解析器按照以下规则输出日期/时间:
- 日期和时间由空格分隔,例如
2015-04-29 15:34
- 日期和时间保留作者的特定级别,例如
15:34
不会变成15:34:00
- 时间和时区始终使用冒号分隔符,例如
+01:30
不会是+0130
- 如果使用,则 Zulu 总是大写,例如
2015-04-29 15:34Z
许可证
Microformats 测试套件 使用 Creative Commons -- CC0 1.0 Universal 鼓励公共领域。