将图像放入 .rst 的语法

Question

我对将图像放入鹈鹕的降价语法工作感到困惑。

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

.. 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)

当包含在降价文件中时，所有这些都仅显示为文本，并且不会生成图像。我在这里错过了什么？

Answer 1

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

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