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

$ опубликовано 2026-11-13 | | обновлено 2026-11-14
Контекст: Полный справочник frontmatter статей, глобальных переключателей и локализованных сообщений с типами, стандартами, примерами и состоянием.

Все поля статьи, OUTPUT, оглавление, взаимодействие и совместимость.


Вывод
слов 1.8k токенов 2.4k

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

Назад к общему справочнику. Сначала различайте файл: глобальные функции/тексты — 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 Вход/индекс; поиск search false статьи исключает, true не обходит глобальный false; search: { enabled: false }
theme.tags.enabled Ссылки статьи и страницы тегов false не удаляет tags; tags: { enabled: false }, списки
theme.socialImage.enabled Автопревью 1200×630 без явного ogImage false сохраняет ручной ogImage, откатывает к обложке/стандарту, не скрывает обложку страницы; socialImage: { enabled: false }

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

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

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

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

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

Полный путь Влияние Основное описание
site.author Запасной автор при отсутствии/пробелах author, также автопревью Идентичность
theme.enableAboutPage Если включён и автор равен автору сайта, ссылка на About языка; иначе текст About
theme.footer.showCredits Подпись темы в автопревью, не custom-изображениях Подвал
site.ogImage Запасная картинка без более приоритетной Идентичность/картинки
theme.comments.enabled Нужны полное подключение и mapping; индивидуального frontmatter нет Giscus

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

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

---
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 без изменения исходного значения.

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 и ссылки раздела:

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: "Закрыть просмотр изображения" }
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 после успеха. Онлайн обновится после размещения.

Установка/обновление, написание статьи, размещение.