Cómo traducir un archivo de cómic CBZ o CBR sin desordenar el orden de las páginas

Un archivo CBZ es un archivo ZIP de imágenes de páginas, y un archivo CBR es la misma idea empaquetada con RAR. Nada dentro del archivo indica "esta es la página 2". Los lectores de cómics, y las herramientas de traducción, determinan el orden de las páginas ordenando los nombres de los archivos. Por eso, la mayoría de los problemas con un cómic traducido empiezan antes de la traducción. Una portada termina al final, la página 10 aparece después de la página 1, o un manga de derecha a izquierda se abre de izquierda a derecha.

Realiza tres comprobaciones antes de subir el archivo. Asegúrate de que los nombres de las páginas se ordenen correctamente, elimina todo lo que no sea una página y conserva el archivo ComicInfo.xml si el archivo lo incluye. Luego sube el archivo como CBZ. Hemos creado un verificador de archivos de cómic gratuito que realiza las tres comprobaciones en un segundo y puede reempaquetar el archivo con nombres de página seguros.

Respuesta rápida: qué hacer con tu archivo

Las secciones siguientes explican cada fila.

Por qué se rompe el orden de las páginas: los lectores ordenan los nombres de archivo

Hay dos formas comunes de ordenar nombres de archivo, y no coinciden en cuanto los números de página tienen longitudes diferentes:

• Una ordenación de caracteres simple compara los nombres carácter por carácter. 10.jpg empieza por 1, así que va antes que 2.jpg. Obtienes el orden 1, 10, 11, 12, 2, 3 …
• Una ordenación natural lee una secuencia de dígitos como un número, así que 2 va antes que 10. Obtienes 1, 2, 3 … 10, 11, 12.

Muchos lectores de cómics ordenan de forma natural, pero no puedes contar con ello y tampoco puedes controlar en qué lector se abrirá el archivo traducido. La solución que funciona en todas partes es rellenar los números con ceros: 001.jpg … 010.jpg se ordenan igual con cualquiera de los dos métodos.

Hay otros dos problemas de nomenclatura que son fáciles de pasar por alto:

• Una portada sin numerar se ordena al final. Ambos métodos de ordenación colocan los dígitos antes que las letras. En un archivo con cover.jpg y 001.jpg … 024.jpg, la portada se convierte en la última página.
• Las carpetas de capítulos se ordenan como parte del nombre. Chapter 10/01.jpg y Chapter 2/01.jpg comparan primero los nombres de las carpetas, así que los números de las carpetas necesitan el mismo cuidado que los números de página.

BookTranslator ordena las páginas .cbz con una ordenación natural e insensible a mayúsculas y omite entradas basura como las carpetas __MACOSX, los archivos ocultos como .DS_Store y Thumbs.db. Esto significa que la página 2 va antes que la página 10 mientras se traduce el archivo. Sin embargo, las páginas traducidas conservan sus nombres originales. Si subes 1.jpg … 12.jpg, recibirás 1.png … 12.png, y un lector que use una ordenación simple seguirá mezclándolas. Renombrar antes de subir corrige el orden para todos los lectores.

Paso 1: Revisa el archivo

Descarga check_comic_archive.py y ejecútalo en tu cómic. Solo necesita Python 3.8 o superior y nada más, y no sube nada:

python3 check_comic_archive.py "My Comic.cbz"

Para mostrar lo que encuentra, creamos un pequeño archivo de muestra con problemas que vemos a menudo en los archivos de cómics. Tiene doce páginas numeradas sin ceros a la izquierda, una cover.png sin numerar, una página doble, un archivo AVIF, entradas basura de macOS y un ComicInfo.xml marcado como manga de derecha a izquierda. El README explica cómo reconstruirlo con make_test_comic.py. Aquí está el final del informe:

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.

Más arriba, el informe enumera cada página en orden de lectura con su tamaño. Señala como página doble una página que es más ancha que alta, y como tira vertical una página que es más de tres veces más alta que ancha, como un capítulo de webtoon. Esas son las páginas que debes revisar primero cuando vuelva la traducción.

Para nombres de archivo ASCII simples, la ordenación natural del verificador sigue la misma comparación que BookTranslator usa para las páginas .cbz, incluidas las carpetas de capítulos, mayúsculas y minúsculas mezcladas, espacios, guiones y guiones bajos. Los nombres con letras acentuadas o kana japonés pueden ordenarse de forma diferente entre herramientas, lo que es una razón más para renombrar las páginas a números simples con ceros a la izquierda.

Paso 2: Vuelve a empaquetar con nombres de página seguros

Si el informe enumera problemas de ordenación, mira primero el orden impreso y luego vuelve a empaquetar:

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

--repack escribe un nuevo CBZ. Las páginas se renombran 0001, 0002 … en el orden mostrado, se eliminan las entradas basura y todos los demás archivos, incluido ComicInfo.xml, se copian sin cambios. --first mueve una página al principio, que es cómo vuelves a poner una portada sin numerar donde corresponde. Puedes repetirlo para una segunda página, como una página de título. El cambio de nombre fija el orden, así que corrígelo antes de volver a empaquetar, no después. Si el archivo tiene una tabla de páginas en ComicInfo.xml, mover páginas cambia sus posiciones; el verificador te recuerda que revises entradas como el marcador de portada después.

En el archivo de muestra, el archivo reempaquetado tiene las páginas 0001.png … 0013.png con la portada primero y sin entradas basura. La única advertencia que queda es el archivo AVIF. El verificador no puede convertir imágenes; abre esa página en un editor de imágenes y expórtala como PNG, JPEG o WebP. Formatos como AVIF, JPEG XL y HEIC no se tratan como páginas. Se copian en el resultado tal como están, sin traducir.

