Pular para o conteúdo principal

Capítulo 19 · Parte III · Na prática

Skill para agentes: portar uma publicação para o Postext

Instale 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

Atualizado 2026-10-2110 minenescadefritptzhjaar

Em poucas palavras

Esta página é para quem já tem um livro ou um documento em outro formato, como PDF, Word ou InDesign, e quer passá-lo para o Postext. Um assistente de inteligência artificial, chamado agente, pode fazer quase todo o trabalho se você der a ele um pequeno complemento chamado skill. A skill ensina o agente a copiar o texto e a refazer o design do original. A página explica como instalá-la, o que pedir e como conferir o resultado. Um vídeo de uns cinco minutos mostra cada passo.

Transforme uma publicação existente em um projeto do Postext com um agente de programação.

Muita gente chega ao Postext com um livro que já existe: um livro didático em PDF de impressão, um relatório no Word, um curso no PowerPoint, um catálogo no InDesign, um EPUB. Portá-lo significa dois trabalhos:

  • Conteúdo: o Markdown enriquecido de cada capítulo, com as diretivas e microformatos.
  • Design: um manifesto de configuração que reproduz as regras de diagramação do original (geometria da página, grade de linhas de base, tipos, aberturas, cabeços, boxes, flutuantes, tabelas, partes).

Um LLM consegue fazer boa parte desse trabalho, mas só se souber como o Postext funciona. O Markdown do Postext não é CommonMark, e a configuração tem armadilhas que só aparecem quando uma página sai errada. A skill postext-port reúne esse conhecimento junto com as ferramentas que usamos para construir cada predefinição do Sandbox, para que seu agente faça a conversão direito.

Ela segue o formato aberto Agent Skills; por isso, funciona com Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode e muitos outros agentes.

#Assista ao tutorial

Cinco minutos, sem código: preparar a pasta, trazer os originais vetoriais, acrescentar um PDF de referência, pedir ao agente e conferir o resultado no Sandbox.

Transcrição

