Lectores, renderizadores y generadores¶
El lector entiende un lenguaje fuente; el renderizador escribe un árbol documental; el constructor coordina el proyecto y publica. Son responsabilidades diferentes.
| Entrada | Lector | Ruta |
|---|---|---|
| RST en un proyecto | RST con la capa integrada de Sphinx | Grafo del proyecto a HTML, Typst/PDF, texto o catálogos. |
| Markdown en un proyecto | Capa de Markdown compatible con MyST | El mismo grafo y los mismos generadores. |
convert file.md |
CommonMark por defecto | Un documento a HTML o Typst/PDF. |
convert file.typ |
Adaptador nativo de Typst | Compilación Typst fuera del árbol semántico de Guidedoc. |
Generadores¶
html-
Un archivo HTML por documento, con índices, búsqueda e inventario.
dirhtml-
URL de documentos con formato de directorio.
singlehtml-
Una página HTML principal con secciones de documentos y referencias locales.
pdf-
Libros Typst definidos por el proyecto. Los alias de generadores LaTeX seleccionan esta ruta.
text-
Archivos de texto plano para los documentos.
gettext-
Plantillas de mensajes para traducción.
dummy-
Lee y resuelve el proyecto sin publicar un artefacto.
La cobertura es una prueba¶
guidedog formats muestra los adaptadores reales del ejecutable. La página de compatibilidad registra suites fijadas y proyectos reales. Pasar CommonMark no prueba cobertura MyST completa; leer RST no prueba todas las extensiones Python. Consulta Compatibilidad con Sphinx.