Это гид по разделу статей: редактор, модерация, предпросмотр и публичный доступ уже работают.
Зачем нам отдельный раздел
Записи в блоге — это короткие заметки: что-то нашли, что-то починили, что-то запустили. Они хорошо работают как лента, но в них тесно, когда хочется рассказать историю целиком: как устроен проект, почему мы приняли такое решение, что сломалось по дороге и что из этого вышло.
Статьи — это формат для длинных текстов. Не «ещё один блог», а место, где можно разложить мысль по полкам: с подзаголовками, оглавлением, картинками, кодом и ссылками на источники. Здесь будут девлоги, разборы, гайды, истории проектов и материалы о том, как мы делаем игры, код и визуал.
Как это работает
Для автора
Автор пишет статью в личном кабинете, в разделе «Мои статьи». Редактор — обычный Markdown: заголовки, списки, цитаты, код, таблицы и ссылки. Рядом — живой предпросмотр, чтобы не отправлять «кота в мешке».
У статьи есть несколько полей:
- Заголовок — о чём текст, без кликбейта.
- Подзаголовок — одно предложение, которое объясняет суть.
- Серия — если материал часть цикла: «как мы делали», «разбор проекта», «заметки о железе».
- Теги — чтобы читатель мог найти связанные тексты.
- Обложка — картинка 1200×630. Можно загрузить свою или сгенерировать из заголовка и тезисов.
- Текст — Markdown с предпросмотром.
- Отложенная публикация — если материал должен выйти в конкретное время.
Черновик можно сохранять сколько угодно. Когда текст готов, автор отправляет его на проверку. После этого статья попадает к админу: он читает, одобряет или возвращает с причиной. Автор видит статус и уведомление.
Для читателя
Готовая статья открывается на отдельной странице. Внутри:
- оглавление по заголовкам;
- время чтения;
- обложка, автор, серия и теги;
- аккуратно отформатированный Markdown: код, таблицы, цитаты, ссылки;
- блок связанных материалов;
- счётчик просмотров.
Карточки статей появляются в отдельном списке /articles/; блог остаётся для коротких заметок. Для поисковиков — нормальные заголовки, описание, JSON-LD и sitemap. Никаких «статья в статье» и бесконечных простыней: длинный текст должен оставаться читаемым.
Что уже готово
Если честно, большая часть механики уже собрана:
- редактор статей с Markdown и предпросмотром;
- черновики, отправка на проверку, одобрение и отклонение с причиной;
- предпросмотр по секретной ссылке — можно показать текст человеку до публикации;
- обложки 1200×630 и генератор из заголовка;
- страница статьи с оглавлением, временем чтения и JSON-LD;
- отдельный список статей на
/articles/; - уведомления автору о статусе.
Раздел открыт для читателей: опубликованные статьи видны в списке, в sitemap и по прямой ссылке. Черновики и материалы на проверке доступны только по ссылке предпросмотра.
Что ещё в работе
- Развивать кабинет автора: история версий, удобные статусы, правки.
- Доделать обложки и красивые превью для соцсетей.
- Добавить обсуждения под статьями — без превращения в ещё один чат.
- Собрать серию: материал о сайте, о ботах, о том, как мы делаем демо.
Правила раздела
Мы хотим, чтобы статьи были интересными, а не «ещё одним способом что-то объявить». Поэтому:
- Одна статья — одна мысль. Если мыслей три, будет три статьи или серия.
- Источники и детали. Если пишем про технологию, инструмент или чужой проект — даём ссылку.
- Без секретов. Пароли, токены, приватные данные и внутренние адреса в текст не попадают.
- Проверка перед публикацией. Ничего не публикуется автоматически: сначала черновик, потом проверка.
- Живой язык. Можно шутить, можно сомневаться, можно рассказывать, как что-то сломалось. Нельзя — писать канцеляритом.
Как предложить тему
Если у тебя есть идея статьи — напиши в кабинет (если ты участник), в Telegram-канал, на почту или через кнопку «Сообщить о проблеме». Можно коротко: тема, зачем она нужна и что читатель вынесет. Мы поможем с структурой, обложкой и публикацией.
Статус: раздел открыт. Редактор, модерация, предпросмотр и публичная часть работают. Статья живая — её можно дополнять.
