防止MyST改变.md图片路径

Question

我正在使用通过相对路径引用图像的 .md 文件生成 sphinx 文档：

.[](../_static/figures/image.png)

我使用 MyST 将 .md 文件解析为 html，但它删除了../'制作所有路径：

_static/figures/image.png 。

相对路径在文档生成之前工作正常并且必须保持不变。 在 sphinx 的conf.py中，我将图像复制为html_static_path文件，如果路径在 html 中保持相同，图像将显示。

MyST 文档state 它复制了 .md 图像，但没有提供用于复制的配置选项。 以下段落仅参考如何解析 HTML 带图像的文件。 我确实找到了另一个应该将所有链接都视为超链接的选项，但这并没有改变。

如何强制 MyST 不更改图像路径？

Answer 1

我认为这更像是一个约定俗成的问题。

建议将_static放在所有文件夹级别中，并在每个文件夹中分离图像等资产，以便像_static/figures/image.png这样的链接仅解析到该文件夹级别。

如果您想为所有文件夹级别使用单个顶级_static文件夹，那么您的链接应写为/_static/figures/image.png ，它们将在其中解析到顶级。