为Pelican站点编辑带有图像的标记文件

Question

有没有一种方法可以引用Markdown文件中的图像，使它们1)在编辑时正确预览，2)在Pelican处理时正确生成？

我尝试Pelican的全部原因是让它尽可能简单地使用各种编辑器在本地/离线编辑文件，而不必运行本地服务器。这些编辑器理解常见的图像语法，如下所示：

![Pelican](images/pelican.jpg)

但是为了让Pelican生成正确的路径，我必须使用：

![Pelican]({filename}/images/pelican.jpg)

编辑器不理解的，所以预览只显示破碎的图像。这并不理想。链接到具有完整地址的图像不起作用，因为我经常脱机工作。

有没有一些设置的组合--除了运行本地服务器，这对我在ipad/etc上编辑文件没有一点帮助--可以让我使用相同的图像标记来编辑和正确发布？

Answer 1

考虑到您所描述的用例，我认为唯一的解决方案是在本地和生产环境中URL路径都是相同的。例如，给定以下层次结构：

- content
    - images
        - dinosaur.jpg
    - posts
        - my-dinosaur.md

..。您可以通过以下方式从my-dinosaur.md中链接到该图像：

Title: My Dinosaur
Date: 2013-03-28
URL: /posts/my-dinosaur.html
Save_as: posts/my-dinosaur.html

Here is an image of my dinosaur:

![Pelican](../images/dinosaur.jpg)

在这种情况下，生成的HTML将包含指向图像的链接，如下所示：

<img src="../images/dinosaur.jpg" />

只要以下各项之间的相对位置：

图像源文档<-> image

• generated
• <->图像

..。都是一样的，上面的技术应该可以让你实现你的目标。

当然，根据您选择的产品URL结构，这可能是可行的，也可能是不可行的。如果您不想更改URL结构以匹配源内容组织结构，则在不运行本地服务器的情况下很难在两种环境中呈现图像。

Answer 2

在当前版本的Pelican中，{文件名}方法似乎不适用于图像。

下面是如何去做的：

从Pelican3.5开始，你可以使用{}标签将任何类型的文件附加到你的静态站点。内容文件夹的相对路径约定保持不变。

![MyImage]({attach}images/MyImage.jpg)

只要在你的Markdown文章中插入上面的短语，你就可以链接到图片的任何地方了。

让我知道这是怎么回事！

Answer 3

你可以在Markdown帖子中使用Jinja {{ SITEURL }}变量来引用图片：

![Pelican]({{SITEURL}}/images/pelican.jpg)

这应该可以解决(2)。但是，如果没有更多关于您正在使用的编辑器以及它们如何将图像路径转换为渲染图像的信息，就不可能知道这是否能解决问题(1)。