Pular para o conteúdo principal

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

InDesign: importar, exportar e portar

Os 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

Atualizado 2026-11-149 minenescadefritptzhjaar

Em poucas palavras

O Postext pode trazer um livro feito no InDesign de dois jeitos. O importador copia o que o arquivo do InDesign contém: cada página, cada quadro e cada estilo como estão. É rápido, mas o resultado é uma cópia das páginas antigas, difícil de mudar e de traduzir. Já a skill para agentes estuda o livro: o arquivo, o PDF de impressão, as fontes e as imagens. Ela descobre as regras que o designer seguiu e refaz o livro a partir delas, com o texto livre para correr, e assim sai um livro melhor, que é o que recomendamos. Esta página explica os dois jeitos, quando cada um serve e como o Postext devolve um livro pronto ao InDesign.

Um livro feito no InDesign pode entrar no Postext copiando as páginas ou deduzindo o design. Recomendamos deduzir o design.

O Postext lê e grava pacotes InDesign Markup (.idml), o arquivo que o InDesign salva com Arquivo › Salvar como › InDesign Markup (IDML). Três ferramentas os usam:

  • o importador, que transforma um .idml em um livro do Postext;
  • a skill para agentes postext-port, que porta um livro a partir de todos os originais dele, entre eles o .idml;
  • o exportador, que grava um livro do Postext como .idml para um designer finalizar no InDesign.

O importador e a skill trazem os dois um livro, e não dão o mesmo livro. Esta página explica a diferença para você poder escolher.

InDesign, entra e sai: importar, portar e exportar livros do InDesign com o PostextAssistir no YouTube (abre em uma nova aba) · O player é carregado do YouTube quando você aperta o play.

#Dois caminhos para o Postext

Um documento do InDesign é um conjunto de páginas que alguém fez à mão. O designer seguiu regras, como um corpo de letra, uma grade, o jeito de abrir um capítulo, o lugar de um boxe ou como uma legenda fica embaixo da sua figura. O .idml guarda o resultado de aplicar essas regras, quadro a quadro, e não registra as regras.

O importador copia o resultado. Ele lê o pacote e grava o que encontra: cada quadro onde estava, cada estilo com os seus valores, cada imagem e cada tabela como recurso. Nada é adivinhado, e o mesmo arquivo dá sempre o mesmo livro. Como o HTML de uma página web, a cópia mostra as páginas sem o raciocínio por trás delas. Um quadro posicionado a olho fica nas suas coordenadas, um título empurrado para baixo com um parágrafo vazio mantém o parágrafo vazio e um ajuste local continua sendo um ajuste local. O livro se parece com o original e carrega o ofício dele.

A skill deduz as regras. Um agente lê o original inteiro: o .idml, o PDF de impressão, as fontes e as ilustrações. Ele mede as páginas e anota as regras que elas seguem, como o formato e as margens, a grade de linhas de base, as funções tipográficas, as aberturas, os cabeços, as famílias de boxes e o lugar dos flutuantes. Depois grava o texto como Markdown que volta a correr e não leva posições de página, e define o design na configuração a partir dessas regras. O Postext diagrama as páginas a partir das regras, então o livro pode ser editado, traduzido e composto em outro formato, e continua parecido com o original.

ImportadorSkill para agentes
LêO .idml e as imagens vinculadas deleO .idml, o PDF de impressão, as fontes e as ilustrações vinculadas (.ai, .psd, .eps, .tif)
MétodoDeterminístico: copia o que o documento contémInferência: mede as páginas e deduz as regras
TextoPreso aos quadros do documento (--layout pages) ou corrido com os estilos dele (--layout flow)Markdown que volta a correr, com diretivas e sem posições de página
DesignOs valores dos estilos e dos quadros do documentoUma configuração de regras: grade, funções tipográficas, aberturas, cabeços, boxes, flutuantes, modelos de página para páginas compostas
TempoSegundosHoras para um livro, com um agente e verificações contra o PDF
ResultadoUma réplica, com um relatório do que se perdeuUm livro do Postext que se comporta como o original

Use a skill por padrão. É o caminho certo para qualquer livro que você vai manter: um livro que vai revisar, traduzir, compor em outro formato ou publicar em EPUB além do impresso.

