Azure DevOps Wiki:YAML 在页面降价上的价值是什么?
Azure DevOps Wiki: What is the value of YAML atop a page's markdown?
在 Azure DevOps Wiki 页面的降价顶部添加 YAML 的价值是什么,由其降价语法支持:Syntax guidance for Markdown usage in Wiki, YAML tags?
它似乎只提供了一种用于指定表的替代语法。也许更精致的表格,但它们只会呈现在页面顶部。我错过了什么?
中的介绍
Any file that contains a YAML block in a Wiki is processed by a table with one head and one row.
因此,我认为 Wiki markdown 中 YAML 标签的价值在于将抽象的 YAML 语句转换为 Wiki 页面上的可视化 table 以增加可读性和快速理解。
特别是对于可能包含多个项目或多个子项目的复杂 YAML 块,YAML 标签应该非常有用。
[更新]
我在 GitHub 存储库“MicrosoftDocs/azure-devops-docs”上找到了另一个用户报告的问题单 (MicrosoftDocs/azure-devops-docs#9976)。这个issue已经报道了一个类似的问题。
而在这个工单中,您还可以看到@amitkumariiit
已经给出了解释:
如果需要更详细的解释,可以关注这个issue ticket,并在里面添加您的意见。
我要提出我自己的答案。我只是想到这很可能是为了取代降价,而不是与降价一起使用。也就是说,支持纯 YAML 编写的文档。这可能有一定的道理,为某些人增加价值,并解释为什么它仅在页面顶部受支持。你用它代替markdown,而不是用markdown。
文档没有说清楚why/how您可能想要使用此功能。
在 Azure DevOps Wiki 页面的降价顶部添加 YAML 的价值是什么,由其降价语法支持:Syntax guidance for Markdown usage in Wiki, YAML tags?
它似乎只提供了一种用于指定表的替代语法。也许更精致的表格,但它们只会呈现在页面顶部。我错过了什么?
Any file that contains a YAML block in a Wiki is processed by a table with one head and one row.
因此,我认为 Wiki markdown 中 YAML 标签的价值在于将抽象的 YAML 语句转换为 Wiki 页面上的可视化 table 以增加可读性和快速理解。
特别是对于可能包含多个项目或多个子项目的复杂 YAML 块,YAML 标签应该非常有用。
[更新]
我在 GitHub 存储库“MicrosoftDocs/azure-devops-docs”上找到了另一个用户报告的问题单 (MicrosoftDocs/azure-devops-docs#9976)。这个issue已经报道了一个类似的问题。
而在这个工单中,您还可以看到@amitkumariiit
已经给出了解释:
如果需要更详细的解释,可以关注这个issue ticket,并在里面添加您的意见。
我要提出我自己的答案。我只是想到这很可能是为了取代降价,而不是与降价一起使用。也就是说,支持纯 YAML 编写的文档。这可能有一定的道理,为某些人增加价值,并解释为什么它仅在页面顶部受支持。你用它代替markdown,而不是用markdown。
文档没有说清楚why/how您可能想要使用此功能。