将图像放入.rst的语法

时间:2018-01-12 20:45:50

标签: python markdown restructuredtext pelican

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

当我拥有它时,一切正常。

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

所有这些只会在包含在降价文件中时显示为文本,并且不会生成图像。我在这里缺少什么?

1 个答案:

答案 0 :(得分:3)

Pelican支持Markdown和ReStructuredText文档。 Markdown文档使用.md文件扩展名,ReStructuredText文档使用.rst文件扩展名。如果您使用的是.rst个文件,那么只有ReStructuredText语法才有效。如果要使用Markdown语法,则需要使用具有相应文件扩展名(.md)的Markdown文件。

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