Der nicht-interaktive inksmith-cli-Begleiter validiert tragbare Vorlagen und rendert JSON-Daten mit dem Desktop-Renderer in PDFs. Es liest den Desktop-Lizenz-Cache des aktuellen Benutzers; es öffnet kein Desktop-Fenster oder verbindet sich mit Press.
Installationsort
Die Windows NSIS Installateure setzen inksmith-cli.exe neben InkSmith.exe. Windows MSIX registriert einen App Execution Alias. Das Linux Debian-Paket installiert inksmith-cli in /usr/bin.
Validierung einer Vorlage
inksmith-cli validate --template path/to/template.inks
Die Validierung überprüft das Paket, das Vorlagenschema und die genau verpackten Schriftenbindungen. Sie braucht keine Lizenz.
Geben Sie eine PDF
inksmith-cli render --template invoice.inks --data customer.json --output invoice.pdf
--data - liest ein JSON-Objekt aus der Standardeingabe. Eine einfache Datendatei kann Folgendes enthalten:
{"customer":{"name":"Ada"},"invoice":{"number":"INV-1042"}}
Der Eingang JSON ist auf 1 MiB begrenzt. Der Ausgabepfad muss in .pdf enden, ein bestehendes Verzeichnis benennen und nicht bereits existieren. Der CLI verpflichtet die komplette Datei atomar und weigert sich, ein bestehendes Ergebnis zu überschreiben.
Handle führt zu einer Anwendung
Erfolgreiche Befehle schreiben ein versioniertes JSON-Objekt auf stdout; Fehler schreiben ein JSON-Objekt auf stderr. Verzweigen Sie auf den Ausstiegsstatus und die stabile error.code, nicht die Anzeigenachricht.
| Ausstiegsstatus | Bedeutung |
|---|---|
| 0 | Erfolgreich |
| 2 | Befehlssyntax |
| 3 | Eingabe- oder JSON-Daten |
| 4 | Vorlagenpaket oder Schema |
| 5 | Bestimmungsort PDF |
| 6 | Absender oder Löschung |
Ctrl+C storniert das Rendern, ohne eine unvollständige PDF zu begehen. Rendering verwendet die gleichen zwischengespeicherten Lizenzlimits wie Desktop-Export. Für vollständige Python-, Node.js- und Shell-Beispiele siehe Beispiele für CLI.