Warum der Foto-Baum keine Content Collection mehr ist

Als meine alte Astro-Seite zweisprachig wurde, verließ der Foto-Baum den Content Layer: Jedes Foto braucht beide Sprachen in einer Datei.

Im März 2026 habe ich den Foto-Baum meiner alten Seite als Content Collection gebaut: eine rekursive collections_photos-Collection, ein index.md pro Knoten, geladen über den Content Layer von Astro. Kurz danach kam ein Flag dazu, das Sets von Kategorie-Knoten trennt. Beides habe ich damals nur auf Englisch beschrieben. Im Juli lief von diesem Code nichts mehr. Der Foto-Baum lud über import.meta.glob und einen selbstgeschriebenen Frontmatter-Parser, nicht mehr über defineCollection(). Der Grund war weder Performance noch Geschmack. Die Seite war inzwischen zweisprachig, und eine Content Collection kann nicht abbilden, was ein zweisprachiges Foto braucht.

Was kaputtging

Die Content Collections der Seite hatten einen Entry pro Sprache. Die id eines Posts war <locale>/<slug>, die deutsche und die englische Fassung eines Artikels also zwei Dateien und zwei Entries, nachträglich über einen gemeinsamen translationKey verbunden. Für Artikel passt das. Einen ganzen Post pro Sprache zu haben ist normal, und die beiden Fassungen dürfen in der Formulierung leicht auseinandergehen.

Bei einem Foto geht das nicht. Es braucht einen deutschen und einen englischen Titel gleichzeitig, in derselben Anfrage, weil die Detailseite je nach Sprache des Besuchers den passenden zeigt. Wer auf diesem Foto die Sprache wechselt, muss auf demselben URL-Slug landen. Zwei Entries mit derselben Foto-ID und verschiedenem Sprach-Präfix bilden das nicht ab. Sie beschreiben zwei Fotos, die zufällig denselben Dateinamen haben.

Die index.md-Knoten haben eine Ebene höher dasselbe Problem. travels/asia/chiang-mai/index.md braucht beide Titel in einer Datei, nicht zwei Dateien, die beide den Slug chiang-mai beanspruchen.

Was stattdessen läuft

src/lib/photos.ts liest den Baum direkt mit Vites import.meta.glob, eager, zur Build-Zeit:

const imageModules = import.meta.glob<{ default: ImageMetadata }>(
  '../content/photos/**/img/*.jpg',
  { eager: true },
);

const jsonModules = import.meta.glob<PhotoMeta>(
  '../content/photos/**/img/*.json',
  { eager: true, import: 'default' },
);

const indexMarkdownModules = import.meta.glob<string>(
  '../content/photos/**/index.md',
  { eager: true, query: '?raw' },
);

Das Frontmatter der index.md-Dateien liest eine kleine Funktion parseFrontmatter() in derselben Datei, ohne die Zod-Validierung von Astro. Jedes Feld, das übersetzt werden muss, ist ein Record mit der Sprache als Schlüssel, bis hinunter zum Foto-Sidecar:

export interface PhotoMeta {
  id: string;
  title: Record<Locale, string[]>;
  alt: Record<Locale, string>;
  tags: Record<Locale, string[]>;
  location: string;
  date: string;
  exif: { camera?: string; lens?: string; /* … */ };
}

export interface PhotoNode {
  slug: string;
  titles: Partial<Record<Locale, string>>;
  descriptions?: Partial<Record<Locale, string>>;
  category?: Partial<Record<Locale, string>>;
  tags?: Partial<Record<Locale, string[]>>;
  isSet: boolean;
  childSlugs: string[];
  // …
}

Ein Sidecar wie 2025-03-09-112512.json trägt jetzt title.de und title.en in einer Datei, direkt neben dem JPG, das es beschreibt. Keine Kopie, kein zweiter Entry, den du synchron halten musst, kein Nachschlagen über den Translation-Key beim Rendern.

Was geblieben ist

Das Flag set: true steht an derselben Stelle im Frontmatter und tut dasselbe: Es sagt der Archivseite, welche Knoten fertige Foto-Sets sind und welche reine Navigation wie travels/asia/. Diese Entscheidung musste ich nicht anfassen, nur das Laden darunter.

Auch die Idee, dass das Verzeichnis die Route ist, hat überlebt. Sie verteilt sich jetzt auf zwei Routendateien: src/pages/photos/[...slug].astro für Englisch und src/pages/de/fotos/[...slug].astro für Deutsch. Beide lesen denselben Baum aus PhotoNode und Photo und zeigen das Feld in der Sprache ihrer Route. Aus der einen Route vom März wurden zwei Routen über denselben Daten.

Zum Mitnehmen

  • Eine Content Collection bildet einen Entry pro Sprache gut ab. Ein Ding, das jede Sprache in einer einzigen Datei tragen muss, bildet sie nicht ab, und Fotos mit zweisprachigen Metadaten sind so ein Ding.
  • Wenn ein bestehendes Feature Übersetzungen bekommt, prüf, ob sein Datenmodell eine Sprache pro Datensatz voraussetzt. Dann hilft meist keine Config-Änderung, sondern nur ein neuer Aufbau des Datensatzes.
  • Klär vor einem Umbau, welche Teile eines Designs mit dem Laden von Daten zu tun haben. Der Rest, wie das set-Flag oder Verzeichnisse als Routen, kann bleiben.

Mehr dazu

Thema
  • Statische Website Eine Website aus fertigen HTML-Dateien, die einmal gebaut und dann unverändert ausgeliefert werden. Kein Servercode, keine Datenbank.
Erwähnt in
Schlagwörter

In der Graph-Ansicht zeigen →