Export-Layout: Kompatibilitätsfehler

Beim Ändern des Seitenlayouts eines Exports auf A4 Hochformat (Paged) oder A4 Querformat (Paged) kann es zu einer Fehlermeldung kommen:

„Das gewählte Layout ist nicht mit diesem Template kompatibel. Bitte verwende ein Layout ohne Paged.js (z.B. ‘A4 Hochformat’) oder passe das Template an."

Die Paged-Layouts verwenden eine spezielle Technik (Paged.js), die den Export in echte Seiten aufteilt – mit automatischen Seitenumbrüchen und Seitenzahlen. Einige ältere Templates verwenden jedoch eigene Techniken zur Seitensteuerung, die damit nicht zusammenarbeiten.

Fehlerbeschreibung: Das Template positioniert Kopf- oder Fußzeilen mit position: fixed, damit sie auf jeder gedruckten Seite erscheinen.

Warum das nicht funktioniert: Paged.js erzeugt eigene Seiten-Container und übernimmt den gesamten Seitenfluss. Fest positionierte Elemente erscheinen dadurch nur auf der ersten Seite oder überlagern den Inhalt.

Lösung: Entferne position: fixed aus dem Template. Für wiederkehrende Kopf- und Fußzeilen in Paged-Layouts stehen CSS-Seitenzähler ({{pageNumber}}, {{totalPages}}) zur Verfügung. Alternativ verwende ein Layout ohne Paged.js (z.B. „A4 Hochformat").

Ursache 2: Eigene @page-Regeln im Template

Fehlerbeschreibung: Das Template definiert eigene CSS-@page-Regeln, z.B. für Seitengröße oder Seitenränder.

Warum das nicht funktioniert: Das Paged-Layout setzt bereits eigene @page-Regeln für die korrekte Seitengröße und Ränder. Doppelte Definitionen führen zu unvorhersehbarem Verhalten – Ränder oder Seitengrößen können sich gegenseitig überschreiben.

Lösung: Entferne die @page-Regeln aus dem Template. Seitengröße und Ränder werden automatisch vom gewählten Layout gesteuert. Alternativ verwende ein Layout ohne Paged.js (z.B. „A4 Hochformat"), wenn du eigene @page-Regeln benötigst.

Ursache 3: Abstands-Trick mit Tabellenkopf und -fuß

Fehlerbeschreibung: Das Template verwendet <thead> und <tfoot> mit festen Höhenangaben, um auf jeder gedruckten Seite Platz für Kopf- und Fußzeilen freizuhalten.

Warum das nicht funktioniert: Dieser Trick nutzt die native Seitenpaginierung des Browsers – der Browser wiederholt <thead> und <tfoot> automatisch auf jeder Druckseite. Paged.js ersetzt diese native Paginierung durch eigene Seiten und ignoriert die Wiederholung, sodass leere Bereiche entstehen.

Lösung: Entferne die Abstands-Elemente aus <thead> und <tfoot>. Verwende stattdessen break-inside: avoid für Tabellenzeilen, die nicht getrennt werden sollen. Alternativ verwende ein Layout ohne Paged.js (z.B. „A4 Hochformat").

Fehlende oder ungültige Bilder

Wenn ein Export Bilder enthält, die nicht geladen werden können, wird der Export trotzdem erzeugt. Anstelle des fehlenden Bildes erscheint ein Platzhalter mit einer Fehlerbeschreibung.

Bild nicht verfügbar

Die Bild-URL konnte nicht erreicht werden. Das kann passieren, wenn das Bild gelöscht wurde, die URL nicht mehr gültig ist oder der Server nicht erreichbar ist.

Lösung: Prüfe die Bild-URL im Template. Stelle sicher, dass das Bild existiert und der Server erreichbar ist. Lade das Bild gegebenenfalls neu hoch und aktualisiere die URL im Template.

Bildformat nicht unterstützt

Das Bild konnte geladen werden, aber das Format wird nicht erkannt. Unterstützt werden gängige Rasterformate wie JPEG, PNG und GIF sowie SVG-Vektorgrafiken.

Lösung: Konvertiere das Bild in ein unterstütztes Format (z.B. PNG oder JPEG) und aktualisiere die URL im Template. SVG-Bilder werden automatisch erkannt und eingebettet – für SVGs ohne explizite Breite/Höhe wird eine Mindestgröße von 100x100px gesetzt.

Welches Layout soll ich verwenden?

LayoutGeeignet für
A4 Hochformat / QuerformatBestehende Templates mit eigener Seitensteuerung, Templates mit festen Kopf-/Fußzeilen
A4 Hochformat / Querformat (Paged)Neue Templates, die echte Seitenpaginierung und Seitenzahlen benötigen
FreiTabellarische Daten, Übersichten ohne Druckformat