Produção de Livros

Matriz de versões: as ferramentas que usamos para produzir um livro

Versão de ferramenta muda, e artigo que escreve versão no corpo envelhece. Por isso toda versão do cluster mora nesta página, com data de conferência e status de teste.

JonathanJonathan
3 min de leitura540 palavras
Capa do artigo: Matriz de versões: as ferramentas que usamos para produzir um livro (eBuz, Produção de Livros)

Todo artigo deste cluster tem um combinado: nenhum escreve número de versão no corpo. As versões moram aqui. Quando uma ferramenta muda, a gente corrige uma linha desta página, e não dezenas de textos.

Esta é a única página do cluster com datas, de propósito. É um registro, e registro precisa de data.

Como ler a tabela

Em uso é a versão com que medimos tudo o que está nos artigos. Última conhecida é a mais recente que encontramos na fonte oficial na data da conferência. Status diz se a versão mais nova foi testada contra o nosso trabalho real ou não. "Não verificada" quer dizer que não procuramos, e não que não existe versão mais nova.

FerramentaEm usoÚltima conhecidaConferido emStatus
Typst (compilador)0.14.20.15.119/10/20260.15.1 testada: mesmo número de páginas e nenhum aviso, mas o layout mudou em 71 de 158 páginas de um boneco. Fixar a versão em uso
Pandoc3.1.3não verificada19/10/2026em uso
EPUBCheck5.1.0não verificada19/10/2026em uso
Ghostscript10.02.1não verificada19/10/2026em uso
poppler (pdftotext, pdfinfo e outros)24.02.0não verificada19/10/2026em uso
qpdf11.9.0não verificada19/10/2026em uso
pikepdf (Python)10.12.0não verificada19/10/2026em uso
potrace1.16não verificada19/10/2026em uso
ImageMagick6.9.12 na máquina de trabalho; 6.9.11 no contêiner do serviçonão verificada19/10/2026as duas funcionam para o que fazemos
Python, numpy, Pillow3.12.3, 2.4.6, 12.2.0não verificada19/10/2026em uso
Crimson Pro (fonte do corpo)arquivos estáticos em TTFnão verificada19/10/2026em uso. Evite a versão variável: o compilador avisa que não a suporta bem
Inter (fonte de títulos e rótulos)4.1, em OTFnão verificada19/10/2026em uso

O que não muda com a versão

Alguns números não dependem de ferramenta. Por isso não estão na tabela. São eles: o formato 6 x 9 polegadas (432 x 648 pontos), a sangria de 3 mm (449 x 665 pontos com sangria), o total de páginas em múltiplo de 4 e o texto do corpo em K puro. Esses valores vêm da gráfica e da geometria do papel. Os artigos do cluster explicam cada um, a partir do guia completo da produção do miolo.

Como conferir a sua versão

Cada comando abaixo imprime a versão instalada na sua máquina. Compare com a coluna "Em uso" antes de seguir qualquer passo a passo do cluster.

typst --version
pandoc --version
gs --version
pdftotext -v
qpdf --version
potrace --version
python3 -c "import pikepdf; print(pikepdf.__version__)"
python3 --version

Se a sua versão do compilador for outra, o número de páginas costuma ficar igual. O layout pode mudar. Compare o seu PDF com o de referência antes de imprimir. O artigo sobre o Typst no lugar do InDesign mostra como fazer essa comparação.

Regra de atualização

  1. Versão nova de ferramenta entra primeiro como "última conhecida".
  2. Só vira "em uso" depois de passar na conferência que o miolo de referência passa. Ela olha páginas, texto, layout e o checklist de preflight.
  3. A conferência de cada linha é revista a cada seis meses.
  4. Se uma versão mais nova mudar o resultado, o artigo não é reescrito: a linha da tabela ganha o aviso.

Baixe, para guardar: a matriz de versões em planilha (CSV).

Perguntas frequentes

Por que as versões ficam só nesta página?

Porque versão de ferramenta muda e artigo não deveria envelhecer por causa disso. Com a tabela em um lugar só, a atualização é uma linha, e todos os artigos do cluster continuam corretos sem serem reescritos.

Posso usar uma versão mais nova do compilador do que a da tabela?

Pode, mas confira o resultado. Em um teste nosso, uma versão mais nova manteve o número de páginas e não deu aviso, mas mudou o layout em 71 de 158 páginas de um boneco. Compare o PDF novo com um de referência antes de imprimir.

O que significa "não verificada" na coluna da última versão?

Significa que ainda não olhamos a fonte oficial dessa ferramenta na data da conferência. Não quer dizer que a versão em uso seja a mais recente.