Как добавить запись

Запись — это файл .md или .mdx в папке языка: src/content/blog/ru-RU/, en-US/ или kk-KZ/. Имя файла становится адресом: ru-RU/how-to-write.md открывается как /ru-RU/posts/how-to-write/.

Поля

---
title: Заголовок записи
description: Одно-два предложения для карточки и поисковиков.
pubDate: 2026-10-03
category: product
tags:
  - guides
cover: ./images/cover.jpg
coverAlt: Что изображено на обложке
author: Имя автора
draft: true
---

Обязательны title, description, pubDate и category. Сборка упадёт с понятной ошибкой, если поле пропущено, категория не из списка или тег не из общего списка.

Категории и теги

Списки лежат в src/consts.ts. Категория — раздел ленты и страница /ru-RU/category/<ключ>/. Теги общие: один и тот же тег можно поставить записям из разных категорий. Страница тега открывается как /ru-RU/tag/<тег>/, а вместе с категорией — как /ru-RU/category/<категория>/<тег>/.

Поле tags необязательно. Пустой список и отсутствие поля значат одно и то же.

Обложки

Путь в cover указывается относительно файла записи. Растровые картинки при сборке сжимаются и нарезаются под разные экраны, SVG сохраняет векторный формат. Если обложки нет, карточка показывает нейтральную плашку с названием категории.

Черновики

Запись с draft: true видна только при локальном запуске и не попадает в сборку, ленту и RSS.