El compañero inksmith-cli no interactivo valida plantillas portátiles y renderiza datos JSON a PDFs usando el renderizador de escritorio. Lee el caché de licencia de escritorio del usuario actual; no abre una ventana de escritorio o se conecta a Press.
Ubicación de instalación
Los instaladores de NSIS Windows pusieron inksmith-cli.exe junto a InkSmith.exe. Windows MSIX registra un alias de ejecución de aplicaciones. El paquete Linux Debian instala inksmith-cli en /usr/bin.
Validar una plantilla
inksmith-cli validate --template path/to/template.inks
La validación comprueba el paquete, el esquema de plantillas y los enlaces de fuentes empaquetados exactos. No necesita licencia.
Render un PDF
inksmith-cli render --template invoice.inks --data customer.json --output invoice.pdf
--data - lee un objeto JSON de entrada estándar. Un archivo de datos simple podría contener:
{"customer":{"name":"Ada"},"invoice":{"number":"INV-1042"}}
La entrada JSON está limitada a 1 MiB. La ruta de salida debe terminar en .pdf, nombrar un directorio existente, y no existe ya. El CLI compromete el archivo completo atómico y se niega a sobreescribir un resultado existente.
Resultados de la mano en una aplicación
Los comandos exitosos escriben un objeto JSON versionado a stdout; fallas escriben un objeto JSON a stderr. Rama en el estado de salida y el estable error.code, no el mensaje de visualización.
| Situación de salida | Significado |
|---|---|
| 0 | Éxito |
| 2 | Sintaxis del comando |
| 3 | Datos de entrada o JSON |
| 4 | Paquete de plantilla o esquema |
| 5 | Destino PDF |
| 6 | Renderador o cancelación |
Ctrl+C cancela la renderización sin comprometer un PDF. Rendering utiliza los mismos límites de licencias de caché que la exportación de escritorio. Para los ejemplos completos de Python, Node.js y shell, véase CLI ejemplos.