Como traduzir um arquivo de quadrinhos CBZ ou CBR sem bagunçar a ordem das páginas

Um arquivo CBZ é um arquivo ZIP de imagens de páginas, e um arquivo CBR é a mesma ideia, mas empacotada com RAR. Nada dentro do arquivo diz "esta é a página 2". Leitores de quadrinhos, e ferramentas de tradução, determinam a ordem das páginas classificando os nomes dos arquivos. Portanto, a maioria dos problemas com um quadrinho traduzido começa antes da tradução. Uma capa vai parar no final, a página 10 aparece depois da página 1, ou um mangá da direita para a esquerda abre da esquerda para a direita.

Faça três verificações antes de enviar. Certifique-se de que os nomes das páginas estejam classificados na ordem correta, remova tudo o que não for uma página e mantenha o arquivo ComicInfo.xml se o arquivo o tiver. Depois, envie o arquivo como CBZ. Criamos um verificador de arquivo de quadrinhos gratuito que executa as três verificações em um segundo e pode reempacotar o arquivo com nomes de página seguros.

Resposta rápida: o que fazer com seu arquivo

As seções abaixo explicam cada linha.

Por que a ordem das páginas quebra: os leitores classificam os nomes dos arquivos

Existem duas maneiras comuns de classificar nomes de arquivos, e elas divergem assim que os números das páginas têm comprimentos diferentes:

• Uma classificação caractere por caractere compara os nomes um caractere de cada vez. 10.jpg começa com 1, então vem antes de 2.jpg. Você obtém a ordem 1, 10, 11, 12, 2, 3 …
• Uma classificação natural lê uma sequência de dígitos como um número, então 2 vem antes de 10. Você obtém 1, 2, 3 … 10, 11, 12.

Muitos leitores de quadrinhos ordenam naturalmente, mas você não pode contar com isso, e não pode controlar em qual leitor o arquivo traduzido será aberto. A solução que funciona em todos os lugares é preencher os números com zeros: 001.jpg … 010.jpg são ordenados da mesma forma com qualquer um dos métodos.

Dois outros problemas de nomenclatura são fáceis de passar despercebidos:

• Uma capa sem numeração é ordenada por último. Ambos os métodos de ordenação colocam dígitos antes de letras. Em um arquivo com cover.jpg e 001.jpg … 024.jpg, a capa se torna a página final.
• Pastas de capítulos são ordenadas como parte do nome. Chapter 10/01.jpg e Chapter 2/01.jpg comparam os nomes das pastas primeiro, então os números das pastas precisam do mesmo cuidado que os números das páginas.

O BookTranslator ordena as páginas de .cbz com uma ordenação natural e insensível a maiúsculas e minúsculas, e ignora entradas inúteis como pastas __MACOSX, arquivos ocultos como .DS_Store e Thumbs.db. Isso significa que a página 2 vem antes da página 10 durante a tradução do arquivo. No entanto, as páginas traduzidas mantêm seus nomes originais. Se você enviar 1.jpg … 12.jpg, receberá de volta 1.png … 12.png, e um leitor que usa ordenação simples ainda vai misturá-las. Renomear antes de enviar corrige a ordem para todos os leitores.

Passo 1: Verifique o Arquivo

Baixe check_comic_archive.py e execute-o no seu quadrinho. Ele precisa do Python 3.8 ou mais recente e nada mais, e não envia nada:

python3 check_comic_archive.py "My Comic.cbz"

Para mostrar o que ele encontra, criamos um pequeno arquivo de exemplo com problemas que costumamos ver em arquivos de quadrinhos. Ele tem doze páginas numeradas sem preenchimento com zeros, uma cover.png sem numeração, uma página dupla, um arquivo AVIF, entradas inúteis do macOS e um ComicInfo.xml marcado como mangá da direita para a esquerda. O README explica como recriá-lo com make_test_comic.py. Aqui está o final do relatório:

Junk entries (skipped): .DS_Store, __MACOSX/._1.png
Other files (carried over unchanged): ComicInfo.xml
ComicInfo.xml:
  Manga (reading direction): YesAndRightToLeft
  Right-to-left is stored here, not in the images. Keep this file in the archive so readers that honor it still see it.
  LanguageISO: ja. Update it after translation; a copied ComicInfo.xml still names the source language.
  Page table: 13 entries for 13 page images.
  13 entries record ImageSize/ImageWidth. These describe the original files and no longer match once pages are replaced.

