Parametry CLI PDF

Spis treści

# Parametry linii poleceń eksportu PDF

Filtr PDF akceptuje ciąg opcji zawierających właściwości PDF eksportu.

## Przykłady:

#### Wiersz poleceń CMD systemu Windows

Podwójne cudzysłowy w ciągu parametrów muszą zostać ujęte w znaki ucieczki (\").

Aby wyeksportować strony od 2 do 5 dokumentu programu 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

Aby dodać kafelkowy znak wodny:

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

Aby zaszyfrować plik:

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

Aby ustawić wersję 1.5 (zamiast domyślnej 1.7):

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

#### PowerShell systemu Windows

Ciąg parametrów musi być ujęty w pojedyncze cudzysłowy, aby umożliwić analizę podwójnych cudzysłowów. Znak ampersand (&) jest znany jako operator wywołania. Służy do wykonywania polecenia, bloku skryptu lub funkcji zapisanej w zmiennej lub ciągu.

Aby wyeksportować strony od 2 do 5 dokumentu programu 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

Aby dodać kafelkowy znak wodny:

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

Aby zaszyfrować plik:

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

Aby ustawić wersję 1.5 (zamiast domyślnej 1.7):

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

#### Linux (BASH) i MacOS (ZSH)

Aby wyeksportować strony od 2 do 5 dokumentu programu Writer:

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

Aby dodać kafelkowy znak wodny:

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

Aby zaszyfrować plik:

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

Aby ustawić wersję 1.5 (zamiast domyślnej 1.7):

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

## Indeks

Właściwości ogólne

Widok początkowy

Interfejs użytkownika

Łącza

Bezpieczeństwo

Podpis cyfrowy

## Właściwości ogólne

Ogólne

Nazwa | Opis | Typ | Wartość domyślna
--- | --- | --- | ---
PageRange | Jeśli ta właściwość jest ustawiona, wskazuje zakres stron do wyeksportowania. Aby wyeksportować wszystkie strony, pozostaw tę właściwość nieskonfigurowaną. Aby wyeksportować zaznaczenie, pozostaw tę właściwość nieustawioną i ustaw tylko właściwość Zaznaczenie. | string | Puste (wszystkie strony są eksportowane)
Selection | Dowolne odpowiadające bieżącemu zaznaczeniu w dokumencie. | Any |
UseLosslessCompression | Określa, czy obrazy są eksportowane do formatu PDF przy użyciu formatu kompresji bezstratnej, takiego jak PNG, czy kompresowane przy użyciu formatu JPEG. | boolean | false
Quality | Określa jakość eksportu JPG. Wyższa wartość zapewnia wyższą jakość obrazu i większy plik. Minimalna wartość łączna: 1. reprezentuje najniższą wartość, którą można użyć. Im niższa wartość, tym gorsza jakość obrazu i mniejszy rozmiar pliku. Maksymalna wartość łączna: 100. reprezentuje najwyższą wartość, którą można użyć. Im wyższa wartość, tym lepsza jakość obrazu i większy rozmiar pliku. | long | 90
ReduceImageResolution | Określa, czy rozdzielczość każdego obrazu jest zmniejszana do rozdzielczości określonej przez właściwość MaxImageResolution. | boolean | false
MaxImageResolution | Jeśli właściwość ReduceImageResolution jest ustawiona na "true", wszystkie obrazy zostaną zmniejszone do podanej wartości w dpi. Możliwe wartości to: 75, 150, 300, 600 i 1200. | long | 300
SelectPdfVersion | Określa wersję PDF do wyemitowania. Możliwe wartości to: 0: PDF 1.7 (wybór domyślny). 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 | Tworzy plik PDF z dostępnością, który spełnia wymagania specyfikacji PDF/UA (ISO 14289). | boolean | false
UseTaggedPDF | Określa, czy pliki PDF są tworzone przy użyciu specjalnych znaczników dostępności. | boolean | false
ExportFormFields | Określa, czy pola formularzy są eksportowane jako widżety, czy eksportowana jest tylko ich stała reprezentacja w postaci wydruku. | boolean | true
FormsType | Określa format wysyłania formularza PDF. Możliwe wartości to: 0: Określa, że używany jest typ formularza FDF. 1: Określa, że używany jest formularz typu PDF. 2: Określa, że używany jest typ formularza HTML. 3: Określa, że używany jest typ formularzy XML. | long | 0
AllowDuplicateFieldNames | Określa, czy wiele eksportowanych pól formularza może mieć tę samą nazwę pola. | boolean | false
ExportBookmarks | Określa, czy zakładki są eksportowane do formatu PDF. | boolean | true
ExportPlaceholders | Eksportuj tylko oznaczenia wizualne pól symboli zastępczych. Wyeksportowany symbol zastępczy jest nieskuteczny. | boolean | false
ExportNotes | Określa, czy notatki są eksportowane do formatu PDF. | boolean | false
ExportNotesPages | Określa, czy strony notatek są eksportowane do formatu PDF. (Strony notatek są dostępne tylko w dokumentach Impress). | boolean | false
ExportOnlyNotesPages | Jeśli właściwość ExportNotesPages jest ustawiona na wartość true, określa, czy do formatu PDF eksportowane są tylko strony notatek. | boolean | false
ExportNotesInMargin | Określa, czy notatki na marginesie są eksportowane do pliku PDF. | boolean | false
ExportHiddenSlides | W przypadku programu LibreOffice Impress eksportuje slajdy nieuwzględnione w pokazach slajdów. | boolean | false
IsSkipEmptyPages | Określa, że automatycznie wstawiane puste strony są pomijane. Ta opcja jest aktywna tylko w przypadku przechowywania dokumentów programu Writer. | boolean | false
EmbedStandardFonts | Określa, czy osadzić 14 standardowych czcionek PDF, czy nie. | boolean | false
IsAddStream | Określa, że do pliku PDF zawierającego oryginalny dokument zostanie wstawiony strumień w celu archiwizacji. | boolean | false
Watermark | Określa tekst znaku wodnego, który ma zostać narysowany na każdej stronie eksportowanego pliku PDF. | string | (empty)
WatermarkColor | Określa kolor tekstu znaku wodnego | long | 8388223 (light green)
WatermarkFontHeight | Określa wysokość czcionki tekstu znaku wodnego. | long |
WatermarkRotateAngle | Określa kąt tekstu znaku wodnego. | long |
WatermarkFontName | Określa nazwę czcionki tekstu znaku wodnego. | string | Helvetica
TiledWatermark | Określa kafelkowy tekst znaku wodnego. | string |
UseReferenceXObject | Gdy opcja jest włączona, wtedy używany jest znacznik odniesienia XObject: jest to prosta operacja, ale przeglądarki muszą obsługiwać ten znacznik, aby wyświetlać obrazy wektorowe. W przeciwnym razie w przeglądarce zostanie wyświetlona awaryjna bitmapa. | boolean | false
IsRedactMode |  | boolean | false
SinglePageSheets | Ignoruje rozmiar papieru każdego arkusza, zakresy druku oraz stan pokazywania/ukrywania i umieszcza każdy arkusz (nawet ukryte arkusze) dokładnie na jednej stronie. | boolean | false

## Widok początkowy

Widok początkowy

Nazwa | Opis | Typ | Wartość domyślna
--- | --- | --- | ---
InitialView | Określa sposób wyświetlania dokumentu PDF po otwarciu. Możliwe wartości to: 0: Wybierz domyślny tryb przeglądarki, bez konspektów i miniatur. 1: Dokument jest otwierany z otwartym panelem konspektu 2: Dokument jest otwierany z otwartym panelem miniatur | long | 0
InitialPage | Określa stronę, na której dokument PDF powinien zostać otwarty w przeglądarce. | long | 1
Magnification | Określa akcję, która ma zostać wykonana po otwarciu dokumentu PDF. Możliwe wartości to: 0: Otwiera z domyślnym powiększeniem. 1: Otwiera w powiększeniu, aby zmieścić całą stronę w oknie. 2: Otwiera w powiększeniu, aby dopasować całą szerokość strony w oknie. 3: Otwiera w powiększeniu, aby zmieścić na całej szerokości ramki ograniczającej w oknie (obcina marginesy). 4: Otwiera z poziomem powiększenia określonym we właściwości Powiększenie. | long | 0
Zoom | Określa poziom powiększenia, z jakim otwierany jest dokument PDF. Obowiązuje tylko wtedy, gdy Powiększenie jest ustawione na „4”. | long | 100
PageLayout | Określa układ strony, który ma być używany po otwarciu dokumentu. Możliwe wartości to: 0: Wyświetlaj strony zgodnie z konfiguracją czytnika. 1: Wyświetlaj jedną stronę na raz. 2: Wyświetlaj strony w jednej kolumnie. 3: Wyświetlaj strony w dwóch kolumnach stron nieparzystych po prawej stronie, aby strony nieparzyste znajdowały się po lewej stronie, należy również użyć właściwości FirstPageOnLeft. | long | 0
FirstPageOnLeft | Używany z wartością 3 powyższej właściwości PageLayout, "true", jeśli pierwsza strona (nieparzysta) powinna znajdować się po lewej stronie ekranu. | boolean | false

## Interfejs użytkownika

Interfejs użytkownika

Nazwa | Opis | Typ | Wartość domyślna
--- | --- | --- | ---
ResizeWindowToInitialPage | Określa, że po otwarciu dokumentu zostanie otwarte okno przeglądarki plików PDF, pokazujące całą stronę początkową. | boolean | false
CenterWindow | Określa, że okno przeglądarki PDF jest wyśrodkowane względem ekranu, gdy dokument PDF jest otwierany. | boolean | false
OpenInFullScreenMode | Określa, że okno przeglądarki PDF jest otwierane na pełnym ekranie, na wierzchu wszystkich okien. | boolean | false
DisplayPDFDocumentTitle | Określa, że tytuł dokumentu, jeśli jest obecny we właściwościach dokumentu, jest wyświetlany na pasku tytułu okna przeglądarki PDF. | boolean | true
HideViewerMenubar | Określa, czy ukryć pasek menu przeglądarki PDF, gdy dokument jest aktywny. | boolean | false
HideViewerToolbar | Określa, czy ukryć pasek narzędzi przeglądarki PDF, gdy dokument jest aktywny. | boolean | false
HideViewerWindowControls | Określa, czy ukryć elementy sterujące przeglądarki PDF, gdy dokument jest aktywny. | boolean | false
UseTransitionEffects | Określa, czy przejścia slajdów są eksportowane do formatu PDF. Ta opcja jest aktywna tylko w przypadku przechowywania dokumentów Impress. | boolean | true
OpenBookmarkLevels | Określa, ile poziomów zakładek ma być otwartych w aplikacji czytnika podczas otwierania pliku PDF. Możliwe wartości to: -1: otwierane są wszystkie poziomy zakładek 1–10: wskaż poziom zakładki (od 1 do 10) | long | -1

## Łącza

Łącza

Nazwa | Opis | Typ | Wartość domyślna
--- | --- | --- | ---
ExportBookmarksToPDFDestination | Określa, że zakładki zawarte w źródłowym pliku LibreOffice powinny zostać wyeksportowane do pliku PDF jako nazwane miejsce docelowe. | boolean | false
ConvertOOoTargetToPDFTarget | Określa, że dokumenty docelowe z rozszerzeniem .od[tpgs] zostaną zmienione na .pdf po wyeksportowaniu łącza do formatu PDF. Dokument źródłowy pozostaje nietknięty. | boolean | false
ExportLinksRelativeFsys | Określa, że obecne w dokumencie hiperłącza związane z systemem plików (protokół file://) zostaną wyeksportowane względem lokalizacji dokumentu źródłowego. | boolean | false
PDFViewSelection | Określa sposób, w jaki wyeksportowany plik PDF będzie oglądany (doświadczany) przez użytkownika. Możliwe wartości to: 0: Określa, że plik PDF zostanie wyeksportowany ze wszystkimi łączami zewnętrznie do dokumentu traktowanego jako URI. To jest ustawienie domyślne. 1: Określa, że plik PDF zostanie wyeksportowany w celu przeglądania tylko w aplikacji do odczytu plików PDF. Obowiązuje tylko wtedy, gdy nie jest eksportowany do formatu PDF/A-1 (np. SelectPdfVersion nie ustawiono na 1). 2: Określa, że plik PDF zostanie wyeksportowany w celu wyświetlenia go w przeglądarce internetowej przy użyciu dostarczonej z nim wtyczki PDF. Zakładka identyfikatora URI będzie zgodna z docelową zakładką wygenerowaną za pomocą funkcji eksportu PDF LibreOffice (patrz ExportBookmarksToPDFDestination). | long | 0

## Bezpieczeństwo

Bezpieczeństwo

Nazwa | Opis | Typ | Wartość domyślna
--- | --- | --- | ---
EncryptFile | Jeśli wartość "true", wybiera szyfrowanie dokumentu PDF za pomocą hasła. Plik PDF można otworzyć tylko wtedy, gdy użytkownik wprowadzi prawidłowe hasło. | boolean | false
DocumentOpenPassword | Jest to hasło, które pozwala użytkownikowi otworzyć plik PDF, gdy EncryptFile ma wartość "true". | string |
RestrictPermissions | Jeśli wartość "true", wybiera ograniczenie niektórych uprawnień. Uprawnienia można zmienić tylko wtedy, gdy użytkownik wprowadzi prawidłowe hasło. | boolean | false
PermissionPassword | Jest to hasło, które umożliwia użytkownikowi dostęp do niektórych ograniczonych uprawnień, jeśli właściwość RestrictPermissions jest ustawiona na wartość "true". | string |
PreparedPasswords |  |  |
PreparedPermissionPassword |  | string |
Printing | Określa, jakie drukowanie jest dozwolone. Możliwe wartości to: 0: Nie można wydrukować dokumentu. 1: Dokument można wydrukować tylko w niskiej rozdzielczości. 2: Dokument można wydrukować z maksymalną rozdzielczością. | long | 2
Changes | Określa zmiany, które można wprowadzić w dokumencie. Możliwe wartości to: 0: Dokument nie może być zmieniony. 1: Dozwolone jest wstawianie, usuwanie i obracanie stron. 2: Wypełnienie pola formularza jest dozwolone. 3: Dozwolone jest zarówno wypełnianie pola formularza, jak i komentowanie. 4: Dozwolone są wszystkie zmiany poprzednich wyborów, z wyjątkiem wyodrębniania stron (kopiowania). | long | 4
EnableCopyingOfContent | Określa, że strony i zawartość dokumentu można wyodrębnić w celu użycia w innych dokumentach (kopiuj i wklej). | boolean | true
EnableTextAccessForAccessibilityTools | Określa, że zawartość dokumentu można wyodrębnić w celu użycia w aplikacjach dostępności. | boolean | true

## Podpis cyfrowy

Podpisy cyfrowe

Nazwa | Opis | Typ | Wartość domyślna
--- | --- | --- | ---
SignPDF | Jeśli wartość "true", podpisz plik PDF. | boolean | false
SignatureLocation | Dodatkowe informacje o podpisie cyfrowym, lokalizacji sygnatariusza. | string |
SignatureReason | Dodatkowe informacje o podpisie cyfrowym, powód podpisu. | string |
SignatureContactInfo | Dodatkowe informacje o podpisie cyfrowym, dane kontaktowe sygnatariusza. | string |
SignaturePassword | Hasło certyfikatu | string |
SignatureCertificate |  |  |
SignCertificateSubjectName |  | string |
SignatureTSA | Podczas procesu podpisywania pliku PDF adres URL Urzędu Znacznika Czasu zostanie użyty do uzyskania podpisanej cyfrowo sygnatury czasowej, która jest następnie osadzona w podpisie. | string |

Prosimy o wsparcie!