﻿---
title: "Справочник настроек: страница статьи"
description: "Полный справочник frontmatter статей, глобальных переключателей и локализованных сообщений с типами, стандартами, примерами и состоянием."
url: "https://demo.anglefeint.com/ru/blog/config-article/"
language: "ru"
author: "Anglefeint"
published: "2026-11-13T00:00:00.000Z"
updated: "2026-11-14T00:00:00.000Z"
---

# Справочник настроек: страница статьи

**Примечание о версии:** Реакция на изменение уменьшения движения и согласованные ключи автора/изображения доступны с 0.36.1; в 0.36.0 этих исправлений нет.

[Назад к общему справочнику](https://demo.anglefeint.com/ru/blog/config-reference/). Сначала различайте файл: глобальные функции/тексты — `src/site.config.ts`, заголовок, даты, изображения и статистика статьи — frontmatter Markdown/MDX. Не меняйте их местами.

Описан стандартный маршрут пакета. Он создаёт страницы включённых языков, оглавление, статистику, переводы и до трёх других статей по реальному контенту. Прямой пользовательский вызов BlogPost должен сам передать атрибуты: всё поведение маршрута автоматически не появляется.

## 1\. Глобальные переключатели

Поля theme в site.config, все `boolean` со стандартом `true`. Примеры объединяются с theme по необходимости, это не предложение выключить всё.

| Полный путь | Действие и условия | Ограничения и пример |
| --- | --- | --- |
| `theme.toc.enabled` | Оглавление из Markdown h2/h3 компилятора, скрыто без заголовков | toc true/false статьи приоритетнее; компоненты/сырой HTML не собираются; `toc: { enabled: false }` |
| `theme.math.enabled` | Математика Markdown/MDX, CSS только при маркерах формул | Глобально, индивидуального math нет; ошибка формулы ломает компиляцию, отключение меняет парсинг; `math: { enabled: false }` |
| `theme.effects.enableRedQueen` | Боковой монитор Red Queen | false не выключает сеть фона, Canvas обложки и всю AI-атмосферу; `effects: { enableRedQueen: false }` |
| `theme.search.enabled` | Вход/индекс; [поиск](https://demo.anglefeint.com/ru/blog/config-search/#enabled) | search false статьи исключает, true не обходит глобальный false; `search: { enabled: false }` |
| `theme.tags.enabled` | Ссылки статьи и страницы тегов | false не удаляет tags; `tags: { enabled: false }`, [списки](https://demo.anglefeint.com/ru/blog/config-blog-list/#tags-enabled) |
| `theme.socialImage.enabled` | Автопревью 1200×630 без явного ogImage | false сохраняет ручной ogImage, откатывает к обложке/стандарту, не скрывает обложку страницы; `socialImage: { enabled: false }` |

Все условны по контенту, области и приоритетам. Например, только стандартное оглавление:

```ts
theme: { toc: { enabled: false } },
```

h3 вкладываются в h2, отдельные h3 тоже входят. h4 и глубже нет. Текст появляется сразу, оглавление не обязательный этап ожидания.

## 2\. Связанные автор, подписи, превью и комментарии

Общие модули, здесь влияние на статью:

| Полный путь | Влияние | Основное описание |
| --- | --- | --- |
| `site.author` | Запасной автор при отсутствии/пробелах author, также автопревью | [Идентичность](https://demo.anglefeint.com/ru/blog/config-site-chrome/#identity) |
| `theme.enableAboutPage` | Если включён и автор равен автору сайта, ссылка на About языка; иначе текст | [About](https://demo.anglefeint.com/ru/blog/config-about/#page-enabled) |
| `theme.footer.showCredits` | Подпись темы в автопревью, не custom-изображениях | [Подвал](https://demo.anglefeint.com/ru/blog/config-site-chrome/#footer) |
| `site.ogImage` | Запасная картинка без более приоритетной | [Идентичность/картинки](https://demo.anglefeint.com/ru/blog/config-site-chrome/#identity) |
| `theme.comments.enabled` | Нужны полное подключение и mapping; индивидуального frontmatter нет | [Giscus](https://demo.anglefeint.com/ru/blog/config-comments/#controls) |

## 3\. Поля статьи: не в site.config

Все 22 поля frontmatter, не новые site.config-поля. Типы начинаются с ввода автора: даты становятся Date, локальные картинки — метаданными.

### Контент и метаданные

| Поле | Тип и стандартное поведение | Действие, ограничения и пример |
| --- | --- | --- |
| `title` | Обязательная string без стандарта | Заголовок/метаданные, не название сайта; `title: 'Мои заметки'` |
| `description` | Обязательная string без стандарта | Метаописание и context при отсутствии; не весь текст; `description: 'Заметки об отладке.'` |
| `pubDate` | Обязательная разбираемая дата | Публикация/порядок/метаданные, показ UTC; будущее не скрывает; `pubDate: '2026-11-13'` |
| `updatedDate` | Необязательная дата, отсутствует | Дата обновления/приоритет sitemap, не порядок; `updatedDate: '2026-11-14'` |
| `author` | Необязательная string, отсутствие/пробелы — автор сайта | Страницу автора не создаёт; `author: 'Другой автор'` |
| `subtitle` | Необязательная string, отсутствует | Подзаголовок без дубля совпадающего context; `subtitle: 'От симптома к причине'` |
| `context` | Необязательная string, иначе description | Под заголовком, ‘’ скрывает без очистки метаописания; `context: 'Решить конкретную задачу.'` |
| `tags` | Необязательный string\[\], иначе без тегов | Ссылки зависят от глобального; `tags: ['astro', 'заметки']` |
| `heroImage` | Необязательный локальный путь, иначе без обложки | Не удалённый/public URL по тем же правилам; `heroImage: ./cover.jpg` с готовым файлом |
| `ogImage` | Необязательный локальный/public/HTTPS, иначе приоритеты превью | Не меняет обложку текста; `ogImage: /images/share.png` с файлом |
| `toc` | Необязательный boolean, глобальное наследование | true обходит глобальный false, но без заголовков скрыто; `toc: false` |
| `search` | Необязательный boolean, true | false исключает только внутренний поиск, не статьи/RSS/sitemap/AI; `search: false` |

Начните с обязательного и дополните:

```yaml
---
title: 'Мои заметки'
description: 'Заметки об отладке.'
pubDate: '2026-11-13'
subtitle: 'От симптома к причине'
context: 'Решить конкретную задачу.'
tags: ['astro', 'заметки']
toc: true
search: true
---
```

Нет draft, расписания, comments, Red Queen или math одной статьи. Неготовое держите вне каталога контента, неизвестное поле не контроль приватности.

### Статистика OUTPUT и статусы

| Поле | Тип и стандартное поведение | Действие, ограничения и пример |
| --- | --- | --- |
| `wordCount` | Необязательное неотрицательное целое, иначе подсчёт исходного текста | Независимое число, не меняет tokenCount; `wordCount: 800` |
| `tokenCount` | Необязательное неотрицательное целое, иначе round(max(автоматический подсчёт слов, 1) × 1.3) | Оценка, не токенизатор/расход; `tokenCount: 1040` |
| `aiModel` | Необязательная string, иначе без ярлыка | Статус заголовка/OUTPUT, без проверки модели; `aiModel: 'Название модели, указанное автором'` |
| `aiMode` | Необязательная string, иначе без ярлыка | Только режим, не выполнение; `aiMode: 'notes'` |
| `aiState` | Необязательная string, иначе без ярлыка | Только текст, не здоровье сервиса; `aiState: 'edited'` |

Автоподсчёт убирает часть Markdown/кода/ссылок; CJK, кана и корейский посимвольно, остальное преимущественно по пробелам. Формулы/MDX могут влиять. wordCount не пересчитывает tokenCount. От 1000 формат одной десятичной k без изменения исходного значения.

```yaml
wordCount: 800
tokenCount: 1040
aiModel: 'Название модели, указанное автором'
aiMode: 'notes'
aiState: 'edited'
```

### Совместимые и сейчас неиспользуемые поля

| Поле | Тип и стандарт | Состояние, ограничения и пример |
| --- | --- | --- |
| `readMinutes` | Необязательное положительное целое, отсутствует | Совместимость, время чтения не показывается; `readMinutes: 3` не возвращает |
| `aiLatencyMs` | Необязательное неотрицательное целое, отсутствует | Совместимость, задержка не показывается; `aiLatencyMs: 150` не измерение |
| `aiConfidence` | Необязательный number 0–1, отсутствует | Совместимость, уверенность не показывается; `aiConfidence: 0.9` не оценка точности |
| `canonicalTopic` | Необязательная string, отсутствует | Сейчас не используется; `canonicalTopic: 'astro'` не создаёт тему/canonical |
| `sourceLinks` | Необязательный массив адресов, отсутствует | Только проверка/нормализация HTTP(S), голый домен получает https; `sourceLinks: ['https://example.com/']` не показывает источники/экспорт |

Для читателя укажите Markdown-ссылки в тексте. Принятый старый тип не подтверждает оставшийся UI; ради обновления удалять данные не требуется.

## 4\. Тексты интерфейса статьи

Префикс `i18n.locales.<locale>.messages.blog`. Необязательные string с обычным откатом; ниже настоящие встроенные упрощённый китайский/английский. Пример — член blog, не frontmatter.

Действующие тексты условны при области. Пустота может очистить label, не скрыть функцию; доступные имена не очищайте. Неиспользуемые эффекта не имеют.

| Поле | Стандарт упрощённого китайского / английского | Действие и ограничения | Состояние | Пример члена |
| --- | --- | --- | --- | --- |
| `rqBadge` | 监视器信号 / monitor feed | Значок включённого Red Queen, не настоящий мониторинг | Условно | `rqBadge: "Сигнал монитора"` |
| `rqReplayAria` | 重放监视器信号 / Replay monitor feed | Имя повтора, не материал/стратегия | Условно | `rqReplayAria: "Повторить сигнал монитора"` |
| `backToTop` | 返回顶部 / Back to top | Имя наверх, показ по прокрутке | Условно | `backToTop: "Наверх"` |
| `toastP10` | 语境解析 10% / context parsed 10% | Ранний прогресс чтения, не AI-запрос | Условно | `toastP10: "Контекст разобран: 10%"` |
| `toastP30` | 语境解析 30% / context parsed 30% | Чтение, не результат семантического анализа | Условно | `toastP30: "Контекст разобран: 30%"` |
| `toastP60` | 推理稳定 60% / inference stable 60% | Чтение, не состояние вывода модели | Условно | `toastP60: "Рассуждение стабильно: 60%"` |
| `toastDone` | 输出完成 / output finalized | Завершение чтения, не доказательство генерации/проверки | Условно | `toastDone: "Вывод завершён"` |
| `metaPublished` | 发布 / published | Метка даты, не дата | Условно | `metaPublished: "Опубликовано"` |
| `metaAuthor` | 作者 / by | Метка автора, не значение | Условно | `metaAuthor: "Автор"` |
| `metaUpdated` | 更新 / updated | Перед updatedDate при наличии | Условно | `metaUpdated: "Обновлено"` |
| `systemStatusAria` | 模型状态 / Model status | Доступное имя статуса, нужен хотя бы один статус | Условно | `systemStatusAria: "Состояние модели"` |
| `systemModelLabel` | 模型 / model | Метка aiModel, также OUTPUT | Условно | `systemModelLabel: "Модель"` |
| `systemModeLabel` | 模式 / mode | Метка aiMode | Условно | `systemModeLabel: "Режим"` |
| `systemStateLabel` | 状态 / state | Метка aiState | Условно | `systemStateLabel: "Состояние"` |
| `promptContextLabel` | 语境 / Context | Метка непустого context | Условно | `promptContextLabel: "Контекст"` |
| `heroMonitor` | 神经监视器 / neural monitor | Надпись монитора при heroImage | Условно | `heroMonitor: "Нейронный монитор"` |
| `heroSignalSync` | 信号同步中 / signal sync active | Статическое украшение, не синхронизация | Условно | `heroSignalSync: "Синхронизация сигнала"` |
| `heroModelOnline` | 模型在线 / model online | Статический ярлык, не проверка сервиса | Условно | `heroModelOnline: "Модель подключена"` |
| `toc` | 文章目录 / On this page | Имя оглавления при включении/заголовках | Условно | `toc: "Список статей"` |
| `responseOutput` | 输出 / Output | Имя OUTPUT, не контент | Условно | `responseOutput: "Вывод"` |
| `statsWords` | 词 / words | Метка количества, не число | Условно | `statsWords: "Слова"` |
| `statsTokens` | 令牌 / tokens | Метка tokens, не оценка | Условно | `statsTokens: "Токены"` |
| `copySectionLink` | 复制本节链接 / Copy section link | Имя копирования h2/h3, не алгоритм якорей | Условно | `copySectionLink: "Копировать ссылку на раздел"` |
| `regenerate` | 重播扫描 / Replay scan | Повтор сканирования, только визуальный | Условно | `regenerate: "Повторить сканирование"` |
| `relatedAria` | 相关文章 / Related posts | Доступное имя при других статьях | Условно | `relatedAria: "Похожие статьи"` |
| `related` | 相关文章 / Related | Заголовок, не рекомендации | Условно | `related: "Похожие статьи"` |
| `backToBlogAria` | 返回博客 / Back to blog | Доступное имя возврата | Условно | `backToBlogAria: "Вернуться в блог"` |
| `backToBlog` | 返回博客 / Back to blog | Видимый возврат, не цель | Условно | `backToBlog: "Вернуться в блог"` |
| `comments` | 评论 / Comments | Доступное имя при действительной конфигурации | Условно | `comments: "Комментарии"` |
| `metaReadMinutes` | 分钟阅读 / min read | Не используется, время чтения не возвращает | Сейчас не используется | `metaReadMinutes: "минут чтения"` |
| `latencyLabel` | 延迟估计 / latency est | Не используется, задержку не возвращает | Сейчас не используется | `latencyLabel: "Оценка задержки"` |
| `confidenceLabel` | 置信度 / confidence | Не используется, уверенность не возвращает | Сейчас не используется | `confidenceLabel: "Уверенность"` |

Статусы, обложка и подсказки чтения создают атмосферу, не подтверждают AI online, сеть или точность. regenerate только повторяет визуальный скан, не переписывает статью/запрашивает AI.

Пример OUTPUT и ссылки раздела:

```ts
i18n: {
  locales: {
    ru: {
      messages: {
        blog: {
          responseOutput: 'Текст',
          statsWords: 'Слова',
          statsTokens: 'Оценка токенов',
          copySectionLink: 'Копировать адрес этого раздела',
          regenerate: 'Повторить эффект сканирования',
        },
      },
    },
  },
},
```

Возврат ведёт в блог текущего языка независимо от текста. Рекомендации — до трёх последних того же языка без текущей, не AI-сходство. Полей количества/сходства нет, related/relatedAria только тексты/доступность.

### Копирование кода и просмотр изображений

Префикс теперь `i18n.locales.<locale>.messages`. Все необязательные string, условно действуют, не меняют права копирования/источник и не добавляют переключатели.

| Конец пути | Стандарт упрощённого китайского / английского | Действие и ограничения | Пример члена |
| --- | --- | --- | --- |
| `codeCopy.copy` | 复制代码 / Copy code | Текст кнопки, не копируемое | `codeCopy: { copy: "Копировать код" }` |
| `codeCopy.copied` | 已复制 / Copied | Успех кода/ссылки раздела | `codeCopy: { copied: "Скопировано" }` |
| `codeCopy.failed` | 复制失败，请手动选择代码。 / Copy failed. Select the code manually. | Ошибка кода/ссылки, не разрешения буфера | `codeCopy: { failed: "Не удалось скопировать; выделите код вручную." }` |
| `imagePreview.open` | 查看大图 / View image | Доступное имя входа/окна | `imagePreview: { open: "Увеличить изображение" }` |
| `imagePreview.close` | 关闭图片预览 / Close image preview | Имя закрытия, не источник | `imagePreview: { close: "Закрыть просмотр изображения" }` |

```ts
i18n: {
  locales: {
    ru: {
      messages: {
        codeCopy: { copy: 'Копировать содержимое', copied: 'Содержимое скопировано', failed: 'Не удалось скопировать; выделите вручную.' },
        imagePreview: { open: 'Увеличить это изображение', close: 'Закрыть изображение' },
      },
    },
  },
},
```

Ссылки разделов только у h2/h3 текста с id, успех/ошибка общие codeCopy.copied/failed. Копирование/просмотр требуют JavaScript. Просмотр обычных изображений исключает обложки и вложенные в ссылки/кнопки; использует выбранный источник без нового HD-оригинала. site.config enabled у них нет.

## 5\. Границы конфигурации и проверка

Страница статьи реагирует на изменение системной настройки уменьшения движения без перезагрузки. При включении обложка и фоновая сеть становятся статичными, Red Queen останавливается и скрывается; при выключении эффекты возвращаются с прежними задержками запуска. Прогресс чтения не сбрасывается, копирование кода, ссылки разделов и просмотр изображений не привязываются заново. Новый переключатель site.config не добавляется.

Текст/панель появляются сразу и неподвижны; сеть фона, световая полоса и обложка независимы. Нет публичных глобального переключателя AI-темы, длительности входа, дыхания панели, количества рекомендаций, imagePreview enabled или codeCopy enabled. Произвольный ключ не работает.

locale, articleSlug, headings, filePath, related, localeHrefs и seoLocaleHrefs — атрибуты BlogPost, не site.config/frontmatter. Стандартный маршрут предоставляет данные, обычной статье заполнять их не нужно.

В dev проверьте контент с/без заголовков и обложки, самостоятельно копирование/разделы/изображения. Поиск — в собранном preview. Перед публикацией остановите dev, выполните npm run doctor и npm run preview, не повторяя check/build после успеха. Онлайн обновится после размещения.

[Установка/обновление](https://demo.anglefeint.com/ru/blog/starter-guide-1-configure-your-site/), [написание статьи](https://demo.anglefeint.com/ru/blog/starter-guide-2-languages-and-routing/), [размещение](https://demo.anglefeint.com/ru/blog/starter-guide-deployment/).
