Zum Inhalt springen
⌘K

Ardo vs Nimbus

Vergleiche Dokumentationsabläufe mit React und Astro, UI-Zuständigkeiten, API-Referenzen, Agent-Dienste und Migrationswege.

Als Markdown ansehen
Auf dieser Seite

Ardo und Nimbus halten Dokumentation im Repository und veröffentlichen statisches HTML sowie Markdown für Agenten. Entscheidend sind das Komponentenmodell, die Pflege der Oberflächendateien und die benötigte Art der API-Referenz.

Geprüft am 10. November 2026 anhand der veröffentlichten Versionen Ardo 6.5.0, Nimbus 0.19.4 und Nimbus-Scaffolder 0.8.3. Die folgenden Nimbus-Quellen sind auf den Release-Commit von 0.19.4 festgelegt und verwenden kein unveröffentlichtes main. Ardo basiert auf dem Tag 6.5.0.

Welcher Ablauf passt?

Wähle Ardo, wenn Dokumentation und Beispiele dasselbe React-Komponentenmodell verwenden sollen, die API aus TypeScript stammt und du die UI als Paket aktualisieren möchtest. Eigene React-Root-Komponenten und Layouts bleiben möglich.

Wähle Nimbus, wenn die direkte Pflege der Layout-, Komponenten- und Stildateien für deinen Ablauf wichtig ist oder du die umfangreichere OpenAPI-Referenz und optionale serverseitige Agent-Dienste benötigst. Seine Projektstruktur trennt eigene Dateien von der Framework-Abhängigkeit; Updates überschreiben die Website nicht einfach.

Funktionsvergleich

BereichArdo 6.5.0Nimbus 0.19.4
SeitenmodellReact-Seiten und MDX, vorgerendert und hydriert; normale Dokumentnavigation.Astro-Seiten und MDX. Interaktive Framework-Komponenten verwenden Astro Islands.
UI-ZuständigkeitDie UI wird im Paket geliefert; mit React kombinierbar oder ersetzbar.Generierte Layouts, Komponenten und Stile liegen in deinem Repository.
API-ReferenzNative TypeScript-Referenz und statischer Generator für lokale OpenAPI-Dateien.OpenAPI 3.x mit eigenen Operationen, Schemas, API-Versionen und Referenzoberfläche.
SprachenVollständige statische Sprachbäume; die vier Sprachen dieser Website verwenden Palamedes-Kataloge.Nimbus stellt eine Dokumentensprache für die Website bereit; Sprachrouting und Übersetzung liegen beim Astro-Projekt.
VersionierungStatische Snapshots großer Versionen; Guide-/API-Verzeichnisse lassen sich unabhängig von Website-Seiten versionieren.Getrennte Inhaltssammlungen und Pfade für ältere Dokumentationsversionen; API-Versionen besitzen ein eigenes Modell.
SucheIntegriertes MiniSearch mit generierten Indizes.Statische Pagefind-Suche oder ein eigener Anbieter des Projekts.
Dateien für AgentenMarkdown pro Seite, llms.txt, llms-full.txt und optionale Agent-Skills-Erkennung.Markdown und llms.txt, mit optionalen Agent-Diensten.
MCPKein vom Framework bereitgestellter MCP-Endpunkt zur Laufzeit.Optionales Remote-MCP: list_pages und get_page; benötigt Serveradapter und SDK.
Prüfung und Lintingardo check ohne Build, ardo lint für Inhalte und Prüfung interner Links beim Build.nimbus-docs check und lint, einschließlich Korrekturen und Upgrade-Prüfungen.
Rezepteardo add gibt zur Version passende Rezepte aus und schreibt keine Dateien.add kopiert Komponentenquellcode; Funktionen liefern einem Agenten Rezepte.
JavaScript im BrowserReact-Hydration und interaktive UI; kein Client-Router.Astro Islands mit den gewählten Komponenten und Skripten; die übertragene Datenmenge hängt von dieser Zusammenstellung ab.
HostingStatische Dateien auf jedem statischen Host.Standardmäßig statisch; Rendering bei Anfragen und Remote-MCP benötigen einen Serveradapter.

Ardos API-Leitfaden, Konfiguration, Internationalisierung und Agent-Anleitung erläutern die Ardo-Seite dieser Tabelle. Nimbus hat Version 1.0 noch nicht erreicht; prüfe die Versionshinweise, bevor du bei einer späteren Minor-Version identisches Verhalten voraussetzt.

Umstieg von Nimbus

Nimbus-ProjektArdo-Entsprechung oder Migrationsaufwand
src/content/docs/Verschiebe Inhalte nach app/routes/, bei entsprechender Konfiguration mit Sprach- und guide-Verzeichnissen. Erhalte alte URLs durch ausdrückliche Weiterleitungen.
title, description, sidebar.orderBehalte title und description; übertrage sidebar.order nach order. Prüfe andere Frontmatter-Felder einzeln.
mode: customVerwende layout: bare für eine Seite ohne Dokumentationsrahmen.
src/components.ts und Astro-KomponentenPrüfe jede Komponente und ihre Props; portiere Astro-Code nach React oder nutze Ardos MDX-Komponenten. Eine automatische Komponentenkonvertierung gibt es nicht.
astro.config.ts und nimbus()Verwende ardo.config.ts für Framework-Optionen und eigene Vite-Plugins, app/root.tsx für den UI-Aufbau.
OpenAPI-ReferenzenBeginne mit Ardos lokaler openapi-Konfiguration. Nimbus-API-Versionen, Schemaansichten und interaktive Referenzfunktionen lassen sich nicht direkt übertragen.

Prüfe vor dem Umzug Entwürfe, verborgene Seiten und Veröffentlichungsregeln; Nimbus-Schalter behalten in Ardo nicht automatisch ihre Bedeutung. Folge der Einrichtungsanleitung und prüfe veröffentlichte Routen, Links und Beispiele in einer Produktionsvorschau.

Lücken und laufende Arbeiten

Nimbus unterstützt außerdem Git-Inhaltsquellen und Teil-Builds. Die entsprechenden Ardo-Vorschläge bleiben #473 und #474. Ein Checkout in CI mit anschließender lokaler Inhaltszuordnung ist bereits heute möglich.

Ardos Inhaltskomponenten, check/lint-Befehle, statisches Mermaid-Rendering und Rezepte sind bereits implementiert: #469, #470, #472 und #475. Automatische Vorschaubilder für Seiten werden in #471 verfolgt; sie gehören nicht zur hier verwendeten veröffentlichten Version 6.5.0.

Diese Seite auf GitHub bearbeitenZuletzt aktualisiert: 13. November 2026