E-Paper para TYPO3

A maioria das soluções de e-paper no TYPO3 são sucessoras do Flash, e é exatamente assim que elas parecem

Extensões de e-paper para TYPO3 vêm conceitualmente da era Flash: um PDF é carregado, uma biblioteca JavaScript simula o folhear de páginas com animação 3D. À primeira vista parece impressionante. À segunda vista: não indexável (Google não consegue ler o conteúdo), não responsivo (uma catástrofe no smartphone), não acessível e com tempos de carregamento acima de 5 segundos. Existem formas melhores de exibir revistas e catálogos no TYPO3.

A questão central não é “Qual plugin de e-paper?”, mas “Realmente precisamos de um e-paper?”. Na maioria dos casos, a resposta é: Não. O conteúdo pertence como HTML ao site, não como PDF em um catálogo folheável.

Cenários típicos de uso

Revistas corporativas e periódicos para clientes. Departamentos de marketing produzem revistas trimestrais em impressão e querem oferecer a versão digital no site. Abordagem clássica: carregar PDF, incorporar widget de catálogo folheável. Melhor abordagem: publicar os artigos como páginas TYPO3 individuais (via tx_news), com uma página de visão geral do magazine como hub. Cada artigo é indexável, linkável e compartilhável individualmente. O PDF permanece como opção de download para leitores offline.

Catálogos de produtos para parceiros comerciais. Atacadistas e empresas B2B oferecem catálogos de produtos a seus distribuidores. Os dados do catálogo frequentemente existem como exportação InDesign (PDF). Um widget de e-paper torna o catálogo folheável, mas não pesquisável. O melhor caminho: manter os dados de produto estruturados no TYPO3 e apresentar o catálogo como página HTML filtrável e pesquisável. O PDF serve como versão de impressão para download.

Relatórios anuais e relatórios de sustentabilidade. Empresas de capital aberto publicam relatórios anuais que devem corresponder visualmente ao layout de impressão. Aqui um viewer baseado em PDF é justificável, porque o layout é vinculante e páginas individuais exigem quebras de página exatas. Mas mesmo aqui: os dados centrais (indicadores financeiros, declarações da diretoria) devem estar disponíveis adicionalmente como HTML.

Arquitetura técnica

Soluções de e-paper no TYPO3 podem ser divididas em três categorias:

Catálogos folheáveis baseados em PDF. Um PDF é carregado, uma biblioteca JavaScript (Turn.js, FlipBook.js, pdf.js) renderiza as páginas no navegador. A biblioteca divide o PDF em páginas individuais e as exibe como elementos Canvas. Vantagens: configuração rápida, layout corresponde 1:1 ao impresso. Desvantagens: sem valor SEO (conteúdo oculto no PDF), performance ruim com PDFs grandes (50+ páginas), sem responsividade.

Layouts de revista baseados em HTML. Os artigos são mantidos como elementos de conteúdo TYPO3 normais e exibidos via template de revista. O layout simula estética de revista (imagens grandes, colunas de texto, pull-quotes) via CSS Grid e Tailwind. Vantagens: indexação SEO completa, responsivo, performante, acessível. Desvantagens: maior esforço inicial, layout diverge do impresso.

Abordagem híbrida. Os artigos existem como HTML, adicionalmente há download em PDF disponível. Na página de visão geral, o visitante vê teasers de artigos, na barra lateral o download PDF da revista completa. Essa abordagem combina valor SEO e fidelidade à impressão.

Para a representação PDF no TYPO3, pdf.js (Mozilla) é adequado, uma biblioteca open-source que renderiza PDFs nativamente no navegador. pdf.js é mais performante que catálogos folheáveis baseados em Turn.js, dispensa animações de folhear e oferece uma representação limpa e rolável com zoom e busca de texto.

Problemas frequentes e soluções

Tempo de carregamento do PDF acima de 5 segundos. Uma revista de 40 páginas como PDF pesa 20 a 40 MB. Sem otimização, o navegador carrega todo o PDF antes de exibir a primeira página. Solução: pdf.js suporta byte-range requests onde apenas a página solicitada é carregada. O servidor deve suportar Accept-Ranges: bytes. Adicionalmente, otimizar o PDF com Ghostscript ou qpdf para web (linearize) para que a primeira página seja exibida imediatamente.

Conteúdo não indexado pelo Google. Google crawla PDFs e indexa seu texto, mas não dentro de um viewer JavaScript. Quando o PDF é exibido apenas via elemento Canvas no navegador, o Google não vê conteúdo. Solução: colocar o conteúdo do PDF adicionalmente como texto oculto (aria-hidden, acessível para leitores de tela) na página HTML ou, melhor, exibir o conteúdo como elementos HTML nativos e oferecer o PDF apenas como download.

Bibliotecas de catálogo folheável desatualizadas. Muitas extensões de e-paper usam bibliotecas que não são atualizadas há anos. Turn.js (última atualização 2013), FlipBook jQuery (dependência jQuery) ou bibliotecas comerciais com licenças expirantes. Solução: migrar para pdf.js ou representação baseada em HTML. Ambos são à prova de futuro e independentes de licenças de terceiros.

Migração e compatibilidade de versões

Extensões de e-paper no TER são predominantemente desatualizadas. A maioria suporta no máximo TYPO3 v10 ou v11. Para v12 e v13 não há extensões de catálogo folheável mantidas.

O caminho recomendado para TYPO3 v12/v13: incorporar pdf.js como biblioteca standalone (sem extensão necessária) para representações baseadas em PDF. Para revistas baseadas em HTML: tx_news com template de revista e categoria própria “Edições”. O esforço para um layout de revista customizado baseado em tx_news é de 3 a 5 dias.

Quem migra de uma extensão de e-paper existente tem três opções: integração pdf.js (1 a 2 dias, mantém o modelo baseado em PDF), migração HTML (5 a 10 dias, transfere o conteúdo para artigos tx_news) ou um serviço externo (Issuu, Yumpu) com embed TYPO3. A Gosign recomenda a abordagem HTML para máximo valor SEO e orienta na decisão entre as variantes.