Skip to content

Commit 31e0491

Browse files
committed
docs: note exportFormFields fixes font clipping (#45)
1 parent b17e0c9 commit 31e0491

2 files changed

Lines changed: 3 additions & 0 deletions

File tree

docs/convert-with-libreoffice/convert-to-pdf.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -331,6 +331,8 @@ curl \\
331331

332332
Set `exportFormFields` to `false` to prevent LibreOffice from creating interactive PDF widgets, effectively flattening them during conversion. Faster than post-processing.
333333

334+
This also fixes clipping when form fields reference fonts that aren't embedded: LibreOffice sizes the widget boxes with a fallback font, so they come out too small. Flattening removes the widgets and the mismatch.
335+
334336
<ApiEndpoint
335337
formFields={[
336338
{

docs/troubleshooting.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,7 @@ Since _8.33.0_, Gotenberg tolerates one transient probe failure and briefly cach
8484

8585
- **Missing Fonts:** LibreOffice relies on installed system fonts to calculate page breaks and layout. If your document uses a font not present in the container, LibreOffice will substitute it, causing shifted layouts. Install the required fonts via a custom Dockerfile (see [Fonts configuration](configuration#fonts)).
8686
- **After upgrading to 8.30.0:** The font stack was simplified from 30+ packages to 8. Documents relying on Microsoft Core Fonts (Arial, Times New Roman, Calibri) now use metric-compatible replacements. If you notice layout differences after upgrading, install `ttf-mscorefonts-installer` or the specific script fonts your documents need (see [Fonts configuration](configuration#installing-additional-fonts)).
87+
- **Clipped Form Field Text:** When form fields reference fonts that aren't embedded, LibreOffice sizes the widget boxes with a fallback font, making them too small and clipping the text. Set `exportFormFields=false` to flatten the fields and remove the mismatch (see [Native Flattening](convert-with-libreoffice/convert-to-pdf#native-flattening-libreoffice)).
8788

8889
### Linked Images Missing After 8.34.0
8990

0 commit comments

Comments
 (0)