﻿---
title: "Konfigurationsverzeichnis: Website, Navigation, soziale Links und Fußzeile"
description: "Alle Website-, Social- und Fußzeilenfelder einschließlich Umgebung, Bildpfaden und ungenutztem siteTitle."
url: "https://demo.anglefeint.com/de/blog/config-site-chrome/"
language: "de"
author: "Anglefeint"
published: "2026-11-13T00:00:00.000Z"
updated: "2026-11-13T00:00:00.000Z"
---

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

Für erste eigene Angaben lies [Installation und Website-Angaben](https://demo.anglefeint.com/de/blog/starter-guide-1-configure-your-site/), für Domain und Deployment [Veröffentlichen](https://demo.anglefeint.com/de/blog/starter-guide-deployment/). Andere Module im [Gesamtverzeichnis](https://demo.anglefeint.com/de/blog/config-reference/).

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](https://demo.anglefeint.com/de/blog/config-home/#home-title). 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](https://demo.anglefeint.com/de/blog/config-home/#site-fallbacks). 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](https://demo.anglefeint.com/de/blog/config-article/#frontmatter). 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](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](https://demo.anglefeint.com/de/blog/config-search/#enabled) |
| 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](https://demo.anglefeint.com/de/blog/config-languages/#content-and-seo), 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](https://demo.anglefeint.com/de/blog/config-languages/#common-messages). Contact/Fragments nutzen ihre Module, keine erfundenen messages.nav-Felder.

## social.links: gemeinsame soziale Links

*   **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’](https://github.com/yourname%E2%80%99), icon: ‘github’ }\].

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

### Fünf Felder jedes SocialLink

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](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:

```text
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.

## theme.footer: Links und Nennung

| 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/’](https://example.com/project/%E2%80%99) }\] |
| 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/](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.

## Beispiele für Identität und Links

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

```ts
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:

```ts
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](https://demo.anglefeint.com/de/blog/config-home/#home-title) und [Identität](https://demo.anglefeint.com/de/blog/config-site-chrome/#identity). 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](https://demo.anglefeint.com/de/blog/config-reference/).
