静态站点生成器的推荐做法是什么:page1/index.md 或 page1.md?
What is the recommended practice with static site generators: page1/index.md or page1.md?
在用于生成页面的静态站点生成器中组织源文件的推荐方法是什么? (我正在使用 Eleventy,但这可能对其他 SSG 有用)
pages
├── page1
├── index.md
├── page2
├── index.md
或
pages
├── page1.md
├── page2.md
两种目录结构都应该(或可以)在最终站点中生成以下结构:
pages
├── page1
├── index.html
├── page2
├── index.html
这两种方式都适用于 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 的考虑因素。
在用于生成页面的静态站点生成器中组织源文件的推荐方法是什么? (我正在使用 Eleventy,但这可能对其他 SSG 有用)
pages
├── page1
├── index.md
├── page2
├── index.md
或
pages
├── page1.md
├── page2.md
两种目录结构都应该(或可以)在最终站点中生成以下结构:
pages
├── page1
├── index.html
├── page2
├── index.html
这两种方式都适用于 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 的考虑因素。