Use o importador quando o objetivo é uma cópia:

  • Um livro que o Postext exportou. Um .idml gravado pelo Postext volta com as mesmas linhas e as mesmas páginas, então as alterações que um designer fizer no InDesign voltam para o livro.
  • Uma olhada rápida. O relatório de importação lista em segundos as páginas, as matérias, os estilos, as fontes, as imagens e as tabelas do documento, antes de você decidir qualquer coisa.
  • Uma página fixa que fica como está. Um cartaz, um formulário, uma única página dupla ou um folheto curto que não vai ser editado nem recomposto.
  • O primeiro passo de uma conversão. A própria skill pode rodar o importador para obter um inventário e um primeiro rascunho, e depois corrigi-lo; veja mais abaixo.

#O importador

postext import-idml book.idml -o book/
postext import-idml book.idml -o book.postext --layout flow --links Links/
postext import-idml book.idml --report --json
postext import-idml package.zip -o book.postext

A mesma importação roda no Sandbox, em Livros › Novo › Livro novo a partir de um documento do InDesign (IDML) (veja Importar um documento do InDesign), que também abre um pacote do InDesign compactado em Livro novo a partir de um pacote do InDesign (.zip) e tira dele as fontes e as imagens vinculadas, e em código com idmlToPostext, do pacote postext-idml (veja Uso programático › Pacotes do InDesign). Todas as opções do comando estão em Linha de comando › import-idml.

#Importar um documento do InDesign

Livro novo a partir de um documento do InDesign (IDML), no menu Novo do painel Livros, lê um arquivo .idml no navegador e abre uma caixa de diálogo. Ela mostra o que o documento contém: as páginas e o tamanho delas, as matérias, as fontes que ele nomeia, as imagens, vinculadas e incorporadas, e as tabelas. Layout escolhe entre Páginas compostas, em que cada página mantém os quadros onde o documento os tem, e Livro de texto corrido, em que o texto corre pelas páginas que o projeto gráfico do livro faz; Automático deixa a escolha para o importador, que diz o motivo. Um .idml não leva as imagens que vincula: escolha os arquivos, ou a pasta que os contém, e cada um é associado pelo nome de arquivo. O relatório de importação acompanha cada escolha: um veredito, as contagens, o que se perdeu, foi aproximado ou anotado, cada item com uma contagem e um exemplo, as fontes de que o livro precisa e os vínculos que ainda faltam. Criar o livro acrescenta o resultado aos seus livros e o abre, e os livros que você tinha ficam como estavam. Um arquivo .indd é recusado com uma mensagem que manda salvá-lo como IDML no InDesign. A linha de comando faz a mesma importação com postext import-idml. A importação é uma cópia das páginas do documento; para um livro que você vai manter, a skill para agentes deduz em vez disso as regras de diagramação dele (veja A skill).

Livro novo a partir de um pacote do InDesign (.zip) recebe a pasta que Arquivo › Empacotar do InDesign cria, compactada em zip, com Incluir IDML marcado. Quando o pacote traz mais de um documento IDML, uma caixa de diálogo pergunta qual vira o livro. A caixa de diálogo de importação funciona então como acima, com o que o pacote acrescenta. As imagens vinculadas são tiradas do pacote, associadas pelo nome de arquivo e, entre arquivos de mesmo nome, pela pasta. Os arquivos de fonte de Document fonts entram no livro: cada estilo é associado pelo nome PostScript ao que o documento nomeia, de modo que o texto é composto nos estilos originais. O relatório lista as fontes que o pacote traz e os estilos para os quais ele não tem arquivo, e nomeia todo arquivo de fonte que o livro não pode levar (Type 1, uma maleta de fontes do Mac, um arquivo WOFF 1). Uma coleção de fontes (.ttc, .otc), como o macOS distribui fontes como a PT Sans, é separada em seus estilos: os que o texto usa, com os outros estilos das mesmas famílias, entram no livro como arquivos TrueType ou OpenType avulsos com o nome do estilo, e os demais estilos da coleção ficam de fora (desde o postext 1.83). Um pacote que traz só um .indd é recusado com uma mensagem que diz como obter o IDML dele.

