E-Paper for TYPO3

Die meisten E-Paper-Lösungen in TYPO3 include Flash-Nachfolger, und genau so fühlen sie sich an

E-Paper-Extensions für TYPO3 stammen konzeptionell aus der Flash-Ära: ein PDF wird hochgeladen, eine JavaScript-Library simuliert Seitenblättern mit 3D-Animation. Das sieht auf dem ersten Blick beeindruckend aus. Auf dem zweiten Blick: nicht indexierbar (Google kann den Content nicht lesen), nicht responsiv (auf dem Smartphone eine Katastrophe), nicht barrierefrei und mit Ladezeiten jenseits der 5 Sekunden. Es gibt bessere Wege, Magazine und Kataloge in TYPO3 darzustellen.

Die zentrale Frage ist nicht “Welches E-Paper-Plugin?”, sondern “Brauchen wir überhaupt ein E-Paper?”. In den meisten Fällen ist die Antwort: Nein. Der Content gehört als HTML auf die Website, nicht als PDF in einen Blätterkatalog.

Typical use cases

Unternehmensmagazine und Kundenzeitschriften. Marketingabteilungen produzieren quartalsweise Magazine im Print und wollen die digitale Version auf der Website anbieten. Klassischer Ansatz: PDF hochladen, Blätterkatalog-Widget einbetten. Besserer Ansatz: Die Artikel als einzelne TYPO3-Seiten (über tx_news) veröffentlichen, mit einer Magazin-Übersichtsseite als Hub. Jeder Artikel ist einzeln indexierbar, verlinkbar und teilbar. Das PDF bleibt als Download-Option für Offline-Leser.

Produktkataloge für Handelspartner. Großhandel und B2B-Unternehmen bieten ihren Händlern Produktkataloge an. Die Katalogdaten existieren oft als InDesign-Export (PDF). Ein E-Paper-Widget macht den Katalog durchblätterbar, aber nicht durchsuchbar. Der bessere Weg: Die Produktdaten strukturiert in TYPO3 pflegen und den Katalog als filtrierbare, durchsuchbare HTML-Seite darstellen. Das PDF dient als Print-Version zum Download.

Geschäftsberichte und Nachhaltigkeitsreports. Börsennotierte Unternehmen veröffentlichen Jahresberichte, die optisch dem Print-Layout entsprechen müssen. Hier ist ein PDF-basierter Viewer vertretbar, weil das Layout bindend ist und einzelne Seiten exakte Seitenumbrüche erfordern. Aber auch hier gilt: Die Kerndaten (Finanzkennzahlen, Management-Statements) sollten zusätzlich als HTML verfügbar sein.

Technical architecture

E-Paper-Lösungen in TYPO3 lassen sich in drei Kategorien einteilen:

PDF-basierte Blätterkataloge. Ein PDF wird hochgeladen, eine JavaScript-Library (Turn.js, FlipBook.js, pdf.js) rendert die Seiten im Browser. Die Library zerlegt das PDF in einzelne Seiten und zeigt sie als Canvas-Elemente an. Vorteile: Schnelle Einrichtung, Layout entspricht 1:1 dem Print. Nachteile: Kein SEO-Wert (Content ist im PDF versteckt), schlechte Performance bei großen PDFs (50+ Seiten), keine Responsiveness.

HTML-basierte Magazin-Layouts. Die Artikel werden als normale TYPO3-Inhaltselemente gepflegt und über ein Magazin-Template dargestellt. Das Layout simuliert Magazin-Ästhetik (großflächige Bilder, Textspalten, Pull-Quotes) über CSS Grid und Tailwind. Vorteile: Volle SEO-Indexierung, responsive, performant, barrierearm. Nachteile: Höherer initialer Aufwand, Layout weicht vom Print ab.

Hybrid-Ansatz. Die Artikel existieren als HTML, zusätzlich steht ein PDF-Download bereit. Auf der Übersichtsseite sieht der Besucher Artikel-Teaser, in der Seitenleiste den PDF-Download des gesamten Magazins. Dieser Ansatz vereint SEO-Wert und Print-Treue.

Für die PDF-Darstellung in TYPO3 eignet sich pdf.js (Mozilla), eine Open-Source-Library, die PDFs nativ im Browser rendert. pdf.js ist performanter als Turn.js-basierte Blätterkataloge, verzichtet auf Blätteranimationen und bietet stattdessen eine saubere, scrollbare Darstellung mit Zoom und Textsuche.

Common problems and solutions

PDF-Ladezeit über 5 Sekunden. Ein 40-seitiges Magazin als PDF wiegt 20-40 MB. Ohne Optimierung lädt der Browser das gesamte PDF, bevor die erste Seite angezeigt wird. Lösung: pdf.js unterstützt Byte-Range-Requests, bei denen nur die angeforderte Seite geladen wird. Der Server muss Accept-Ranges: bytes unterstützen. Zusätzlich das PDF mit Ghostscript oder qpdf für Web optimieren (linearize), damit die erste Seite sofort angezeigt wird.

Content nicht von Google indexiert. Google crawlt PDFs und indexiert deren Text, aber nicht innerhalb eines JavaScript-Viewers. Wenn das PDF nur über ein Canvas-Element im Browser dargestellt wird, sieht Google keinen Content. Lösung: Den PDF-Inhalt zusätzlich als versteckten Text (aria-hidden, für Screenreader zugänglich) auf der HTML-Seite platzieren oder, besser, den Content als native HTML-Elemente darstellen und das PDF nur als Download anbieten.

Veraltete Blätterkatalog-Libraries. Viele E-Paper-Extensions nutzen Libraries, die seit Jahren nicht mehr aktualisiert werden. Turn.js (letztes Update 2013), FlipBook jQuery (jQuery-Abhängigkeit) oder kommerzielle Libraries mit ablaufenden Lizenzen. Lösung: Auf pdf.js oder eine HTML-basierte Darstellung migrieren. Beide sind zukunftssicher und unabhängig von Drittanbieter-Lizenzen.

Migration and version compatibility

E-Paper-Extensions im TER sind überwiegend veraltet. Die meisten unterstützen maximal TYPO3 v10 oder v11. Für v12 und v13 gibt es keine gepflegten Blätterkatalog-Extensions.

Der empfohlene Weg für TYPO3 v12/v13: pdf.js als Standalone-Library einbinden (kein Extension nötig) für PDF-basierte Darstellungen. Für HTML-basierte Magazine: tx_news mit einem Magazin-Template und eigener Kategorie “Ausgaben”. Der Aufwand für ein Custom-Magazin-Layout auf tx_news-Basis liegt bei 3-5 Tagen.

Wer von einer bestehenden E-Paper-Extension migriert, hat drei Optionen: pdf.js-Integration (1-2 Tage, behält das PDF-basierte Modell), HTML-Migration (5-10 Tage, überführt den Content in tx_news-Artikel) oder einen externen Dienst (Issuu, Yumpu) mit TYPO3-Embed. Gosign empfiehlt den HTML-Ansatz für maximalen SEO-Wert und berät bei der Entscheidung zwischen den Varianten.