Versiones
Qué ofrece Ardo 6, las funciones experimentales o previstas y las guías de migración.
En esta página
Ardo publica framework, interfaz y ejecución en un único paquete. Esta página distingue funciones disponibles, experimentales y previstas. El registro de cambios detalla cada versión.
Guías de actualización
- Actualizar a Ardo 6 desde Ardo 5: build estático sin React Router y menos archivos.
- Actualizar a Ardo 5 desde Ardo 4: Ferromark para Markdown/MDX y Ferriki para resaltado.
- Actualizar a Ardo 4.0 desde Ardo 3: URL estables por versión mayor.
- Migrar desde TypeDoc: la referencia nativa reemplaza
typedoc.
Los agentes siguen estas guías mediante las Instrucciones para agentes.
Disponible
Estas funciones están disponibles en la línea actual.
| Área | Notas |
|---|---|
| Build estático | Vite con HTML por página, rutas por archivos y sin router cliente. |
| Markdown y MDX | Markdown, MDX, GFM, frontmatter, índice y componentes integrados. |
| Resaltado de sintaxis | Ferriki durante el build para código Markdown y CodeBlock estáticos. |
| Búsqueda | Datos generados e interfaz integrada. |
| Referencia API nativa | API TypeScript mediante api en ardo.config.ts. |
| Colecciones | Archivos locales validados por esquema, rutas y registros tipados para React. |
| Metadatos para redes sociales | URL canónicas, Open Graph y Twitter para Markdown. |
| Salidas SEO | Sitemap, robots, textos LLM, enlaces y redirecciones. |
| Colores del tema | Los tonos de marca, acento y neutros recolorean la paleta predeterminada mediante la prop de tema de ArdoRoot o CSS. |
| Componentes | Avisos, insignias, tarjetas, pestañas, acordeones, pasos, código, iconos, hero y funciones: Componentes. |
Experimental
Estas áreas funcionan, pero su API o mantenimiento aún puede evolucionar.
| Área | Notas |
|---|---|
| SDK del compilador nativo | TypeScript 7.1 nightly fijado; compatibilidad y estabilidad requieren atención. |
| Tokens de tema | Variables CSS y tokens Vanilla Extract públicos; otras API pueden cambiar. |
| Versiones de documentación | Carpetas estáticas, redirecciones raíz, versions.json, selector y aviso de versión antigua. |
| i18n estático | Árboles completos, búsqueda e interfaz localizadas, enlaces alternativos y rechazo de traducciones ausentes: Internacionalización. |
| OpenAPI estático | Referencias locales OpenAPI 3.0/3.1 JSON/YAML; sin playground interactivo. |
Previsto
| Área | Issue | Notas |
|---|---|---|
| Guías de migración | #134 | Faltan guías desde Docusaurus, Starlight, VitePress y Mintlify. |
| Diagramas Mermaid | ferromark#531 | SVG estático al compilar. Mientras tanto, mermaid se muestra como código. |
Mejoras posibles
Útiles para algunos equipos, pero no centrales para el framework.
| Área | Issue | Notas |
|---|---|---|
| Tooltip | #81 | Requiere accesibilidad y diseño móvil cuidadosos. |
| Opiniones por página | #74 | Interfaz pequeña; el destino de los datos es más complejo. |
| Notación matemática | #68 | MathML nativo podría ser ligero con una integración sencilla. |
| Fuentes propias | #77 | Generalmente posible mediante CSS y personalización del head. |
| Árbol de archivos | Las estructuras de proyecto usan bloques de código. | |
| Pestañas de gestores | Ya posible con Tabs y un bloque por gestor. | |
| Marco de ejemplo | Los ejemplos React interactivos necesitan reglas de sandbox e hidratación. |
No previsto
Ardo se centra en un enfoque concreto de la documentación.
| Área | Motivo |
|---|---|
| Edición alojada | Ardo sigue ligado al repositorio y autoalojado. Elige una plataforma alojada para esa colaboración. |
| Producto de analítica integrado | Los sitios estáticos integran proveedores directamente; Ardo no necesita guardar eventos. |
| Sitio de texto con JavaScript mínimo | Prima la reutilización de React. Astro, VitePress o Starlight pueden servir mejor para texto puro. |
| Ejemplos TypeScript al pasar el cursor | Las ayudas Twoslash añaden mucho mantenimiento y herramientas. |
| Playgrounds integrados | Los editores Sandpack no encajan con salida estática y bundles pequeños. |
Editar esta página en GitHubÚltima actualización: 28 de octubre de 2026