Pular para o conteúdo principal

Capítulo 3 · Parte II · O ofício

Configuração do Postext

O que é uma configuração do Postext e em qual das vinte páginas da referência cada grupo de ajustes é explicado

Atualizado 2026-11-105 minenescadefritptzhjaar

Em poucas palavras

Esta página abre a referência de todos os ajustes que definem a aparência das suas páginas. Um só grupo de ajustes reúne todas as escolhas: tamanho da página, número de colunas, fontes, tamanho do texto, títulos, boxes, cores e muito mais. Você só escreve os ajustes que quer mudar, porque cada um já começa com um valor sensato. A referência está dividida em vinte páginas. A lista desta página tem um link para cada seção; por isso, vá direto à parte de que precisa.

Toda decisão de diagramação no Postext é controlada por um único objeto de configuração.

PostextConfig controla as dimensões da página, a disposição das colunas, a tipografia do texto corrido, os estilos de título, o idioma do documento (locale) e mais. Todas as propriedades são opcionais: o Postext vem com valores padrão sensatos, inspirados na tipografia tradicional do livro. Você só precisa especificar o que quer mudar.

import { buildDocument } from 'postext';
 
const document = buildDocument(content, {
  page: { sizePreset: '21x28', dpi: 300 },
  layout: { layoutType: 'double', gutterWidth: { value: 0.5, unit: 'cm' } },
  bodyText: { fontFamily: 'EB Garamond', fontSize: { value: 9, unit: 'pt' } }, // 9 pt substitui o padrão de 8 pt
  headings: { fontFamily: 'Open Sans' },
});

Para uma visão geral de como o motor processa essa configuração, veja a página Arquitetura.

#Índice

A referência está dividida em vinte páginas. Cada grupo desta lista é uma página, seguida das seções que ela contém.

Página e diagramação

Cabeçalhos e rodapés

  • Cabeçalhos e rodapés — elementos de texto, fio, caixa e imagem por página, com marcadores, paridade, papéis de página e posicionamento.

Texto do corpo

Hifenização e idioma

  • Hifenização — padrões de hifenização, palavras que não se dividem, texto em bandeira.
  • Idioma do documento — o locale de nível superior, que define a hifenização de reserva, os tipos de recurso embutidos, os textos de continuação de tabelas e de boxes divididos e o idioma marcado num PDF acessível; os algarismos (numerals) e a direção do texto (direction) que dele decorrem; e os idiomas e sistemas de escrita que o Postext compõe. O guia dos livros da direita para a esquerda é Composição em árabe.
  • Idiomas e escritas — os sistemas de escrita que o Postext compõe e as páginas que tratam de cada um.
  • Texto árabe — formas das letras, kashida, sinais vocálicos e algarismos do texto árabe.

Títulos

  • Títulos — padrões comuns e valores próprios de cada nível, de H1 a H6.

Viúvas, órfãs e equilíbrio

Listas e matemática

Notas e referências

  • Notas de rodapé — footnotes: para onde vão as notas citadas com [^id], como são numeradas e que aparência têm.
  • Numeração de linhas — lineNumbers: um número na margem a cada cinco linhas do verso, ou do texto; o que é contado, onde a contagem recomeça e de que lado ficam os números.
  • Referências cruzadas — crossRefs: as palavras impressas junto ao número ou à página de um :ref, e seu estilo padrão.
  • Citações — citations: o estilo de citação e a aparência das citações e da bibliografia.
  • Links na edição impressa — links: o que a página impressa mostra do endereço de um link: nada, o endereço entre parênteses ou uma nota com o endereço e um código QR.
  • Sumário — o que :::toc imprime: tipografia das entradas, linhas de pontos, números de página, linhas de autor, linhas de parte.
  • Índice remissivo — o que :::index imprime: tipografia das entradas, recuos, separadores e intervalos de páginas, grupos por letra, idioma de ordenação.

Tipografia do Leste Asiático

  • Tipografia do Leste Asiático — cjk: as convenções regionais e a quebra de linha do texto em chinês, japonês e coreano, como se distribuem as linhas justificadas, as larguras da pontuação e a pontuação pendente, o espaço entre caracteres Han e latinos, a grade de caracteres, os números em pé no texto vertical, e as marcas, o rubi, as notas warichu e as marcas de kanbun. Os guias de tudo isso são Composição chinesa e Composição japonesa.

