v0.10.1 - IDs de encabezado de GitHub, análisis de bloques de código y correcciones de enlaces
v0.10.1 - IDs de encabezado de GitHub, análisis de bloques de código y correcciones de enlaces
IDs de encabezado de GitHub, análisis de bloques de código y correcciones de enlaces
v0.10.1 añade compatibilidad con IDs de encabezado planos compatibles con GitHub y corrige la preservación de bloques de código en la compilación MDX, la normalización de enlaces internos para nombres de archivo con puntos y parámetros de consulta, y mejoras en el análisis de barras laterales en la herramienta de migración de MkDocs.
Added
- IDs de encabezado planos compatibles con GitHub (
@docmd/parser): Se añadió la opción"markdown": { "headingIds": "github" }(o frontmatter por páginaheadingIds: github) para generar IDs de encabezado planos siguiendo la convención de slugs de GitHub (minúsculas, eliminación de signos de puntuación sin colapsar guiones, espacios a guiones y sufijos-1,-2para encabezados duplicados en una página). Por defecto, docmd conserva sus IDs de encabezado contextuales jerárquicos existentes ("nested"). Sugerido por @thinkbig1979 en #286.
Fixed
- Evaluación de expresiones en bloques de código corregida (
@docmd/plugin-mdx,lite-mdx): Actualización delite-mdxa0.1.2con escaneo de delimitadores de código compatible con CommonMark. Los bloques de código que contienen comillas, títulos o atributos de lenguaje (como```json "docmd.config.json") ahora están estrictamente protegidos de la compilación de expresiones JSX/MDX. Además,@docmd/plugin-mdxahora solo activa el procesamiento MDX en archivos.mdcuando hay sintaxis JSX real o importaciones/exportaciones presentes. - Enlaces internos con puntos y cadenas de consulta (
@docmd/parser): Se corrigió el problema por el cual los enlaces a páginas Markdown con puntos en el nombre de archivo (ej.release-1.0.md,docmd.config.md) se clasificaban incorrectamente como archivos estáticos sin procesar, omitiendo las barras finales y los desplazamientos de profundidad../en subpáginas. Las cadenas de consulta (ej.other.md?tab=npm,index.md?tab=npm) ahora se separan junto con los fragmentos de hash antes de eliminar la extensión y se conservan adecuadamente en los cambios relativos de profundidad. Resuelve #284. - Migración de navegación de MkDocs (
@docmd/core):docmd migrate --mkdocsahora finaliza el análisis de la navegación en la siguiente clave YAML de nivel superior (evitando queplugins:ymarkdown_extensions:se agreguen a la barra lateral), elimina comillas en títulos/rutas y asignaindex.mda rutas de carpeta raíz o de subdirectorios. Contribuido por @jayhemnani9910 en #285. - Aserción dinámica de versión en pruebas: Se actualizó la aserción de prueba en
tests/cli-contracts/variables-engine.test.jspara validar dinámicamente contraregistry.get('docmd.version').
Documentation & Diagnostics
- Guías de IDs de encabezado y normalización de enlaces: Se añadió documentación de referencia de configuración y frontmatter para
markdown.headingIds, y se documentó la preservación de enlaces para nombres de archivo con puntos y parámetros de consulta en los cuatro idiomas. - Documentación del plugin Iconify: Se añadió documentación dedicada y ejemplos interactivos de contenedores en vivo (Avisos, Botones, Tarjetas, Pestañas, Etiquetas) en los cuatro idiomas (
en,de,es,zh) enplugins/iconify.md. - Formato de bloques de código anidados: Se corrigió el escape de delimitadores de código anidados en el ejemplo del componente Pestañas utilizando bloques de 4 tildes graves con sintaxis de contenedor
::: tabs.
Links
Documentación: https://docs.docmd.io/
Plataforma Cloud: https://cloud.docmd.io/
Habilidades para desarrollo y redacción: https://github.com/docmd-io/docmd-skills
New Contributors
- @jayhemnani9910 realizó su primera contribución en https://github.com/docmd-io/docmd/pull/285
Changelog completo: https://github.com/docmd-io/docmd/compare/0.10.0...0.10.1