Eine große Overlay-Datei lässt sich in mehrere JSON-Dateien aufteilen. Mit include lädt der Reader zusätzliche Dateien. Mit addon können deren Materialien einen eigenen Bereich in der Seitenleiste erhalten. Das sind zwei getrennte Entscheidungen: Eine zusätzliche Datei allein erzeugt noch keinen eigenen Tab.
Das vollständige Downloadpaket und die Upload-Schritte stehen in Materialien nach Aufgaben bündeln. Dort sind alle folgenden Einträge bereits enthalten. Die Grundlagen der Seitenzählung erklärt Overlay-JSON: Seiten, Bilder und Seitensprünge.
Eine zusätzliche JSON-Datei laden
Die Hauptdatei hallo-viertel.json bleibt direkt neben der PDF. Im äußeren JSON-Objekt ergänzen Sie:
"include": ["zusatz.json"]
Legen Sie zusatz.json ebenfalls ins Hauptverzeichnis. Sie wird relativ zum Produktverzeichnis geladen. Mehrere Dateien können in der Liste stehen. Listen Sie alle Dateien hier auf: Ein weiteres include innerhalb einer eingebundenen Datei wird nicht rekursiv geladen.
Beispiel: ein eigener Tab „Extras“
Unsere vollständige zusatz.json lautet:
{
"version": 2,
"pageOffset": 2,
"addon": "extras",
"overlays": [
{
"type": "extraMaterial",
"pageNum": 2,
"pageFrom": 2,
"pageTo": 4,
"path": "material/loesungen.pdf",
"description": "Café-Begleitblatt im Zusatzbereich",
"category": "Zusatzmaterial"
}
]
}
addon: "extras" auf dieser eingebundenen Datei ordnet alle ihre Overlays dem Tab Extras zu. Das Begleitblatt erscheint dort auf Inhaltsseite 2 bis einschließlich 4, ohne zusätzlichen Button auf der PDF. Die Datei material/loesungen.pdf wird nicht kopiert: Der Eintrag verweist auf das bereits vorhandene Dokument.
Ein eigener Tab ist keine Zugriffssperre. Verwenden Sie ihn zur Gliederung, nicht zum Verstecken vertraulicher Lehrerunterlagen oder Lösungen vor bestimmten Nutzern. Eine getrennte Berechtigung wird dadurch nicht eingerichtet.
Warum steht pageOffset auch in der zweiten Datei?
Jede JSON-Datei wird zunächst mit ihrem eigenen Seitenversatz verarbeitet. Der Versatz aus der Hauptdatei wird nicht einfach auf die Rohdaten aller Zusatzdateien übertragen.
Im Beispiel zählt auch zusatz.json die gedruckten Inhaltsseiten. Deshalb braucht sie ebenfalls pageOffset: 2. Ohne diesen Wert wäre ihr Bereich auf den physischen PDF-Seiten 2 bis 4 statt auf den gewünschten physischen Seiten 4 bis 6.
Verwenden Sie in allen Dateien möglichst dieselbe Zählweise. Lassen Sie globale Einstellungen wie startPage, twoPageOffset, captions und das Lektionsverzeichnis in der Hauptdatei. Zusätzliche Dateien sollten nur ihre eigenen Overlays, gegebenenfalls Slots, ihren Seitenversatz und optional addon enthalten. Das vermeidet unbeabsichtigtes Überschreiben von Einstellungen beim Zusammenführen.
Nur aufteilen, ohne eigenen Tab
Wenn Sie eine Datei nur zur besseren Pflege auslagern, lassen Sie addon weg. Ihre Medien bleiben dann im normalen Hauptbereich. Umgekehrt kann addon: "extras" auch direkt an einem einzelnen Overlay stehen. Ein addon nur am äußeren Objekt der Hauptdatei ist nicht gleichbedeutend mit der gezeigten Zuordnung für eine eingebundene Datei.
Die Dateiaufteilung ändert die Pfadregeln der Medien nicht. Das Beispiel-PDF bleibt über material/loesungen.pdf vom Produktverzeichnis aus erreichbar. Verschieben Sie Dateien nicht allein deshalb, weil ihr Overlay nun in einer anderen JSON steht.
Sicher hochladen und prüfen
- Neue Mediendateien hochladen.
- Die zusätzliche JSON hochladen und Schreibweise sowie Pfad kontrollieren.
- Erst dann die Hauptdatei mit dem neuen
includeersetzen. - Den Reader neu öffnen. Auf Inhaltsseite 2 den Tab Extras wählen und das Begleitblatt öffnen.
- Seiten 2, 3 und 4 sowie die Außengrenzen 1 und 5 prüfen. Der Eintrag soll nur innerhalb seines Bereichs erscheinen.
Ein fehlendes oder fehlerhaftes Include kann übersprungen werden, während sich das Heft trotzdem öffnet. „Die PDF startet“ reicht deshalb nicht als Prüfung: Kontrollieren Sie jeden erwarteten Zusatzinhalt. Diese Reihenfolge ersetzt keine atomare Veröffentlichung und keine Zugriffskontrolle. Hinweise zum Aktualisieren stehen in PDF-Overlay-Produkte prüfen und aktualisieren.