Как я могу просматривать несколько исходных каталогов в Jekyll?

Я почти уверен, что видел в проектах блога Jekyll несколько каталогов исходных документов, таких как _posts и _pages, но параметр source в файле _config.yml может принимать только 1 каталог в качестве аргумента, а не массив или пробел. строка каталогов работает.

Я неправильно понимаю значение параметра source? Я ожидаю, что часы будут использовать его, чтобы указать, какие изменения файлов вызовут сборку и какие файлы нужно построить.

Кроме того, у меня есть такие фрагменты, как about.md, которые можно включить в другие страницы. Какое лучшее место для таких файлов?


jekyll jekyll-extensions
person Keith Bennett    schedule 03.04.2018    source источник

Ответы (2)


arrow_upward
1
arrow_downward

Конфигурация source относится к вашему <project_root>, а не к отдельным каталогам в корне проекта. По умолчанию он установлен в ваш текущий_каталог (местоположение, из которого вы запускаете jekyll build (or) serve.

Jekyll по умолчанию отслеживает все вложенные файлы и каталоги глубоко в исходном каталоге.

about.md не следует рассматривать как фрагмент для включения в другие файлы. Это полноценная «страница», которая будет отображаться в _site/about.html или _site/about/index.html в зависимости от настроек вашей постоянной ссылки.

Фрагменты, которые должны быть включены в другие страницы, находятся внутри каталога _includes и вставляются с помощью конструкции Liquid {% include <fragment-filename>.html %}.

Каталоги, за исключением _layouts, _includes и _sass, Jekyll игнорирует каталоги, начинающиеся со знака подчеркивания, если только вы не настроили Jekyll так, чтобы они отображались как «коллекции». _posts — это предопределенный и жестко запрограммированный каталог коллекций.

Для получения дополнительной информации о Jekyll см. официальную документацию по адресу https://jekyllrb.com.

person ashmaroli    schedule 03.04.2018

arrow_upward
0
arrow_downward

Если кто-то, как и я, хочет включить несколько исходных папок в github-pages, вы можете просто настроить корень jekyll в github-page в ветке master. т.е. ни в ветке gh-page, ни в папке docs.

Таким образом обрабатывается вся папка. README.md обрабатываются как index.md, и вы можете легко сделать относительные ссылки из основного README.md в корне на любой другой документ, который находится «ниже» его в файловой иерархии. Таким образом, jekyll покрывает всю вашу документацию по коду.

person Juh_    schedule 26.08.2019