E-Paper dla TYPO3

Większość rozwiązań E-Paper w TYPO3 to następcy Flasha - i dokładnie tak się prezentują

Rozszerzenia E-Paper dla TYPO3 wywodzą się koncepcyjnie z ery Flasha: PDF jest przesyłany, biblioteka JavaScript symuluje przewracanie stron z animacją 3D. Na pierwszy rzut oka wygląda to imponująco. Na drugi: nie jest indeksowalne (Google nie może odczytać treści), nie jest responsywne (na smartfonie katastrofa), nie jest dostępne i z czasami ładowania przekraczającymi 5 sekund. Istnieją lepsze sposoby prezentowania magazynów i katalogów w TYPO3.

Kluczowe pytanie to nie “Który plugin E-Paper?”, ale “Czy w ogóle potrzebujemy E-Paperu?”. W większości przypadków odpowiedź brzmi: nie. Treść powinna znajdować się jako HTML na stronie, a nie jako PDF w katalogu do przeglądania.

Typowe scenariusze zastosowania

Magazyny firmowe i czasopisma dla klientów. Działy marketingu produkują kwartalnie magazyny w druku i chcą udostępnić wersję cyfrową na stronie. Klasyczne podejście: przesłanie PDF, osadzenie widgetu katalogu. Lepsze podejście: opublikowanie artykułów jako pojedynczych stron TYPO3 (przez tx_news) z magazynową stroną przeglądową jako hubem. Każdy artykuł jest osobno indeksowalny, linkowalny i udostępnialny. PDF pozostaje jako opcja pobierania dla czytelników offline.

Katalogi produktowe dla partnerów handlowych. Hurtownie i przedsiębiorstwa B2B udostępniają swoim dealerom katalogi produktowe. Dane katalogowe istnieją często jako eksport z InDesign (PDF). Widget E-Paper czyni katalog przeglądalnym, ale nie przeszukiwalnym. Lepsza droga: ustrukturyzowane zarządzanie danymi produktowymi w TYPO3 i prezentacja katalogu jako filtrowalnej, przeszukiwalnej strony HTML. PDF służy jako wersja do druku do pobrania.

Raporty roczne i raporty zrównoważonego rozwoju. Spółki giełdowe publikują raporty roczne, które muszą optycznie odpowiadać układowi druku. Tutaj przeglądarka oparta na PDF jest uzasadniona, ponieważ układ jest wiążący i poszczególne strony wymagają dokładnych podziałów. Ale i tu obowiązuje: dane kluczowe (wskaźniki finansowe, oświadczenia zarządu) powinny być dodatkowo dostępne jako HTML.

Architektura techniczna

Rozwiązania E-Paper w TYPO3 można podzielić na trzy kategorie:

Katalogi do przeglądania oparte na PDF. PDF jest przesyłany, biblioteka JavaScript (Turn.js, FlipBook.js, pdf.js) renderuje strony w przeglądarce. Biblioteka dzieli PDF na pojedyncze strony i wyświetla je jako elementy Canvas. Zalety: szybka konfiguracja, układ odpowiada 1:1 drukowi. Wady: brak wartości SEO (treść ukryta w PDF), słaba wydajność przy dużych PDF (50+ stron), brak responsywności.

Układy magazynowe oparte na HTML. Artykuły są zarządzane jako normalne elementy treści TYPO3 i prezentowane przez szablon magazynowy. Układ symuluje estetykę magazynu (wielkoformatowe obrazy, kolumny tekstowe, wyróżnione cytaty) przez CSS Grid i Tailwind. Zalety: pełna indeksacja SEO, responsywność, wydajność, dostępność. Wady: wyższy nakład początkowy, układ odbiega od druku.

Podejście hybrydowe. Artykuły istnieją jako HTML, dodatkowo dostępne jest pobieranie PDF. Na stronie przeglądowej odwiedzający widzi zajawki artykułów, w pasku bocznym pobieranie PDF całego magazynu. To podejście łączy wartość SEO z wiernością druku.

Do prezentacji PDF w TYPO3 nadaje się pdf.js (Mozilla), biblioteka open-source renderująca PDF natywnie w przeglądarce. pdf.js jest wydajniejszy niż katalogi oparte na Turn.js, rezygnuje z animacji przewracania i oferuje zamiast tego czystą, przewijalną prezentację z zoomem i wyszukiwaniem tekstu.

Częste problemy i rozwiązania

Czas ładowania PDF powyżej 5 sekund. 40-stronicowy magazyn jako PDF waży 20-40 MB. Bez optymalizacji przeglądarka ładuje cały PDF, zanim wyświetli pierwszą stronę. Rozwiązanie: pdf.js obsługuje Byte-Range-Requests, przy których ładowana jest tylko żądana strona. Serwer musi obsługiwać Accept-Ranges: bytes. Dodatkowo optymalizacja PDF Ghostscriptem lub qpdf dla webu (linearize), aby pierwsza strona wyświetlała się natychmiast.

Treść nie jest indeksowana przez Google. Google crawluje PDF i indeksuje ich tekst, ale nie wewnątrz przeglądarki JavaScript. Gdy PDF jest wyświetlany tylko przez element Canvas w przeglądarce, Google nie widzi treści. Rozwiązanie: umieszczenie treści PDF dodatkowo jako ukrytego tekstu (aria-hidden, dostępnego dla czytników ekranu) na stronie HTML lub, lepiej, prezentacja treści jako natywnych elementów HTML i oferowanie PDF tylko do pobrania.

Przestarzałe biblioteki katalogów. Wiele rozszerzeń E-Paper korzysta z bibliotek, które nie były aktualizowane od lat. Turn.js (ostatnia aktualizacja 2013), FlipBook jQuery (zależność od jQuery) lub komercyjne biblioteki z wygasającymi licencjami. Rozwiązanie: migracja na pdf.js lub prezentację opartą na HTML. Oba są przyszłościowe i niezależne od licencji zewnętrznych.

Migracja i kompatybilność wersji

Rozszerzenia E-Paper w TER są przeważnie przestarzałe. Większość obsługuje maksymalnie TYPO3 v10 lub v11. Dla v12 i v13 nie ma utrzymywanych rozszerzeń katalogów do przeglądania.

Zalecana droga dla TYPO3 v12/v13: osadzenie pdf.js jako samodzielnej biblioteki (bez potrzeby rozszerzenia) dla prezentacji opartych na PDF. Dla magazynów opartych na HTML: tx_news z szablonem magazynowym i własną kategorią “Wydania”. Nakład pracy na niestandardowy układ magazynowy na bazie tx_news to 3-5 dni.

Kto migruje z istniejącego rozszerzenia E-Paper, ma trzy opcje: integracja pdf.js (1-2 dni, zachowuje model oparty na PDF), migracja HTML (5-10 dni, przenosi treść do artykułów tx_news) lub usługa zewnętrzna (Issuu, Yumpu) z osadzeniem TYPO3. Gosign rekomenduje podejście HTML dla maksymalnej wartości SEO i doradza przy decyzji między wariantami.