Diseño de documentos
Un sistema de diseño para documentos HTML autocontenidos. El objetivo: correcto en pantalla, limpio al imprimir a PDF y sin paso de compilación: un solo archivo que puedes abrir en cualquier lugar.
Copia references/cv-template.html como punto de partida; ya integra todo lo que se describe a continuación.
Tokens de diseño
Coloca cada color y superficie en propiedades personalizadas en :root, con una variante para tema oscuro. Nunca codifiques un valor hexadecimal en una regla; eso es lo que hace que el documento sea tematizable e imprimible.
:root {
--doc-background: #ffffff;
--doc-background-mid: #eef0ee; /* fondo de página */
--doc-border-light: #e3e3e0;
--doc-text-primary: #1d1f22;
--doc-text-secondary: #5f6368;
--doc-accent: #1f6f5c; /* un solo acento, usado con moderación */
--doc-accent-soft: #e7f1ee; /* fondo de chip/matiz */
}
html[data-theme='dark'] {
--doc-accent: #4fbfa3;
--doc-accent-soft: #16332b;
}
Reglas:
- Un solo color de acento. Marca encabezados de sección, el nombre del cargo/empresa, los marcadores de viñeta y nada más. El acento en todas partes se lee como decoración.
- Dos colores de texto. Primario para el contenido, secundario para metadatos (fechas, ubicaciones, notas).
- Matiz, no relleno. Usa
--doc-accent-softpara chips en lugar de bloques sólidos de acento.
Maquetación
- Ancho máximo de página 820px, centrado, con un margen superior de 24px. Más ancho que esto y la longitud de línea perjudica la legibilidad.
- Relleno de página 38–42px. El relleno carga el peso visual, por lo que no se necesita un borde exterior.
- El fondo de la página es
--doc-background-midpara que la página blanca se lea como una hoja. - Las secciones se apilan con un espacio de 15px. La estructura proviene del espaciado y de una sola línea fina debajo de cada encabezado de sección, no de cajas o paneles.
Tipografía
- Pila de fuentes del sistema, sin fuentes web:
-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif. Nada que cargar, nada que falle sin conexión. - Base pequeña: 12.8px en pantalla con interlineado de 1.38. Esto es un documento, no una entrada de blog: la densidad es una característica.
- Escala: nombre 28px/700, encabezado de sección 11.5px/700 mayúsculas con espaciado de letras de 1.3px, título del cargo 13.5px/700, cuerpo 12–12.5px, metadatos 11px.
- Los encabezados de sección están en mayúsculas y con color de acento, con una línea fina debajo. Ese es el único tratamiento de encabezado; no agregues otro nivel de jerarquía visual.
- Separación silábica y justificación: deja el texto alineado a la izquierda, nunca justificado.
Reglas de impresión
La impresión a PDF es el uso principal, por lo que el bloque de impresión es tan importante como el de pantalla.
@page { size: letter; margin: 0 }con el relleno movido al contenedor de la página, lo que da control sobre los márgenes.- Fuerza fondos blancos y establece
print-color-adjust: exactpara que los chips con matiz se mantengan. - Reduce a ~10pt con interlineado de 1.3. Los tamaños de pantalla son demasiado grandes en papel.
break-inside: avoiden cada cargo, subcargo y el encabezado, para que ninguna entrada laboral se divida entre páginas.- Oculta el marco interactivo — botones, enlaces con estilo de controles — en la impresión.
Accesibilidad
- Mantén el contraste: texto primario sobre blanco, acento solo para encabezados y marcadores. Nunca uses el acento para texto largo del cuerpo.
- Usa elementos de encabezado reales (
h1,h2) en un orden lógico; aplica mayúsculas mediante CSS en lugar de escribirlas en el texto. - Proporciona a los enlaces un texto descriptivo; no te bases solo en el color para distinguirlos.
- Mantén la estructura de lista semántica para las viñetas: los lectores de pantalla anuncian la longitud de la lista, lo que ayuda en un CV largo.
Anti-patrones
- Diseños de varias columnas: se rompen en la impresión y los lectores de pantalla los leen en el orden incorrecto.
- Tablas para maquetación.
- Imágenes o fuentes de iconos en lugar de texto; no sobreviven a la extracción de texto de PDF ni al análisis ATS.
- Encabezados con relleno sólido de acento, degradados, sombras paralelas en el contenido o reglas decorativas entre cada sección.
- Encabezados y pies de página inyectados por el navegador (fecha, URL, recuento de páginas): desactívalos en el diálogo de impresión.