状态标签是什么,比如 [build |通过]

What are the status tags, like [build | passing]

可能是一个众所周知的问题,但实际上我是在问这个,因为我不熟悉这些标签。

我在各种 Github 项目中看到过类似类型的标签,尤其是在他们的 README.md 中。关于这些,我的问题是多方面的:

  1. 这些标签的用途是什么?
  2. 如何生成它们?
  3. 是否有任何好的实践或文档建议在项目中可以使用或应该使用什么类型的标签?
  4. 何时可以使用此类标签确定项目可行?

What's the purpose of these tags?

这些图像由外部服务提供,通常是 continuous integration 服务,用于显示有关存储库的有趣信息。

例如,您在示例中显示的第一个徽章表示构建正在“通过”(具体定义将因构建而异,但通常意味着测试通过并且在构建过程中没有任何问题发生)最近的版本)。

第三个例子,覆盖率:12%,是一份code coverage报告。

How to generate them?

每个服务都有自己的方式。

您示例中的第二个徽章来自 Scrutinizer,遗憾的是我找不到有关其徽章的文档。但是大多数徽章系统的工作方式是为您可以在网站上使用的每个项目或工作提供 link 或 GitHub 或其他任何内容,并且当构建发生时,徽章的外观会相应更新。

Travis CI documentation 包含一个很好的例子。

在回答了第一个问题后,我认为您的后两个问题基本消失了。 可以使用的徽章取决于您可以找到的任何服务。 应该使用的徽章完全由您决定。