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
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 — tamanho, margens, grade de linhas de base, marcas de corte, numeração, encadernação.
- Diagramação — número de colunas, medianizes, fios, escrita vertical.
- Facas especiais —
dieCuts: furos que atravessam uma ou mais folhas, cantos arredondados e livros recortados, com o texto afastado de cada furo. O guia é Tintas especiais e facas, que trata também dos acabamentos das cores especiais (finish) e da linha de faca (print.dieLine).
- 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 — tipografia, justificação e quebra de linhas, citações, verso, paradas de tabulação e capitulares.
- Hifenização — padrões de hifenização, palavras que não se dividem, texto em bandeira.
- Idioma do documento — o
localede 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 — padrões comuns e valores próprios de cada nível, de H1 a H6.
- Órfãs, viúvas, linhas curtas e regras de manter junto — chaves de
bodyTextque mantêm linhas e blocos juntos numa quebra de coluna. - Equilíbrio de colunas — os mecanismos que fazem todas as colunas terminarem na mesma altura, na ordem editorial.
- Listas com marcadores e Listas numeradas — marcadores, numeração, aninhamento.
- Matemática — renderização de LaTeX, escala, cor, margens.
- 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
:::tocimprime: tipografia das entradas, linhas de pontos, números de página, linhas de autor, linhas de parte. - Índice remissivo — o que
:::indeximprime: tipografia das entradas, recuos, separadores e intervalos de páginas, grupos por letra, idioma de ordenação.
- 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.
- 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 —
scoreStyleescoreStyles: 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 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="…"}).
- Estilos de boxe — notas, dicas e objetivos em boxe para contêineres
:::callout.
- 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.
- 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.
- 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 comlook="…". Todos os problemas que um modelo pode ter estão em Avisos dos modelos de página.
- Unidades e cores + Paleta de cores —
Dimension,ColorValue, cores nomeadas. - Fontes personalizadas — declarar famílias tipográficas enviadas pelo usuário ao lado das Google Fonts.
- Estilos de algarismos —
figureStyle: algarismos de estilo antigo, alinhados, tabulares ou proporcionais por estilo de texto, com os recursos OpenType da fonte. - Visualizador HTML — largura de coluna desejada e quebra de linha para o renderizador HTML.
- Visualizador Canvas —
canvasViewer: o espaço entre as duas páginas de um par e entre uma fileira e a seguinte no Canvas do Sandbox. - Geração de PDF (configuração) — marcadores do documento (outlines), saída acessível (marcada) e espaço de cor forçado para o renderizador PDF.
- Produção gráfica (configuração) —
print: PDF/X-1a e PDF/X-4, os perfis de saída ICC, o preto (cinzas só em K, sobreimpressão, preto composto), as cores definidas em CMYK, o preflight e a simulação de impressão. - Verificação de contraste (configuração) —
contrast: o texto sobre o fundo no nível AA ou AAA do WCAG, na tela e no papel do perfil de saída, e o texto vazado fino demais para impressão. - Verificação do conteúdo (configuração) —
checks.contentInConfig: textos de design que guardam o texto do livro em vez de marcadores, com uma lista de frases permitidas para o título e a editora. - Visualizador Folio (configuração) — papel, encadernação, superfície e luz do visualizador de livro em 3D.
- Depuração — sobreposições visuais e avisos de autoria para o editor.
- Uso programático —
buildDocument, os avisos que ele emite, resolvers, caches. - Executar a diagramação num Web Worker — builds fora da thread principal, com cancelamento.
- Geração de PDF —
postext-pdf: provedores de fontes, fontes CJK, workers e arquivos prontos para impressão.
- 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 (arquivos
.postext) — um livro inteiro em um só arquivo: criar, abrir e montar arquivos.postexta partir do código.