Erste Schritte mit Transcriber
Dies ist ein Beispielbeitrag. Er existiert, damit der Anleitungsbereich etwas darstellen kann und sich Übersicht, Einzelseite und RSS-Feed vollständig prüfen lassen. Sobald echte Inhalte vorliegen, kann er ersetzt oder gelöscht werden.
Wie dieser Bereich funktioniert
Jeder Beitrag ist eine MDX-Datei unter src/content/guide/<locale>/ mit dem
Namensschema YYYY-MM-DD-slug.mdx. Das Datum im Dateinamen dient nur der
Sortierung auf der Festplatte — für Sortierung und Anzeige auf der Website zählt
ausschließlich das Feld publishDate im Frontmatter.
Einen Beitrag anlegen
- Lege
src/content/guide/de/YYYY-MM-DD-dein-slug.mdxan. - Fülle das Frontmatter aus.
titleunddescriptionwerden unverändert als<title>und<meta name="description">verwendet — schreibe sie also als echte SEO-Texte mit etwa 60 bzw. 155 Zeichen. - Setze während der Arbeit
isDraft: true. Entwürfe werden weiterhin gebaut und sind über die direkte URL erreichbar, tauchen aber nicht in der Übersicht, im Feed oder in der Sitemap auf und sind aufnoindexgesetzt. - Schreibe den Text unterhalb des Frontmatters in Markdown oder MDX.
- Lege das englische Gegenstück unter
src/content/guide/en/mit demselben Slug an und verweise in beiden Dateien perlinkedLocaleaufeinander. - Setze
isDraft: falseund öffne einen Pull Request. Über den Preview-Link am PR lässt sich der Beitrag in beiden Sprachen prüfen, bevor er live geht.
Formatierung
Standard-Markdown funktioniert überall — Überschriften, Listen, Tabellen und Codeblöcke:
npm run dev
Da es sich um MDX-Dateien handelt, lassen sich Astro-Komponenten direkt im Text importieren und verwenden, wenn Markdown allein nicht ausreicht.