我在组织的 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 页面上不可见。
这让我想到两个问题:
.md
但保持图像的相对文件路径不变,而不是将它们转换为 css,或者我是否必须手动进入 .md
并每次将它们更改回来我更新自述文件?从 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 文件:
生成的md文件: