Parámetros de consola para trabajar con PDF

Contenido

# Parámetros de consola para exportar a PDF

El filtro PDF acepta una serie de opciones que configuran las propiedades de exportación a PDF.

## Ejemplos:

#### Símbolo del sistema de Windows - CMD

Las comillas dobles en la cadena del parámetro deben tener caracteres de escape (\").

Para exportar las páginas 2 a 5 de un documento de Writer:

"C:\Program Files\LibreOffice\program\soffice" --convert-to pdf:writer_pdf_Export:{\"PageRange\":{\"type\":\"string\",\"value\":\"2-5\"}} --outdir C:\Users\myuser\Documents C:\Users\myuser\Documents\myfile.odt

Para agregar una marca de agua en mosaico:

"C:\Program Files\LibreOffice\program\soffice" --convert-to pdf:draw_pdf_Export:{\"TiledWatermark\":{\"type\":\"string\",\"value\":\"draft\"}} C:\Users\myuser\Documents\test.odg

Para cifrar un archivo:

"C:\Program Files\LibreOffice\program\soffice" --convert-to pdf:draw_pdf_Export:{\"EncryptFile\":{\"type\":\"boolean\",\"value\":\"true\"},\"DocumentOpenPassword\":{\"type\":\"string\",\"value\":\"secret\"}} test.odg

Para establecer la versión 1.5 (en lugar de la 1.7 predeterminada):

"C:\Program Files\LibreOffice\program\soffice" --convert-to pdf:draw_pdf_Export:{\"SelectPdfVersion\":{\"type\":\"long\",\"value\":\"15\"}} prueba.odg

#### PowerShell de Windows

La cadena de parámetros debe ir entre comillas simples para permitir el análisis de las comillas dobles. El carácter «&» se conoce como operador de llamada. Se utiliza para ejecutar una orden, un bloque de secuencias o una función almacenada en una variable o una cadena.

Para exportar las páginas 2 a 5 de un documento de Writer:

& 'C:\Program Files\LibreOffice\program\soffice' --convert-to 'pdf:writer_pdf_Export:{"PageRange":{"type":"string","value":"2-5"}}' --outdir C:\Users\myuser\Documents C:\Users\myuser\Documents\myfile.odt

Para agregar una marca de agua en mosaico:

& 'C:\Program Files\LibreOffice\program\soffice' --convert-to 'pdf:draw_pdf_Export:{"TiledWatermark":{"type":"string","value":"draft"}}' test.odg

Para cifrar un archivo:

& 'C:\Program Files\LibreOffice\program\soffice' --convert-to 'pdf:draw_pdf_Export:{"EncryptFile":{"type":"boolean","value":"true"},"DocumentOpenPassword":{"type":"string","value":"secret"}}' test.odg

Para establecer la versión 1.5 (en lugar de la 1.7 predeterminada):

& 'C:\Program Files\LibreOffice\program\soffice' --convert-to 'pdf:draw_pdf_Export:{"SelectPdfVersion":{"type":"long","value":"15"}}' test.odg

#### Linux (BASH) y MacOS (ZSH)

Para exportar las páginas 2 a 5 de un documento de Writer:

soffice --convert-to 'pdf:writer_pdf_Export:{"PageRange":{"type":"string","value":"2-5"}}' --outdir /home/mi_usuarior mi_archivo.odt

Para agregar una marca de agua en mosaico:

soffice --convert-to 'pdf:draw_pdf_Export:{"TiledWatermark":{"type":"string","value":"draft"}}' test.odg

Para cifrar un archivo:

soffice --convert-to 'pdf:draw_pdf_Export:{"EncryptFile":{"type":"boolean","value":"true"},"DocumentOpenPassword":{"type":"string","value":"secret"}}' test.odg

Para establecer la versión 1.5 (en lugar de la 1.7 predeterminada):

soffice --convert-to 'pdf:draw_pdf_Export:{"SelectPdfVersion":{"type":"long","value":"15"}}' test.odg

## Índice

Propiedades generales

Vista inicial

Interfaz de usuario

Enlaces

Seguridad

Firma digital

## Propiedades generales

Generales

Nombre | Descripción | Tipo | Valor predeterminado
--- | --- | --- | ---
PageRange | Si se establece esta propiedad, indica el intervalo de páginas que se exportarán. Para exportar todas las páginas, no establezca esta propiedad. Para exportar una selección, no establezca esta propiedad y establezca solo la propiedad Selection. | string | Vacío (se exportan todas las páginas)
Selection | Un any se corresponde con la selección actual en el documento. | Any |
UseLosslessCompression | Especifica si las imágenes se deben exportar a PDF usando un formato con compresión sin pérdidas como PNG u otro como JPEG. | boolean | false
Quality | Especifica la calidad de la exportación JPG. Un valor más alto produce una imagen de mayor calidad y un archivo más grande. Valor mínimo inclusivo: 1. Representa el valor más bajo que se puede utilizar. Cuanto menor sea el valor, peor será la calidad de la imagen y menor será el tamaño del archivo. Valor máximo inclusivo: 100. Representa el valor más alto que se puede utilizar. Cuanto mayor sea el valor, mejor será la calidad de la imagen y mayor será el tamaño del archivo. | long | 90
ReduceImageResolution | Especifica si la resolución de cada imagen se reduce a la resolución especificada por la propiedad MaxImageResolution. | boolean | false
MaxImageResolution | Si la propiedad ReduceImageResolution se establece en verdadero, todas las imágenes se reducirán al valor dado en DPI. Los valores posibles son: 75, 150, 300, 600 y 1200. | long | 300
SelectPdfVersion | Especifica la versión de PDF que se aplicará. Los valores posibles son: 0: PDF 1.7 (opción predeterminada). 1: PDF/A-1b 2: PDF/A-2b 3: PDF/A-3b 15: PDF 1.5 16: PDF 1.6 17: PDF 1.7 | long | 0
PDFUACompliance | Crea un archivo PDF accesible que cumple los requisitos de la especificación PDF/UA (ISO 14289). | boolean | false
UseTaggedPDF | Determina si los archivos PDF se crean utilizando etiquetas especiales de accesibilidad. | boolean | false
ExportFormFields | Especifica si los campos de formulario se exportan como activos o solo se exporta su representación como imagen. | boolean | true
FormsType | Especifica el formato para el envío de un formulario PDF. Los valores posibles son: 0: especifica que se usa el tipo de formulario FDF. 1: especifica que se usa el tipo de formulario PDF. 2: especifica que se usa el tipo de formulario HTML. 3: especifica que se usa el tipo de formulario XML. | long | 0
AllowDuplicateFieldNames | Especifica si se permite que varios campos de formulario exportados tengan el mismo nombre de campo. | boolean | false
ExportBookmarks | Especifica si los marcadores se exportan a PDF. | boolean | true
ExportPlaceholders | Exporta solo las marcas visuales de los campos sustitutivos. Este indicador exportado es inoperante. | boolean | false
ExportNotes | Especifica si las notas se exportan a PDF. | boolean | false
ExportNotesPages | Especifica si las páginas de notas se exportan a PDF. (Las páginas de notas solo están disponibles en documentos de Impress). | boolean | false
ExportOnlyNotesPages | Si la propiedad ExportNotesPages está establecida en verdadero, especifica si solo se exportan las páginas de notas a PDF. | boolean | false
ExportNotesInMargin | Especifica si las notas al margen se exportan a PDF. | boolean | false
ExportHiddenSlides | En LibreOffice Impress, exporta las diapositivas excluidas del pase de diapositivas. | boolean | false
IsSkipEmptyPages | Especifica que se suprimen las páginas vacías insertadas automáticamente. Esta opción está activa solo si se almacenan documentos de Writer. | boolean | false
EmbedStandardFonts | Especifica si se deben incrustar los 14 tipos de letra estándar de PDF o no. | boolean | false
IsAddStream | Especifica si se inserta una secuencia en el archivo PDF conteniendo el documento original para fines de archivado. | boolean | false
Watermark | Especifica el texto para una marca de agua que se reproducirá en todas las páginas del archivo PDF exportado. | string | (empty)
WatermarkColor | Especifica el color del texto de la marca de agua. | long | 8388223 (light green)
WatermarkFontHeight | Especifica la altura de letra del texto de la marca de agua. | long |
WatermarkRotateAngle | Especifica el ángulo del texto de la marca de agua. | long |
WatermarkFontName | Especifica el tipo de letra del texto de la marca de agua. | string | Helvetica
TiledWatermark | Especifica el texto de la marca de agua en mosaico. | string |
UseReferenceXObject | Cuando la opción está habilitada, se utiliza el marcado XObject de referencia: esta es una operación simple, pero los visores PDF deben admitir este marcado para mostrar imágenes vectoriales. De lo contrario, se muestra un mapa de bits alternativo en el visor PDF. | boolean | false
IsRedactMode |  | boolean | false
SinglePageSheets | Ignora el tamaño de papel de cada hoja, los intervalos de impresión y el estado visible/oculto y coloca cada hoja (incluso las ocultas) en exactamente una página. | boolean | false

## Vista inicial

Vista inicial

Nombre | Descripción | Tipo | Valor predeterminado
--- | --- | --- | ---
InitialView | Especifica cómo se debe mostrar el documento PDF cuando se abre. Los valores posibles son: 0: Selecciona el modo predeterminado, ni esquemas ni miniaturas. 1: el documento se muestra con el panel de esquema abierto 2: El documento se muestra con el panel de miniaturas abierto. | long | 0
InitialPage | Especifica en la página que se debe abrir el documento PDF en el visor PDF. | long | 1
Magnification | Especifica la acción que se realizará cuando se abra el PDF. Los valores posibles son: 0: se abre con el zum predeterminado. 1: se abre con la ampliación precisa para encajar la página entera en la ventana. 2: Se abre ampliada ajustando todo el ancho de la página en la ventana. 3: Se abre ampliado ajustando todo el ancho del cuadro delimitador en la ventana (recorta los márgenes). 4: Se abre con el nivel de zum especificado en la propiedad Zum. | long | 0
Zoom | Especifica el nivel de zum con el que se abre un documento PDF. Sólo es válido si Magnification está establecido en "4". | long | 100
PageLayout | Especifica el diseño de página que se utilizará cuando se abra el documento. Los valores posibles son: 0: Muestra las páginas según la configuración del visor PDF. 1: muestra una página a la vez. 2: Muestra las páginas en una columna. 3: Muestra las páginas en dos columnas, páginas impares a la derecha; para tener las páginas impares a la izquierda, se debe usar la propiedad FirstPageOnLeft. | long | 0
FirstPageOnLeft | Se usa con el valor 3 de la propiedad PageLayout anterior, verdadero si la primera página (impar) debe estar en el lado izquierdo de la pantalla. | boolean | false

## Interfaz de usuario

Interfaz de usuario

Nombre | Descripción | Tipo | Valor predeterminado
--- | --- | --- | ---
ResizeWindowToInitialPage | Especifica que la ventana del visor de PDF se abra mostrando la página inicial completa al abrir el documento. | boolean | false
CenterWindow | Especifica que la ventana del visor de PDF esté centrada en la pantalla cuando se abra el PDF. | boolean | false
OpenInFullScreenMode | Especifica que la ventana del visor de PDF se abra en pantalla completa, encima de todas las ventanas. | boolean | false
DisplayPDFDocumentTitle | Especifica que el título del documento, si está presente en las propiedades del documento, se muestra en la barra de título de la ventana del visor de PDF. | boolean | true
HideViewerMenubar | Especifica si se debe ocultar la barra de menú del visor de PDF cuando el documento esté activo. | boolean | false
HideViewerToolbar | Especifica si se debe ocultar la barra de herramientas del visor de PDF cuando el documento esté activo. | boolean | false
HideViewerWindowControls | Especifica si se ocultarán los controles del visor de PDF cuando el documento esté activo. | boolean | false
UseTransitionEffects | Especifica que las transiciones entre diapositivas se exporten al PDF. Esta opción está activa solamente si se van a almacenar documentos de Impress. | boolean | true
OpenBookmarkLevels | Especifica cuántos niveles de marcadores deben abrirse en la aplicación de lectura cuando se abra el PDF. Los valores posibles son: -1: todos los niveles de marcadores están abiertos 1–10: indica un nivel de marcadores (de 1 a 10) | long | -1

## Enlaces

Enlaces

Nombre | Descripción | Tipo | Valor predeterminado
--- | --- | --- | ---
ExportBookmarksToPDFDestination | Especifica que los marcadores contenidos en el archivo LibreOffice de origen deben exportarse al archivo PDF como destinos con nombre. | boolean | false
ConvertOOoTargetToPDFTarget | Especifica que los documentos de destino con extensión .od[tpgs] tendrán esa extensión cambiada a .pdf cuando el enlace se exporte a PDF. El documento de origen permanece intacto. | boolean | false
ExportLinksRelativeFsys | Especifica que los hiperenlaces relativos al sistema de archivos (protocolo file://) presentes en el documento se exporten en relación con la ubicación del documento de origen. | boolean | false
PDFViewSelection | Especifica la forma en que el usuario verá (experimentará) el PDF exportado. Los valores posibles son: 0: Especifica que el PDF se exportará con todos los enlaces externos al documento tratados como URI. Este es el valor predeterminado 1: Especifica que el PDF se exportará para poder verlo únicamente a través de un visor de PDF. Válido solo si no se exporta a PDF/A-1 (por ejemplo, SelectPdfVersion no configurado en 1). 2: Especifica que el PDF se exportará para poder verlo a través de un navegador de Internet, utilizando el complemento PDF que se proporciona con él. El marcador del URI se volverá compatible con el marcador de destino generado con la función de exportación de PDF de LibreOffice (consulte ExportBookmarksToPDFDestination). | long | 0

## Seguridad

Seguridad

Nombre | Descripción | Tipo | Valor predeterminado
--- | --- | --- | ---
EncryptFile | Si es verdadero, cifrará el documento PDF con una contraseña. El archivo PDF solo se puede abrir cuando el usuario ingresa la contraseña correcta. | boolean | false
DocumentOpenPassword | Esta es la contraseña que permite al usuario abrir el archivo PDF cuando EncryptFile está establecido en verdadero. | string |
RestrictPermissions | Si es verdadero, selecciona restringir algunos permisos. Los permisos se pueden cambiar solo cuando el usuario ingresa la contraseña correcta. | boolean | false
PermissionPassword | Esta es la contraseña que permite al usuario acceder a algunos permisos restringidos si RestrictPermissions se establece en verdadero. | string |
PreparedPasswords |  |  |
PreparedPermissionPassword |  | string |
Printing | Especifica qué impresiones se permiten. Los valores posibles son: 0: el documento no se puede imprimir. 1: el documento puede imprimirse solo en resolución baja. 2: El documento se puede imprimir a máxima resolución. | long | 2
Changes | Especifica los cambios que se pueden realizar en el documento. Los valores posibles son: 0: el documento no puede modificarse. 1: se permite insertar, eliminar y girar páginas. 2: se permite rellenar campos de formulario. 3: se permite tanto rellenar los campos de formulario como añadir comentarios. 4: se permiten todos los cambios de las selecciones anteriores, salvo la extracción (copia) de páginas. | long | 4
EnableCopyingOfContent | Especifica que las páginas y el contenido del documento se pueden extraer para utilizarlos en otros documentos (copiar y pegar). | boolean | true
EnableTextAccessForAccessibilityTools | Especifica que el contenido del documento se puede extraer para utilizarlo en aplicaciones de accesibilidad. | boolean | true

## Firma digital

Firmas digitales

Nombre | Descripción | Tipo | Valor predeterminado
--- | --- | --- | ---
SignPDF | Si es verdadero, firme el PDF. | boolean | false
SignatureLocation | Información adicional sobre la firma digital, ubicación del firmante. | string |
SignatureReason | Información adicional sobre la firma digital, motivo de la firma. | string |
SignatureContactInfo | Información adicional sobre la firma digital, datos de contacto del firmante. | string |
SignaturePassword | Contraseña del certificado | string |
SignatureCertificate |  |  |
SignCertificateSubjectName |  | string |
SignatureTSA | Durante el proceso de firma del PDF, se utilizará el URL de la autoridad de cronomarcación para obtener un cronomarcador firmado digitalmente que luego se incrustará en la firma. | string |

¡Necesitamos su ayuda!