在 Jekyll markdown 集合中包含图像

Question

我在我的 Jekyll 配置中创建了一个自定义集合：

collections:
  tutorials:
    output: true
    permalink: /tutorials/:path/

我有一个降价文件，路径为：_tutorial/category/ios.md 我还有一张图片，路径为：_tutorial/category/xcode.png

在ios.md中我使用： ![xcode](xcode.png)

这应该是有道理的，因为它们在同一个目录中。

在_site生成的文件夹中，我看到

tutorial/
  category/
    xcode.png
    ios/
      index.html

很明显，生成的 HTML 正在查找图像的错误位置，因为它们不再位于同一目录中。

我想改变我的结构，让我的 markdown 文件成为 _tutorial/category/ios/index.md，但是它所做的只是创建一个名为 index 的文件夹，所以问题是一样的。

在 Jekyll/Markdown 中包含图像的预期方式是什么？

我是否应该将它们全部保存在网站根目录下的一个文件夹中？这显然可行，但很难跟踪哪些图像与每个 post...

相关联

Answer 1

因为你的 collection 有一个 permalink 以斜线结尾:

permalink: /tutorials/:path/

Jekyll 会将您的 Markdown 文件转换为 index.html 文件，使 link 更漂亮。所以 ios.md 变成 ios/index.html.

您可以通过使用带有扩展名的 link 来完全避免这个问题。这是the default option。注意没有尾部斜线：

permalink: /tutorials/:path

如果您仍然想要 extension-free links，那么为了使相对图像路径起作用，您可以将 Markdown 向上移动一个目录：

ios.md
ios/
  xcode.png

或将图片路径更改为![xcode](../xcode.png)。这两种方法似乎 counter-intuitive.

Include image in Jekyll markdown collection