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

# Справочник настроек: сайт, навигация, социальные ссылки и подвал

Для первой замены данных см. [установку и сведения сайта](https://demo.anglefeint.com/ru/blog/starter-guide-1-configure-your-site/), для домена — [размещение](https://demo.anglefeint.com/ru/blog/starter-guide-deployment/). Другие модули — в [общем справочнике](https://demo.anglefeint.com/ru/blog/config-reference/).

Настройки в src/site.config.ts, стандарты из пакета, не личные имена/аккаунты/домен demo. Объединяйте с существующим defineThemeConfig({…}), сохраняя import/export и модули.

## site: шесть общих полей идентичности

site — объект, все поля частичной конфигурации необязательны. Все условны: используются читающей их страницей, где среда или более конкретный параметр могут иметь приоритет.

| Полный путь | Тип | Стандарт темы | Действие, ограничения и пример |
| --- | --- | --- | --- |
| `site.title` | string | `"My Blog"` | Бренд шапки, имя копирайта, RSS, название structured data и часть страниц/автопревью; не то же, что большой заголовок главной. Общего fallback пустой строки нет; `"Мой блог"` |
| `site.description` | string | `"Cinematic web interfaces, AI-era engineering notes, and system architecture essays."` | Один источник общего описания/машинного индекса. Главная предпочитает messages.siteDescription, About/списки имеют свои; не заменяет всё; `"Проекты, чтение и повседневная жизнь."` |
| `site.url` | string | `"https://example.com"` | Публичный абсолютный адрес для Astro site/canonical/RSS/sitemap/экспорта. Настоящий HTTP(S), не статья; не покупает домен, не настраивает DNS/сертификат/публикацию; `"https://blog.example.com"` |
| `site.author` | string | `"Your Name"` | Стандартный автор/structured data, статья может переопределить. Копирайт использует site.title; About/почта автоматически не меняются; `"Линь"` |
| `site.tagline` | string | `""` | Дополнительная фраза подвала с trim, пустота скрывает. Точное старое Built with Astro. тоже скрыто во избежание дубля; `"Сохраняйте любопытство и продолжайте создавать."` |
| `site.ogImage` | string, необязателен | `""` | Общая картинка ссылок без более приоритетной страницы/статьи. Пустота — встроенная; public или HTTPS, не аватар/массовая замена обложек; `"/images/share.webp"` |

site.title — общее имя, `i18n.locales.<locale>.site.homeTitle` — только видимый большой заголовок главной языка с непустым языковым откатом к общему. См. [главная](https://demo.anglefeint.com/ru/blog/config-home/#home-title). messages.siteTitle сейчас не меняет бренд/заголовок стандартной главной.

site.description не видимое вступление: оно из `i18n.locales.<locale>.site.hero`, метаописание главной — messages.siteDescription. [Приоритеты](https://demo.anglefeint.com/ru/blog/config-home/#site-fallbacks). Смена идентичности не переписывает уже заполненный About.

### Приоритет и пути превью ссылок

site.ogImage используется общим head при отсутствии изображения страницы. ogImage статьи, автогенерация или обложка могут быть приоритетнее: [статья](https://demo.anglefeint.com/ru/blog/config-article/#frontmatter). При включённой генерации site.ogImage не заменяет все статьи.

/images/share.webp соответствует public/images/share.webp, подготовьте заранее. Отсутствие, выход из publicDir или неверный путь вызывают ошибку разбора запасной картинки. Локальный URL получает base и версию содержимого; HTTPS сохраняется без скачивания/проверки. Пустота/пробелы дают встроенную картинку, не удаляют метаданные.

site.ogImage — строка, не объект Astro image import. Тип frontmatter.ogImage другой. PUBLIC\_SITE\_OG\_IMAGE нет, heroImage не меняется.

## Среда и приоритет домена

Это читаемые переменные среды, не новые site.config-поля. Все string, без значения используется поле site. Nullish-слияние не считает пустую строку отсутствием.

| Переменная | Переопределяет | Пример |
| --- | --- | --- |
| PUBLIC\_SITE\_TITLE | site.title | PUBLIC\_SITE\_TITLE=Мой блог |
| PUBLIC\_SITE\_DESCRIPTION | site.description | PUBLIC\_SITE\_DESCRIPTION=Проекты и учебные заметки |
| PUBLIC\_SITE\_AUTHOR | site.author | PUBLIC\_SITE\_AUTHOR=Линь |
| PUBLIC\_SITE\_TAGLINE | site.tagline | PUBLIC\_SITE\_TAGLINE=Сохраняйте любопытство |
| PUBLIC\_SITE\_URL | site.url | PUBLIC\_SITE\_URL=[https://blog.example.com](https://blog.example.com/) |

Интеграция читает PUBLIC\_SITE\_URL через Vite dotenv режима dev/build/–mode, согласуя Astro site и публичные URL. Среда процесса приоритетнее одноимённого dotenv. Не забывайте значение платформы при изменении site.url. Пустота может очистить текст/сломать адрес, не восстанавливает стандарт.

У SITE\_URL страницы промежуточный import.meta.env.SITE: PUBLIC\_SITE\_URL → SITE → site.url. Стандартная интеграция задаёт Astro site из PUBLIC\_SITE\_URL/config, head предпочитает Astro.site. SITE — совместимый fallback adapter, не рекомендуемая отдельная настройка домена.

Домен не подпуть публикации. Astro base, выход хостинга и DNS/HTTPS настраиваются по руководству. Произвольная вставка каталога в site.url не перемещает маршруты. Перезапустите dev/пересоберите production; серверных редиректов это не создаёт.

## Общая навигация: фиксированные входы и переключатели

Нет публичного nav-массива, порядка или custom-элементов. Стандартная шапка собирается так:

| Место | Источник и ограничения |
| --- | --- |
| Бренд | site.title/среда, ведёт на главную текущего языка |
| Главная, Blog | Всегда присутствуют; messages.nav.home/blog меняют имена, не цели |
| About | theme.enableAboutPage boolean true; theme: { enableAboutPage: false } убирает страницу/вход |
| Decoder в Frontier | theme.enableDecoderPage boolean true; надпись шапки фиксирована Decoder Lab |
| Fragments в Frontier | theme.fragments.enabled boolean false; messages.fragments.title |
| Contact в Frontier | При About, messages.about.contact, /about/#contact текущего языка; независимо от Decoder |
| Поиск | theme.search.enabled boolean true; [поиск](https://demo.anglefeint.com/ru/blog/config-search/#enabled) |
| Язык и статус | Включённые языки/meta.label и статические сообщения ниже; опции не произвольные ссылки |

Frontier и его название фиксированы компонентом, отсутствует только без всех подпунктов. messages.decoderPage.fullTool меняет полную страницу/ссылку подвала, не фиксированный Decoder Lab шапки.

Правила — в [языках](https://demo.anglefeint.com/ru/blog/config-languages/#content-and-seo), поля About/Fragments/Decoder — у них. Пустые labels не выключают вход, оставляют адрес/непонятные кнопки.

### Семь текстов шапки и подвала

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

| Относительное поле | Стандарт упрощённого китайского / английского | Действие и ограничения | Пример |
| --- | --- | --- | --- |
| `nav.home` | 首页 / Home | Текст главной, не маршрут | `"Главная"` |
| `nav.blog` | 博客 / Blog | Текст Blog, не маршрут | `"Статьи"` |
| `nav.about` | 关于 / About | Вход About и повторное открытие окна текста | `"Обо мне"` |
| `nav.status` | system: online / system: online | Статический статус, не проверка сети/API/здоровья | `"Система подключена"` |
| `nav.statusAria` | 系统状态 / System status | Доступное имя статуса, не переключатель мониторинга | `"Состояние сайта"` |
| `footer.theme` | 主题： / Theme by | Префикс подписи, ссылка/текст Anglefeint фиксированы | `"Тема от"` |
| `footer.builtWith` | 构建工具： / Built with | Префикс Astro, ссылка/текст фиксированы | `"Создано с"` |

messages.langLabel — имя контрола языка, meta.label — опции: [языки](https://demo.anglefeint.com/ru/blog/config-languages/#common-messages). Contact/Fragments используют свои модули, не новые поля messages.nav.

## social.links: общие социальные ссылки шапки/подвала

*   **Тип / стандарт:** SocialLink\[\] / \[\], пять полей ниже.
*   **Состояние и действие:** действует, один список с порядком массива. Полная замена, без публичного лимита/языковых списков.
*   **Ограничения:** \[\] не скрывает всё: стандартный компонент оставляет некликабельные Mastodon/Twitter/GitHub, dev также подсказку. Пустой href настоящего элемента остаётся ссылкой, не таким заполнителем.
*   **Пример:** \[{ label: ‘GitHub’, href: ‘[https://github.com/yourname’](https://github.com/yourname%E2%80%99), icon: ‘github’ }\].

Почта/GitHub About независимы и автоматически не меняются. theme.social.enabled/hidePlaceholders нет; showPlaceholdersWhenEmpty — параметр макета.

### Пять полей SocialLink

Префикс social.links\[\]. Обязательным нет автозначений; даже если partial-тип допускает неполный объект, заполняйте действительную запись.

| Поле | Тип / стандарт | Состояние, действие и ограничения | Пример |
| --- | --- | --- | --- |
| href | string, обязателен / нет | Действует: адрес без общей проверки протокола/непустоты/доступности и без BASE\_URL. Полный HTTPS или правильный внутренний путь, не проверенный аккаунт | ‘[https://github.com/yourname](https://github.com/yourname)’ |
| label | string, обязателен / нет | Действует: доступное имя, а без значка видимый текст. Нет автоимени платформы/страницы, задайте понятное непустое | ‘GitHub’ |
| rel | string, необязателен / отсутствует, минимум noopener noreferrer | Действует: пробельные маркеры в нижний регистр, уникальные, opener удалён, защита сохранена даже при ‘’. Нестрока — ошибка | ‘me nofollow’ |
| icon | Встроенный SocialIcon, необязателен / отсутствует | Условно: одно из 12 имён ниже без iconSrc. Неизвестное непустое — ошибка; URL не определяет платформу. Без обоих — label | ‘github’ |
| iconSrc | string, необязателен / отсутствует | Условно: локальный SVG/PNG/WebP publicDir. Действительный непустой приоритетнее icon; пробелы — отсутствие, неверный тип/правило — ошибка | ‘/icons/community.svg’ |

Настоящие ссылки открываются новой вкладкой; rel объединяется с защитой. Labels без HTML. Точные регистрозависимые имена:

```text
mastodon
twitter
github
youtube
bluesky
linkedin
discord
telegram
instagram
facebook
whatsapp
line
```

### Ограничения файлов собственных значков

public/icons/community.svg соответствует iconSrc: ‘/icons/community.svg’. Реальный publicDir, не ресурс пакета/src/assets. Начало один /, не URL, //, query/fragment, percent-encoding или сегменты `.` / `..`. Обратные слеши, двоеточия и управляющие символы запрещены.

Сборка проверяет существование файла и реальный путь внутри publicDir; symlink наружу тоже запрещён. Обычные пробелы/китайские имена компонент кодирует сам, заранее percent-encoding не нужен. Путь значка получает Astro base, приоритет значка не меняет сырой href. JPG/GIF и другие расширения здесь не поддерживаются.

При действительном iconSrc встроенный icon не выбирается. Размер/интервалы значков — параметры макета, не SocialLink.

## theme.footer: ссылки и подписи

| Полный путь | Тип / стандарт | Состояние, действие и ограничения | Пример |
| --- | --- | --- | --- |
| theme.footer.showCredits | boolean / true | Действует: подписи темы/Astro, не копирайт/социальные/фраза/прочие ссылки. Также подпись текущих автопревью, не собственные картинки | false |
| theme.footer.links | { label: string; href: string }\[\] / \[\] | Действует: custom-ссылки по порядку, полная замена; шапку не меняет. Макет может добавить Decoder, \[\] не гарантирует отсутствие ссылок | \[{ label: ‘Проект’, href: ‘[https://example.com/project/’](https://example.com/project/%E2%80%99) }\] |
| theme.footer.links\[\].label | string, обязателен / нет | Условно: видимое имя текстом, не автоизвлечение | ‘Проект’ |
| theme.footer.links\[\].href | string, обязателен / нет | Условно: сырой адрес без проверки custom-значков или auto-base. Правильность внутренних путей на вас; переход в текущей вкладке | ‘[https://example.com/project/](https://example.com/project/)’ |

Custom-ссылки перед добавленными макетом, без дедупликации. Включённый Decoder добавляет ссылку полной страницы с messages.decoderPage.fullTool. Отключайте функцию Decoder, не очищайте footer.links ради удаления.

Копирайт — год сборки и эффективный SITE\_TITLE, отдельного copyright/year нет. site.tagline независим от подписей; trim-совпадение старому Built with Astro. скрывает совместимую фразу. showCredits false не меняет остальные фразы и не удаляет уже существующие изображения с подписью.

## Пример сайта и общих ссылок для объединения

Сохраните личные данные, объедините только нужное:

```ts
site: {
  title: 'Блог Линя',
  description: 'Проекты, чтение и повседневная жизнь.',
  url: 'https://blog.example.com',
  author: 'Линь',
  tagline: 'Сохраняйте любопытство и продолжайте создавать.',
},
social: {
  links: [
    { label: 'GitHub', href: 'https://github.com/yourname', icon: 'github' },
    { label: 'Страница проекта', href: 'https://example.com/project/' },
  ],
},
theme: {
  footer: {
    showCredits: true,
    links: [{ label: 'Проект', href: 'https://example.com/project/' }],
  },
},
```

Замените аккаунты/домены/ссылки своими, сетевой проверки нет. Для iconSrc/site.ogImage сначала подготовьте public-файлы.

Только русская навигация и префиксы:

```ts
i18n: {
  locales: {
    ru: {
      messages: {
        nav: { home: 'Главная', blog: 'Статьи', about: 'Обо мне' },
        footer: { theme: 'Тема от', builtWith: 'Создано с' },
      },
    },
  },
},
```

## Сейчас не используется: messages.siteTitle

Путь `i18n.locales.<locale>.messages.siteTitle`, необязательный string. Стандарты упрощённого китайского/английского оба ‘Angle Feint’. Стандартная главная/общая идентичность не читают, состояние «сейчас не используется». siteTitle: ‘Мой блог’ их не меняет.

Заголовок главной — `i18n.locales.<locale>.site.homeTitle`, бренд — верхний site.title: [главная](https://demo.anglefeint.com/ru/blog/config-home/#home-title) и [идентичность](https://demo.anglefeint.com/ru/blog/config-site-chrome/#identity). Для переименования сохранённое поле не нужно.

## Совместимость и границы неработающих полей

*   Все шесть site, социальные/подвал и семь текстов потребляются; приоритет картинок, среда и переключатели определяют результат конкретной страницы.
*   Built with Astro. в site.tagline — явная совместимость старого стандарта. Подавление этой фразы не означает запрет всех коротких текстов.
*   messages.siteTitle не потребляется; принимаемый тип не означает чтение страницей.
*   homeHref, localeHrefs, extraLinks, showPlaceholdersWhenEmpty, iconSize — параметры компонентов, не site.config. Нет nav-массива, выключения social-заполнителей, шаблона копирайта или отдельной проверки статуса.

После файлов/настроек пересоберите и разместите; среда требует перечитать режим. Домен, доступность ссылок, аккаунты и онлайн-вид подтверждаются собственным размещением, не одной проверкой типов. [Назад к общему справочнику](https://demo.anglefeint.com/ru/blog/config-reference/).