Tudo o que o narrador diz, com uma descrição do que aparece na tela.

  1. 0:00

    Na telaAbertura: o logotipo do Postext, a chamada “Tutorial · 5 passos” e o título “Converta sua publicação em Postext com um agente de IA. Sem programar.”

  2. 0:03

    Na tela“Sua publicação já existe.” Três capas caem uma depois da outra com as suas etiquetas: um livro, Dom Casmurro, de Machado de Assis (Coleção Casuarina), marcado InDesign (IDML); um manual, o da chaleira elétrica Verra W1, marcado Word (DOCX); e uma revista, FALLOW, marcada PDF. Elas se agrupam à esquerda, uma seta dourada tracejada passa por um selo “Agente de IA” e aparece um ícone de arquivo, meu-livro.postext, sob “Um agente a converte em Postext. Cinco passos. Alguns pedidos bem escritos.”

    NarraçãoVocê já tem uma publicação: um livro, um manual, uma revista. Ela vive no InDesign, no Word ou num PDF. Neste tutorial, um agente de inteligência artificial vai convertê-la em Postext para você. Sem programar: cinco passos e alguns pedidos bem escritos.

  3. 0:24

    Na tela“O plano”: cinco cartões numerados aparecem à medida que cada passo é nomeado: 01 Prepare a pasta, 02 Reúna os originais vetoriais, 03 Adicione uma referência, 04 Peça ao agente, 05 Revise no Sandbox.

    NarraçãoO plano: preparar a pasta, reunir os originais vetoriais, adicionar uma referência, pedir ao agente e revisar o resultado.

  4. 0:34

    Na telaPasso 01, a pasta: “Um projeto, uma pasta.” Uma pasta grande, meu-livro/, flutua entre dez arquivos soltos, como MinionPro-Regular.otf, capa.jpg, fig-2-1.ai, capitulo-01.docx, mapa.svg, livro.idml e grafico.pdf. Abre-se uma janela com a árvore da pasta, e cada arquivo voa para a sua subpasta quando ela é nomeada: referencia.pdf (como deve ficar → passo 03), fontes/ (Minion Pro, Myriad…, .otf .ttf .woff2), imagens/ (fotografias, .jpg .png), ilustracoes/ (originais vetoriais, .ai .svg .pdf) e textos/ (Word, InDesign IDML…).

    NarraçãoPasso um: reúna tudo numa única pasta no seu computador. Um projeto, uma pasta. Dentro dela, dê a cada tipo de material a sua própria subpasta: as fontes, as imagens, as ilustrações e os textos.

  5. 0:51

    Na telaA linha fontes/ fica destacada e um cartão com o título “Fontes” mostra um “Aa” grande, os estilos Redondo, Itálico e Negrito, os formatos OTF, TTF e WOFF2 e a nota “Só dá para usar as que você incluir.” Depois, “Quanto mais organizada, menos ele adivinha.”, enquanto cada subpasta da árvore recebe um visto.

    NarraçãoNão se esqueça das fontes: elas são a voz do design, e o agente só pode usar as que você incluir. Quanto mais organizada estiver a pasta, menos o agente vai ter que adivinhar.

  6. 1:04

    Na telaPasso 02, originais vetoriais: “Reúna os originais.” Um diagrama, um gráfico e um mapa são desenhados em traço, com os pontos de ancoragem à mostra, e aparecem três ícones de arquivo: .ai Illustrator, .svg SVG e .pdf PDF.

    NarraçãoPasso dois: se as suas ilustrações são vetoriais, como diagramas, gráficos ou mapas, procure os arquivos originais: Illustrator, SVG ou PDF.

  7. 1:15

    Na telaDois painéis mostram a mesma figura, um diagrama em que Manuscrito e Modelo apontam para Páginas, com a legenda “Fig. 2.1 Conteúdo e design se encontram.” À esquerda, “Recortada do PDF: uma foto do desenho” fica borrada e pixelada ao ser ampliada; à direita, “O original: o próprio desenho” continua nítido. O painel da esquerda se apaga, os rótulos do original são reescritos em inglês (Manuscript, Template, Pages), marcas de corte o enquadram e três vistos dizem “Nítida em qualquer tamanho”, “Rótulos como texto real” e “Original → gráfica”.

    NarraçãoUma figura recortada do PDF final é pouco mais que uma foto do desenho. O original é o próprio desenho. Com o original, o agente recompõe cada figura: nítida em qualquer tamanho, com seus rótulos como texto real, prontos para traduzir. E na gráfica, o original vai do jeito que está.

  8. 1:37

    Na telaPasso 03, a referência: “Mostre como deve ficar.” Na árvore da pasta, referencia.pdf fica destacado com a etiqueta “Na raiz”; dele sai uma página que se transforma numa página de livro grande, em duas colunas, marcada referencia.pdf.

    NarraçãoO passo três é essencial: na raiz da pasta, coloque um arquivo que mostre com clareza como o produto final deve ficar. O ideal é um PDF.

  9. 1:47

    Na telaSobre a página aparecem as medidas: o contorno das colunas, uma medianiz de 9 mm, uma margem de 20 mm, etiquetas para o título (Fraunces 28 pt), o texto (Lora 9,4/13,6 pt) e um boxe (fundo, 1 fio), e as linhas de base com entrelinha de 13,6 pt. Um arquivo, ficha-de-especificacoes.md, vai sendo preenchido: página 210 × 280 mm; margens 24 · 20 · 22 · 20 mm, simétricas; 2 colunas, medianiz 9 mm; grade de linhas de base 13,6 pt; texto Lora 9,4 / 13,6 pt, justificado; títulos Fraunces 28 pt · Geist; aberturas com faixa de cor de 101 mm; boxes com fundo e fio à esquerda. Depois a palavra “Adivinhar” é riscada e “Medir.” se acende em dourado.

    NarraçãoO agente lê o design nessas páginas: mede margens, colunas, fontes e espaçamentos, e os anota como regras de diagramação. Sem referência, ele teria que adivinhar. Com ela, mede.

  10. 2:03

    Na telaPasso 04, o agente: “Peça com suas palavras.” Abre-se uma janela com o título “Agente · ~/meu-livro” ao lado dos selos Claude Code, Codex e “ou qualquer outro agente”. Na janela é digitada uma mensagem assinada VOCÊ: “Instale a skill do Postext: `npx skills add drnachio/postext --skill postext-port`”, e o agente responde “✓ Skill instalada: postext-port”. Um cartão da skill postext-port lista “Um método testado”, “Tudo sobre o Postext” e “Ferramentas para revisar o próprio trabalho”.

    NarraçãoPasso quatro: abra o seu agente, Claude Code, Codex ou o que você usa, nessa pasta, e peça que ele instale a skill do Postext. Uma skill é um pacote de conhecimento especializado. Esta ensina o agente a converter uma publicação para Postext, e lhe dá ferramentas para revisar o próprio trabalho.

  11. 2:24

    Na telaO pedido seguinte é digitado: “Use a skill postext-port para converter este livro para Postext. O design está em referencia.pdf, as fontes em fontes/ e as ilustrações originais em ilustracoes/: use-as em vez de recortar as figuras do PDF. Comece só pelo capítulo 1 e me mostre a ficha de especificações antes de construí-lo.” Ao lado, referencia.pdf, fontes/ e ilustracoes/ se acendem na árvore da pasta à medida que a mensagem os cita, e aparece um cartão com “Cap. 1”.

    NarraçãoDepois, peça o que você quer com as suas palavras. Diga onde estão a referência, as fontes e os originais, e que ele comece por um só capítulo.

  12. 2:37

    Na telaUma grade de doze páginas esmaecidas; a primeira ganha um contorno dourado. Uma seta circular conta as rodadas de ajuste sobre ela até aparecer um visto, e então as outras onze se acendem. Embaixo: Capítulo de amostra → Refinar → Estender.

    NarraçãoSe o conteúdo for longo, comece por um capítulo de amostra. Refine-o até ficar perfeito, e só então estenda-o ao resto.

  13. 2:45

    Na telaO agente pergunta “Cópia fiel ou redesenho?”, “Quais idiomas?” e “Papel, tela ou os dois?”. Uma lista de tarefas avança por Fazer o inventário, Medir o design, Extrair o texto, Fontes e imagens, Comparar página a página e Empacotar o arquivo, e aparece o arquivo meu-livro.postext. Um terceiro pedido é digitado: “O capítulo 1 está aprovado. Converta o resto dos capítulos com o mesmo design, compare cada um com referencia.pdf e empacote tudo num único arquivo .postext.” O agente responde “✓ 12 capítulos · 0 avisos · meu-livro.postext”.

    NarraçãoO agente vai fazer algumas perguntas: cópia fiel ou redesenho, quais idiomas, papel ou tela. Depois mede, extrai, monta e confere, e entrega um arquivo Postext. Quando a amostra estiver boa, estendê-la ao livro inteiro é só mais um pedido.

  14. 3:08

    Na telaPasso 05, o Sandbox: “Revise página por página.” Numa janela de navegador é digitado o endereço postext.dev/pt/sandbox. O ponteiro clica em Livros na barra lateral, depois em Novo e em “Abrir um arquivo .postext…”; o arquivo entra voando, “Meu livro, 12 capítulos · 184 páginas” aparece no alto da lista e as primeiras páginas se abrem na visualização Canvas; as abas de visualização são Canvas, HTML, PDF, Folio e EPUB 3.

    NarraçãoPasso cinco: abra o Sandbox do Postext, em postext.dev. Em Livros, escolha Novo e abra o seu arquivo.

  15. 3:17

    Na telaA página de referência e a do Postext ficam lado a lado, com as etiquetas Referência e Postext, e uma linha dourada as percorre de cima a baixo. Abre-se o painel Verificações, com um contador de 3 e a lista Viúva (p. 4), Linha frouxa (p. 7) e A figura não cabe (p. 9); caixas vermelhas marcam cada problema na página do Postext.

    NarraçãoRevise página por página, ao lado da sua referência. O painel Verificações aponta os problemas: viúvas, linhas frouxas, figuras que não cabem.

  16. 3:28

    Na telaDuas fileiras de páginas esquemáticas, “Referência · PDF” e “Postext · fluido”. Na fileira fluida, uma figura passa da primeira página para o topo da segunda, e uma linha tracejada liga as suas duas posições. Texto: “As mesmas regras, não as mesmas páginas. O conteúdo flui: uma figura ou uma quebra de página podem cair em outro lugar.” Depois, um sinal de igual une cada par de páginas sob “O que precisa coincidir”: Margens e grade de linhas de base, Tipografia, Estilo de figuras e boxes, Páginas limpas: sem viúvas, colunas equilibradas. Um painel vermelho com o sinal ≠ diz “Decisões artesanais à mão: não são regras, não servem para um conteúdo que muda”.

    NarraçãoTenha em mente uma coisa: as páginas não precisam ser idênticas às do PDF. O Postext entendeu as regras de diagramação e agora o seu conteúdo é fluido, então uma figura ou uma quebra de página podem cair em outro lugar. O que precisa coincidir é a qualidade: os mesmos valores de produção. Quando diagramamos à mão, tomamos pequenas decisões artesanais que não são regras. E só com regras dá para diagramar um conteúdo que muda.

  17. 3:59

    Na telaA janela do agente volta com um quarto pedido: “No Sandbox, capítulo 2, página 7: o boxe ‘Lembre’ se divide em duas colunas e falta o cabeço. Verificações marca 3 linhas frouxas. Corrija isso e empacote o arquivo de novo.” Uma captura vai anexada, captura-cap2-p7.png. Depois, um ciclo entre Sandbox (revisar) e Agente (corrigir) dá as voltas 1 a 3 enquanto o número de avisos cai de 3 para 0, e termina com um visto e “Perfeito.”

    NarraçãoDepois, conte ao agente o que você vê, com a maior precisão possível: o capítulo, a página e o que está errado. Uma captura de tela ajuda. Abra a nova versão, revise de novo e repita. Cada rodada chega mais perto, até que fique perfeito.

  18. 4:20

    Na tela“Não só uma versão Postext.” O arquivo meu-livro.postext se divide em dois ao longo de uma linha dourada. À esquerda, Conteúdo (o que diz): chapters/pt/02-a-celula.md, com o título “A célula”, uma frase que cita a figura fig-celula e um boxe “lembre”. À direita, Forma (como fica): um modelo deduzido do seu original, com página de 210 × 280 mm simétrica, 2 colunas com medianiz de 9 mm, texto Lora 9,4/13,6 justificado, títulos em Fraunces numerados, boxes “lembre” com fundo e fio, e figuras no topo da coluna.

    NarraçãoE o melhor: você não só tem o seu conteúdo em Postext. Você separou o conteúdo da forma. O texto vive em capítulos limpos; o design, num modelo com as regras de diagramação deduzidas do seu original.

  19. 4:34

    Na telaOs chips Corrigir, Ampliar e Traduzir se acendem sobre uma fileira de páginas: uma linha fica destacada e um brilho percorre as páginas, entram mais duas páginas e as páginas viram para mostrar a edição em inglês. Um pedido é digitado: “Acrescente uma edição em inglês: traduza os capítulos, as legendas das figuras e os rótulos dos diagramas, e mantenha o mesmo design.” Rodapé: “As mesmas regras. Conteúdo novo. As páginas se compõem sozinhas.” Depois, “Um arquivo, o livro inteiro.”: um ícone .postext se ramifica para uma página com marcas de corte (PDF para impressão), um leitor de livros digitais com o texto ajustado à sua tela (Livro digital EPUB), uma janela de navegador (Leitor web) e um par de páginas (Cada página, composta).

    NarraçãoAssim, quando o seu conteúdo mudar, quando você o corrigir, ampliar ou traduzir, não vai precisar se preocupar com o formato. O Postext o recompõe com as mesmas regras. Um só arquivo para o livro inteiro: um PDF pronto para impressão, um livro digital EPUB, um leitor para a web e páginas que se compõem sozinhas.

  20. 4:59

    Na telaFechamento: o logotipo do Postext, o lema “O tipógrafo programável para a web”, postext.dev, um chip com “Os prompts deste vídeo estão na descrição ↓” e o rodapé “Código aberto · MIT · github.com/drnachio/postext”.

    NarraçãoPostext. Código aberto, em postext.dev. Os prompts de exemplo estão na descrição.

