Plugins de CLI de Documentize
Abrir la aplicación: Consigue los plugins CLI → (products.documentize.ai)
En resumen
Un plugin de CLI es una pequeña herramienta de línea de comandos, autónoma, que hace una operación: unir, comprimir, girar, extraer texto, OCR, etcétera. Lo descargas del catálogo de plugins en products.documentize.ai/pdf-cli, lo ejecutas con el entorno de ejecución de .NET y encadenas varios en un script de shell. El procesamiento ocurre en tu ordenador.
Instalación
- Abre el catálogo, busca o filtra por categoría (AI, Convert, Edit, Extract, OCR, Security, Archive) y descarga el zip del plugin.
- Instala el entorno de ejecución .NET 10 (no el SDK). La descarga es un
.dllya compilado. - Coloca tu archivo de licencia
documentize.licjunto al.dlldel plugin. Sin él, el plugin funciona en modo de evaluación. - Solo en Linux, instala los gráficos y las fuentes:
sudo apt-get install -y libgdiplus fontconfig fonts-liberation fonts-dejavu-core - Comprueba que funciona:
dotnet Documentize.Merge.dll --help.
Windows y macOS no necesitan paquetes adicionales en el uso normal. Algunos zips contienen además un ejecutable nativo (./Documentize.Merge, Documentize.Merge.exe), que puedes ejecutar en lugar de dotnet ...dll.
El modelo de carpetas (léelo una vez)
Los plugins no reciben rutas de archivo como indicadores. Trabajan con un par de carpetas de tarea:
- entrada:
<PLUGIN_INPUT_DIR>/<task-id>/ - salida:
<PLUGIN_OUTPUT_DIR>/<task-id>/
Ambas variables toman por defecto /tmp/documentize/input y /tmp/documentize/output en Linux/macOS (%TEMP%\documentize\... en Windows). Pasa siempre tu propio --task-id; si no, se usa un GUID aleatorio y no sabrás adónde fue el resultado. Cada plugin deja además un archivo de traspaso <task-id>.json en la carpeta de salida; ignóralo cuando ejecutes a mano.
Códigos de salida según los readmes de los plugins: 0 correcto, 1 la tarea se ejecutó pero falló (detalles en stderr), 2 error de uso.
Un ejemplo por familia
Los indicadores de abajo proceden de los readmes de los plugins.
export PLUGIN_INPUT_DIR=$HOME/dmz/in PLUGIN_OUTPUT_DIR=$HOME/dmz/out
# Merge: files in the input folder are merged in filename order. No other flags.
mkdir -p $PLUGIN_INPUT_DIR/j1 && cp a.pdf b.pdf $PLUGIN_INPUT_DIR/j1/
dotnet Documentize.Merge.dll --task-id j1
# Compress: --compress-type is an int preset, default 1
dotnet Documentize.Compress.dll --task-id j2 --compress-type 1
# Rotate: --angle (default 90), --rotate-type (a = all pages), --page-num
dotnet Documentize.Rotate.dll --task-id j3 --angle 90
# Remove pages: --remove-range is required, e.g. 1,3,5-7
dotnet Documentize.RemovePages.dll --task-id j4 --remove-range 1,3
# OCR to searchable PDF: --language (Tesseract code, default eng)
dotnet Documentize.OcrSearchable.dll --task-id j5 --language eng
Encadenar con el shell
No hay tubería: la carpeta de salida del paso N pasa a ser la carpeta de entrada del paso N+1. Envuélvelo en una pequeña función:
step() { # step <prev-task> <next-task> <plugin> [flags...]
prev=$1; next=$2; plugin=$3; shift 3
mkdir -p "$PLUGIN_INPUT_DIR/$next"
cp "$PLUGIN_OUTPUT_DIR/$prev"/*.pdf "$PLUGIN_INPUT_DIR/$next/"
dotnet "Documentize.$plugin.dll" --task-id "$next" "$@"
}
# merge -> remove cover page -> compress
dotnet Documentize.Merge.dll --task-id m1 # inputs already in $PLUGIN_INPUT_DIR/m1
step m1 m2 RemovePages --remove-range 1
step m2 m3 Compress --compress-type 1
ls "$PLUGIN_OUTPUT_DIR/m3"
Usa set -e para que una salida distinta de cero detenga la cadena. Valen las reglas de orden de Organizar: primero organiza, comprime al final.
Entrada alternativa
En lugar de indicadores, un plugin acepta un único argumento JSON codificado en base64 (campos en PascalCase más "ID"). Es útil cuando lo lanza otro programa; consulta el readme de cada zip.
Notas y precauciones
- Las páginas del catálogo pueden mostrar un comando de estilo
doccli; los readmes de los zips de los plugins son la referencia (compruébalo con el zip que hayas descargado). - Espera comprobaciones de licencia en la primera ejecución y una conexión a internet para la activación (compruébalo en cada plugin).