content-management-system - 静态站点生成器 : page1/index. md 或 page1.md 的推荐做法是什么？

Question

在静态站点生成器中组织源文件以生成页面的推荐方法是什么？ (我正在使用 Eleventy，但这可能对其他 SSG 有用)

pages
├── page1
         ├── index.md
├── page2
         ├── index.md

或

pages
├── page1.md
├── page2.md

两个目录结构都应该(或可以)在最终站点中生成以下结构:

pages
├── page1
         ├── index.html
├── page2
         ├── index.html

Answer 1

这两种方式都可以在 Eleventy 中使用，所以这完全取决于您更喜欢哪种方式，哪种方式最适合您排列文件和目录的方式，等等 ( https://www.zachleat.com/web/introducing-eleventy/#directory-structure-flexibility )。

在其他 SSG 中——特别是 Gatsby、Gridsome 和 Hugo——需要记住的一个因素是，您想要特殊处理的图像最好位于与 Markdown 或“调用”它们的其他内容文件相同的目录中，因为相应的插件或管道需要相对文件路径:

• Gatsby:“如果使用的任何 [image] 路径未解析为文件[，] Gatsby 将不会创建子节点，而是将 [path] 值保留为字符串。” (https://www.orangejellyfish.com/blog/a-comprehensive-guide-to-images-in-gatsby/)

• Gridsome — “Gridsome 仅压缩本地相对图像路径。” (https://gridsome.org/docs/images/)

• Hugo —“图像是页面资源，下面列出的 [图像] 处理方法对/static 文件夹内的图像不起作用 [原文如此]。” (https://gohugo.io/content-management/image-processing/)

然而，Eleventy 并没有考虑这一点。