Também no YouTube: assista lá ou na playlist do Postext.

Edite um livro Postext com um agente de IA: capítulos, novas edições, adaptações — tutorial 2Assistir no YouTube (abre em uma nova aba) · O player é carregado do YouTube quando você aperta o play.

#O que a skill contém

  • Um fluxo de trabalho:
    1. combinar o briefing;
    2. fazer o inventário do original;
    3. medir o design em uma ficha de especificações;
    4. montar o esqueleto do projeto;
    5. extrair o conteúdo;
    6. revisá-lo e passá-lo para o Markdown do Postext;
    7. preparar fontes e imagens;
    8. verificar página por página;
    9. empacotar.
  • Referências:
    • o formato do documento e o manifesto de configuração, ambos conferidos com o motor;
    • o formato do projeto (pacote);
    • um roteiro por formato de origem;
    • um método de análise de design;
    • um catálogo de casos de diagramação resolvidos: partes com cores próprias, aberturas de capítulo, verso, notas de margem, notas de rodapé, índices remissivos, boxes flutuantes, divididos e aninhados, originais vetoriais de impressão, figuras com texto vivo, imagens em células de tabela, tabelas em paisagem, edições bilíngues e mais;
    • livros chineses, compostos na horizontal ou na vertical e encadernados à direita: o que perguntar no briefing (escrita, região, direção, encadernação), como medir uma grade de caracteres, como ler PDFs verticais, o rubi e o warichu do InDesign, o layout asiático do Word e os EPUBs da direita para a esquerda, e como recortar fontes CJK para o livro (veja Composição chinesa);
    • livros japoneses, romances bunko e tankōbon verticais encadernados à direita ou livros técnicos horizontais: o idioma que liga as regras japonesas (ja, nunca uma tag chinesa), o que perguntar (direção, grade, furigana, notas, a ortografia da edição), como medir a mancha em caracteres e linhas, a marcação de furigana e de bōten, textos do Aozora Bunko convertidos com aozora.py, digitalizações de edições em domínio público da Biblioteca Nacional da Dieta, e fontes japonesas recortadas com os kana e as formas verticais (veja Composição japonesa);
    • livros árabes, modernos ou clássicos e vocalizados, compostos da direita para a esquerda e encadernados à direita: o idioma que põe o livro inteiro da direita para a esquerda, o que perguntar (região e algarismos, vocalização, verso, sumário no fim), como medir uma página espelhada, como ler árabe em PDFs, no Word e na Wikisource, poemas como :::verse, notas «(١)» por página, e fontes árabes recortadas com as tabelas de ligação (veja Composição em árabe);
    • quadrinhos, mangás e tiras de jornal: a divisão que corta uma página em quadros, as imagens dos quadros com as âncoras de personagem e as áreas seguras, um roteiro por idioma que o motor letreira (balões, recordatórios, onomatopeias), mangás da direita para a esquerda e edições árabes, e como portar a partir de desenhos sem texto mais traduções, de digitalizações letreiradas ou de um roteiro com desenhos gerados (veja Quadrinhos);
    • tintas especiais e facas: as chapas de cores especiais e as chapas e camadas do fabricante de facas de um PDF ou de um IDML, o acabamento que o nome de cada tinta sugere (metálica, hot stamping, fluorescente, branco opaco, verniz), confirmado com a especificação da gráfica, e as facas medidas na linha de faca (veja Tintas especiais e facas);
    • as páginas compostas: páginas fixas de livros didáticos, cadernos de exercícios e revistas portadas como modelos de página cujos blocos são preenchidos pelo Markdown, qual rodada de porte o Postext instalado aceita e as verificações que cada edição precisa passar (veja Páginas compostas);
    • o objeto impresso: como ler o papel, a encadernação, as capas e a lombada do original e defini-los nas configurações folio que o visualizador Folio mostra, conferidas pelo linter.
  • Scripts (Python e Node), descritos na próxima seção.

