Design de documento
Um sistema de design para documentos HTML autocontidos. O objetivo: correto na tela, limpo ao imprimir em PDF e sem etapa de build — um único arquivo que pode ser aberto em qualquer lugar.
Copie references/cv-template.html como ponto de partida; ele já conecta tudo o que está descrito abaixo.
Tokens de design
Coloque cada cor e superfície em propriedades personalizadas em :root, com uma substituição para tema escuro. Nunca codifique um valor hexadecimal em uma regra; é isso que torna o documento temável e imprimível.
:root {
--doc-background: #ffffff;
--doc-background-mid: #eef0ee; /* entorno da página */
--doc-border-light: #e3e3e0;
--doc-text-primary: #1d1f22;
--doc-text-secondary: #5f6368;
--doc-accent: #1f6f5c; /* um acento, usado com moderação */
--doc-accent-soft: #e7f1ee; /* fundo de chip/tom */
}
html[data-theme='dark'] {
--doc-accent: #4fbfa3;
--doc-accent-soft: #16332b;
}
Regras:
- Uma cor de acento. Ela marca cabeçalhos de seção, o nome do cargo/empresa, marcadores de lista e nada mais. Acento em todo lugar parece decoração.
- Duas cores de texto. Primária para conteúdo, secundária para metadados (datas, locais, notas).
- Tonalize, não preencha. Use
--doc-accent-softpara chips em vez de blocos sólidos de acento.
Layout
- Largura máxima da página 820px, centralizada, com margem superior de 24px. Mais larga que isso e o comprimento da linha prejudica a legibilidade.
- Padding da página de 38–42px. O padding carrega o peso visual, então nenhuma borda externa é necessária.
- Entorno da página é
--doc-background-midpara que a página branca pareça uma folha. - As seções se empilham com um espaçamento de 15px. A estrutura vem do espaçamento e de uma linha fina abaixo de cada cabeçalho de seção, não de caixas ou painéis.
Tipografia
- Pilha de fontes do sistema, sem fontes web:
-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif. Nada para carregar, nada para falhar offline. - Base é pequena: 12,8px na tela com altura de linha de 1,38. Isto é um documento, não uma postagem de blog — densidade é uma característica.
- Escala: nome 28px/700, cabeçalho de seção 11,5px/700 maiúsculo com espaçamento entre letras de 1,3px, título do cargo 13,5px/700, corpo 12–12,5px, metadados 11px.
- Cabeçalhos de seção são maiúsculos e com cor de acento com uma linha fina abaixo. Esse é o único tratamento de cabeçalho; não adicione outro nível de hierarquia visual.
- Hifenização e justificação: deixe o texto alinhado à esquerda, nunca justificado.
Regras de impressão
Imprimir em PDF é o uso principal, então o bloco de impressão é tão importante quanto o da tela.
@page { size: letter; margin: 0 }com o padding movido para o contêiner da página, dando controle sobre as margens.- Forçar fundos brancos e definir
print-color-adjust: exactpara que chips tonalizados sobrevivam. - Reduzir para ~10pt com altura de linha de 1,3. Os tamanhos de tela são grandes demais no papel.
break-inside: avoidem cada cargo, subcargo e no cabeçalho, para que nenhuma entrada de trabalho seja dividida entre páginas.- Ocultar cromo interativo — botões, links estilizados como controles — na impressão.
Acessibilidade
- Manter contraste: texto primário sobre branco, acento apenas para cabeçalhos e marcadores. Nunca use o acento para texto longo do corpo.
- Usar elementos de título reais (
h1,h2) em uma ordem sensata; estilizar maiúsculas com CSS em vez de digitá-las em CAIXA ALTA. - Dar texto descritivo aos links; não confiar apenas na cor para distingui-los.
- Manter a estrutura de lista semântica para marcadores — leitores de tela anunciam o comprimento da lista, o que ajuda em um CV longo.
Anti-padrões
- Layouts multicoluna — eles quebram na impressão e leitores de tela os leem na ordem errada.
- Tabelas para layout.
- Imagens ou fontes de ícones no lugar de texto; eles não sobrevivem à extração de texto de PDF ou à análise de ATS.
- Cabeçalhos com preenchimento sólido de acento, gradientes, sombras projetadas no conteúdo ou réguas decorativas entre cada seção.
- Cabeçalhos e rodapés injetados pelo navegador (data, URL, número de página) — desabilite-os no diálogo de impressão.