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

$ опубликовано 2026-11-13 | | обновлено 2026-11-14
Контекст: Все общие поля site/social/footer, настоящие стандарты и ограничения навигации, включая неиспользуемое messages.siteTitle.

Общее название и домен, переменные среды, ссылки, значки и подписи.


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

Для первой замены данных см. установку и сведения сайта, для домена — размещение. Другие модули — в общем справочнике.

Настройки в 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 — только видимый большой заголовок главной языка с непустым языковым откатом к общему. См. главная. messages.siteTitle сейчас не меняет бренд/заголовок стандартной главной.

site.description не видимое вступление: оно из i18n.locales.<locale>.site.hero, метаописание главной — messages.siteDescription. Приоритеты. Смена идентичности не переписывает уже заполненный About.

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

site.ogImage используется общим head при отсутствии изображения страницы. ogImage статьи, автогенерация или обложка могут быть приоритетнее: статья. При включённой генерации 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

Интеграция читает 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; поиск
Язык и статус Включённые языки/meta.label и статические сообщения ниже; опции не произвольные ссылки

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

Правила — в языках, поля 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 — опции: языки. Contact/Fragments используют свои модули, не новые поля messages.nav.

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

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

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

Поле Тип / стандарт Состояние, действие и ограничения Пример
href string, обязателен / нет Действует: адрес без общей проверки протокола/непустоты/доступности и без BASE_URL. Полный HTTPS или правильный внутренний путь, не проверенный аккаунт ‘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. Точные регистрозависимые имена:

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/’ }]
theme.footer.links[].label string, обязателен / нет Условно: видимое имя текстом, не автоизвлечение ‘Проект’
theme.footer.links[].href string, обязателен / нет Условно: сырой адрес без проверки custom-значков или auto-base. Правильность внутренних путей на вас; переход в текущей вкладке ‘https://example.com/project/’

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

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

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

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

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-файлы.

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

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: главная и идентичность. Для переименования сохранённое поле не нужно.

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

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

После файлов/настроек пересоберите и разместите; среда требует перечитать режим. Домен, доступность ссылок, аккаунты и онлайн-вид подтверждаются собственным размещением, не одной проверкой типов. Назад к общему справочнику.