#Scripts

ScriptO que faz
inventory.pyPrimeira olhada em qualquer original: geometria, fontes, estilos em uso, mídia, páginas que precisam de OCR; num PDF impresso como PDF/X, a condição de saída e a sangria, com os ajustes print que as reproduzem. Também lista as chapas de cores especiais de um PDF ou de um IDML, com o acabamento que cada nome sugere, e as chapas e camadas do fabricante de facas.
measure_layout.pyMargens, colunas, medianiz e entrelinha (a grade de linhas de base) de um PDF
pdf_extract.pyPDF → rascunhos de capítulos por papel tipográfico (fonte/tamanho/cor): ordem de leitura, parágrafos, remoção da hifenização, negrito/itálico, sobrescritos/subscritos, listas, legendas
pdf_figures.pyRecorta figuras de um PDF: fotos na resolução nativa, visualizações em SVG, originais vetoriais de impressão em PDF
pdf_regions.py, template_dedupe.py, anchors.pyTransformam as páginas fixas de um PDF (livros didáticos, cadernos, revistas) em páginas compostas: modelos de página com blocos medidos em mm; estilos de boxe, de aba e de destaque; um fundo de página sem texto; as imagens recortadas sem o texto; e Markdown com um contêiner de página (::::page) por página e um slot por caixa, na ordem de leitura. O texto escondido sob outra pintura fica de fora. template_dedupe.py junta numa só biblioteca os modelos e os estilos das páginas de um mesmo tipo, dá aos blocos nomes pelo papel que cumprem (box-light-blue, caption-of-picture) em vez de pelo tipo e pela ordem, e atualiza os contêineres de página de acordo. anchors.py transforma as palavras de um mapa em âncoras do recurso e em linhas ::label para cada edição. Quando a execução tem uma só página e, portanto, não há o que mesclar, o próprio pdf_regions.py extract dá aos blocos nomes pelo papel (--name-frames, desde o postext 1.43). Desde o postext 1.48, desenha como vetores as linhas, os cartões e as formas da página (conectores entre blocos, linhas que apontam um ponto de uma imagem, traçados) em vez de uma imagem por página, e o template_dedupe.py transforma os cartões dispostos em linhas e colunas em grades que se repetem e cada faixa da página em um módulo. A partir do postext 1.50, também coloca numa fileira de módulos os blocos que ficam lado a lado, mantém numa só grade os cartões que mudam apenas de cor, cada um com uma aparência nomeada, e dá às páginas pré-textuais e às do miolo um único modelo de base, cujo fólio e cor de página são desenhados quando o bloco ::::page indica. Desde o postext 1.51 o rascunho pede menos retoques: cada imagem é recortada sem nada além da imagem (ficam de fora as letras escondidas, os preenchimentos vizinhos e as margens em branco), a placa que a página pinta sobre uma foto fica por cima dela, o texto de um quadro vai até a borda do quadro, os ornamentos ao lado de um cabeço acompanham-no, as legendas compostas em colunas sob as imagens ganham um quadro cada uma, uma cor que o livro já nomeia empresta o nome à aparência que a usa, e os blocos que o rascunho encadeia um sob o outro ainda podem formar uma fileira de módulos. As correções feitas à mão vão em curation.json, que o extract escreve vazio e o manifest aplica depois de cada compilação, então uma nova compilação as mantém: blocos corrigidos, removidos ou acrescentados, decoração removida, sobreposições permitidas, estilos alterados e recursos acrescentados, cada um com o seu motivo; uma correção cujo modelo, bloco ou estilo não existe interrompe a compilação.
extract_tables.pyTabelas de PDF → TableModel do Postext: as células mantêm alinhamento, negrito e preenchimento, as células mescladas a sua extensão, uma linha de título vira a legenda e o rótulo da tabela, uma linha que cruza todas as colunas uma faixa de grupo centralizada, as linhas de cabeçalho são contadas pelo negrito ou pelo preenchimento, e duas linhas lidas como uma são separadas de novo. O pdf_extract.py já transforma as tabelas com fios em recursos de tabela.
pandoc_to_postext.pyDOCX, PPTX, ODT, EPUB, HTML, LaTeX, Markdown, JATS, DocBook → rascunhos de capítulos, com os estilos do Word mapeados para boxes e estilos de parágrafo
idml_extract.pyIDML do InDesign → rascunhos de capítulos por estilo de parágrafo, tabelas e imagens ancoradas; rubi, tate-chu-yoko, marcas de ênfase e warichu viram :ruby, :tcy, :dots e :warichu, e o script informa as matérias verticais e uma encadernação da direita para a esquerda
aozora.pyTexto do Aozora Bunko (um zip em CP932 ou um .txt) → Markdown do Postext: furigana, bōten e linhas laterais, títulos com os recuos, blocos 字下げ e 地付き como estilos de parágrafo, quebras de página, 外字 resolvidos pela JIS X 0213, marcas de kanbun; devolve o bloco de créditos e um relatório do que não conseguiu expressar
index_marks.pyReconstrói um índice remissivo impresso como marcas :index: lê as páginas do índice no PDF, encontra cada termo na página indicada e marca as mesmas palavras nos capítulos
comic_panels.pyMede páginas de quadrinhos: encontra os quadros pelo papel entre eles, escreve a expressão split (da esquerda para a direita ou da direita para a esquerda, sarjetas inclinadas incluídas), as sarjetas e a moldura, recorta uma imagem por quadro e imprime os esqueletos :::page; sobrepõe uma grade às imagens para ler as âncoras de personagem e as áreas seguras, e as desenha de volta para conferi-las
fonts.py, images.py, convert_assets.pyInstanciam, recortam, escalam e dividem fontes (uma face chinesa ou japonesa recortada para os caracteres do livro mantém as formas verticais e as métricas; uma árabe, as formas de ligação e o tatweel); convertem imagens para sRGB, aparam e juntam imagens; transformam arte .ai/.pdf em SVG
preset_kit.pyMonta o esqueleto do projeto e o script gerador dele, constrói o preset.json, empacota o arquivo .postext e passa o linter na configuração, sinalizando o texto do livro digitado em elementos de design (a configuração deve guardar só o design) e uma configuração grande demais para o Sandbox
lint_project.pyDetecta tudo o que o parser e o carregador interpretam errado sem avisar e, para texto chinês, japonês e coreano, os caracteres que as fontes incluídas não conseguem compor; para texto japonês, kana sob um idioma chinês, faces ou configurações chinesas, notação do Aozora esquecida nos capítulos e entradas de índice em kanji sem leitura; para texto árabe, a falta de um idioma árabe, faces só latinas ou sem ligação, espaçamento entre letras, hifenização forçada e ênfase em itálico; nos quadrinhos, expressões de divisão que não são interpretadas, quadros que não correspondem às células, imagens e estilos de balão ou de quadro desconhecidos, âncoras de personagem malformadas, faces de letreiramento que o projeto não inclui e edições cujas páginas diferem. Também aponta o que um agente deixa para trás: marcas em linha num texto de desenho sem inlineMarks, um espaço comum digitado ao lado de um espaço fixo, um chip num título com um motor anterior à 1.52, maiúsculas digitadas num chip pequeno em vez de :smallcaps[…] e um ::: depois de uma diretiva de uma linha como :::toc; a sua lista de ajustes de configuração vem dos tipos do próprio motor
render.mjsDiagrama o projeto (uma pasta ou um arquivo .postext) sem interface, com o motor real, lendo a configuração dele como o Sandbox faz, e imprime os avisos. Com --jpeg, pinta as páginas que você pedir (--pages 12-15) como arquivos JPEG com o próprio renderizador de canvas do motor, em um ou dois segundos, para que o agente veja as páginas sem gerar um PDF; --out grava o PDF. Um livro preparado para impressão recebe linhas PREFLIGHT (imagens de baixa resolução, fios finos, texto pequeno em várias tintas, tinta acima do limite, texto perto do refile), e o PDF é separado com o perfil ICC de saída. Uma página com faca mostra as páginas embaixo dos seus furos, como na mão.
compare_pages.pyColoca lado a lado as páginas do original e as do Postext, a partir do PDF renderizado ou da pasta de JPEGs gerada; com --score, mede o quanto se parecem, e com --check a pontuação falha enquanto as verificações ainda apontarem um bloco sobre outro; com --watch DIR, ao lado de postext build … --images DIR --watch, reescreve o par e a nota de uma página toda vez que essa página muda
port_audit.pyCompara o PDF de origem e o PDF da adaptação atributo por atributo, emparelhando as palavras pelo conteúdo: espaços especiais, itálico (inclusive um redondo inclinado), negrito, versaletes, tamanho e peso dos marcadores, alinhamento e peso das células de tabela, e as cores de fólios, cabeços e texto. Escreve um relatório JSON e outro Markdown com uma contagem por atributo e página; rode antes da entrega
composed_check.pyPáginas compostas: round lê a versão do motor instalado e diz qual rodada de porte ele aceita e quais recursos de páginas compostas lhe faltam; check roda postext check e postext html em cada edição e falha com blocos que transbordam, modelos ou slots desconhecidos, rótulos que não cabem na âncora, texto escrito na configuração e blocos que o HTML lê em outra ordem que não a do Markdown que os preenche. Desde o postext 1.48, também falha quando um bloco fica embaixo de outro ou sai da sua caixa (frameCovered, frameOutsideArea) e termina com o número de sobreposições; uma sobreposição que o original imprime de propósito é anotada, com o motivo, no composed-check.json do projeto. Também falham os ajustes escritos errado e os valores que o motor não aceita (unknownConfigKey, unknownConfigValue), e todos os outros avisos são impressos. --json-out FILE salva o resultado sem perder o relatório nem o código de saída, e o preset_kit.py pack se recusa a empacotar enquanto a verificação salva tiver falhado
postext_md.pyO módulo auxiliar que os outros scripts importam para escrever texto no dialeto Markdown do Postext: trechos planos de marcas inline, caracteres ativos escapados e parágrafos que seriam lidos como lista, título ou bloco mantidos como texto

