Какую практику рекомендуется использовать с генераторами сайтов stati c: page1 / index.md или page1.md? - PullRequest
Новая
       60

Какую практику рекомендуется использовать с генераторами сайтов stati c: page1 / index.md или page1.md?

2 голосов
/ 15 января 2020

Каков рекомендуемый способ организации исходных файлов в генераторе сайтов stati c для создания страниц? (Я использую Eleventy, но это может быть полезно для других SSG) 

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

или 

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

Обе структуры каталогов должны (или могут) генерировать следующую структуру в финале сайт: 

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

1 Ответ

2 голосов
/ 15 января 2020

Любой способ работает в Eleventy, так что все зависит от того, какой путь вы предпочитаете, какой лучше всего подходит для организации файлов и каталогов и т. Д. (https://www.zachleat.com/web/introducing-eleventy/#directory -structure-compatibility ) ).

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

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

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

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

Однако это не относится к Eleventy.

...