Справочник настроек: главная страница
Заголовок, вступление, последние статьи, подсказки запуска и переход Matrix.
На этой странице
Назад к общему справочнику. Здесь описаны поля настоящей главной страницы, без изменения темы и без подмены стандартных значений личными настройками demo.
Заменяйте <locale> настоящим включённым кодом. Примеры используют ru: меняют только русский, не английский и не включение языка. Все фрагменты объединяйте с существующим defineThemeConfig в src/site.config.ts, сохраняя остальные поля theme, i18n и site.
1. Большой заголовок, вступление и метаописание
i18n.locales.<locale>.site.homeTitle
- Тип: необязательный
string. - Стандарт темы: не задан. У встроенных языков нет отдельного homeTitle; в итоге используется название сайта, стандартно My Blog.
- Действие: видимый большой заголовок главной.
- Состояние и ограничения: условно действует. Последовательно ищет непустой заголовок текущего и резервных языков после удаления крайних пробелов, затем название сайта.
''/пробелы не скрывают заголовок. Не меняет название сайта во вкладке, навигации, подвале, RSS или SEO.
i18n.locales.<locale>.site.hero
- Тип: необязательный
string. - Стандарт темы: встроенное вступление языка. Для упрощённого китайского: «在这里写一段站点简介,并告诉读者你将发布什么类型的内容。», английского: «Write a short introduction for your site and what readers can expect from your posts.». Остальные языки используют свои встроенные значения.
- Действие: видимое вступление под большим заголовком.
- Состояние и ограничения: условно действует; ищет определённое значение текущего и резервных языков.
''намеренно очищает и прекращает откат. Обычный текст без Markdown/HTML, не меняет метаописание.
i18n.locales.<locale>.messages.siteDescription
- Тип: необязательное переопределение
string. - Стандарт темы: встроенный текст языка; упрощённый китайский «电影感网页界面与 AI 时代工程实践文章。», английский «Cinematic web interfaces and AI-era engineering essays.».
- Действие: описание, передаваемое главной в head, не видимое вступление.
- Состояние и ограничения: условно действует; сначала разрешает интерфейс и откаты, затем использует значение. Только пустая строка результата возвращает к общему description. Пустая строка не выключает все описания страниц; пробелы автоматически не превращаются в отсутствие описания.
Эти независимые поля можно настроить вместе:
i18n: {
locales: {
ru: {
site: {
homeTitle: 'Мой цифровой сад',
hero: 'Заметки о разработке, чтении и жизни.',
},
messages: { siteDescription: 'Личные проекты и учебные заметки.' },
},
},
},
Связанные общие поля: site.title, site.description
Здесь только связь с главной: site.title — окончательный заголовок при отсутствии действительного homeTitle, site.description — запасное метаописание при пустом языковом. Они не принадлежат исключительно главной. Типы, стандарты, среда и полные примеры — в справочнике идентичности сайта.
2. Число последних статей
theme.homeLatestCount
- Тип:
number. - Стандарт темы:
3. - Действие: первые N статей текущего языка по убыванию pubDate на главной. Если их меньше N, показывает имеющиеся; счётчик — фактическое число / итог языка.
- Состояние и ограничения: действует через прямой slice без отдельной проверки положительного целого. Рекомендуется разумное положительное целое, не отрицательное, дробь, NaN или Infinity.
0создаёт пустой список с подсказкой отсутствия статей, даже если они есть; не скрывает всю область последних статей. - Независимость: не меняет размер Blog List и максимум три превью заметок главной.
theme: { homeLatestCount: 5 },
Заголовки, даты и описания поступают из статей, не из подпараметров поля. Главная не дополняет список автоматически статьями других языков вместо отсутствующих переводов.
3. Подсказки запуска и нижний статус
Все три поля — boolean, стандарт true, действуют. false скрывает только соответствующую часть, отсутствие сохраняет стандарт.
| Полный путь | Действие | Ограничение |
|---|---|---|
theme.home.showInitialize |
Текст запуска Initialize/done | Только отображение блока, не загрузка текста или фона главной |
theme.home.showFollow |
Подсказка Wake Up/Follow The White Rabbit | Независима от предыдущей, не условие работы навигации |
theme.home.showTrace |
Нижний PIRATE SIGNAL/TRACE PROGRAM | Не широкоформатный терминал; атмосферный текст, не настоящее отслеживание или сеть |
theme: {
home: {
showInitialize: false,
showFollow: true,
showTrace: false,
},
},
Отключение первых двух удаляет соответствующий компонент текста запуска. Нет site.config-полей для фиксированных фраз, нижних статусов или их таймингов. Не придумывайте startupText/traceText.
4. Тексты интерфейса главной
Все поля находятся в i18n.locales.<locale>.messages.home, необязательные string. Обычные разрешаются стандартным откатом интерфейса. Ниже настоящие встроенные значения упрощённого китайского и английского; у остальных языков свои.
| Конец полного пути | Стандарт упрощённого китайского / английского | Действие и ограничения |
|---|---|---|
latest |
最新 / Latest | Заголовок последних статей, не порядок или количество |
viewAll |
全部 / All | Текст архива главной и доступное описание архива заметок; адрес не меняет |
noPosts |
该语言暂时没有文章。 / No posts available in this language yet. | Подсказка пустого latestPosts, не черновики или управление публикацией |
openDoor |
开门 / Open door | Доступное имя замочной скважины терминала и метка превью, обычно не постоянно видимый заголовок |
Условно действуют при существовании области. Пустая строка очищает текст, не удаляя контейнер/функцию, и может лишить кнопку понятного имени. Для отображения используйте соответствующий переключатель.
i18n: {
locales: {
ru: {
messages: {
home: {
latest: 'Последние статьи',
viewAll: 'Все статьи',
noPosts: 'Пока нет статей.',
openDoor: 'Открыть превью коридора',
},
},
},
},
},
i18n.locales.<locale>.messages.home.transmission
- Тип: необязательное переопределение
string. - Стандарт темы:
'Knock, knock.', общий без личного переопределения, включая китайский. - Действие: выделяемый прокручиваемый текст широкоформатного терминала.
- Состояние и ограничения: условно действует при ширине viewport от 1440px. Отдельный порядок: личная настройка текущего языка → личная английская → стандартная фраза, без полной обычной цепочки.
''очищает текст, не скрывая терминал/коридор.
Например, текст на русском языке:
i18n: {
locales: {
ru: { messages: { home: { transmission: 'Оставьте здесь небольшую подсказку.' } } },
},
},
В том же месте ru меняет только русский. Текст не запрашивает реальный сетевой сигнал и не меняет открытие коридора замочной скважиной.
i18n.locales.<locale>.messages.home.hero
- Тип: необязательное переопределение
string. - Стандарт темы: встроенное вступление языка, китайское/английское совпадают с site.hero выше.
- Действие: запасное вступление, только если getSiteHero не нашёл определённое значение текущего и резервных языков.
- Состояние и ограничения: условно действует, не устаревшее поле. Но у встроенных языков уже есть site.hero, поэтому изменение только этого поля обычно незаметно.
site.hero: ''не запускает его. Обычно меняйте site.hero напрямую.
i18n: {
locales: {
ru: { messages: { home: { hero: 'Вступление, используемое при отсутствии значения site.hero.' } } },
},
},
Пример показывает путь/тип, не обходит более приоритетный site.hero. Для смены вступления не удаляйте стандарты и не редактируйте зависимости.
5. Проход Matrix при переходе к статье
theme.effects.enableHomePassage
- Тип:
boolean. - Стандарт темы:
false. - Действие: обычный щелчок заголовка последней статьи или соответствующего входа блога навигации главной сначала показывает проход Matrix, затем переходит. Нормальная шкала около 8 секунд, предусмотрен переход при завершении/ошибке.
- Состояние и ограничения: условно, нужен JavaScript. Reduced Motion, модификаторы, не левая кнопка, download, внешние адреса и новое окно сохраняют нативное поведение. Не задерживает появление текста главной, не управляет About Oracle и превью терминала.
theme: { effects: { enableHomePassage: true } },
При выключении ссылки переходят напрямую. Этот boolean не предоставляет длительность, цвет сцены или целевой адрес; не добавляйте непубличный homePassageDuration.
6. Общие настройки, используемые главной
Эти поля не эксклюзивны главной. Здесь только связь; полное описание — в основном справочнике.
| Полный путь | Использование на главной | Основное описание |
|---|---|---|
theme.fragments.enabled |
Аватар при заметках текущего языка, также полный список; максимум три превью | Fragments |
i18n.locales.<locale>.messages.blog.allPosts |
Подсказка количества последних статей и доступное имя архива | Общие тексты списка |
i18n.locales.<locale>.messages.fragments.title |
Доступное имя аватара, не заголовок рядом | Тексты заметок |
i18n.locales.<locale>.messages.fragments.close |
Доступное имя закрытия превью без смены значка | Тексты заметок |
Если аватара нет, проверьте заметки текущего языка; не копируйте существующий ID ради появления. Изображения, код и высота — в Fragments, создание — в руководстве.
7. Каких настроек главной сейчас нет
messages.siteTitle не меняет стандартную главную или общее название сайта; не заменяет homeTitle/верхний site.title. Тип, стандарт и пример — в неиспользуемом поле названия.
Плотность/цвет дождя кода, зеркальная кнопка, материалы аватара, количество превью заметок, фиксированные стартовые фразы и длительность прохода не имеют site.config-полей. Они реализованы макетом/стилями/скриптами: произвольное имя в TypeScript не заставляет их работать. Reduced Motion влияет на эффекты, но не является новым переключателем этой статьи.
Связь / и языковой главной определяют i18n.defaultLocale и i18n.routing.defaultLocalePrefix; полное определение — в языках и адресах. Общие навигация, подвал, музыка и статистика тоже не отдельные настройки главной.
Как проверить изменения?
В dev откройте нужный язык и различайте заголовок, вступление, метаописание и доступное имя. Текст терминала проверяйте при viewport не менее 1440px, метаописание — в head, имена кнопок — по доступному имени/title, а не наличию крупных надписей.
После смены среды перезапустите dev; опубликованному сайту нужны сборка и размещение. Перед публикацией остановите dev, выполните npm run doctor, затем npm run preview. doctor уже включает сборку: повторять check/build сразу не нужно. Шаги — в установке и размещении.