Одна з труднощів, яку я зазнав, коли спробуй пройти з Ворпреса в Джекілл фЯ повинен розуміти, для чого призначений кожен компонент і як вони взаємодіяли між собою. Я знайшов рішення, коли я перестав намагатися створити свій блог з нуля і почав робити інженерні переробки тему розроблений кимось іншим. Переваги відкритого коду.
Для початку, припустимо, що ви встановили передумови, які ми описали в попередніх статтях, давайте створимо наш сайт. Приклад - садівничий блог.
jekyll new blog_de_jardineria
Якщо ви перейдете до папки, ви побачите наступне:
- Папка під назвою _постів.
- Два файли із розширенням розмітки
- Веб-сторінка.
- Файл конфігурації з розширенням .yml, який ми детально обговоримо в наступній статті.
- Файл Gemfile, у якому перелічені компоненти сайту та інший однойменний файл, але з розширенням .lock, що запобігає випадкові зміни.
Структура проекту
Як і будь-який веб-сайт на основі WordPress, Jekyll також створює структуру папок, де зберігає всі файли, і робить це з тих самих причин. Дозвольте користувачеві впорядковувати файли впорядковано і в міру зростання проекту залишатись керованим.
Створюємо базову папку за допомогою команди jekyll new. Всередині нього ми знаходимо два типи папок; ті, що пов’язані з конфігурацією блогу, які позначені тире перед іменем (у нашому випадку папка _post та ті, що мають ресурси, які не будуть включені в процес створення. Наприклад, ті, що містять зображення.
Папки на основі вмісту
У цій групі сe зберігає вміст, призначений для відвідувачів сайту
_ допис
Папка _пост містить усі записи в блозі. Тут використовується дуже конкретний формат для кожного з файлів, які в ньому зберігаються. Ім'я файлу має бути у форматі ім'я файлу-дати - year-month-date-full_filename.md - і ця дата розміщення відображатиметься як дата створення цього допису в блозі Jekyll. Ми повинні мати на увазі, що хоча ця папка і називається _ повідомлень, ось весь вміст, який побачать читачі блогу, наприклад контактна форма або біографії авторів. Пізніше ми побачимо, що на сторінках можна призначити різні конструкції.
_проекти
Це еквівалентно збереженню чернетки WordPress. Його рекомендується використовувати для публікацій, які не готові до публікації, хоча їх можна використовувати для зберігання списків ідей, дизайнів для подальшого використання тощо.
_включає
У цьому просторі ми можемо зберігати html-код, який можна використовувати повторно кілька разів. Наприклад, у нашому випадку банер, що вітає початок сезону залежно від півкулі, в якій знаходиться користувач.
_розкладки
Як ми вже говорили вище, різні частини вмісту можуть потребувати різних макетів. Наприклад, щоб показати відео, ми можемо хотіти, щоб сторінка була однією колонкою, тоді як, якщо вона є запрошеним автором, нам знадобиться стовпець, щоб показати їх біографію та контактну інформацію. У цій папці зберігаються різні конструкції, які використовуватиме сайт.
Інформаційні папки
Ці дві папки використовуються сайтом для його роботи.
_дані
У приватному щоденнику файл конфігурації може зберігати всі необхідні дані. Але якщо у нас є блог із багатьма авторами, потрібен інший спосіб управління інформацією. Папка _дані Він використовується для зберігання даних у форматах JSON або CSV, які сайт може отримати відповідно до взаємодії з користувачами.
_якщо ви
Папка _якщо ви Сайт доповнює його всією інформацією, доступною в попередніх папках. Тут ми знайдемо сайт, який ми завантажимо на сервер, щоб користувачі мали доступ. Звичайно, оскільки це html та css-код, можна внести зміни до нього, як і до будь-якого іншого веб-сайту.
У наступній статті ми почнемо модифікувати файл конфігурації.