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

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

[Назад к общему справочнику](https://demo.anglefeint.com/ru/blog/config-reference/). Здесь описаны поля настоящей главной страницы, без изменения темы и без подмены стандартных значений личными настройками 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. Пустая строка не выключает все описания страниц; пробелы автоматически не превращаются в отсутствие описания.

Эти независимые поля можно настроить вместе:

```ts
i18n: {
  locales: {
    ru: {
      site: {
        homeTitle: 'Мой цифровой сад',
        hero: 'Заметки о разработке, чтении и жизни.',
      },
      messages: { siteDescription: 'Личные проекты и учебные заметки.' },
    },
  },
},
```

### Связанные общие поля: `site.title`, `site.description`

Здесь только связь с главной: site.title — окончательный заголовок при отсутствии действительного homeTitle, site.description — запасное метаописание при пустом языковом. Они не принадлежат исключительно главной. Типы, стандарты, среда и полные примеры — в [справочнике идентичности сайта](https://demo.anglefeint.com/ru/blog/config-site-chrome/#identity).

## 2\. Число последних статей

### `theme.homeLatestCount`

*   **Тип:** `number`.
*   **Стандарт темы:** `3`.
*   **Действие:** первые N статей текущего языка по убыванию pubDate на главной. Если их меньше N, показывает имеющиеся; счётчик — фактическое число / итог языка.
*   **Состояние и ограничения:** действует через прямой slice без отдельной проверки положительного целого. Рекомендуется разумное положительное целое, не отрицательное, дробь, NaN или Infinity. `0` создаёт пустой список с подсказкой отсутствия статей, даже если они есть; не скрывает всю область последних статей.
*   **Независимость:** не меняет размер Blog List и максимум три превью заметок главной.

```ts
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 | Не широкоформатный терминал; атмосферный текст, не настоящее отслеживание или сеть |

```ts
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 | Доступное имя замочной скважины терминала и метка превью, обычно не постоянно видимый заголовок |

Условно действуют при существовании области. Пустая строка очищает текст, не удаляя контейнер/функцию, и может лишить кнопку понятного имени. Для отображения используйте соответствующий переключатель.

```ts
i18n: {
  locales: {
    ru: {
      messages: {
        home: {
          latest: 'Последние статьи',
          viewAll: 'Все статьи',
          noPosts: 'Пока нет статей.',
          openDoor: 'Открыть превью коридора',
        },
      },
    },
  },
},
```

### `i18n.locales.<locale>.messages.home.transmission`

*   **Тип:** необязательное переопределение `string`.
*   **Стандарт темы:** `'Knock, knock.'`, общий без личного переопределения, включая китайский.
*   **Действие:** выделяемый прокручиваемый текст широкоформатного терминала.
*   **Состояние и ограничения:** условно действует при ширине viewport от 1440px. Отдельный порядок: личная настройка текущего языка → личная английская → стандартная фраза, без полной обычной цепочки. `''` очищает текст, не скрывая терминал/коридор.

Например, текст на русском языке:

```ts
i18n: {
  locales: {
    ru: { messages: { home: { transmission: 'Оставьте здесь небольшую подсказку.' } } },
  },
},
```

В том же месте ru меняет только русский. Текст не запрашивает реальный сетевой сигнал и не меняет открытие коридора замочной скважиной.

### `i18n.locales.<locale>.messages.home.hero`

*   **Тип:** необязательное переопределение `string`.
*   **Стандарт темы:** встроенное вступление языка, китайское/английское совпадают с site.hero выше.
*   **Действие:** запасное вступление, только если getSiteHero не нашёл определённое значение текущего и резервных языков.
*   **Состояние и ограничения:** условно действует, не устаревшее поле. Но у встроенных языков уже есть site.hero, поэтому изменение только этого поля обычно незаметно. `site.hero: ''` не запускает его. Обычно меняйте site.hero напрямую.

```ts
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 и превью терминала.

```ts
theme: { effects: { enableHomePassage: true } },
```

При выключении ссылки переходят напрямую. Этот boolean не предоставляет длительность, цвет сцены или целевой адрес; не добавляйте непубличный homePassageDuration.

## 6\. Общие настройки, используемые главной

Эти поля не эксклюзивны главной. Здесь только связь; полное описание — в основном справочнике.

| Полный путь | Использование на главной | Основное описание |
| --- | --- | --- |
| `theme.fragments.enabled` | Аватар при заметках текущего языка, также полный список; максимум три превью | [Fragments](https://demo.anglefeint.com/ru/blog/config-fragments/#enabled) |
| `i18n.locales.<locale>.messages.blog.allPosts` | Подсказка количества последних статей и доступное имя архива | [Общие тексты списка](https://demo.anglefeint.com/ru/blog/config-blog-list/#tag-messages) |
| `i18n.locales.<locale>.messages.fragments.title` | Доступное имя аватара, не заголовок рядом | [Тексты заметок](https://demo.anglefeint.com/ru/blog/config-fragments/#fragment-messages) |
| `i18n.locales.<locale>.messages.fragments.close` | Доступное имя закрытия превью без смены значка | [Тексты заметок](https://demo.anglefeint.com/ru/blog/config-fragments/#fragment-messages) |

Если аватара нет, проверьте заметки текущего языка; не копируйте существующий ID ради появления. Изображения, код и высота — в [Fragments](https://demo.anglefeint.com/ru/blog/config-fragments/#preview-and-links), создание — в [руководстве](https://demo.anglefeint.com/ru/blog/starter-guide-5-fragments/).

## 7\. Каких настроек главной сейчас нет

`messages.siteTitle` не меняет стандартную главную или общее название сайта; не заменяет homeTitle/верхний site.title. Тип, стандарт и пример — в [неиспользуемом поле названия](https://demo.anglefeint.com/ru/blog/config-site-chrome/#legacy-site-title).

Плотность/цвет дождя кода, зеркальная кнопка, материалы аватара, количество превью заметок, фиксированные стартовые фразы и длительность прохода не имеют site.config-полей. Они реализованы макетом/стилями/скриптами: произвольное имя в TypeScript не заставляет их работать. Reduced Motion влияет на эффекты, но не является новым переключателем этой статьи.

Связь `/` и языковой главной определяют i18n.defaultLocale и i18n.routing.defaultLocalePrefix; полное определение — в [языках и адресах](https://demo.anglefeint.com/ru/blog/config-languages/#routing). Общие навигация, подвал, музыка и статистика тоже не отдельные настройки главной.

## Как проверить изменения?

В dev откройте нужный язык и различайте заголовок, вступление, метаописание и доступное имя. Текст терминала проверяйте при viewport не менее 1440px, метаописание — в head, имена кнопок — по доступному имени/title, а не наличию крупных надписей.

После смены среды перезапустите dev; опубликованному сайту нужны сборка и размещение. Перед публикацией остановите dev, выполните npm run doctor, затем npm run preview. doctor уже включает сборку: повторять check/build сразу не нужно. Шаги — в [установке](https://demo.anglefeint.com/ru/blog/starter-guide-1-configure-your-site/) и [размещении](https://demo.anglefeint.com/ru/blog/starter-guide-deployment/).
