Что рекомендуется делать с генераторами статических сайтов: 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/).

В других SSG, особенно Gatsby, Gridsome и Hugo, следует иметь в виду, что изображения, для которых требуется специальная обработка, лучше всего размещать в тех же каталогах, что и Markdown или другие файлы содержимого, которые их "называют", как относительный файл. пути требуются соответствующими плагинами или каналами:

• Гэтсби: "Если какой-либо из используемых путей [image] не разрешается в файл [,] Gatsby не будет создавать дочерние узлы, вместо этого оставив значение [path] в виде строки". (https://www.orangejellyfish.com/blog/a-comprehensive-guide-to-images-in-gatsby/)

• Gridsome - "Только локальные относительные пути изображений будут сжиматься Gridsome". (https://gridsome.org/docs/images/)

• Хьюго: "Изображение является ресурсом страницы, и перечисленные ниже методы обработки [изображения] не работают [sic] с изображениями в вашей папке / static". (https://gohugo.io/content-management/image-processing/)

Однако это не вопрос Eleventy.