#Páginas ou texto corrido

  • --layout pages segue o documento página por página. Cada página vira uma página composta e cada quadro fica no seu lugar, com o seu tamanho e a sua ordem; uma cadeia de quadros vinculados continua sendo uma cadeia. Use-o para documentos com páginas feitas à mão uma a uma.
  • --layout flow grava as matérias na ordem de leitura com os estilos de parágrafo do documento, e o Postext as compõe nas páginas que o projeto gráfico do livro faz. Use-o para texto corrido, como um romance ou um ensaio, em que as páginas só contêm o texto. As páginas cujos quadros só se leem juntos são compostas inteiras (desde o postext 1.83.1). Uma página sem texto corrido próprio, como uma capa ou uma folha de rosto de parte, vira no fluxo uma página composta, com os quadros onde o InDesign os tem e as formas e imagens como decoração. Uma página cujo texto corrido começa sob um título com uma faixa, uma imagem ou um quadro preenchido é uma abertura: o título vira um título que abre a página, e o design do seu estilo de título desenha a faixa, o chapéu e a aba na margem externa, se houver. O relatório as lista como composedPagesInFlow e openerDesigns.
  • auto, o padrão, escolhe um dos dois a partir do documento e diz o motivo.

#O que passa

  • Os estilos de parágrafo e de caractere viram os estilos de parágrafo e de título do livro, com fonte, corpo, entrelinha, recuos, espaçamento, alinhamento, paradas de tabulação e cor.
  • O texto com a sua ênfase, as quebras de linha forçadas, as tabulações, as notas de rodapé, os hiperlinks, o ruby, os sinais de ênfase e o tate-chu-yoko.
  • As tabelas com as células mescladas, as linhas de cabeçalho, as margens internas e as imagens nas células; as imagens, ancoradas e posicionadas; os fios, os retângulos e as amostras de cor.
  • As páginas, o tamanho e as margens delas, os itens das páginas-mestre e as seções.
  • O contorno de texto. O texto contorna um quadro que o afasta. Atrás de um objeto com contorno Saltar objeto, o quadro de texto é cortado em quadros encadeados acima e abaixo do objeto, com os deslocamentos superior e inferior do contorno, e assim o texto para acima dele e continua abaixo, como no InDesign; Saltar para a próxima coluna o para acima do objeto (desde o postext 1.82.2).
  • As amostras de cor especial, como cores especiais da paleta, cada uma na sua própria chapa. Uma cor especial com acabamento vira uma entrada de print.inks: o acabamento que uma exportação do Postext anotou volta como foi escrito, e qualquer outro é deduzido do nome da tinta (PANTONE 871 C, metálica; Verniz, um verniz) e aparece em inkFinishGuessed para você confirmar com a gráfica (desde o postext 1.87.0).
  • A linha de faca. Os traçados de uma camada com nome de linha de faca (Faca, Die line, Troquel…), ou cujo traço usa uma amostra CutContour, Die ou Dieline, nas páginas ou nas páginas-mestre delas, viram os dieCuts do livro: cada furo, uma forma posta no primeiro recto que corta, com leaves quando atravessa também as folhas seguintes, e uma borda recortada, como cantos arredondados (corners) ou um contorno (outline). O nome da amostra vira print.dieLine.ink. Os traçados da faca não são copiados como ilustração (desde o postext 1.87.0).

#O que o relatório informa

O .idml não leva as fontes nem as imagens vinculadas. O importador lista as famílias de fontes de que o livro precisa, que você depois passa para a geração com --font-dir. Ele lê as imagens vinculadas de --links ou da pasta do arquivo, e lista as que não encontra. Um pacote compactado traz as duas coisas: na linha de comando (postext import-idml package.zip), no Sandbox e em código com openIdmlArchive, o importador tira as imagens da pasta Links dele e coloca no livro os arquivos de fonte da pasta Document fonts.

O InDesign faz coisas que não têm equivalente no Postext, como texto em um traçado, uma célula girada, uma linha diagonal em uma célula, estilos GREP e aninhados ou efeitos de transparência. Cada uma delas vira um achado do relatório, com uma contagem e um exemplo: uma perda quando fica de fora, um aviso quando é composta de forma parecida com o original (as linhas de rodapé de uma tabela, um degradê, um contorno de texto). O relatório termina com um veredito:

  • faithful: nada foi perdido nem aproximado. Um livro exportado do Postext volta fiel. Desde o postext 1.85.0 a exportação encadeia o texto corrido das páginas compostas em colunas numa só matéria, um quadro por coluna, e o importador o lê de volta como o livro de fluxo que era: os parágrafos inteiros, os títulos, as caixas e as figuras com suas legendas onde estavam. Suas guias de coluna são as colunas da página, coluna lateral incluída. Desde o postext 1.86.0 seus cabeçalhos e números de página voltam como o cabeçalho e o rodapé do livro, inclusive os das aberturas de capítulo, e as caixas flutuadas numa coluna lateral (glosas) voltam como flutuantes dessa coluna. As formas que o Postext desenha em cada página ficam de fora e são relatadas como perda (pageArtInFlow), então um livro que as tem volta lossy como livro de fluxo; seu design pode desenhá-las de novo. Exportado com --text frames (um quadro por bloco, como antes da 1.85.0), volta como páginas compostas, cada página com seus quadros onde a exportação os pôs, e os estilos de parágrafo, os estilos de caractere, as caixas e as imagens do livro (desde o postext 1.84.0).
  • approximate: algumas coisas foram compostas de forma parecida com o original, e nada ficou de fora.
  • lossy: alguma coisa ficou de fora.