Recursos e tabelas

  • Tipos de recurso — numeração por tipo para figuras, tabelas e tipos personalizados.
  • Estilo de tabela (com estilos de tabela nomeados) e Estilo de legenda — tipografia e decoração das tabelas inseridas como recurso e das legendas delas.
  • Estilo de diagramas — recoloração a uma só tinta dos diagramas SVG incorporados, para impressão em cor especial.
  • Estilo de partitura — scoreStyle e scoreStyles: tamanho da pauta, fonte musical, espaçamento e números de compasso de todas as partituras.
  • Estilo de vídeo — videoStyle: a marca de reprodução e o código QR sobre o pôster de um vídeo, e o que os players do vídeo oferecem no visualizador HTML e no EPUB.

Estilos e partes

  • Estilos de parágrafo — estilos nomeados para contêineres :::paragraphs: bibliografias, glossários, notas.
  • Estilos de chip — chipStyles: estilos nomeados para o :chip[…] em linha: a caixa de um banco de palavras, uma tecla, uma etiqueta.
  • Estilos de caractere — characterStyles: visuais nomeados para um trecho de palavras escrito :span[…]{style="id"}: uma fonte, um corpo, uma cor, um espaçamento entre letras, maiúsculas e um estilo de destaque que os acompanhe.
  • Estilos de destaque — markStyles: estilos nomeados para o :mark[…] em linha: a faixa atrás de uma frase destacada que passa de linha, e uma linha por baixo dela ou atravessando-a.
  • Listagens de código — codeStyle: a fonte, a caixa, a largura da tabulação, as linhas longas, os números de linha e as cores dos elementos das listagens ```, a coloração de sintaxe e o gancho para um realçador externo, e o código em linha numa fonte de código.
  • Partes — páginas divisórias de parte para contêineres :::part: paridade, área do corpo, design de abertura, tipografia do corpo.
  • Estilos de título — estilos nomeados para títulos {style="…"}: capítulos sem número, elementos pré-textuais com cabeços próprios, geometria e paleta.
  • Estilos de capítulo — chapterStyles: um design inteiro (página, tipografia, cores e cabeços) que um capítulo adota ao nomeá-lo no seu preâmbulo (chapterStyle:), ou que uma parte dá a todos os seus capítulos (:::part{style="…"}).

Boxes

  • Estilos de boxe — notas, dicas e objetivos em boxe para contêineres :::callout.

Ajustes de exercícios

  • Estilos de exercício — exerciseStyles: o selo do número, a tipografia do enunciado, os rótulos das alternativas, as lacunas, as áreas de escrita, as grades, a conta de dividir e a cor das respostas dos blocos :::exercise. Ajustes do livro — exercises: a edição do professor, o lugar das soluções, a semente dos embaralhamentos e as edições de tela. O guia é Exercícios.

Ajustes de quadrinhos

  • Quadrinhos — comics: a moldura e as sarjetas das páginas de quadrinhos, os estilos de quadro, o letreiramento, os estilos de balão e o elenco. O guia é Quadrinhos.

Ajustes de páginas compostas

  • Modelos de página — pageTemplates: os blocos, grupos e a decoração de uma página composta, a herança entre modelos e as variantes de página ímpar e par. Estilos de rótulo — labelStyles: a aparência dos rótulos colocados nas âncoras de uma imagem. Aparências de bloco — frameLooks: conjuntos de cores com nome que um trecho de uma página composta usa com look="…". Todos os problemas que um modelo pode ter estão em Avisos dos modelos de página.

Fontes, cores e saída

Uso programático

Arquivos PDF

  • Geração de PDF — postext-pdf: provedores de fontes, fontes CJK, workers e arquivos prontos para impressão.

HTML, Folio, EPUB e SCORM

  • Integrar o visualizador HTML e Gerar PDFs — receitas completas, de ponta a ponta.
  • Um livro em 3D (postext-folio) — o documento diagramado como um livro impresso aberto sobre uma mesa, com folhas que o leitor vira.
  • Livros EPUB — arquivos EPUB 3 de layout fixo e refluível a partir da mesma diagramação, e como verificá-los com o EPUBCheck.
  • Pacotes SCORM — capítulos e seções como SCOs para um sistema de gestão de aprendizagem, com exercícios que enviam as suas notas.

Pacotes .postext