静态站点生成器的推荐做法是什么：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 — “图像是页面资源，下面列出的 [image] 处理方法不适用于 [sic] 您 /static 文件夹中的图像。” (https://gohugo.io/content-management/image-processing/)

然而，这不是 Eleventy 的考虑因素。