Справочник настроек: сайт, навигация, социальные ссылки и подвал
Общее название и домен, переменные среды, ссылки, значки и подписи.
На этой странице
Для первой замены данных см. установку и сведения сайта, для домена — размещение. Другие модули — в общем справочнике.
Настройки в 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.
social.links: общие социальные ссылки шапки/подвала
- Тип / стандарт: SocialLink[] / [], пять полей ниже.
- Состояние и действие: действует, один список с порядком массива. Полная замена, без публичного лимита/языковых списков.
- Ограничения: [] не скрывает всё: стандартный компонент оставляет некликабельные Mastodon/Twitter/GitHub, dev также подсказку. Пустой href настоящего элемента остаётся ссылкой, не таким заполнителем.
- Пример: [{ label: ‘GitHub’, href: ‘https://github.com/yourname’, icon: ‘github’ }].
Почта/GitHub About независимы и автоматически не меняются. theme.social.enabled/hidePlaceholders нет; showPlaceholdersWhenEmpty — параметр макета.
Пять полей SocialLink
Префикс 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-заполнителей, шаблона копирайта или отдельной проверки статуса.
После файлов/настроек пересоберите и разместите; среда требует перечитать режим. Домен, доступность ссылок, аккаунты и онлайн-вид подтверждаются собственным размещением, не одной проверкой типов. Назад к общему справочнику.