Converter OPF para EPUB

Um fluxo de publicação, arquivo ou aplicativo de leitura pode fornecer um pacote OPF enquanto o leitor de destino ou serviço de distribuição exige um único arquivo .epub. A conversão empacota o OPF, XHTML, folhas de estilo, imagens, fontes e recursos de navegação no contêiner EPUB.

O que é o formato OPF

OPF, normalmente identificado pela extensão .opf, é um documento de pacote XML usado por sistemas de produção EPUB. Ele define os metadados, o manifesto de recursos e a ordem de leitura por meio de elementos como <metadata>, <manifest> e <spine>.

Um arquivo OPF geralmente não é um ebook completo. Ele faz referência a capítulos XHTML ou HTML, CSS, imagens, fontes, arquivos de capa e documentos de navegação em caminhos relativos. Esses arquivos devem permanecer nos locais declarados pelo manifesto. Arquivos OPF são usados por editoras, aplicativos de criação de ebooks, projetos do Calibre, bibliotecas digitais e pacotes EPUB extraídos; normalmente não são abertos diretamente em softwares de leitura.

O que é o formato EPUB

EPUB é um contêiner de ebook baseado em ZIP que empacota o documento OPF com os recursos aos quais ele faz referência. Um EPUB deve incluir um arquivo mimetype no nível raiz contendo application/epub+zip, um arquivo META-INF/container.xml que identifica o documento de pacote e os arquivos de conteúdo nomeados por esse pacote.

O EPUB 2 geralmente usa um pacote OPF e um índice de sumário NCX. O EPUB 3 usa o pacote OPF com um documento de navegação XHTML e pode oferecer suporte a recursos como HTML semântico, MathML, sobreposições de mídia, áudio, vídeo, scripting e layouts fixos, conforme o suporte do leitor.

O layout refluível do EPUB adapta o texto a diferentes tamanhos de tela, enquanto um único arquivo pode conter metadados, navegação, folhas de estilo, imagens e fontes. Apple Books, Kobo, Thorium Reader, Adobe Digital Editions, muitos aplicativos de leitura para Android e serviços de distribuição de ebooks oferecem suporte a EPUB, embora o suporte a recursos individuais varie.

Converter um projeto OPF completo com Calibre

1. Coloque o arquivo OPF e todos os arquivos XHTML ou HTML referenciados, folhas de estilo, imagens, fontes, capa e documentos de navegação na estrutura de diretórios especificada pelo manifesto. Preserve os caminhos relativos e a capitalização dos nomes de arquivo.
2. Instale a versão atual para desktop do Calibre a partir de calibre-ebook.com.
3. Execute o conversor de linha de comando a partir do diretório do projeto:
   ebook-convert book.opf book.epub
4. Como alternativa, tente o fluxo de trabalho gráfico: use Calibre → Add books, selecione a origem, escolha Convert books, selecione EPUB como formato de saída e inicie a conversão. Se o importador gráfico não aceitar o OPF, use ebook-convert.
5. Abra a saída no aplicativo de leitura pretendido e verifique a ordem dos capítulos, o índice de sumário, as imagens, os links, as fontes, a capa e os metadados.

O Calibre pode resolver o manifesto OPF, reconstruir o contêiner EPUB, normalizar metadados e reescrever HTML ou CSS incompatível. Ele pode alterar a marcação e a estilização de origem; portanto, mantenha o projeto original quando a renderização exata ou a preservação da origem forem importantes. Adobe Digital Editions é um leitor, não um conversor geral de OPF para EPUB.

Reconstruir um EPUB que foi extraído

Se o OPF veio de um EPUB extraído e todos os arquivos do pacote ainda estiverem presentes, a conversão pelo Calibre será desnecessária. Recrie o ZIP do EPUB com a estrutura de diretórios original. A raiz do pacote deve conter mimetype, META-INF/container.xml, o documento de pacote nomeado por container.xml e todos os recursos do manifesto.

A partir da raiz do pacote, crie o arquivo com a entrada mimetype primeiro e sem compressão:

zip -X0 ../book.epub mimetype
zip -rX9 ../book.epub META-INF OEBPS

Substitua OEBPS pelo diretório de conteúdo real e inclua todos os diretórios referenciados por container.xml e pelo manifesto OPF. O arquivo mimetype deve conter exatamente application/epub+zip, sem espaços em branco adicionais, e deve ser a primeira entrada do ZIP. Use uma ferramenta de empacotamento compatível com EPUB se o utilitário de arquivamento do sistema operacional não puder preservar esses requisitos.

Validar o EPUB

Execute o utilitário oficial EPUBCheck no resultado:

epubcheck book.epub

O EPUBCheck detecta metadados de pacote malformados, referências quebradas no manifesto ou no spine, navegação inválida, declarações MIME incorretas e erros na estrutura do contêiner. Ele não pode restaurar arquivos ausentes nem corrigir HTML, CSS, tipografia ou layout visual inadequados.

Conversores online e limites de compatibilidade

A maioria dos conversores de ebooks online aceita um único documento, não um projeto OPF com sua árvore de diretórios referenciada. Enviar apenas o arquivo .opf pode produzir um EPUB incompleto ou omitir recursos sem tornar a falha evidente. Para manuscritos não publicados ou conteúdo licenciado, o processamento local pelo Calibre evita enviar a origem a terceiros.

Serviços reconhecidos, como CloudConvert e Zamzar, só devem ser considerados quando a lista de formatos atual aceita explicitamente o OPF fornecido ou um arquivo de pacote completo e explica como os recursos externos são resolvidos. Eles são mais adequados para um ebook empacotado ou uma conversão simples de arquivo único do que para um projeto OPF com vários arquivos. Valide qualquer resultado online com o EPUBCheck e teste-o no leitor de destino.

• Um OPF não pode fornecer capítulos, imagens, CSS, fontes ou arquivos de navegação ausentes das referências do manifesto.
• Os caminhos dentro dos pacotes EPUB são efetivamente sensíveis a maiúsculas e minúsculas. Uma referência a Images/Cover.jpg não resolve de forma confiável images/cover.jpg.
• O Calibre pode alterar CSS, HTML, metadados, navegação e o tratamento de imagens durante a conversão; compare a saída com a origem.
• Fontes incorporadas exigem tipos MIME válidos e licenciamento adequado das fontes. Alguns leitores as ignoram ou restringem seu uso.
• JavaScript, layouts fixos, MathML, sobreposições de mídia, áudio, vídeo e outros recursos do EPUB 3 têm suporte desigual. Teste no aplicativo, dispositivo ou validador de distribuição real.