<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="de">
<id>https://ardo-docs.dev/de/news/</id><title>Ardo News</title>
<link rel="self" href="https://ardo-docs.dev/de/news/atom.xml"/><link href="https://ardo-docs.dev/de/news/"/>
<updated>2026-11-01T22:02:42.000Z</updated>
<entry><id>urn:ardo:post:e26831f6-8a6f-45c9-9683-c51b25f88161</id><title>Ardo 6.1: Platz für Neuigkeiten</title><link href="https://ardo-docs.dev/de/news/ardo-6-1/"/><published>2026-11-01T22:02:42.000Z</published><updated>2026-11-01T22:02:42.000Z</updated><author><name>Sebastian Werner</name><uri>https://github.com/swernerx</uri></author><category term="Releases"/><content type="html">&lt;p&gt;Ein Projekt braucht einen Ort, an dem es neue Entwicklungen erklären kann. Ein
Release verdient mehr Kontext als eine Commit-Liste, und eine technische
Entscheidung kann weit über ihren Pull Request hinaus interessant sein.
Ardo 6.1 gibt solchen Geschichten einen Platz neben der Dokumentation.&lt;/p&gt;
&lt;p&gt;Du liest gerade eine davon. Dieser News-Bereich verwendet dieselbe
Publikationsfunktion, die jedem Ardo-Projekt zur Verfügung steht: Artikel
liegen im Repository und werden als statische Seiten gebaut.&lt;/p&gt;
&lt;h2 id=&quot;beiträge-bleiben-beim-projekt&quot;&gt;Beiträge bleiben beim Projekt&lt;/h2&gt;
&lt;p&gt;Ein Artikel entsteht in Markdown oder MDX. Titel, Veröffentlichungsdatum,
stabile ID und Autorenverweise stehen im Frontmatter. Ardo erzeugt daraus eine
Seite und einen chronologischen Index. Gemeinsame Autorenprofile halten Namen,
Porträts und Links an einer Stelle; ein Artikel kann mehrere Autoren nennen.&lt;/p&gt;
&lt;p&gt;Eine Publikation beginnt mit einem lokalen Quellverzeichnis und einem
Autorenverzeichnis:&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-ts&quot;&gt;import { defineArdoConfig } from &amp;quot;ardo/config&amp;quot;

