Konfigurationsverzeichnis: Website, Navigation, soziale Links und Fußzeile

$ veröffentlicht 2026-11-13 | | aktualisiert 2026-11-13
Kontext: Alle Website-, Social- und Fußzeilenfelder einschließlich Umgebung, Bildpfaden und ungenutztem siteTitle.

Globale Identität, Domain-Priorität, öffentliche Einstiege und Linkfelder.


Ausgabe
Wörter 1.8k Tokens 2.3k

Für erste eigene Angaben lies Installation und Website-Angaben, für Domain und Deployment Veröffentlichen. Andere Module im Gesamtverzeichnis.

Die Werte liegen in src/site.config.ts. Vorgaben stammen aus dem Paket, nicht von Namen, Konten und Domains der Demo. Erhalte import, export und andere Module im bestehenden defineThemeConfig({…}) und vereinige benötigte Ausschnitte.

site: sechs globale Identitätsfelder

site ist ein Objekt; alle Felder dürfen in Teilkonfigurationen fehlen. Sie wirken bedingt beim jeweiligen Leser. Umgebungsüberschreibungen und speziellere Seitenparameter können Vorrang haben.

Vollständiger Pfad Typ Theme-Standard Wirkung, Grenzen und Beispiel
site.title string "My Blog" Marke im Header, Copyrightname, RSS-Titel, strukturierte Website-Daten sowie einige Seiten und Freigabebilder. Nicht derselbe wie großer Startseitentitel. Kein einheitlicher Leerstring-Fallback; etwa "Mein Blog"
site.description string "Cinematic web interfaces, AI-era engineering notes, and system architecture essays." Eine Quelle globaler und Maschinenindex-Beschreibung. Startseite bevorzugt messages.siteDescription, About/Listen haben eigene Werte. Ersetzt nicht jede Seite; etwa "Projekte, Lektüre und Alltag."
site.url string "https://example.com" Öffentliche absolute HTTP(S)-Adresse für Astro site, canonical, RSS, Sitemap und Exporte. Kein einzelner Artikel. Kauft keine Domain und erledigt weder DNS, Zertifikat noch Deployment; etwa "https://blog.example.com"
site.author string "Your Name" Standardautor und strukturierte Daten; Artikel-author überschreibt. Copyright nutzt title, nicht author. About-Text und E-Mail ändern sich nicht automatisch; etwa "Alex"
site.tagline string "" Getrimmter Zusatzsatz in Fußzeile, leer verborgen. Exakt alter Standard Built with Astro. bleibt ebenfalls verborgen gegen doppelte Nennung; etwa "Bleib neugierig und entwickle weiter."
site.ogImage string, optional "" Globales Freigabebild ohne vorrangiges Seitenbild. Leerraum nutzt Theme-Bild. Lokaler public-Pfad oder HTTPS-URL, kein Avatar oder Massen-Titelbildersatz; etwa "/images/share.webp"

site.title ist global, i18n.locales.<Sprachcode>.site.homeTitle nur die sichtbare Startseitenüberschrift der Sprache. Letztere sucht nichtleere Sprach-Fallbacks und zuletzt globalen Namen; siehe Startseitentitel. messages.siteTitle steuert beide derzeit nicht.

site.description ist nicht die sichtbare Einführung. Diese verwendet i18n.locales.<Sprachcode>.site.hero, die Startseitenmetabeschreibung zusätzlich messages.siteDescription. Priorität im Startseitenverzeichnis. Globale Änderungen ersetzen keine vorhandene persönliche About-Vorstellung.

Freigabebild-Priorität und Pfade

site.ogImage greift bei fehlendem Seitenbild im öffentlichen head. Artikel-ogImage, automatisches Bild und Titelbild können vorrangig sein, siehe Artikelverzeichnis. Es ersetzt keine automatischen Bilder bei aktiver Erzeugung.

/images/share.webp entspricht public/images/share.webp und muss vorher existieren. Fehlende Datei, Überschreiten von publicDir oder ungültiger Pfad werfen bei Auflösung Fehler. Lokale Bilder erhalten base und Inhaltsversionsparameter. HTTPS bleibt extern ohne Downloadvalidierung. Leer/Leerraum verwendet das Theme-Bild statt Metadaten zu entfernen.

site.ogImage ist ein String, kein Astro-image-import-Objekt. Artikel-frontmatter.ogImage hat andere Typen. Keine PUBLIC_SITE_OG_IMAGE-Überschreibung und keine Änderung von heroImage.

