← Zurück zu den Anleitungen

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

  1. Lege src/content/guide/de/YYYY-MM-DD-dein-slug.mdx an.
  2. Fülle das Frontmatter aus. title und description werden unverändert als <title> und <meta name="description"> verwendet — schreibe sie also als echte SEO-Texte mit etwa 60 bzw. 155 Zeichen.
  3. 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 auf noindex gesetzt.
  4. Schreibe den Text unterhalb des Frontmatters in Markdown oder MDX.
  5. Lege das englische Gegenstück unter src/content/guide/en/ mit demselben Slug an und verweise in beiden Dateien per linkedLocale aufeinander.
  6. Setze isDraft: false und ö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.

  • grundlagen
  • einrichtung