feat: Add LibreOffice PDF Viewer Preferences fields (Gotenberg v8.29.0)

[jprivet-dev]

Description

Gotenberg v8.29.0 introduced 15 new form fields for controlling PDF viewer behavior in the LibreOffice route.

These fields should be exposed in LibreOfficePdfBuilder.

New fields

Field	Type	Default	Description
initialView	integer	0	Initial view when opening the PDF. 0: neither document outline nor thumbnails. 1: document outline visible. 2: thumbnail images visible.
initialPage	integer	1	The page on which the PDF opens.
magnification	integer	0	Initial magnification level. 0: default. 1: fit page. 2: fit width. 3: fit visible. 4: use zoom value.
zoom	integer	100	Initial zoom percentage when magnification is set to 4.
pageLayout	integer	0	Page layout. 0: default. 1: single page. 2: one column. 3: two columns.
firstPageOnLeft	boolean	false	Place the first page on the left when using two-column page layout.
resizeWindowToInitialPage	boolean	false	Resize the viewer window to the size of the first page.
centerWindow	boolean	false	Center the viewer window on the screen.
openInFullScreenMode	boolean	false	Open the PDF in full-screen mode.
displayPDFDocumentTitle	boolean	true	Display the document title in the viewer title bar instead of the filename.
hideViewerMenubar	boolean	false	Hide the viewer menu bar.
hideViewerToolbar	boolean	false	Hide the viewer toolbar.
hideViewerWindowControls	boolean	false	Hide the viewer window controls.
useTransitionEffects	boolean	true	Use transition effects when advancing slides in Impress presentations.
openBookmarkLevels	integer	-1	Number of bookmark levels to show when opening the PDF. -1 shows all levels.

Source: https://gotenberg.dev/docs/convert-with-libreoffice/convert-to-pdf#pdf-viewer-preferences

References

• Gotenberg v8.29.0 release
• Gotenberg issue #1316

[jprivet-dev]

I'll take care of that!

[Neirda24]

When it is a fixed set of values (initialView, magnification, ...) prefer the use of enum. Unless you think it may change to a user defined value, Enums are appropriate.

"zoom" requires two kinds of verification. between 1 and 100 and only if magnification = 4.

Thank you for working on this.