#Instalação

#Qualquer agente (skills.sh)

A CLI skills detecta seus agentes e instala a skill para eles:

npx skills add drnachio/postext --skill postext-port

Escolha os agentes explicitamente com -a, e instale globalmente (em todos os projetos) com -g:

npx skills add drnachio/postext --skill postext-port -a codex -a claude-code -g

O site também publica a mesma skill; por isso, isto também funciona:

npx skills add https://postext.dev

#Plugin do Claude Code

O repositório do Postext também é um marketplace de plugins do Claude Code. Dentro do Claude Code:

/plugin marketplace add drnachio/postext
/plugin install postext@postext

Ou a partir de um shell:

claude plugin marketplace add drnachio/postext
claude plugin install postext@postext

#Deixe o agente instalá-la

Você pode pedir a seu agente que faça isso, por exemplo: “Instale a skill de conversão do Postext (npx skills add drnachio/postext --skill postext-port) e use-a para portar este PDF.” Os agentes que leem https://postext.dev/llms.txt encontram ali esta página e o comando de instalação.

#Ferramentas que os scripts usam

python3 -m pip install pymupdf pillow fonttools brotli numpy
brew install pandoc poppler
mkdir -p ~/.cache/postext-tools && cd ~/.cache/postext-tools && npm init -y && npm i postext postext-pdf postext-citeproc react @pdf-lib/fontkit @napi-rs/canvas

