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

$ опубликовано 2026-11-13 | | обновлено 2026-11-14
Контекст: Типы, стандарты, ограничения и примеры публичных настроек главной страницы Anglefeint.

Заголовок, вступление, последние статьи, подсказки запуска и переход Matrix.


Вывод
слов 1.2k токенов 1.6k

Назад к общему справочнику. Здесь описаны поля настоящей главной страницы, без изменения темы и без подмены стандартных значений личными настройками 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 сразу не нужно. Шаги — в установке и размещении.