export default defineArdoConfig({
  title: &amp;quot;My project&amp;quot;,
  siteUrl: &amp;quot;https://example.com&amp;quot;,
  publication: {
    from: &amp;quot;posts&amp;quot;,
    authors: { team: { name: &amp;quot;Project team&amp;quot; } },
  },
})
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Über Atom oder RSS erhalten Leser den vollständigen portablen Artikel. Braucht
eine MDX-Komponente außerhalb der Website eine Erklärung, sorgt eine explizite
Markdown-Fassung für einen brauchbaren Feed. Entwürfe und zukünftige Beiträge
werden nicht veröffentlicht. Ein geplanter Beitrag wird bei einem Build ab
seinem Veröffentlichungszeitpunkt berücksichtigt.&lt;/p&gt;
&lt;h2 id=&quot;bilder-aus-lokalen-originalen-aufbereiten&quot;&gt;Bilder aus lokalen Originalen aufbereiten&lt;/h2&gt;
&lt;p&gt;Quellbilder können neben dem Beitrag liegen. Ardo erzeugt responsive
AVIF-Auflösungen und ein JPEG als Fallback mit höchstens 1280 Pixeln Breite. Die
generierten Dateien gehören zum Build; im Repository bleiben die Originale.&lt;/p&gt;
&lt;p&gt;Ohne Angaben zum Bildausschnitt bleibt die Komposition erhalten. Optionale
Kern- und Wunschbereiche ermöglichen Zuschnitte in 16:10 und 4:3, die das Motiv
erhalten. Darstellungsvorlagen wählen den Ausschnitt über Media-Bedingungen am
&lt;code&gt;picture&lt;/code&gt;-Element; per &lt;code&gt;srcset&lt;/code&gt; wählt der Browser die Auflösung. Die Verarbeitung
läuft lokal mit Sharp und libvips.&lt;/p&gt;
&lt;h2 id=&quot;versionierung-bekommt-eine-engere-aufgabe&quot;&gt;Versionierung bekommt eine engere Aufgabe&lt;/h2&gt;
&lt;p&gt;Die Adresse eines Release-Beitrags sollte sich nicht ändern, wenn die
Dokumentation zur nächsten Hauptversion wechselt. Dasselbe gilt für die
Startseite eines Projekts.&lt;/p&gt;
&lt;p&gt;Mit &lt;code&gt;versioning.directories&lt;/code&gt; lassen sich ganze Dokumentationsordner auswählen,
etwa &lt;code&gt;guide&lt;/code&gt; und &lt;code&gt;api-reference&lt;/code&gt;. Ihre Seiten behalten Versionspräfixe; alles
außerhalb bleibt von der Dokumentationsversion unabhängig. Bestehende Websites
behalten ihr bisheriges Verhalten, bis sie diese Option aktivieren. Diese
Website nutzt die Trennung jetzt für Startseite, News, Guides und API-Referenz.&lt;/p&gt;
&lt;p&gt;Das Release ergänzt außerdem Update-Prüfungen in der CLI und eine optionale
Nutzungsberichterstattung. Die Berichterstattung setzt eine ausdrückliche
Zustimmung voraus und ist von Update-Prüfungen getrennt. Mit &lt;code&gt;ardo telemetry&lt;/code&gt;
lässt sie sich einsehen und verwalten.&lt;/p&gt;
&lt;p&gt;Der &lt;a href=&quot;https://ardo-docs.dev/v6/de/guide/publications/&quot;&gt;Publikations-Guide&lt;/a&gt; erklärt Autoren, Bilder, Feeds,
Lokalisierung und Einrichtung. Metadaten folgen, wo passend, den Namen von
Standard.site. Das Veröffentlichen in ein AT-Protocol-Konto bleibt ein späterer
Schritt. Die &lt;a href=&quot;https://github.com/sebastian-software/ardo/releases/tag/ardo-v6.1.0&quot;&gt;Release Notes zu v6.1&lt;/a&gt;
enthalten die vollständige Änderungsliste.&lt;/p&gt;
</content></entry>
<entry><id>urn:ardo:post:b84b6328-070e-46de-97d6-7edcc1000d60</id><title>Ardo 6: React-Dokumentation, als HTML ausgeliefert</title><link href="https://ardo-docs.dev/de/news/ardo-6/"/><published>2026-10-29T21:10:31.000Z</published><updated>2026-10-29T21:10:31.000Z</updated><author><name>Sebastian Werner</name><uri>https://github.com/swernerx</uri></author><category term="Releases"/><content type="html">&lt;p&gt;Ardo 6 verändert, wie eine Dokumentationswebsite ihre Leser erreicht. Jede Seite
wird als vollständiges HTML-Dokument gebaut. Guides, API-Referenz und Suchdaten
entstehen vor dem Deployment. Das Ergebnis lässt sich auf einem statischen
Host ausliefern.&lt;/p&gt;
&lt;p&gt;Für Autoren bleibt der Einstieg vertraut: Markdown oder MDX schreiben,
React-Komponenten einbinden und die Website neben dem beschriebenen Code
pflegen. Dieses Release macht den Weg dorthin direkter.&lt;/p&gt;
&lt;h2 id=&quot;ein-dokument-bei-jedem-aufruf&quot;&gt;Ein Dokument bei jedem Aufruf&lt;/h2&gt;
&lt;p&gt;Ardo 6 entfernt React Router aus der Website-Architektur. Ein Seitenlink lädt
ein neues Dokument. Dessen HTML enthält bereits den angefragten Inhalt,
einschließlich hervorgehobener Codeblöcke und generierter API-Beschreibungen.
Interaktive Beispiele und Website-Bedienelemente laufen nach der Hydration
weiterhin mit React.&lt;/p&gt;
&lt;p&gt;Auch die Einrichtung ändert sich: Ardo verwaltet passende Versionen von React,
React DOM und Vite. Ein Dokumentationsprojekt verwendet Ardos React-Einstiegspunkte
und JSX-Konfiguration und muss dadurch weniger Framework-Abhängigkeiten selbst
aufeinander abstimmen.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://ardo-docs.dev/assets/posts/4a68e74e8668f3c03b5f.jpg&quot; alt=&quot;Ein Ardo-Guide mit Bereichsnavigation, Inhaltsverzeichnis und hervorgehobenem Konfigurationsbeispiel.&quot;&gt;&lt;/p&gt;
&lt;h2 id=&quot;native-werkzeuge-übernehmen-die-vorbereitung&quot;&gt;Native Werkzeuge übernehmen die Vorbereitung&lt;/h2&gt;
&lt;p&gt;Ferromark kompiliert Markdown und MDX zu React-Modulen. Ferriki hebt Codeblöcke
während der Kompilierung hervor und bereitet die Farben für den hellen und
dunklen Modus vor. Beides geschieht, bevor ein Leser die Seite öffnet.&lt;/p&gt;
&lt;p&gt;Auch die API-Referenz ist neu aufgebaut. Ardo liest TypeScript-Exporte über den
nativen TypeScript-Compiler und erstellt die Referenz selbst. Das ersetzt die
TypeDoc-Integration. Komponenten und ihre Props gehören zusammen; Signaturen,
Parameter und Kommentare werden zu durchsuchbaren Seiten. Für diese Analyse
verwendet das Release eine festgelegte Nightly-Version von TypeScript 7.&lt;/p&gt;
&lt;p&gt;Der &lt;a href=&quot;https://github.com/sebastian-software/ardo/blob/ardo-v6.0.0/docs/reports/2026-10-29-release-benchmark.md&quot;&gt;Benchmark-Bericht zum Release&lt;/a&gt;
beschreibt die gemessenen Aufgaben, den Rechner und die Grenzen der
veröffentlichten Zeitmessungen.&lt;/p&gt;
&lt;h2 id=&quot;auch-der-website-rahmen-ist-react&quot;&gt;Auch der Website-Rahmen ist React&lt;/h2&gt;
&lt;p&gt;Header, Sidebars und Footer lassen sich als Kinder von &lt;code&gt;ArdoRoot&lt;/code&gt; zusammensetzen.
Theme, Logo und Icon werden in JSX übergeben. Gestaltung und Layout liegen damit
dort, wo React-Entwickler ohnehin mit Komponenten arbeiten.&lt;/p&gt;
&lt;p&gt;Dazu kommen viele Verbesserungen beim Lesen: Suchergebnisse zeigen Textauszüge,
der schmale Header lässt dem Inhalt mehr Platz, und der Build prüft interne
Links und Sprungmarken im erzeugten HTML. Ardos eigene Guides gibt es jetzt auf
Englisch, Deutsch, Französisch und Spanisch. Palamedes verwaltet ihre
Übersetzungen aus einer gemeinsamen englischen Quelle.&lt;/p&gt;
&lt;h2 id=&quot;eine-bestehende-website-auf-v6-umstellen&quot;&gt;Eine bestehende Website auf v6 umstellen&lt;/h2&gt;
&lt;p&gt;Dies ist ein Major-Release. Router-Einstiegsdateien und die zugehörige
Konfiguration entfallen, die native API-Generierung ersetzt die
TypeDoc-Konfiguration, und Theme-Einstellungen wandern zu &lt;code&gt;ArdoRoot&lt;/code&gt;.
Voraussetzung ist Node.js 22.22 oder neuer.&lt;/p&gt;
&lt;p&gt;Der &lt;a href=&quot;https://ardo-docs.dev/v6/de/guide/releases/upgrade-to-v6/&quot;&gt;Upgrade-Guide für v6&lt;/a&gt; führt durch die
Umstellung. Für eine neue Website beginnt der Weg bei
&lt;a href=&quot;https://ardo-docs.dev/v6/de/guide/getting-started/&quot;&gt;Erste Schritte&lt;/a&gt;. Die
&lt;a href=&quot;https://github.com/sebastian-software/ardo/releases/tag/ardo-v6.0.0&quot;&gt;vollständigen Release Notes zu v6.0&lt;/a&gt;
enthalten alle einzelnen Änderungen und entfernten Funktionen.&lt;/p&gt;
</content></entry>
</feed>