O Pandoc é necessário para originais em Word, PowerPoint, EPUB e HTML, o poppler para as imagens das páginas do original, e o numpy para comic_panels.py. Os pacotes do Node fazem funcionar o renderizador sem interface (Node 22.15 ou mais recente); @napi-rs/canvas é um canvas pré-compilado que permite pintar as páginas do livro direto em JPEG. Ferramentas opcionais: ocrmypdf para digitalizações, ImageMagick e veraPDF para verificações PDF/UA.

mkdir -p ~/.local/bin && curl -fL -o ~/.local/bin/postext https://github.com/drnachio/postext/releases/latest/download/postext-macos-arm64 && chmod +x ~/.local/bin/postext

Escolha o arquivo do seu sistema (postext-macos-arm64, postext-macos-x64, postext-linux-x64, postext-linux-arm64, postext-linux-x64-musl, postext-windows-x64.exe); com o Node, npx postext-cli também funciona.

O ciclo de trabalho roda na linha de comando, um executável autônomo que não precisa ser instalado: o agente mantém o projeto descompactado e deixa postext build --watch rodando sobre as páginas em que está trabalhando, de modo que cada mudança aparece como JPEG cerca de um segundo depois, mesmo num livro longo. Os pacotes do Node são opcionais: eles rodam o render.mjs, que acrescenta as verificações extras do Sandbox. Os dois diagramam o livro com bodyText.shapingLanguage: 'host', seja qual for a configuração do livro; por isso, uma linha pode quebrar numa palavra diferente da do Sandbox (veja Diferenças em relação ao Sandbox).

