Autres outils

CLI de bureau

Valider les fichiers .inks et rendre les PDF d'autres applications.

Le compagne inksmith-cli non interactif valide les modèles portables et rend les données JSON en PDF à l'aide du rendu Bureau. Il lit le cache de licence de l'utilisateur actuel; il n'ouvre pas une fenêtre de bureau ou se connecte à Press.

Installer l'emplacement

Les installateurs Windows NSIS mettent inksmith-cli.exe à côté de InkSmith.exe. Windows MSIX enregistre un alias d'exécution de l'application. Le paquetage Linux Debian installe inksmith-cli dans /usr/bin.

Valider un modèle

inksmith-cli validate --template path/to/template.inks

La validation vérifie le paquet, le schéma du modèle et les liaisons de polices exactes. Elle n'a pas besoin de licence.

Rendre un PDF

inksmith-cli render --template invoice.inks --data customer.json --output invoice.pdf

--data - lit un objet JSON depuis une entrée standard. Un fichier de données simple peut contenir :

{"customer":{"name":"Ada"},"invoice":{"number":"INV-1042"}}

L'entrée JSON est limitée à 1 Mio. Le chemin de sortie doit se terminer dans .pdf, nommer un répertoire existant, et il n'existe pas encore. Le CLI engage le fichier complet atomiquement et refuse d'écraser un résultat existant.

Manipulation résultats dans une application

Les commandes réussies écrivent un objet JSON versionné à stdout; les échecs écrivent un objet JSON à stderr. Branche sur l'état de sortie et le error.code stable, pas le message d'affichage.

État de sortie Signification
0 Succès
2 Syntaxe des commandes
3 Données d'entrée ou de JSON
4 Paquet ou schéma de modèles
5 Destination PDF
6 Rendu ou annulation

Ctrl+C annule le rendu sans commettre un PDF incomplet. Le rendu utilise les mêmes limites de licence en cache que l'exportation de bureau. Pour des exemples complets de Python, Node.js et de shell, voir Exemples de CLI.