Jekyll, minima: Использование уценки для главной страницы

Проблема

Я создаю статический сайт, используя Jekyll и Минимальная тема. Я редактирую index.md, меняю домашнюю страницу, но вижу странный комментарий вверху файла:

---
# You don't need to edit this file, it's empty on purpose.
# Edit theme's home layout instead if you wanna make some changes
# See: https://jekyllrb.com/docs/themes/#overriding-theme-defaults
layout: home
---

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

Структура каталогов

index.md
_layouts
├── default.html
├── home.html
├── page.html
└── post.html

Мой вопрос

Является ли изменение index.md правильным способом добавления содержимого на домашнюю страницу Jekyll?


jekyll markdown website-homepage
person Adam Matan    schedule 02.01.2018    source источник

Ответы (1)


arrow_upward
2
arrow_downward

Кто-то, кто начинает с Jekyll, может смутиться, увидев (почти) пустой файл index.md. Ключевым моментом здесь является то, что он использует домашний макет, расположенный по адресу _layouts/home.html, и именно там находится код.

В приведенном выше примечании просто говорится, что если вы хотите внести некоторые изменения в домашнюю страницу, обратитесь к файлу макета, а не стройте структуру домашней страницы в этом файле.

Если вы добавите контент под вторым ---, он появится на главной странице, потому что _layouts/home.html содержит {{ content }}.

Подводя итог, если вы просто добавляете некоторый контент и довольны тем, куда его помещает шаблон, то вам нечего менять, если вы хотите, чтобы контент отображался где-то еще или изменил структуру, отредактируйте файл шаблона home.html.

person marcanuy    schedule 02.01.2018