#Como usar

Coloque os arquivos originais na sua pasta de trabalho e peça a conversão. Por exemplo:

  • “Porte os capítulos 1–3 de manual.pdf para o Postext, reproduzindo a diagramação em duas colunas, as aberturas de capítulo e os boxes.”
  • “Converta course.docx em um livro do Postext. Os estilos ‘Nota’ e ‘Actividad’ são boxes.”
  • “Transforme deck.pptx em uma apostila do Postext: os slides viram seções, as notas do apresentador viram o texto.”
  • “Temos o pacote do InDesign (IDML + PDF de impressão) deste livro didático. Monte a predefinição do Postext para o capítulo 1 em espanhol e em inglês.”

Para um livro do InDesign, dê ao agente a pasta que Arquivo › Empacotar cria no InDesign (o .idml, o PDF de impressão, as fontes e as ilustrações vinculadas). A skill deduz delas as regras de diagramação, o que o importador de IDML não faz: InDesign: importar, exportar e portar compara os dois.

O agente segue o fluxo de trabalho:

  1. Briefing. Ele pergunta o que não consegue deduzir: uma reprodução fiel ou um redesenho, um capítulo de amostra ou o livro inteiro, idiomas, impressão ou tela, e os direitos sobre o texto, as imagens e as fontes.
  2. Inventário e medição. Ele lê o original e escreve uma ficha de especificações com fatos medidos: refile, margens, colunas, entrelinha, papéis tipográficos, paleta, aberturas, cabeços, famílias de boxes e hábitos de colocação. Ele classifica cada página como texto corrido ou como página composta (boxes, rótulos e mapas em lugares fixos). Com o Postext 1.35 ou mais recente, agrupa as páginas compostas por tipo e monta cada tipo a partir de um modelo de página, de modo que a diagramação continua idêntica e o texto continua editável e traduzível. Com uma versão anterior, se mais de um terço das páginas for composta, pergunta se você prefere a diagramação idêntica ou um texto que possa editar e traduzir.
  3. Projeto. Ele monta o esqueleto de my-book/ com um gerador build_preset.py que guarda a especificação como constantes e produz o preset.json.
  4. Conteúdo. Ele extrai rascunhos de capítulos com o extrator certo e depois os revisa e passa para o Markdown do Postext: boxes, estilos de parágrafo, partes, atributos de título para as aberturas, citações :ref, recursos de tabela e de figura.
  5. Verificação. Ele passa o linter e deixa postext build --watch rodando sobre o projeto descompactado: muda um capítulo ou uma configuração, olha o JPEG da página, repintado cerca de um segundo depois, e muda de novo até que as quebras de página, as figuras e os boxes coincidam com o original página por página. A cada etapa concluída ele roda as verificações completas (postext check e o linter). O PDF é gerado para as verificações de impressão, não a cada olhada.
  6. Entrega. Ele define o papel, a encadernação e as capas do livro para o visualizador Folio e empacota my-book.postext.