#Quanto a cópia se parece

O IDML guarda o texto e os quadros, não as linhas em que o InDesign os quebrou. O Postext quebra as linhas de novo com o seu próprio compositor, então uma linha de um documento feito no InDesign raramente termina na mesma palavra. O que deve coincidir é qual texto cai em qual página. O importador é testado com um corpus de documentos feitos no InDesign: um livro de 15 páginas, páginas de revista, tabelas, links e notas, japonês e árabe, objetos ancorados e estilos. Nos seis que foram medidos, de 87 a 100 por cento das palavras caem na mesma página que no PDF do próprio InDesign (desde o postext 1.78).

Um livro que o Postext exportou mantém as suas linhas. Cada linha da exportação termina com uma quebra forçada, e o importador ativa bodyText.justifyHardBreaks para que essas linhas continuem justificadas.

#A skill

A skill para agentes porta um livro nos passos que aquela página descreve: um briefing, um inventário do original, uma folha de dados medidos, a configuração, os capítulos e a verificação de cada página contra o original. Para um livro do InDesign, dê a ela tudo o que o InDesign tem.

#A pasta do original

No InDesign, Arquivo › Empacotar reúne as fontes e as imagens vinculadas do documento em uma pasta; marque Include IDML e Include PDF (Print). Ponha essa pasta no projeto como source/:

my-book/
  source/
    Book.indd
    Book.idml
    Book.pdf
    Document fonts/
    Links/
      cover.ai
      map-01.ai
      photo-12.psd
  • O .idml dá o texto, os estilos, as tabelas e as imagens ancoradas na ordem das matérias. A skill o lê com o seu próprio idml_extract.py, que atribui uma função a cada estilo de parágrafo.
  • O PDF de impressão dá o que falta ao .idml: onde cada linha, cada boxe e cada figura caiu na página impressa. A skill mede nele a grade, as margens e as aberturas, e no fim compara as próprias páginas com ele.
  • As fontes permitem ao Postext compor o texto nas letras do original, para que as medidas se mantenham. Verifique se a licença delas permite isso; a skill pergunta quando não consegue saber.
  • As ilustrações de Links/ viram as figuras do livro: os arquivos do Illustrator como SVG vetorial, e os do Photoshop e TIFF como bitmaps.

Depois peça ao agente, por exemplo: “Porte para o Postext o livro do InDesign que está em source/: primeiro os capítulos 1 a 3, em espanhol, para impressão e EPUB.”

#Como a skill usa o importador

A skill pode rodar postext import-idml source/Book.idml --report --json no início. O relatório dá um inventário em segundos: os estilos em uso, as matérias, as fontes, as imagens, as tabelas e o que não tem equivalente. A skill parte dele, e não entrega a importação como está. Ela substitui os quadros em lugares fixos por regras e modelos, os parágrafos vazios e os ajustes locais por espaçamentos e estilos, e as posições de cada página por flutuantes.

#O exportador

postext idml book/ -o book.idml
postext idml book.postext -o book.idml --images link --fonts
postext build book/ --pdf book.pdf --idml book.idml

