Тип записи “Статья”

Статьи — полезны для связанного контента (имеет дату и категорию).

Статьи создаются в каталоге _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>