Umgebung und Domain-Priorität

Dies sind gelesene Umgebungsvariablen, keine zusätzlichen site.config-Felder. Alle string; ohne Angabe gilt das site-Feld. Nullish coalescing behandelt leer nicht automatisch als fehlend.

Variable Vorrang vor Beispiel
PUBLIC_SITE_TITLE site.title PUBLIC_SITE_TITLE=Mein Blog
PUBLIC_SITE_DESCRIPTION site.description PUBLIC_SITE_DESCRIPTION=Projekte und Lernnotizen
PUBLIC_SITE_AUTHOR site.author PUBLIC_SITE_AUTHOR=Alex
PUBLIC_SITE_TAGLINE site.tagline PUBLIC_SITE_TAGLINE=Neugierig bleiben
PUBLIC_SITE_URL site.url PUBLIC_SITE_URL=https://blog.example.com

Die Integration liest PUBLIC_SITE_URL entsprechend dev/build und –mode mit Vite-dotenv, damit Astro site und öffentliche URLs übereinstimmen. Bestehende Prozesswerte schlagen dotenv. Vergiss Hosting-PUBLIC_SITE_URL nicht, wenn nur site.url geändert wurde. Leer kann Text entfernen oder URLs ungültig machen, stellt keine Vorgaben wieder her.

Seitenseitiges SITE_URL behält import.meta.env.SITE als Kompatibilitätsstufe: PUBLIC_SITE_URL → SITE → site.url. Die Standardintegration setzt Astro site aus Umgebung/Konfiguration, head bevorzugt zudem Astro.site. SITE ist Adapter-Fallback, keine empfohlene separate Domainquelle.

Domain und Unterpfad sind verschieden. Astro base, Hosting-Ausgabe und DNS/HTTPS folgen dem Deployment-Tutorial. Beliebige Unterordner in site.url verschieben nicht alle Routen. Starte dev nach Änderung neu, online baue und veröffentliche erneut. Server-Redirects entstehen nicht.

Öffentliche Navigation: feste Einstiege plus Schalter

Kein öffentliches nav-Array, keine Reihenfolge oder eigene Menüfelder. Standardheader:

Position Quelle und Grenzen
Markenname site.title/Umgebung, führt zur aktuellen Sprachstartseite
Startseite, Blog Beide immer erhalten; messages.nav.home/blog ändern Beschriftung, nicht Ziel
About theme.enableAboutPage, boolean, Standard true; etwa theme: { enableAboutPage: false } entfernt Seite und Einstieg
Decoder unter Frontier theme.enableDecoderPage, boolean, Standard true; Headertext fest Decoder Lab
Fragments unter Frontier theme.fragments.enabled, boolean, Standard false; Label messages.fragments.title
Contact unter Frontier Bei aktivem About; messages.about.contact, führt zu /about/#contact der Sprache, unabhängig von Decoder
Suche theme.search.enabled, boolean, Standard true; Suchverzeichnis
Sprache und Status Aktive Sprachen, meta.label und statische Texte unten; keine freie Linkliste

Frontier-Name und -Titel sind fest; nur ohne alle Untereinträge entfällt es. messages.decoderPage.fullTool ändert Werkzeugseite und Fußzeilenlink, nicht Header-Decoder Lab.

Sprachen und Adressen stehen im Sprachenverzeichnis, About/Fragments/Decoder in eigenen Verzeichnissen. Leere Labels deaktivieren Navigation nicht und lassen unklare Knöpfe zurück.

Sieben Header- und Fußzeilentexte

Präfix i18n.locales.<Sprachcode>.messages, optionale string mit Sprachvorgaben und Fallback. Tabelle zeigt vereinfachtes Chinesisch/Englisch. Alle bedingt bei vorhandenem Bereich und Klartext ohne Markdown/HTML.

Relatives Feld Standard vereinfachtes Chinesisch / Englisch Wirkung und Grenzen Beispiel
nav.home 首页 / Home Startseitentext, keine Routenänderung "Start"
nav.blog 博客 / Blog Blogtext, keine Routenänderung "Beiträge"
nav.about 关于 / About About-Navigation und Wiederöffnen des Textfensters "Über mich"
nav.status system: online / system: online Statischer Headerstatus, keine Netzwerk-/API-/Gesundheitsmessung "System online"
nav.statusAria 系统状态 / System status Zugänglicher Statusname, kein Monitoring-Schalter "Websitestatus"
footer.theme 主题: / Theme by Präfix der Nennung; Anglefeint-Linktext/-ziel fest "Theme von"
footer.builtWith 构建工具: / Built with Astro-Präfix, Linktext/-ziel fest "Erstellt mit"

