2026-09-01

Как добавить статью

Статьи — это обычные Markdown-файлы, которые компилируются в сайт на этапе сборки. Никакого отдельного генератора и docker cp не нужно: добавили файл — пересобрали фронтенд.

Шаг 1. Создайте файл

Положите новый файл в папку frontend/content/articles/ с расширением .md.

Файл должен начинаться с блока метаданных (front-matter):

---
slug: my-article
title: Моя статья
date: 2026-09-01
description: Краткое описание для списка.
order: 5
---

# Заголовок статьи

Текст в формате Markdown...

slug — адрес страницы (/articles/my-article);
title — заголовок;
date — дата (для сортировки);
description — описание в списке;
order — порядок в списке (меньше — выше).

Шаг 2. Пересоберите фронтенд

cd frontend
npm run build

При сборке Markdown-файлы из content/articles/ автоматически собираются в список статей и страницы /articles/* пререндерятся в статический HTML (та же сетка, что и у остального сайта).

Локальная проверка

cd frontend
npm run dev        # статьи сразу в dev-режиме
npm run preview    # проверить прод-сборку (после npm run build)

Поддерживаемый Markdown

Заголовки #–######;
жирный, курсив, код;
Списки - и 1.;
Ссылки и картинки;
Блоки кода ` ` `;
Цитаты > и разделители ---.

Готово! Статья доступна на /articles/my-article.