将图像放入 .rst 的语法

Syntax to put images in .rst

我对将图像放入 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)

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

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

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