O exportador diagrama o livro como o PDF faz e grava as páginas como um .idml para um designer finalizar no InDesign. Ele roda pela linha de comando (postext idml, ou --idml em build), pelo Sandbox (Exportar para o InDesign (IDML) no cabeçalho do painel Texto; veja Sandbox › Livros e salvamento) e em código com idmlDocument, de postext-idml.

  • Páginas e lâminas. As páginas ficam no formato refilado, em lâminas de páginas espelhadas em um livro com margens espelhadas e uma página por lâmina nos outros casos; --spreads facing ou --spreads single as monta assim, digam as margens o que disserem.
  • Linhas. --lines keep, o padrão, termina cada linha onde o Postext a terminou, então o InDesign mostra as mesmas linhas do PDF. --lines reflow deixa os parágrafos para o compositor do InDesign, no caso de um livro que vai ser composto de novo lá.
  • Texto. O texto corrido das páginas compostas em colunas corre numa só matéria, encadeada por um quadro de texto por coluna, como num livro diagramado no InDesign, e as caixas do fluxo ficam ancoradas nela (desde o postext 1.85.0); --text frames escreve em vez disso um quadro e uma matéria por bloco, onde o Postext o pintou. Cada bloco de uma página composta vira um quadro de texto com a sua própria matéria, e os blocos encadeados com next compartilham uma. Os estilos de parágrafo levam os nomes dos estilos do livro, os recuos, as paradas de tabulação e o espaçamento. Passam as notas de rodapé, os links, o ruby, os sinais de ênfase e as matérias da direita para a esquerda e verticais.
  • Cabeçalhos. Com o texto encadeado, os cabeçalhos e os números de página ficam em páginas-mestre, como num livro composto no InDesign (desde o postext 1.86.0). O número de página é o número de página atual do InDesign, {chapterTitle} é uma variável de texto de cabeçalho que mostra o último título de capítulo da página, e as outras palavras são escritas como estão. As páginas que mostram os mesmos cabeçalhos aplicam a mesma página-mestre, e as aberturas de capítulo têm uma própria, chamada Opener. Um cabeçalho que o InDesign não consegue expressar, como {attr.lugar}, fica na sua página. As caixas flutuadas numa coluna lateral (glosas) são ancoradas no texto corrido numa posição personalizada, de modo que acompanham o parágrafo ao lado do qual estão.
  • Itens de página. Fios, boxes, traçados e imagens viram itens de página do InDesign; as tabelas viram tabelas do InDesign, e as fórmulas em linha, a música e as amostras viram objetos ancorados. As cores CMYK definidas pelo autor viram amostras de cor de escala, e os chips com campo de formulário viram campos de formulário do InDesign.
  • Tintas especiais e linha de faca. Cada cor especial vira uma amostra de cor especial com tinta própria, e o acabamento fica no rótulo de script da amostra (postext:finish), porque o InDesign não tem um campo para ele. O Gerenciador de tintas recebe o tipo de tinta com que o acabamento se separa: Transparente para um verniz, Opaca para um branco, uma tinta metálica ou um hot stamping. O branco e o verniz sobreimprimem, como no PDF. As facas especiais são desenhadas numa camada bloqueada chamada Die line, como traçados cujo traço usa a amostra da faca, em sobreimpressão; a camada não imprime quando print.dieLine.output é none. Importado de novo, o pacote devolve as mesmas tintas e as mesmas facas especiais (desde o postext 1.87.0).
  • Imagens e fontes. --images link grava as imagens em Links/, ao lado do pacote, em vez de incorporá-las. Cada arquivo leva a extensão do seu formato (.svg, .png, .jpg, .pdf…), então abre no seu programa depois de descompactado. --fonts grava os arquivos de fonte em Document fonts/, onde o InDesign os encontra, e deixa de fora qualquer família que o livro não possa redistribuir.
  • Avisos. O que o InDesign não consegue mostrar como o Postext compôs é avisado como idml.*, como a moldura arredondada de uma tabela ou os pontos de ênfase do texto vertical.

Exportar não é portar ao contrário. O .idml contém as páginas que o Postext diagramou, e as regras que as diagramaram ficam no livro do Postext. Uma alteração feita no InDesign volta ao Postext pelo importador, como cópia da página. As regras que você quiser mudar, como o corpo de letra, é melhor mudar no livro do Postext e exportar de novo.

#Em resumo, qual escolher

  • Para manter, editar ou traduzir um livro feito no InDesign, porte-o com a skill a partir de uma pasta empacotada.
  • Para ver o que um .idml contém, ou para trazer de volta um livro que o Postext exportou, use o importador.
  • Para manter como está uma página fixa avulsa, importe-a com --layout pages.
  • Para mandar um livro do Postext para um estúdio que trabalha com InDesign, exporte-o com postext idml.