Тип записи “Статья”
Статьи — полезны для связанного контента (имеет дату и категорию).
Статьи создаются в каталоге _posts.
Для дальнейшего удобства к доступу статей желательно внутри каталога _posts создавать подкаталог с номером года, внутри него подкаталог с номером месяца статьи _posts/2023/09. Хотя это не обязательно.
Ссылка на тип записи “Статья” формируется основываясь на настройках конфигурационного файла _config.yml, параметр шаблона ссылки permalink: /blog/:name-:categories.html. Можно изменить как шаблон ссылки, так и саму ссылку в файле статьи.
Создание записи “Статья”
Тип записи “Статья” можно создать как вручную в каталоге _posts, так и через терминал используя команду.
# Создаст новую статью
# Статья создастся в каталоге _posts перенести ее в 2023/09 придется вручную
bundle exec jekyll post "My New Post"
После создания статьи не забудьте перенести ее в каталог с годом и месяцем статьи _posts/2023/09/2023-09-02-my-new-post.md.
Параметры записи “Статья”
Основные параметры для типа записи “Статьи”, так же можно дополнять пользовательскими параметрами.
---
# название шаблона
layout: base
# заголовок статьи
title: "Добро пожаловать в Jekyll!"
# дата добавления статьи
date: 2023-09-03 12:02:32 +0600
# описание статьи
description: Описание статьи про Jekyll
# изображение страницы используется для seo
image: /images/cover.jpg
# категория статьи
category: jekyll
# теги статьи
tags: [jekyll, html, css]
# статус публикации статьи
published: true
# выводить ссылку на статью в карте сайта
sitemap: true
# разделитель между анонсом и полным текстом
excerpt_separator: "<!--more-->"
---
Пример записи “Статья”
---
layout: base
title: "Добро пожаловать в Jekyll!"
date: 2023-09-03 12:02:32 +0600
description: Тестовая вступительная запись
image: /images/cover.jpg
category: jekyll
tags: [jekyll, html, css]
published: true
sitemap: true
excerpt_separator: "<!--more-->"
---
Тестовая вступительная запись
<!--more-->
Вы найдете этот пост в своем каталоге `_posts`. Отредактируйте его и перестройте сайт, чтобы увидеть изменения. Вы можете перестроить сайт разными способами, но наиболее распространенным способом является запуск `jekyll serve`, который запускает веб-сервер и автоматически восстанавливает ваш сайт при обновлении файла.
Jekyll требует, чтобы файлы сообщений блога имели имена в следующем формате:
`YEAR-MONTH-DAY-title.md`
Где `Год` — четырехзначное число, `Месяц` и `День` — двузначные числа, а `md` — это расширение файла, представляющее формат, используемый в файле. После этого добавьте необходимую вступительную часть. Взгляните на источник этого поста, чтобы получить представление о том, как это работает.
Jekyll также предлагает мощную поддержку фрагментов кода:
{% highlight ruby %}
def print_hi(name)
puts "Hi, #{name}"
end
print_hi('Tom')
#=> prints 'Hi, Tom' to STDOUT.
{% endhighlight %}
Проверьте [Jekyll docs][jekyll-docs] для получения дополнительной информации о том, как максимально эффективно использовать Jekyll. Сообщите обо всех ошибках/запросах на новые функции по адресу [Jekyll’s GitHub repo][jekyll-gh]. Если у вас есть вопросы, вы можете задать их на [Jekyll Talk][jekyll-talk].
[jekyll-docs]: https://jekyllrb.com/docs/home
[jekyll-gh]: https://github.com/jekyll/jekyll
[jekyll-talk]: https://talk.jekyllrb.com/
<picture>
<source srcset="/images/thumbnail/2023/09/welcome-to-jekyll/cover.webp" type="image/webp">
<img src="/images/thumbnail/2023/09/welcome-to-jekyll/cover.jpg" alt="">
</picture>