Abra o resultado no Sandbox: Livros → Novo → Abrir um arquivo .postext…. A importação traz os capítulos e os textos no idioma do Sandbox. Para trabalhar com uma pasta de projetos em uma cópia local do Postext, defina POSTEXT_PRIVATE_PRESETS_DIR (veja Sandbox).

#Carregar o resultado a partir de código

O arquivo entregue não está preso ao Sandbox. O pacote postext o abre com openBundle, diagrama o livro com buildBundle e o renderiza em canvas, HTML ou PDF (veja Pacotes). Uma conversão pode, portanto, alimentar um programa diretamente. Quando a saída desse programa precisar de ajustes, exporte-a de volta para um arquivo .postext com createBundle, faça o ajuste fino no Sandbox e carregue de novo o arquivo corrigido. O render.mjs sem interface da skill também aceita um arquivo .postext empacotado, além de uma pasta de projeto.

#O que esperar

  • Os extratores produzem rascunhos; o agente os revisa. Conte com uma rodada de revisão por capítulo, comparando com as páginas originais. É dessa revisão que vem a qualidade.
  • O texto fica no Markdown. A configuração guarda o projeto gráfico e cada palavra do livro está nos capítulos; por isso, uma correção ou uma tradução é só uma edição do Markdown. Com o Postext 1.35 ou mais recente, as páginas compostas são modelos de página na configuração, cujos blocos se preenchem com o Markdown de cada capítulo: um boxe cresce com uma tradução mais longa e empurra os de baixo, e a partir da 1.37 as palavras de um mapa são rótulos escritos no Markdown. Com uma versão anterior, elas são montadas com boxes fixados no lugar, imagens de página sem texto e figuras SVG com rótulos em texto vivo. O relatório diz qual dos dois caminhos o agente seguiu e com qual versão. Quando o Postext não consegue expressar algo sem digitar texto na configuração, o agente para, escreve a lacuna como rascunho de issue e pergunta a você. A skill nunca altera o motor para encaixar um livro.
  • Um só arquivo para todos os idiomas. Uma tradução é um conjunto de capítulos no mesmo arquivo .postext, com legendas e rótulos de figura próprios, verificado com postext check em cada idioma.
  • Os direitos são decisão sua. O agente pergunta antes de reproduzir imagens ou fontes cujas licenças não estejam claras. As fontes licenciadas são marcadas com redistributable: false, e por isso os projetos exportados as deixam de fora.
  • Fidelidade onde importa. O objetivo é a mesma grade, os mesmos tipos, aberturas, boxes, colocação das figuras e quebras de página na maioria das páginas (com diferença de no máximo uma página por capítulo), não quebras de linha idênticas.

#Onde ela fica

A skill está no repositório em plugins/postext/skills/postext-port. Ela cobre todos os casos encontrados ao construir as predefinições do Sandbox, públicas e privadas. Quando uma conversão topar com um caso que ela ainda não cobre, abra uma issue ou um pull request que melhore a skill, para que a próxima conversão já o receba pronto.