Pular para o conteúdo principal

Documentação do Postext

Sumário

Três partes: o que é o Postext e como ele é construído, o ofício tipográfico que ele automatiza e as ferramentas com que você o usa.

Parte I · Fundamentos

  1. 1IntroduçãoTempo de leitura: 7 minO que é o Postext, por que ele existe e que problema resolve
  2. 2ArquiteturaTempo de leitura: 29 minArquitetura técnica do motor de diagramação do Postext: os conceitos, a árvore do documento, o ritmo vertical, os renderizadores e o desempenho
  3. 2.1O pipeline de layoutTempo de leitura: 29 minA passada de posicionamento e suas rodadas: como o motor posiciona linhas, flutuantes, notas e colunas, e repete o processo até a diagramação se estabilizar

Parte II · O ofício

  1. 3ConfiguraçãoTempo de leitura: 5 minO que é uma configuração do Postext e em qual das vinte páginas da referência cada grupo de ajustes é explicado
  2. 3.1Página e diagramaçãoTempo de leitura: 36 minO tamanho da página, as margens e a grade de linhas de base, a numeração das páginas, e as colunas e as medianizes entre elas
  3. 3.2Cabeçalhos e rodapésTempo de leitura: 32 minO que é impresso no alto e no pé de cada página: texto com marcadores, fios, caixas, imagens e caminhos vetoriais, conforme a paridade da página, e onde cada elemento fica
  4. 3.3Texto do corpoTempo de leitura: 28 minA tipografia do texto corrido: fonte, tamanho e entrelinha, cores, recuos, citações, verso, paradas de tabulação e capitulares
  5. 3.4Hifenização e idiomaTempo de leitura: 23 minPadrões e exceções de hifenização, texto em bandeira, o idioma do documento (com os algarismos e a direção que ele define) e os sistemas de escrita que o Postext compõe
  6. 3.5TítulosTempo de leitura: 34 minOs padrões dos títulos, os valores próprios de cada nível, as quebras de página antes de um título, as aberturas de capítulo na largura da página e os números por extenso
  7. 3.6Viúvas, órfãs e equilíbrioTempo de leitura: 23 minAs regras que mantêm linhas e blocos juntos numa quebra de coluna, e as alavancas que fazem todas as colunas terminarem na mesma altura
  8. 3.7Listas e matemáticaTempo de leitura: 19 minListas com marcadores e listas numeradas (marcadores, recuos e aninhamento), listas de tarefas, e o tamanho, a cor e o espaçamento das fórmulas matemáticas
  9. 3.8Notas e referênciasTempo de leitura: 29 minComo configurar as notas de rodapé, a numeração de linhas, as referências cruzadas e as citações, o sumário e o índice remissivo
  10. 3.9Tipografia do Leste AsiáticoTempo de leitura: 36 minComo configurar o texto chinês, japonês e coreano (cjk): a quebra de linha, a largura da pontuação, o espaçamento, a grade de caracteres, o rubi e as marcas
  11. 3.10Recursos e tabelasTempo de leitura: 45 minOs tipos de recurso e a numeração deles, os estilos de tabela e de legenda, os diagramas em uma só tinta e os vídeos impressos
  12. 3.11Estilos e partesTempo de leitura: 48 minComo definir estilos nomeados para parágrafos, chips, destaques, listagens de código e títulos, e como configurar as páginas que abrem cada parte
  13. 3.12BoxesTempo de leitura: 28 minComo definir estilos nomeados para os boxes :::callout (moldura, fundo, faixa, título, ícone, marcador e aba de rótulo), dar ao boxe uma forma com raios por canto, bordas por lado e abas unidas, numerar enunciados, escolher a tipografia dentro do boxe, marcar os boxes divididos entre páginas e desenhar designs dentro de um boxe
  14. 3.13Ajustes de exercíciosTempo de leitura: 12 minEstilos de exercício (exerciseStyles) e ajustes de exercícios do livro (exercises): selos de número, tipografia do enunciado, rótulos e marcadores das alternativas, lacunas, respostas de verdadeiro ou falso, ligar colunas, bancos de palavras, áreas de escrita, grades, conta de dividir, marcas de dificuldade, ícones, a cor das respostas, o lugar das soluções, a edição do professor e as edições de tela
  15. 3.14Ajustes de quadrinhosTempo de leitura: 8 minComo configurar os quadrinhos: a moldura e as sarjetas das páginas, os estilos de quadro e de balão, o letreiramento e o elenco
  16. 3.15Ajustes de páginas compostasTempo de leitura: 11 minOs modelos das páginas compostas (blocos, grupos, grades que repetem um conjunto de blocos, módulos, decoração e conectores, herança e variantes de página ímpar e par), os estilos dos rótulos colocados nas âncoras de uma imagem e os avisos que um modelo pode gerar
  17. 3.16Fontes, cores e saídaTempo de leitura: 42 minAs unidades, as cores e a paleta, as fontes personalizadas, o visualizador HTML, o PDF e a produção gráfica, o visualizador Folio e a depuração
  18. 3.17Uso programáticoTempo de leitura: 31 minComo chamar o Postext a partir do código: o buildDocument e os avisos dele, os valores padrão, as fontes, os caches e o Web Worker
  19. 3.18Arquivos PDFTempo de leitura: 31 minO postext-pdf a partir do código: instalação, a API, provedores de fontes no navegador e no Node, fontes CJK, bytes de recursos, texto vertical, workers e arquivos prontos para impressão
  20. 3.19HTML, Folio, EPUB, SCORMTempo de leitura: 18 minComo mostrar o livro diagramado numa página web, como livro em 3D com o postext-folio, como EPUB 3 de layout fixo ou refluível com o postext-epub e como pacote SCORM para um LMS com o postext-scorm
  21. 3.20Pacotes .postextTempo de leitura: 29 minComo abrir, diagramar, renderizar e criar arquivos .postext a partir do código; pacotes bilíngues; arquivos gravados por versões anteriores; e a API de baixo nível
  22. 4Hifenização e justificaçãoTempo de leitura: 44 minComo o Postext quebra linhas, justifica o texto e controla o espaçamento entre palavras com o algoritmo de Knuth-Plass
  23. 5Formato do documentoTempo de leitura: 16 minO subconjunto de Markdown que o Postext lê: o front matter, os títulos, as listas e os blocos de código; o que ele ignora; e as regras para escrever os documentos de origem
  24. 5.1DiretivasTempo de leitura: 38 minAs diretivas iniciadas por ::: (contêineres, colunas, papel, quebras de página, numeração, espaço, verso, sumário e índice remissivo, quebras de linha) e a marcação das páginas de quadrinhos
  25. 5.2Formatação em linha e fórmulasTempo de leitura: 32 minAs marcas que se usam dentro da linha: ênfase, links, chips, versaletes, tabulações, texto vertical, marcas chinesas e japonesas, direção do texto e fórmulas LaTeX
  26. 5.3Notas e referênciasTempo de leitura: 15 minNotas de rodapé, referências cruzadas e âncoras, citações e bibliografia, e as marcas do índice remissivo
  27. 5.4Imagens e tabelasTempo de leitura: 45 minComo pôr recursos no texto: referências e inserções, numeração, posicionamento e o lugar onde cada flutuante vai parar, contorno de texto, tamanho dos bitmaps, áreas seguras, âncoras de quadrinhos e símbolos nas legendas
  28. 5.5VídeosTempo de leitura: 9 minOs recursos de vídeo: YouTube, Vimeo, arquivos seus e streams HLS, o que cada saída mostra, os campos de um vídeo, o pôster e o endereço, os players, o VDT e os pacotes, e os vídeos que tocam nas páginas do Folio
  29. 6Composição chinesaTempo de leitura: 36 minComo o Postext compõe o chinês, na horizontal e na vertical: regiões, quebra de linhas, largura da pontuação, justificação entre caracteres, a grade de caracteres, livros encadernados pela direita, números em pé, marcas, rubi, warichu, numerais chineses e fontes
  30. 7Composição em árabeTempo de leitura: 32 minComo o Postext compõe o árabe: direção do texto e algoritmo bidirecional, livros encadernados pela direita, palavras ligadas que nunca são cortadas nem espaçadas, justificação com kashida, sinais vocálicos, ênfase, algarismos e estilos de numeração, ordinais por extenso, notas de rodapé, verso clássico, sumário, índice remissivo, citações e fontes
  31. 8Composição japonesaTempo de leitura: 38 minComo o Postext compõe o japonês, na vertical e na horizontal: a região Japão, kinsoku, espaçamento dos yakumono, colchetes no início do parágrafo, formas verticais, furigana, marcas de ênfase e linhas laterais, kanbun, contadores, títulos com gyōdori, notas, índice remissivo em ordem gojūon, citações, fontes e textos do Aozora Bunko
  32. 9QuadrinhosTempo de leitura: 41 minComo o Postext compõe quadrinhos e mangás a partir de Markdown: páginas de quadrinhos cortadas por uma árvore de divisões, desenhos dos quadros recortados em torno da área segura, letreiramento gerado a partir de um roteiro (fala, pensamento, sussurro, grito, rádio, recordatórios, onomatopeias), estilos de balão, âncoras dos personagens nos desenhos, tiras no meio do texto, páginas duplas, leitura da direita para a esquerda e letreiramento vertical, traduções e as saídas em canvas, PDF, HTML e EPUB
  33. 10Notação musicalTempo de leitura: 12 minComo o Postext compõe música num livro: notação escrita como texto em ABC, MusicXML, MEI ou Humdrum, gravada na largura da coluna e dividida em sistemas que continuam por colunas e páginas, exemplos musicais numerados como recursos, o estilo de partitura, as saídas e como uma editora de música traz suas partituras
  34. 11ExercíciosTempo de leitura: 16 minComo o Postext compõe os exercícios de um livro didático ou de um caderno de atividades: o delimitador :::exercise, seus doze tipos, da múltipla escolha à conta de dividir, as respostas escritas no Markdown, a numeração, as soluções depois do exercício, de cabeça para baixo, no fim do capítulo ou do livro, a edição do professor, as verificações, os exercícios respondidos na tela em HTML e EPUB, limites para uma prova e resultados enviados a um LMS num pacote SCORM
  35. 12Páginas compostasTempo de leitura: 44 minComo se escreve uma página composta em Markdown: o contêiner ::::page, aberto com quatro sinais de dois-pontos, que indica o modelo; os blocos e o atributo slot, que distribuem o conteúdo pelos blocos do modelo; os slots repetidos e os módulos; e os avisos que aparecem quando o conteúdo não corresponde ao modelo ou cobre outro bloco
  36. 12.1Figuras com rótulosTempo de leitura: 9 minFiguras que põem palavras sobre uma imagem: rótulos nas âncoras de um recurso, o texto alternativo, a legenda e a nota próprios de uma figura, como um rótulo é composto, rótulos afastados do seu ponto com linhas de chamada, legendas de mapa e símbolos em linha, e os avisos dos rótulos
  37. 13Tintas especiais e facasTempo de leitura: 14 minQuintas cores, tintas metálicas e fluorescentes, hot stamping, branco opaco e verniz como cores especiais com acabamento, e facas especiais: furos que atravessam uma ou mais folhas, cantos arredondados e livros recortados, a linha de faca no PDF, o preflight e como cada visualizador os mostra

