Notas de la versión v0.9.1
Destacados
docmd v0.9.1 ofrece una modernización integral del motor de contenedores: introducción de etiquetas de cierre de contenedor explícitas estandarizadas, atributos de cabecera clave-valor explícitos, comentarios # comentario al final, un contenedor de diagramas ::: mermaid nativo, la resolución de Issue #187 (líneas en blanco en bloques HTML en modo noStyle) y paridad de documentación 1:1 en todos los idiomas admitidos (en, de, es, zh).
Estandarización del Motor de Contenedores
- Etiquetas de Cierre Explícitas: Etiquetas de cierre explícitas estandarizadas (
::: container…::: /container) en todos los contenedores estructurales para una resolución determinista de bloques y profundidad de anidación infinita. - Nomenclatura Unificada de Subcontenedores: Introducción de elementos de subcontenedor con nombre (
::: tab…::: /tabpara::: tabs,::: step…::: /steppara::: steps,::: log…::: /logpara::: changelog). Los marcadores anteriores (== tab,1.) siguen siendo compatibles hacia atrás. - Formato Clave-Valor Explícito: Sintaxis de parámetros con nombre estandarizada (
title:"...",url:"...",align:center,zoom:true,icon:name) en cabeceras manteniendo compatibilidad con argumentos posicionales. - Comentarios en Cabeceras de Contenedores: Soporte nativo para comentarios al final
# comentarioen líneas de contenedor (::: tabs # comentario de cabecera,::: /tabs # comentario de cierre). - Normalizador de Contenedores de Cierre Automático & Etiquetas Flexibles: Seguimiento de profundidad mejorado, incrustación en párrafos (
::: button,::: tag) y eliminación automática de etiquetas huérfanas en contenedores de cierre automático (::: button,::: tag,::: embed). Las etiquetas de cierre explícitas opcionales (::: /button,::: /tag) son totalmente compatibles. - Nuevo Contenedor de Tooltip (
::: tip): Introducción de explicaciones emergentes e interactivas (::: tip "Explicación" term:"Término" ::: /tip) al pasar el cursor para documentación en línea y en bloque.
Contenedor de Diagramas ::: mermaid Nativo
- Interfaz de Usuario Avanzada: Introducción de un contenedor dedicado
::: mermaidque envuelve el DSL del diagrama dentro de un contenedor interactivo con cabeceras personalizadas, barra de título, iconos, alineación (left,center,right), temas integrados (default,dark,forest,neutral) y controles de zoom/desplazamiento. - Ejecución Vinculada al Plugin: Desarrollado directamente por
@docmd/plugin-mermaid. Si el plugin está desactivado endocmd.config.json, tanto los contenedores::: mermaidcomo los bloques de código se desactivan limpiamente sin cargar recursos JS en el cliente. - Compatibilidad Híbrida con GFM: Los bloques de código estándar (
```mermaid) siguen siendo 100% compatibles con GitHub y previsualizadores de IDE.
Mejoras del Asistente de IA y Herramientas de Navegación
- Nueva Herramienta
get_site_structure: Se equipó@docmd/plugin-aicon una herramienta de inspección estructural (get_site_structure) que permite al Asistente de IA obtener el manifiesto completo de versiones del sitio (actuales e históricas), idiomas admitidos, configuración de espacio de trabajo multiproyecto y el árbol completo de navegación de páginas con títulos y URLs. - Detección Dinámica de Capacidades de Búsqueda: El Asistente de IA ahora inspecciona los metadatos de compilación de
@docmd/plugin-search(searchCapabilities: { keyword: true, semantic: Boolean }) para determinar dinámicamente si la búsqueda vectorial semántica está habilitada o si solo está activa la búsqueda por palabras clave (MiniSearch). - Optimización de Consultas de Palabras Clave y Semánticas: Se actualizaron las instrucciones y el enrutamiento del asistente para que las llamadas a
search_documentationden formato a los términos como palabras clave concisas y de alta precisión (por ejemplo,"containers hero"), evitando coincidencias irrelevantes en motores de palabras clave y maximizando la relevancia en índices semánticos.
Correcciones del Motor y de Errores
- Líneas en Blanco en Bloques HTML (Issue #187): Se resolvió un problema en el que las líneas en blanco entre elementos HTML en páginas
noStyleo archivos Markdown estándar provocaban que los elementos HTML posteriores se renderizaran como texto sin formato. - Preservación de Enlaces de Portada en SPAs Zero-Config (Issue #196): Se solucionó un error en la sincronización de la barra lateral tras transiciones SPA en el que los enlaces de la página de inicio raíz (
<a href="">) se convertían erróneamente en<a href="#">, impidiendo volver a la raíz de la documentación. - Renderizado del Banner en la Plantilla Summer: Se solucionó un problema en
@docmd/template-summeren el que las configuraciones de banner basadas en objetos (con formato Markdown, variantes de tipo, enlaces, iconos y botón de cierre) no mostraban el texto ni los componentes del banner.
Paridad Global de Documentación
- Sincronización Multilingüe: Se actualizaron todas las páginas de documentación, guías de contenedores y ejemplos de código 1:1 en inglés (
en), alemán (de), español (es) y chino (zh).