从 R markdown 渲染 .md 时,图像不显示 Azure Devops 存储库自述文件

问题描述 投票:0回答:1

我在组织的 Azure Devops 中有一个 R 项目的存储库。我想在 README 文件中包含一个图像,该图像是我使用 R markdown 创建的,并使用

github_document
作为输出。我参考了文档中的图片如下:

![Fig. 1 - Parameters to select](./images/Knit_with_params.png)

其中

images
是包含图像
knit_with_params.png
的文件夹名称(也上传到我的存储库)。 在 R markdown 文档中的参考下方,我可以看到该图像。 我还可以在编织文档时 RStudio 生成的 HTML 预览中看到它。 查看 README.md 文件,我发现我的图像引用已转换为此(css?):

<figure>
<img src="/images/Knit_with_params.png"
alt="Fig. 1 - Parameters to select" />
<figcaption aria-hidden="true">Fig. 1 - Parameters to
select</figcaption>
</figure>

问题是,当我将自述文件推送到我的存储库时,它只向我显示一个占位符而不是图像本身,尽管事实上当我查看存储库中的图像文件夹时,我可以看到图像文件在那里,如果我点击它,我什至可以看到图像本身。

我的同事通过进入

README.md
文件并将 css 更改为(注意相对路径开头的正斜杠之前也缺少
.
)解决了这个问题:

![Fig. 1 - Parameters to select](/images/Knit_with_params.png)

如果我从 R markdown 中的相对文件路径中删除

.
,它不喜欢它 - 我收到以下消息:

(No image at path /images/Knit_with_params.png)

.md
中的CSS看起来仍然与以前完全相同,但是HTML预览不再显示图像,并且无论哪种方式(有或没有
.
)只要有CSS并且不是相对文件路径渲染
.md
。,该图像在存储库的 README 页面上不可见。

这让我想到两个问题:

  1. 为什么 markdown 中的 css 在 Azure Devops 存储库中不起作用?
  2. 有没有办法将 R markdown 渲染为
    .md
    但保持图像的相对文件路径不变,而不是将它们转换为 css,或者我是否必须手动进入
    .md
    并每次将它们更改回来我更新自述文件?
css azure-devops r-markdown repository github-document
1个回答
0
投票

从 Rmd 生成 markdown 文件时,我可以重现相同的外观。

对于第一个查询,DevOps markdown 中不支持 css,如官方文档中所述,需要对图像使用以下语法:

![Text](URL)

例如:

Relative path: ![Image alt text](./image.png)
Absolute path in Git: ![Image alt text](/media/markdown-guidance/image.png)

对于第二个查询,您可以尝试使用原始 Markdown 块来包含图像,它会将内容视为原始 Markdown。

我的Rmd 文件:

enter image description here

生成的md文件

enter image description here

© www.soinside.com 2019 - 2024. All rights reserved.