python - 将图像放入 .rst 的语法

Question

我对将图像放入 pelican 的 markdown 语法感到困惑。

当我有了这个，一切正常。

.. image:: /images/Rugby-Tackle.jpg
    :alt: About to make the tackle, Yale Alumni Game 2017

但我在 .rst 文档中发现了这一点。 pelican docs有很多这样的代码引用:

[![Alt Text]({filename}/images/Rugby-Tackle.jpg)]({filename}/images/Rugby-Tackle.jpg)

或者这个:

![Alt Text]({filename}/images/Rugby-Tackle.jpg)

所有这些内容在包含在 Markdown 文件中时仅显示为文本，并且不会生成图像。我在这里缺少什么？

Answer 1

Pelican 支持 Markdown 和 ReStructuredText 文档。 Markdown 文档使用 .md 文件扩展名，ReStructuredText 文档使用 .rst 文件扩展名。如果您使用 .rst 文件，则只有 ReStructuredText 语法才有效。如果要使用 Markdown 语法，则需要使用具有适当文件扩展名 (.md) 的 Markdown 文件。

您不能在同一文档中混合使用 Markdown 和 ReStructuredText 语法。如果您使用简单的格式，这可能不会立即明显，因为一些基础知识(如段落)在两者中的工作方式相同。但是，任何不同的语法都不会被理解。 Markdown 对 ReStructuredText 语法一无所知，而 ReStructuredText 对 Markdown 语法一无所知。