Check before uploading:
  - A plain character sort puts '10.png' at position 2, where natural sort has '2.png'. A reader without natural sorting will show pages out of order.
  - Pages without a number in the file name: 'cover.png' at 13. Digits sort before letters, so an unnumbered cover usually ends up last.
  - Page numbers use [1, 2] digits. Zero-pad them (001, 002, ... 010) so every reader agrees on the order.
  - Images in a format that is not treated as a page here: 13.avif. Convert them to PNG, JPEG or WebP, or they stay untranslated.

Acima disso, o relatório lista cada página na ordem de leitura com seu tamanho. Ele sinaliza uma página mais larga do que alta como uma página dupla, e uma página mais de três vezes mais alta do que larga como uma tira vertical, como um capítulo de webtoon. Essas são as páginas para olhar primeiro quando a tradução voltar.

Para nomes de arquivo em ASCII simples, a ordenação natural do verificador segue a mesma comparação que o BookTranslator usa para páginas .cbz, incluindo pastas de capítulos, maiúsculas e minúsculas misturadas, espaços, hífens e sublinhados. Nomes com letras acentuadas ou kana japonês podem ser ordenados de forma diferente entre ferramentas, o que é mais um motivo para renomear as páginas para números simples preenchidos com zeros.

Passo 2: Reempacote com Nomes de Página Seguros

Se o relatório listar problemas de ordenação, veja primeiro a ordem impressa e depois reempacote:

python3 check_comic_archive.py "My Comic.cbz" --first cover.png --repack "My Comic fixed.cbz"

--repack grava um novo CBZ. As páginas são renomeadas para 0001, 0002 … na ordem mostrada, as entradas inúteis são descartadas e todos os outros arquivos, incluindo ComicInfo.xml, são copiados sem alteração. --first move uma página para a frente, que é como você coloca uma capa sem numeração de volta no lugar certo. Você pode repetir para uma segunda página, como uma página de título. A renomeação fixa a ordem, então corrija antes de reempacotar, não depois. Se o arquivo tiver uma tabela de páginas em ComicInfo.xml, mover páginas desloca suas posições; o verificador lembra você de conferir entradas como o marcador de capa frontal depois.

No arquivo de exemplo, o arquivo reempacotado tem as páginas 0001.png … 0013.png com a capa primeiro e sem entradas inúteis. O único aviso restante é o arquivo AVIF. O verificador não consegue converter imagens; abra essa página em um editor de imagens e exporte como PNG, JPEG ou WebP. Formatos como AVIF, JPEG XL e HEIC não são tratados como páginas. Eles são copiados para o resultado como estão, sem tradução.

Passo 3: Transforme um Arquivo CBR, CB7 ou CBT em CBZ

Um arquivo .cbr é um arquivo RAR, um .cb7 é 7z e um .cbt é tar. Renomear um .cbr para .cbz não o converte. O verificador lê os primeiros bytes do arquivo. Para um arquivo RAR, 7z ou tar, ele para e informa qual você tem. Se ele imprimir um relatório normal de páginas, o arquivo já é um arquivo ZIP com outro nome: renomeie para .cbz e volte ao Passo 1.

Para converter um arquivo RAR, 7z ou tar de verdade, extraia-o em uma pasta com o 7-Zip ou o The Unarchiver. Depois aponte o verificador para essa pasta:

7z x "My Comic.cbr" -o"My Comic"
python3 check_comic_archive.py "My Comic" --repack "My Comic.cbz"

O reempacotamento coloca as páginas e o ComicInfo.xml no nível superior do novo arquivo, mesmo que os arquivos extraídos estivessem em uma subpasta.

O BookTranslator também aceita uploads de CBR, CB7 e CBT, mas eles passam por um pipeline diferente com preço fixo, e o processo página a página descrito na próxima seção se aplica a arquivos .cbz. Converter primeiro leva alguns segundos e também fornece os nomes de página limpos do Passo 2.