Parte III · Na prática

  1. 14ContribuirTempo de leitura: 6 minComo entrar na comunidade do Postext e contribuir com o projeto
  2. 15SandboxTempo de leitura: 33 minA interface do Sandbox: a barra de atividades, os painéis Texto, Livros, Capítulos, Recursos e Fontes, e a disposição da tela em celulares
  3. 15.1Painéis Design e VerificaçõesTempo de leitura: 43 minOs grupos, as páginas, a busca e a visão geral do painel Design, e os avisos ao vivo do painel Verificações, agrupados por tipo
  4. 15.2Páginas compostasTempo de leitura: 21 minComo editar os modelos de página e os blocos diretamente na página, conectores e formas, linhas de chamada, indicadores e legendas, grades, módulos e a biblioteca deles, reorganizar blocos, verificações de sobreposição e abas com glifo, organizar os estilos de bloco numa biblioteca, verificar as páginas compostas em todas as edições, levar para o Markdown o texto de um livro e corrigir um bloco com um clique
  5. 15.3VisualizaçõesTempo de leitura: 16 minAs abas Canvas, PDF, Folio, HTML, EPUB 3 e SCORM da área de visualização principal: o que cada uma mostra e o que permite fazer
  6. 15.4Livros, arquivos do Word e salvamentoTempo de leitura: 43 minComo organizar livros e capítulos, editar páginas de quadrinhos, importar e exportar documentos do Word, e como o Sandbox salva, exporta e importa seu trabalho
  7. 15.5Agentes, incorporação e predefiniçõesTempo de leitura: 13 minFerramentas WebMCP para agentes de IA; o componente PostextSandbox no seu próprio app, com as props e o CSS de que ele precisa; e o formato do pacote de predefinição
  8. 16Livros de páginas compostasTempo de leitura: 22 minUm passo a passo no Sandbox com um livro didático feito de páginas compostas: como montar um modelo de página, preenchê-lo a partir do Markdown, rotular um mapa, traduzir a página, corrigir o texto que não cabe selecionar elementos na página e no texto, e depois desenhar uma árvore com conectores, notas num mapa com indicadores e legenda, uma grade de cartões com fotos e uma biblioteca de módulos para uma coleção
  9. 17Levar para páginas compostasTempo de leitura: 13 minComo passar para modelos de página e Markdown um livro que guarda o texto das páginas em estilos de título, com o assistente Levar o texto para o Markdown do Sandbox ou à mão, o que conferir depois, e como trocar as linhas pintadas numa imagem por conectores e os blocos avulsos por grades e módulos
  10. 18InDesignTempo de leitura: 9 minOs dois caminhos para trazer um livro do InDesign para o Postext, o importador de IDML, que copia o que o documento contém, e a skill para agentes, que deduz as regras de diagramação dele; quando usar cada um, e como o exportador de IDML devolve um livro ao InDesign
  11. 19SkillTempo de leitura: 10 minInstale a skill postext-port no Claude Code, no Codex ou em qualquer agente e deixe que ela transforme um PDF, Word, PowerPoint, EPUB, InDesign ou HTML em um projeto do Postext que segue a diagramação original
  12. 20Linha de comandoTempo de leitura: 14 minUm único executável autossuficiente para macOS, Linux e Windows. Ele transforma um livro .postext, uma pasta de livro ou arquivos Markdown soltos em PDF, HTML, EPUB, imagens das páginas e Word, monta pacotes, verifica livros e oferece saída JSON para scripts e agentes, com pacotes Python e Rust que o usam a partir do código
  13. 21WebMCPTempo de leitura: 13 minO que um agente de IA no navegador pode fazer no Sandbox com as 64 ferramentas WebMCP que ele oferece (olhar as páginas, mudar qualquer ajuste, editar o texto, adicionar imagens, tabelas e fontes, rodar as verificações, exportar) e como chamar cada uma, com argumentos e respostas reais