Guidedog Manual 0.2.0
Idioma
En esta página
Guidedog / Documentación 0.2.0

Tipografía para la lectura

La estructura debe verse antes de estudiar la página. Un título firme, navegación discreta y una columna medida hacen casi todo. El color debe marcar relaciones o acciones, sin llevar solo el significado.

La página web

El diseño tiene navegación del proyecto, documento y esquema de página; en pantallas pequeñas usa un panel desplegable. Incluye Libertinus Serif y Sans: títulos en serif negrita y controles, etiquetas y navegación en sans. Los WOFF2 comprimidos se sirven con el sitio, sin servicios externos.

Claro es el predeterminado. También hay oscuro y sistema, con elección recordada en el mismo origen. Sistema sigue al sistema operativo. El HTML impreso usa colores claros. Contenido y navegación funcionan sin JavaScript; tema y búsqueda avanzada son mejoras progresivas.

La prosa inglesa puede usar saltos Knuth–Plass de párrafo completo en el navegador. Un script mide la fuente, crea cajas, espacios y penalizaciones de guionado y elige los cortes globales. El método de patrones de Frank Liang aporta candidatos ingleses. Se incluyen los patrones TeX originales y las licencias.

La mejora conserva énfasis y texto exacto, recalculando al cambiar el ancho. Copiar dentro de un párrafo optimizado devuelve la fuente, sin divisiones visuales ni guiones añadidos. Al imprimir restaura el párrafo normal para paginarlo.

Enlaces, matemáticas, código, interacción, anchos estrechos y otros idiomas usan el diseño nativo, igual que párrafos sin una solución bien espaciada. Sigue siendo legible sin JavaScript. El fallback usa hyphens: auto y text-wrap: pretty según el idioma; ese CSS no promete por sí solo Knuth–Plass.

La página PDF

El libro usa Libertinus, como la web, con justificación, cortes optimizados y guionado por idioma. Controla espacios, encabezados, leyendas, código y tablas. Fuente, coste de guionado y ancho actúan juntos. Forzar un salto rara vez arregla bien un párrafo flojo.

Typst optimiza los párrafos PDF; la mejora web, la prosa apta. Comparten fuente, tipografías y jerarquía, pero pueden cortar distinto. Consulta el contrato de texto Typst y el contrato de guionado del navegador.

Cambiar el diseño

Edita _static/editorial.css para los tokens visuales, _templates/layout.html para estructura y _templates/book.typ para impresión. Conserva orden de lectura, foco visible, etiquetas y contraste suficiente.

Tras cambiar, construye ambos formatos y revisa código, tablas, diagramas y ecuaciones. Una portada bonita no demuestra que funcione el resto. El contrato está en Plantillas; la API completa, en API Reference y el mismo PDF.