Passo 4: Mantenha o ComicInfo.xml e Depois Atualize-o

Muitos arquivos incluem um arquivo ComicInfo.xml com o título, série, idioma e direção de leitura. Seu formato é mantido pelo Anansi Project. Dois de seus campos importam aqui:

• Manga. O esquema permite Unknown, No, Yes e YesAndRightToLeft. O último é como um arquivo informa ao leitor para virar as páginas da direita para a esquerda. As imagens das páginas não podem carregar essa configuração, então, se o arquivo for perdido, os leitores que o usam também perdem a direção de leitura.
• LanguageISO. Este contém o código de idioma do quadrinho. Após a tradução, ele ainda indica o idioma de origem, por exemplo ja, até você alterá-lo.

O BookTranslator copia o ComicInfo.xml para o arquivo traduzido sem alteração, então mangás da direita para a esquerda permanecem da direita para a esquerda em leitores que suportam a flag. Abra o arquivo em um editor de texto depois e altere LanguageISO para o idioma de destino. Se o arquivo tiver uma tabela <Pages>, suas entradas apontam para páginas por posição, então elas ainda correspondem desde que você não tenha reordenado as páginas. Valores de tamanho como ImageSize descrevem as imagens originais e não corresponderão mais às páginas PNG traduzidas. Uma ferramenta de biblioteca que depende deles pode precisar reescanear o arquivo.

O que o BookTranslator faz com um CBZ

Quando você envia um quadrinho .cbz, o BookTranslator:

1. lista as imagens das páginas (PNG, JPEG, WebP, GIF, BMP ou TIFF) na ordem natural e ignora entradas inválidas;
2. processa cada página pelo mesmo pipeline usado para imagens avulsas. Ele localiza o texto, remove a letra original e desenha a tradução no lugar, trabalhando com algumas páginas por vez;
3. monta um novo .cbz com cada página traduzida salva como PNG na mesma posição, além de todos os outros arquivos do arquivo original.

Alguns detalhes vale a pena saber antes de pagar:

• O preço depende da contagem de páginas. Cada página é uma execução completa de tradução de imagem, então um CBZ é cobrado por página, não por palavra. O orçamento aparece após o envio, antes do checkout. Remover entradas inválidas e imagens avulsas que não são páginas não altera o valor, porque elas não são contadas como páginas.
• Uma página com falha mantém a imagem original. Se uma página falhar, ela permanece no idioma de origem e na posição correta, então o quadrinho continua completo. Se mais de 30% das páginas falharem, a tarefa falha em vez de entregar um livro majoritariamente não traduzido.
• Você recebe apenas o quadrinho traduzido. Arquivos de quadrinhos não têm versão bilíngue lado a lado.
• As páginas voltam como PNG. O arquivo traduzido pode ficar consideravelmente maior que um original em JPEG.

Se você também precisa do texto em japonês em si, por exemplo de volumes de mangá digitalizados com colunas verticais e furigana, nosso guia de OCR de texto vertical japonês aborda esses problemas de ordem de leitura para páginas de texto.

Antes de enviar: acesso ao arquivo

Este guia pressupõe que o quadrinho é um arquivo que você possui e pode abrir livremente, como uma compra sem DRM, suas próprias digitalizações ou seu próprio trabalho. Lojas de aplicativos costumam entregar quadrinhos em formatos protegidos que só abrem no leitor delas. Renomear ou reempacotar esses arquivos não muda isso. Se não tiver certeza, leia primeiro como verificar se um ebook tem DRM antes da tradução. Baixar um arquivo também não lhe dá permissão para compartilhar ou publicar uma tradução dele.

Traduza o quadrinho

Quando o verificador não reportar problemas de ordenação e todas as páginas forem PNG, JPEG ou WebP, envie o CBZ para o tradutor de mangá e confira o preço por contagem de páginas antes de pagar. Quando a tradução estiver pronta, abra-a no leitor que você pretende usar. Confira a capa, a primeira página dupla e a última página, depois corrija LanguageISO em ComicInfo.xml. Para projetos mais longos, como uma série que você pretende publicar, nosso guia completo de tradução de livros aborda revisão, terminologia e consistência entre volumes.