eleventy

https://www.11ty.dev/docs/config/

• .eleventy.js в корне проекта. Самый основной конфиг.
  В нем, в числе прочего, указывается, где что искать. Каталог источников (в том числе layouts, includes и data могут быть в отдельных подкаталогах) и каталог результатов.
• при установке eleventy образуются каталог node_modules и файлы package.json и package-lock.json. Node-modules, как и каталог с результатами – хранить не обязательно, если есть интернет и исходные данные.
  • Что интересно, в package.json можно вписать раздел scripts (https://docs.npmjs.com/cli/v10/using-npm/scripts), и использовать его примерно как Makefile. In addition to the shell's pre-existing PATH, npm run adds node_modules/.bin to the PATH provided to scripts. Any binaries provided by locally-installed dependencies can be used without the node_modules/.bin prefix. Scripts are run from the root of the package folder, regardless of what the current working directory is when npm run is called. If you want your script to use different behavior based on what subdirectory you're in, you can use the INIT_CWD environment variable, which holds the full path you were in when you ran npm run.
    Это фишка npm, не eleventy, понятно. Заметила у https://randomgeekery.org/post/2022/01/building-my-eleventy-site/.
• там же могут жить всякие настроечные файлы для редактора, .git и прочие полезности, которые нужны, но не исходник сайта непосредственно.

• В начале frontmatter, который по умолчанию yaml, но может быть json, js (JavaScript object literals in front matter) и другие варианты — https://www.11ty.dev/docs/data-frontmatter/
  • Если заморочиться сильнее, то https://www.11ty.dev/docs/data-frontmatter-customize/ говорит, что eleventy использует gray-matter npm package, и можно сделать уйму всего интересного с учетом этого. В том числе использовать javascript в более свободном виде. Использовать toml. Вроде бы даже определить свои «языки» для этого.
    • Можно указать разделитель, чтобы получить excerpts from content, то, что позволяет начало страницы до разделителя как-то иначе показывать (и мне теперь интересно, насколько реально в странице со списком записей из блога показывать кроме названия еще и такой excerpt, если он есть). Мне такая возможность помнится еще по вордпрессу, кажется приятной.
  • permalink and eleventyComputed front matter values can contain variables and shortcodes like you would use in the body of your templates. If you need to use variables or shortcodes in other front matter values, use eleventyComputed to set them.
  • Можно задать вручную язык шаблона для обработки конкретно этого файла, например templateEngineOverride: njk, а templateEngineOverride: false заставит скопировать содержимое без изменений.
• Дальше основное содержание. Ряд вариантов языков. Вроде бы, можно указать свой и обработчик для него. https://www.11ty.dev/docs/languages/custom/.

– https://www.11ty.dev/docs/layouts/ – «макет» страницы.

• You can use any template language in your layout file—it doesn’t need to match the template language of the content: an ejs template can use a njk layout.
• Layouts can contain their own front matter data! It’ll be merged with the content’s data on render. Content data takes precedence, if conflicting keys arise.
• https://www.11ty.dev/docs/layouts/#layout-aliasing - как сказать, что layout, указанный во frontmatter файла, означает, что надо обращаться к вот этому файлу с layout-ом. Условно, там указано post, и с этим надо ходить в posts-from-my-very-old-blog.njk. :))
• Из них можно делать цепочку независимо от возможностей конкретного языка шаблонов — https://www.11ty.dev/docs/layout-chaining/. Есть одно место для вставки содержимого, которое content. И eleventy как-то смерживает данные из frontmatter-ов, куда тож много что можно засунуть :) Ну, и возможности используемого языка никуда не деваются :))

• https://www.11ty.dev/docs/data-computed/ — специфическая штука, которую можно засунуть в js-файлы, и оно будет приоритетно. Типа, вычисляем недостающее из имеющегося — вот так.

• Глобальные, применяются ко всему проекту. https://www.11ty.dev/docs/data-global/. Но находятся на последнем месте по приоритету в «каскаде». Типа, если ничего не нашлось приоритетнее, то берем отсюда.

  • «One way to create global data is through global data files: JSON and JavaScript files placed inside of the global data folder. The global data folder is placed inside the project's input directory (set by the dir.input configuration option), and the name of the global data folder is set by the dir.data configuration option (_data by default). All *.json and module.exports values from *.js files in this directory will be added into a global data object available to all templates.»
  • https://www.11ty.dev/docs/data-global-custom/ «global data can be added to the Eleventy config object using the addGlobalData method. This is especially useful for plugins. The first value of addGlobalData is the key that will be available to your templates and the second value is the value of the value returned to the template». На странице есть ряд примеров — значение, функция, promise, асинхронная функция. Чуть приоритетнее предыдущих, кажется.
  • Каталожные. Относятся к содержимому конкретного каталога. Типа, к условному posts/subdir/my-first-blog-post.md будут относиться posts/subdir/subdir.11tydata.js и posts/posts.11tydata.js, аналогично для *.11tydata.json и *.json. Ближе к файлу — приоритетнее.
  • Околофайловые. Относятся к одноименному файлу. Типа, к условному posts/subdir/my-first-blog-post.md можно поскладывать всякого интересного в файлы рядышком posts/subdir/my-first-blog-post.11tydata.js, posts/subdir/my-first-blog-post.11tydata.json, posts/subdir/my-first-blog-post.json. Приоритетнее только то, что внутри и в шаблоне-layout файла. :)

Содержимое образуется в ней. Кажется, временами стоит чистить от того, что не нужно.