messages.langLabel gehört zur Sprachsteuerung, meta.label zu Optionen, siehe Sprachtexte. Contact/Fragments nutzen ihre Module, keine erfundenen messages.nav-Felder.

  • Typ / Standard: SocialLink[] / [], fünf Felder unten.
  • Status und Wirkung: wirksam in Header/Fußzeile in Array-Reihenfolge. Vollständiger Ersatz, ohne öffentliche Höchstzahl oder Sprachlisten.
  • Grenzen: [] verbirgt nicht alles. Es zeigt drei nicht klickbare Mastodon-/Twitter-/GitHub-Platzhalter, in dev mit Konfigurationshinweis. Leeres href eines echten Eintrags bleibt Link, nicht Platzhalter.
  • Beispiel: [{ label: ‘GitHub’, href: ‘https://github.com/yourname’, icon: ‘github’ }].

About-E-Mail und GitHub-Kontakt sind unabhängig. Kein theme.social.enabled oder hidePlaceholders; showPlaceholdersWhenEmpty ist Layoutparameter.

Präfix social.links[]. Pflichtfelder haben keine Ergänzung; auch wenn partielle Typen Teilobjekte erlauben, gib vollständige gültige Einträge an.

Feld Typ / Standard Status, Wirkung und Grenzen Beispiel
href string, Pflicht / keiner Wirksam: Zieladresse. Keine einheitliche Protokoll-/Existenz-/Nichtleerprüfung oder BASE_URL-Ergänzung. Vollständiges HTTPS oder korrekter interner Pfad, kein verifiziertes Konto ‘https://github.com/yourname’
label string, Pflicht / keiner Wirksam: zugänglicher Name, ohne Symbol auch sichtbar. Kein automatischer Plattform-/Zieltitel; klar und nichtleer ‘GitHub’
rel string, optional / nicht gesetzt, zuletzt mindestens noopener noreferrer Wirksam: Leerraum-getrennte Beziehungen, klein, dedupliziert, opener entfernt, Neufensterschutz erhalten. Leer hebt Schutz nicht auf; Nichtstring ist Fehler ‘me nofollow’
icon integriertes SocialIcon, optional / nicht gesetzt Bedingt: einer von zwölf Namen unten, ohne iconSrc verwendet. Unbekannt nichtleer ist Fehler; keine URL-Erkennung. Ohne beides label-Text ‘github’
iconSrc string, optional / nicht gesetzt Bedingt: lokaler SVG/PNG/WebP-Pfad in publicDir; gültig nichtleer vor icon. Nur Leerraum gilt als fehlend; falscher Typ/Regelverstoß ist Fehler ‘/icons/community.svg’

Echte Links öffnen neue Tabs. rel wird mit Schutzmarkern vereinigt. Labels sind kein HTML. Namen sind exakt und großschreibungsabhängig:

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

Dateiregeln eigener Symbole

public/icons/community.svg entspricht iconSrc: ‘/icons/community.svg’. Es muss eine echte Datei im publicDir sein, kein Paketasset oder src/assets. Ein einzelner Anfangs-/; keine URL, protokollrelative Adresse, Query/Fragment, Prozentkodierung oder . / ..-Segmente. Backslash, Doppelpunkt und Steuerzeichen sind verboten.

Der Build prüft Existenz, Datei und realen Pfad innerhalb publicDir, auch gegen ausbrechende Symlinks. Leerzeichen und chinesische Dateinamen kodiert die Komponente selbst; keine vorab prozentkodierten Pfade. Ausgaben erhalten Astro base. Symbolpriorität ändert href-Rohbehandlung nicht. JPG, GIF und andere Formate sind hier nicht unterstützt.

Bei gültigem iconSrc zählt icon nicht. Symbolgröße und Abstand sind Layoutparameter, keine SocialLink-Felder.

Vollständiger Pfad Typ / Standard Status, Wirkung und Grenzen Beispiel
theme.footer.showCredits boolean / true Wirksam: Theme-/Astro-Links. Entfernt nicht Copyright, soziale Links, Satz oder weitere Links. Steuert auch Nennung automatischer Artikelbilder, nicht eigene Bilder false
theme.footer.links { label: string; href: string }[] / [] Wirksam: eigene Links in Array-Reihenfolge, vollständiger Ersatz ohne Headeränderung. Layout kann Decoder ergänzen; [] garantiert keine linklose Fußzeile [{ label: ‘Projekt’, href: ‘https://example.com/project/’ }]
theme.footer.links[].label string, Pflicht / keiner Bedingt: sichtbarer Klartextname ohne automatischen Zieltitel ‘Projekt’
theme.footer.links[].href string, Pflicht / keiner Bedingt: unverändertes Ziel ohne Symbolpfadprüfung oder automatisches base; interne Pfade selbst korrekt setzen. Standard im aktuellen Tab ‘https://example.com/project/’

Eigene Links stehen vor Layout-Ergänzungen, ohne Deduplizierung. Aktiver Decoder ergänzt den vollständigen Werkzeuglink mit messages.decoderPage.fullTool. Deaktiviere bei Bedarf Decoder selbst, statt footer.links zu leeren.

Copyright zeigt fest Build-Jahr und wirksamen SITE_TITLE, ohne eigene copyright/year-Felder. site.tagline erscheint unabhängig von Nennungen; alter getrimmter Standard Built with Astro. entfällt aus Kompatibilität. showCredits false entfernt weder weitere Sätze noch bestehende Bildnennungen.

Erhalte persönliche Angaben und vereinige nur benötigte Felder:

site: {
  title: 'Alex’ Blog',
  description: 'Projekte, Lektüre und Alltag.',
  url: 'https://blog.example.com',
  author: 'Alex',
  tagline: 'Bleib neugierig und entwickle weiter.',
},
social: {
  links: [
    { label: 'GitHub', href: 'https://github.com/yourname', icon: 'github' },
    { label: 'Projektseite', href: 'https://example.com/project/' },
  ],
},
theme: {
  footer: {
    showCredits: true,
    links: [{ label: 'Projekt', href: 'https://example.com/project/' }],
  },
},

Ersetze Konten, Domains und Links. Das Theme prüft sie nicht online. Eigene Symbole und globale Bilder brauchen zuerst passende public-Dateien, dann iconSrc oder site.ogImage.

Nur deutsche Navigation und Präfixe:

i18n: {
  locales: {
    de: {
      messages: {
        nav: { home: 'Start', blog: 'Beiträge', about: 'Über mich' },
        footer: { theme: 'Theme von', builtWith: 'Erstellt mit' },
      },
    },
  },
},

Derzeit ungenutzt: messages.siteTitle

i18n.locales.<Sprachcode>.messages.siteTitle ist optionale string-Überschreibung; vereinfachtes Chinesisch und Englisch haben beide ‘Angle Feint’. Standardstartseitentitel und globale Identität lesen es nicht. Status „derzeit ungenutzt“. siteTitle: ‘Mein Blog’ ändert diese Namen nicht.

Startseitentitel verwendet i18n.locales.<Sprachcode>.site.homeTitle, öffentliche Marke oberstes site.title; siehe Startseite und Identität. Zum Umbenennen ist dieses reservierte Feld unnötig.

Kompatibilität und unwirksame Felder

  • Alle sechs site-Felder, soziale/Fußzeilenfelder und sieben Texte haben Verbraucher. Bildpriorität, Umgebung und Funktionsschalter entscheiden über konkrete Seitenwirkung.
  • Built with Astro. in site.tagline ist eine explizite Altstandard-Sonderregel, kein Verbot beliebiger Sätze.
  • messages.siteTitle bleibt ungenutzt. Ein akzeptierter Typ bedeutet keinen Seitenverbrauch.
  • homeHref, localeHrefs, extraLinks, showPlaceholdersWhenEmpty und iconSize sind Komponentenparameter, keine site.config-Felder. Kein öffentliches nav-Array, Platzhalterschalter, Copyrighttemplate oder separates Statusmonitoring.

Nach Konfiguration und Dateien neu bauen und veröffentlichen. Geänderte Umgebungen müssen im passenden Modus neu gelesen werden. Domain, Erreichbarkeit, Remote-Konten und Online-Wirkung prüfst du in deinem Deployment; lokale Typprüfung beweist sie nicht. Weitere Module im Gesamtverzeichnis.