Paso 3: Convierte un archivo CBR, CB7 o CBT en CBZ

Un archivo .cbr es un archivo RAR, un .cb7 es 7z y un .cbt es tar. Cambiar el nombre de un .cbr a .cbz no lo convierte. El verificador lee los primeros bytes del archivo. Para un archivo RAR, 7z o tar, se detiene y te dice cuál tienes. Si en cambio imprime un informe de páginas normal, el archivo ya es un archivo ZIP con otro nombre: cámbiale el nombre a .cbz y vuelve al Paso 1.

Para convertir un archivo RAR, 7z o tar real, extráelo en una carpeta con 7-Zip o The Unarchiver. Luego apunta el verificador a esa carpeta:

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

El reempaquetado coloca las páginas y ComicInfo.xml en el nivel superior del nuevo archivo, incluso si los archivos extraídos estaban en una subcarpeta.

BookTranslator también acepta cargas CBR, CB7 y CBT, pero pasan por un proceso diferente a un precio fijo, y el proceso página por página descrito en la siguiente sección se aplica a los archivos .cbz. Convertir primero es cuestión de unos segundos y además te da los nombres de página limpios del Paso 2.

Paso 4: Conserva ComicInfo.xml y luego actualízalo

Muchos archivos incluyen un archivo ComicInfo.xml con el título, la serie, el idioma y la dirección de lectura. Su formato lo mantiene el Proyecto Anansi. Dos de sus campos importan aquí:

• Manga. El esquema permite Unknown, No, Yes y YesAndRightToLeft. El último es cómo un archivo le dice a un lector que pase las páginas de derecha a izquierda. Las imágenes de las páginas no pueden llevar esa configuración, así que si se pierde el archivo, los lectores que lo usan también pierden la dirección de lectura.
• LanguageISO. Contiene el código de idioma del cómic. Después de la traducción, sigue indicando el idioma de origen, por ejemplo ja, hasta que lo cambies.

BookTranslator copia ComicInfo.xml en el archivo traducido sin cambios, así que el manga de derecha a izquierda sigue siendo de derecha a izquierda en los lectores que admiten la marca. Abre el archivo en un editor de texto después y cambia LanguageISO al idioma de destino. Si el archivo tiene una tabla <Pages>, sus entradas apuntan a las páginas por posición, así que siguen coincidiendo siempre que no hayas reordenado las páginas. Los valores de tamaño como ImageSize describen las imágenes originales y ya no coincidirán con las páginas PNG traducidas. Una herramienta de biblioteca que dependa de ellos puede necesitar volver a escanear el archivo.

Qué hace BookTranslator con un CBZ

Cuando subes un cómic .cbz, BookTranslator:

1. enumera las imágenes de las páginas (PNG, JPEG, WebP, GIF, BMP o TIFF) en orden natural y omite las entradas basura;
2. procesa cada página con el mismo flujo de trabajo que se usa para imágenes individuales. Detecta el texto, elimina el rotulado original y dibuja la traducción en su lugar, trabajando en unas pocas páginas a la vez;
3. genera un nuevo .cbz con cada página traducida guardada como PNG en la misma posición, además de todos los demás archivos del archivo original.

Hay algunos detalles que conviene conocer antes de pagar:

• El precio depende del número de páginas. Cada página es una ejecución completa de traducción de imágenes, por lo que un CBZ se cobra por página en lugar de por palabra. El presupuesto aparece después de subir el archivo, antes de pagar. Eliminar las entradas basura y las imágenes sueltas que no son páginas no cambia el precio, porque no se cuentan como páginas.
• Una página fallida conserva su imagen original. Si una página falla, se queda en el idioma de origen y en la posición correcta, así que el cómic sigue estando completo. Si falla más del 30% de las páginas, la tarea falla en lugar de entregar un libro mayormente sin traducir.
• Solo obtienes el cómic traducido. Los archivos de cómics no tienen una versión bilingüe en paralelo.
• Las páginas se devuelven como PNG. El archivo traducido puede ser notablemente más grande que un original en JPEG.

Si también necesitas el texto japonés en sí, por ejemplo de volúmenes de manga escaneados con columnas verticales y furigana, nuestra guía sobre OCR de texto vertical japonés cubre esos problemas de orden de lectura para páginas de texto.

Antes de subir: acceso al archivo

Esta guía supone que el cómic es un archivo que posees y puedes abrir libremente, como una compra sin DRM, tus propios escaneos o tu propio trabajo. Las tiendas de aplicaciones suelen entregar cómics en formatos protegidos que solo se abren dentro de su propio lector. Cambiar el nombre o reempaquetar esos archivos no cambia eso. Si no estás seguro, lee primero cómo comprobar si un ebook tiene DRM antes de traducirlo. Descargar un archivo tampoco te da permiso para compartir o publicar una traducción del mismo.

Traduce el cómic

Una vez que el verificador informe que no hay problemas de orden y que todas las páginas son PNG, JPEG o WebP, sube el CBZ al traductor de manga y comprueba el precio según el número de páginas antes de pagar. Cuando la traducción esté lista, ábrela en el lector que planeas usar. Revisa la portada, la primera doble página y la última página, luego corrige LanguageISO en ComicInfo.xml. Para proyectos más largos, como una serie que planeas publicar, nuestra guía completa para la traducción de libros cubre la revisión, la terminología y la consistencia entre volúmenes.