首页 > 解决方案 > 如何在同一存储库的 README 降价文件中显示(链接到/超链接)Azure DevOps Git 存储库中的图像?

问题描述

我们的团队希望在我们的 Git 存储库中的一些降价文件文档中包含图像。我们还想将图像存储在 Git 存储库中并将它们视为源。因为它们是二进制文件,我们可以将它们存储在单独的 Git 存储库中。但是,我们更愿意将图像保留在源中,而不必将它们放在其他某种存储中(即,除了 repo 之外的存储)。

在降价中,我们希望能够链接到图像,以便它们显示在 Azure DevOps 预览中(就像它们是常规的 HTML 页面一样)。

是否有可以在 Azure DevOps 中的 markdown 文件中使用的链接格式来显示我们的图像?

我们尝试简单地在 markdown 中放置一个“img”标签,并将其指向 Azure DevOps Git 存储库中文件的 URI。这不起作用。

<img src="https://anyaccount.visualstudio.com/repos/_git/ourRepo?path=%2FSrc%2FDocumentation%2FImages%2FImage.PNG&version=GBmaster" alt="drawing" style="width:541px" />

我们希望能够对图像使用完整的 URI(即不是相对链接),以便它不仅显示在 Azure DevOps 的“预览”视图中,而且允许我们将我们的降价文件转换为其他格式(例如 HTML , MediaWiki) 也将正确显示图像。

标签: githyperlinkversion-controlazure-devopsmarkdown

解决方案


尝试使用Git 项目 API。我能够使用以下 URL 以这种方式直接链接到回购项目:

https://{organization}.visualstudio.com/{project}/_apis/git/repositories/{repo}/Items?path=path=%2Ftip.png&versionDescriptor%5BversionOptions%5D=0&versionDescriptor%5BversionType%5D=0&versionDescriptor%5Bversion%5D=master&download=false&resolveLfs=true&%24format=octetStream&api-version=5.0-preview.1

例子:

存储在 repo 中的图像:

在此处输入图像描述

然后在 README.md 中使用 API 引用它:

<img src="https://{organization}.visualstudio.com/{project}/_apis/git/repositories/{repo}/Items?path=%2Ftip.png&version%5D=master&download=false&resolveLfs=true&%24format=octetStream&api-version=5.0-preview.1"/>

然后它显示在 README 中:

在此处输入图像描述


推荐阅读