Beispiele und Voraussetzungen
Die Beispiel-Domain-IDs 501/502, Origins shop.example.com/dev.shop.example.com und der Entwicklername lena sind Platzhalter. Kein Beispiel legt einen echten Zugang an. Produktion verwendet in der Anleitung nsadmin als Linux-Produzentenbenutzer.
Auswahl
| Datei | Pfad / Zweck | Vor dem Start |
|---|---|---|
| puppeteer-simple.html | Selbstständiger Chromium-Datenaufbau mit eigenem Readinesssignal | Aktivierter Unmanaged-Eingang; keine externen Ressourcen. |
| Katalog mit Paged.js | Publisher-TOC, Preflight, Margin-Header, Komponenten | publisher-origin auf die eigene Instanz setzen; Module/Paged.js im Worker erreichbar. |
| landscape-table.html | Mehrseitige Tabelle auf benannten Querformatseiten | Wie Katalogbeispiel; alle Sonderseiten im Zielrenderer prüfen. |
| fixed-product-sheet.html | Eigenes A5-Datenblatt ohne Publishermodule | Unmanaged Chromium; bewusst begrenzter Inhalt. |
| weasyprint-static.html | Native CSS-Seiten/TOC ohne JavaScript | Freigegebener WeasyPrint-Pfad und kompatible installierte CLI. |
| weasyprint-prerender.html | Chromium-Datenaufbau und Canvasserialisierung vor WeasyPrint | Chromium und WeasyPrint; keine Paged.js-Fragmentierung. |
| embedded-patch.html | Inline-DOMPatch vor Publisher-Paginierung | Eigene Publisher-Instanz wie im Katalogbeispiel. |
| chromium-header-footer.html | Erkannte Inline-Header-/Footer-IDs | Schnittstellendemo: Worker-PDF-Margins 0mm, keine Sichtbarkeitsgarantie für diese Header. |
| header.html, footer.html | Begleitfragmente für --header und --footer |
Nicht als eigenständige Dokumente einreichen. |
| qr-kjua.html | QR-Demo mit explizit bereitgestellter Library | Kompatible geprüfte assets/kjua.min.js selbst mitgeben. |
| theme-override.html | Gestaltungsänderung ohne eigenen zweiten Bootstrap | Publisher-Origin ersetzen. |
| rich-text.html | Variable Text-/Tabellenstruktur | Publisher-Origin ersetzen; echte Rohtexte vorher sicher bereinigen. |
| managed-template.plain.adp | SSR-Slave mit vollständigen Master-Properties | Vorhandener Controller liefert Kontext; kein eigenständiges HTML. |
| project-data.raw-example.plain.adp | Sichere Vorschau einer Uploadquelle | In vorhandenen Upload-Projektablauf einbinden. |
Die selbstständigen Demos mit eigener Freigabe sind keine Managed-Snapshottemplates. Sie setzen kein gefälschtes Preflight-Ergebnis, sondern zeigen den Unmanaged-Readinessvertrag. Im Managed-Master bleibt die koordinierte Pipeline allein zuständig.
Konfigurationen
config.managed.example.json zeigt den Managed-Eingang mit Callback. config.unmanaged-offline.example.json eignet sich für selbstständige Chromiumdateien. config.hybrid.example.json erlaubt bewusst WeasyPrint ohne eine hier nicht durchsetzbare Netzwerk-Originbeschränkung. Es sind vollständige alternative Beispiele, nicht blind zusammenzufügende Fragmente und kein Ersatz für bestehende Secrets/Domainfreigaben.
# Im vollstaendigen Checkout, vor dem Deployment:
node ./service/vantaplex-publisher.js --config ./doc/examples/config.managed.example.json --check-config
Das prüft nur die Form. Die reservierte Callback-Domain funktioniert nicht als reales Ziel. Die Node-Binary muss die geforderte Serviceversion unterstützen.
Unmanaged-Beispiel ausführen
Aus einem bereits berechtigten Produzentenprozess:
node /opt/vantaplex-publisher/current/tools/submit-unmanaged.cjs --input-dir /var/lib/vantaplex-publisher/domains/502/unmanaged/input --html ./doc/examples/puppeteer-simple.html
Das Tool liefert den Outputpfad. Ein zweiter Upload bekommt einen neuen Schlüssel. Einreichen ist nicht Warten auf die fertige PDF. Der administrativ ausgeführte Smoke-Test verbindet Einlieferung und Ergebnisprüfung.
Bei instanzgebundenen HTML-Beispielen zunächst die Metaangabe publisher-origin ersetzen. Der Document-Bootstrap lädt aktuelle Module aus dieser Instanz. Deren CORS-/CSP-/Ressourcenregeln müssen den vorgesehenen Worker-Render zulassen. Die Dokumentation empfiehlt nicht, diesen Anschluss durch pauschales Abschalten von Web-Security zu umgehen.
Uploadquelle und Fachadapter
Die Dateien JSON, CSV und XML beschreiben dieselben beiden Demoprodukte. id ist die stabile Komponentenidentität; price_cents ist eine ganzzahlige Demo-Darstellung, keine Vorgabe für alle VANTAPLEX-Währungsmodelle. CSV verwendet hier explizit Semikolon und Kopfzeile.
Der vorhandene Uploadcontroller validiert die grundsätzliche Quelle und stellt Raw-Inhalte bereit. Ein projektspezifischer Adapter muss Schema, Typen und Grenzen prüfen und sichere Templatevariablen daraus erzeugen. In dieser Lieferung wird kein universeller XML-/CSV-Mapper in den Produktivcode eingebaut.
Was die Pakettests belegen
Syntax-, Link- und Konfigurationsprüfungen sichern die formale Konsistenz. Browserprüfungen der eigenständigen beziehungsweise lokal angebundenen Beispiele ersetzen keinen produktiven Managed-Roundtrip. WeasyPrint-Seitenumbrüche, gedruckte QR-Lesbarkeit und installationsspezifische Header-/Footer-Platzierung sind separat abzunehmen. Details im mitgelieferten TEST-RESULTS.md.