--- title: Update description: Timelineartige Changelog-Einträge mit Datum, Beschreibung und Kategorie-Tags, integriert in Ihr Inhaltsverzeichnis zur Navigation. --- > **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version. Die Update-Komponente erstellt Changelog-Einträge im Timeline-Stil, die automatisch in Ihr Inhaltsverzeichnis integriert werden. Jeder Eintrag kann ein Datumslabel, eine Beschreibung und Kategorie-Tags enthalten. Damit eignet sich die Komponente für „Was ist neu?“-Seiten, API-Changelogs und Versionshinweise. Verwenden Sie Update zum: - **Dokumentieren von Releases** mit Versionsnummern oder Datumsangaben - **Erstellen von Changelogs**, die Leser über das Inhaltsverzeichnis durchsuchen können - **Ankündigen von Funktionen** mit kategorisierten Tags (new, fix, breaking) Sie haben aus diesen Einträgen einen Changelog erstellt? Mit einer „Was ist neu?“-Schaltfläche und einem Punkt für ungelesene Einträge können Sie ihn in Ihrem eigenen Produkt anzeigen. Siehe [Changelog einbetten](/de/development/embed-page). ## Grundlegende Verwendung Unterstützung für den Dark Mode in allen Themes hinzugefügt. ```mdx Added support for dark mode across all themes. ``` ## Mit Beschreibung Fügen Sie unter dem Datum zusätzlichen Kontext hinzu: Die Funktion `getData()` erfordert jetzt ein Optionsobjekt. ```mdx The `getData()` function now requires an options object. ``` ## Mit Tags Kategorisieren Sie Einträge mit Tags: - Veraltete Option `legacyMode` entfernt - Authentifizierungsablauf aktualisiert ```mdx - Removed deprecated `legacyMode` option - Updated authentication flow ``` ## Mehrere Einträge Stapeln Sie Update-Komponenten für einen vollständigen Changelog: Neue Exportfunktion für PDF- und CSV-Formate. Zeitzonenverarbeitung in geplanten Beiträgen korrigiert. Die `v1`-API-Endpoints sind jetzt veraltet. Migrieren Sie bis März 2025 zu `v2`. ## Ankerlinks und Inhaltsverzeichnis Jedes Update generiert eine Anker-ID aus seinem Label (`label="January 10, 2025"` erstellt `#january-10-2025`). Labels werden außerdem zur schnellen Navigation im Inhaltsverzeichnis angezeigt. ## Props Datums- oder Versionslabel (erstellt eine Anker-ID). Sekundärtext unter dem Label. Als Badges angezeigte Kategorie-Tags. ISO-Datumszeichenfolge (z. B. `"2025-03-15"`), die für den RSS-Feed als `pubDate` verwendet wird. Wird nicht visuell dargestellt; das `label` bleibt Ihr Anzeigetext. ## RSS-Feed Ermöglichen Sie Ihren Lesern, Changelog-Aktualisierungen zu abonnieren. Fügen Sie jeder Seite mit Update-Komponenten `rss: true` hinzu. Jamdesk generiert dann während des Builds automatisch eine `feed.xml`. ```yaml --- title: Changelog rss: true --- ``` Wenn diese Option aktiviert ist: - Neben dem Seitentitel wird ein RSS-Symbol angezeigt, das auf den Feed verweist. - Für die automatische Erkennung wird dem `` ein ``-Tag hinzugefügt, sodass RSS-Reader und Browser den Feed automatisch finden können. - Jedes `` wird zu einem RSS-Element, dessen Titel dem Label entspricht und das einen Ankerlink zurück zum Eintrag enthält. ### Veröffentlichungsdaten festlegen Verwenden Sie die `date`-Prop, um das `` für jeden Eintrag im Feed festzulegen. Ohne `date` erscheint der Eintrag im Feed, jedoch ohne Zeitstempel. ```mdx Added dark mode support across all themes. ``` ### Feed-Inhalt RSS-Feeds enthalten ausschließlich Klartext. Markdown-Formatierung, MDX-Komponenten, Codeblöcke und HTML werden aus der Feed-Beschreibung entfernt. Formulieren Sie daher den ersten Satz als klare Zusammenfassung, die auch ohne Formatierung funktioniert. ### Feed-URL Der Feed ist unter `/feed.xml` verfügbar (oder unter `/docs/feed.xml`, wenn Ihre Website [hostAtDocs](/de/deploy/custom-domains) verwendet). Der generierte Feed sieht folgendermaßen aus: ```xml Acme Docs Changelog https://docs.acme.com Updates and changelog for Acme Docs March 2025 — New dashboard https://docs.acme.com/changelog#march-2025 Sat, 15 Mar 2025 00:00:00 GMT Added dark mode support across all themes. ``` ### Integration mit anderen Tools Abonnenten können die Feed-URL mit jedem RSS-kompatiblen Dienst verwenden: - Slack: Fügen Sie den [RSS-App](https://slack.com/apps/A0F81R7U7-rss) `/feed` zu einem Channel hinzu. - Discord: Verwenden Sie [MonitoRSS](https://monitorss.xyz/) oder einen ähnlichen Bot, um Aktualisierungen automatisch zu veröffentlichen. - E-Mail: Verbinden Sie den Feed mit [Zapier](https://zapier.com/) oder [IFTTT](https://ifttt.com/), um Abonnenten über neue Einträge zu informieren. - Browser: Safari, Vivaldi und Firefox (über Erweiterungen) unterstützen RSS nativ. Sie können mehreren Seiten `rss: true` hinzufügen. Alle Update-Einträge auf RSS-aktivierten Seiten werden zu einer einzigen websiteweiten `feed.xml` zusammengeführt. ## Bewährte Vorgehensweisen Jedes Label erstellt eine Anker-ID. Verwenden Sie daher eindeutige Labels, um eine korrekte Verlinkung auf bestimmte Inhalte sicherzustellen: - Verwenden Sie konkrete Datumsangaben: `January 10, 2025` (nicht nur `January 2025`) - Fügen Sie Versionsnummern ein: `v2.1.0` gegenüber `v2.0.0` - Doppelte Labels erstellen doppelte IDs und beeinträchtigen die Ankernavigation. Wählen Sie ein Format und verwenden Sie es konsequent: - `January 10, 2025` (empfohlen) - `2025-01-10` (ISO-Format) - `v2.0.0` (für versionsbasierte Changelogs) Häufige Tags mit automatischer Farbcodierung: | Tag | Farbe | Verwendung | |-----|-------|------------| | `breaking` | Rot | Breaking Changes | | `feature` / `new` | Grün | Neue Funktionen | | `deprecation` / `deprecated` | Bernstein | Veraltete Funktionen | | Andere Tags | Grau | Allgemeine Kategorien wie `api`, `fix` | - Beginnen Sie mit der wichtigsten Änderung. - Verwenden Sie Aufzählungen für mehrere Punkte. - Verlinken Sie bei komplexen Änderungen auf eine ausführliche Dokumentation. ## Wie geht es weiter? Alle verfügbaren Komponenten durchsuchen Erfahren Sie, wie Sie Komponenten in MDX verwenden.