3

我工作的公司决定以 Markdown 格式存储需求，以实现简单性、可引用性和直接在 TFS/Azure DevOps Server 中预览。问题在于 TFS/Azure Dev Ops Server 中的预览部分。正如我所发现的，它支持：HTML 标记、数学公式、图像大小调整、提及拉取请求、用户、工作项等等。但是不支持美人鱼图，尽管它们对我的想法非常有用，可以在最短的时间内获得对复杂过程的共同理解。

我已经安装了 pandoc，这是一个过程：为 REPO 中的每个更新的 md 文件自动生成 HTML 文件问题是 TFS/Azure DevOps 服务器不接受预览 BASE64 编码的图像，pandoc 内置在 HMTL 中。

所以我决定做这样的事情：

  • 为每个更新的 md 文件创建带有后缀的副本 (***_IMG.md)
    • 对于每个美人鱼图
      • 生成PNG图像
      • 将PNG图像保存到图像文件夹
      • 用生成图像的链接替换美人鱼图
  • 保存更改的 md 文件

是否可以指定一个软件列表来实现此解决方案？我还没有找到关于我应该使用什么仪器的答案，我猜是 python？但可能还有其他选择吗？

4

3 回答 3

3

这比你想象的要容易。TFS/Azure DevOps Server Wiki由 Git 存储库提供支持，因此您的流程可能类似于：

  • git pull
  • 扫描 repo 文件以查找美人鱼图
  • 生成 JPG 并将片段替换为图像链接
  • git commit
  • git push

它可以在 Pipeline 中轻松实现自动化，也许像Git Tools for Azure DevOps这样的扩展可以使这项工作更加简单。

于 2019-04-30T16:13:01.810 回答
2

将简单 UML 包含到 TFS/Azure Dev Ops Wiki 的另一种方法是yUML.me。

只需将<img>标签添加到您的降价中，包括您的 UML 语法，例如。

<img src="http://yuml.me/diagram/scruffy/class/%2F%2F Cool Class Diagram, [Customer|-forname:string;surname:string|doShiz()]<>-orders*>[Order], [Order]++-0..*>[LineItem], [Order]-[note:Aggregate root{bg:wheat}].jpg">

这会将这样的图像添加到您的 Wiki 页面：

在此处输入图像描述

许多样本可以在这里找到： https ://yuml.me/diagram/scruffy/class/samples

当然，这有一些限制，例如 Uri 的最大长度，但我发现这对于小型 UML 非常有用，并且您可以在输入 Uml 语法时在预览选项卡中实时看到结果。

我还没有使用 AzureDevOps Server 对其进行测试，但在 TFS 2018 中它就像一个魅力。

于 2019-06-13T11:46:29.613 回答
0

您可以使用CLI版本，https://github.com/mermaid-js/mermaid-cli 使用 CLI，您可以从 .mmd 文件构建 .svg 或 .png 渲染。（另见实时编辑器https://mermaid-js.github.io/mermaid-live-editor/，创建 .mmd 文件可能更容易）

于 2021-09-10T13:30:45.520 回答