diff --git a/docs/configuration.mdx b/docs/configuration.mdx index 878a7b8..32871e4 100644 --- a/docs/configuration.mdx +++ b/docs/configuration.mdx @@ -15,7 +15,8 @@ The following flags allow you to configure the API module: | Flag | Description | Default | | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | --------------- | | --api-port | Set the port on which the API should listen. | 3000 | -| --api-port-from-env | Set the environment variable with the port on which the API should listen - override the default port. | None | +| --api-port-from-env | Set the environment variable with the port on which the API should listen - override the default port. | None | +| --api-start-timeout | Set the time limit for the API to start. | 30s | | --api-timeout | Set the time limit for requests. | 30s | | --api-root-path | Set the root path of the API - for service discovery via URL paths. | / | | --api-trace-header | Set the header name to use for identifying requests. | Gotenberg-Trace | @@ -45,7 +46,7 @@ The following flags allow you to configure the Chromium module: | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | | --chromium-restart-after | Number of conversions after which Chromium will automatically restart. Set to 0 to disable this feature. | 0 | | --chromium-auto-start | Automatically launch Chromium upon initialization if set to true; otherwise, Chromium will start at the time of the first conversion. | false | -| --chromium-start-timeout | Maximum duration to wait for Chromium to start or restart. | 10s | +| --chromium-start-timeout | Maximum duration to wait for Chromium to start or restart. | 20s | | --chromium-allow-file-access-from-files | Allow file:// URIs to read other file:// URIs. | false | | --chromium-allow-insecure-localhost | Ignore TLS/SSL errors on localhost. | false | | --chromium-allow-list | Set the allowed URLs for Chromium using a regular expression. | All | @@ -74,7 +75,7 @@ The following flags allow you to configure the LibreOffice module: | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | --libreoffice-restart-after | Number of conversions after which LibreOffice will automatically restart. Set to 0 to disable this feature. | 10 | | --libreoffice-auto-start | Automatically launch LibreOffice upon initialization if set to true; otherwise, LibreOffice will start at the time of the first conversion. | false | -| --libreoffice-start-timeout | Maximum duration to wait for LibreOffice to start or restart. | 10s | +| --libreoffice-start-timeout | Maximum duration to wait for LibreOffice to start or restart. | 20s | | --libreoffice-disable-routes | Disable the route. | false | ### Switch Language diff --git a/docs/routes.mdx b/docs/routes.mdx index d92f118..9ca4075 100644 --- a/docs/routes.mdx +++ b/docs/routes.mdx @@ -745,7 +745,7 @@ Each route accepts the following form fields: At present, the following PDF/A formats are available: -* `PDF/A-1a` +* `PDF/A-1b` * `PDF/A-2b` * `PDF/A-3b` @@ -761,7 +761,7 @@ values={[ curl \ --request POST 'http://localhost:3000/forms/chromium/convert/url' \ --form 'url="https://my.url"' \ ---form 'pdfa="PDF/A-1a"' \ +--form 'pdfa="PDF/A-1b"' \ --form 'pdfua="true' \ -o my.pdf ``` @@ -1025,7 +1025,7 @@ The route also accepts the following form fields: At present, the following PDF/A formats are available: -* `PDF/A-1a` +* `PDF/A-1b` * `PDF/A-2b` * `PDF/A-3b` @@ -1041,7 +1041,7 @@ values={[ curl \ --request POST 'http://localhost:3000/forms/libreoffice/convert' \ --form 'files=@"/path/to/file.docx"' \ ---form 'pdfa="PDF/A-1a"' \ +--form 'pdfa="PDF/A-1b"' \ --form 'pdfua="true"' \ -o my.pdf ``` @@ -1069,7 +1069,7 @@ Note that at least one of the form field must be provided.\* At present, the following PDF/A formats are available: -* `PDF/A-1a` +* `PDF/A-1b` * `PDF/A-2b` * `PDF/A-3b` @@ -1085,7 +1085,7 @@ values={[ curl \ --request POST 'http://localhost:3000/forms/pdfengines/convert' \ --form 'files=@"/path/to/pdf.pdf"' \ ---form 'pdfa="PDF/A-1a"' \ +--form 'pdfa="PDF/A-1b"' \ --form 'pdfua="true"' \ -o my.pdf ``` @@ -1108,7 +1108,7 @@ curl \ --form 'files=@"/path/to/pdf2.pdf"' \ --form 'files=@"/path/to/pdf3.pdf"' \ --form 'files=@"/path/to/pdf4.pdf"' \ ---form 'pdfa="PDF/A-1a"' \ +--form 'pdfa="PDF/A-1b"' \ --form 'pdfua="true"' \ -o my.zip ``` @@ -1180,7 +1180,7 @@ POST /forms/pdfengines/merge At present, the following PDF/A formats are available: -* `PDF/A-1a` +* `PDF/A-1b` * `PDF/A-2b` * `PDF/A-3b` diff --git a/docs/troubleshooting.mdx b/docs/troubleshooting.mdx index 7c3fec7..ac24dff 100644 --- a/docs/troubleshooting.mdx +++ b/docs/troubleshooting.mdx @@ -37,11 +37,17 @@ If you are experiencing timeouts (i.e., *503 Service Unavailable*), consider the ## LibreOffice -### Filenames with Non-Latin Characters +### PDF/A-1a -Ensure that filenames are encoded in *UTF-8*. +Beginning with version 7.6, LibreOffice has discontinued support for `PDF/A-1a`. -For additional details, refer to issue [#427](https://github.com/gotenberg/gotenberg/issues/427). +Previously, LibreOffice claimed to generate `PDF/A-1a` files, a claim that held true for straightforward documents. +However, in many instances, the software was actually producing `PDF/A-1b` files. + +Due to specific metadata, some validators incorrectly identified these documents as compliant with `PDF/A-1a` standards, +despite this not being the case. + +For additional details, refer to this LibreOffice [commit](https://git.libreoffice.org/core/+/c4b12d06698402984b3ffdbd2c139f261fa35ca1%5E%21). ### Internal Server Error diff --git a/src/components/Highlights.js b/src/components/Highlights.js index 7d977b3..7559620 100644 --- a/src/components/Highlights.js +++ b/src/components/Highlights.js @@ -22,7 +22,7 @@ curl \\ --form 'files=@"/path/to/file.docx"' \\ --form 'files=@"/path/to/file.xlsx"' \\ --form 'merge="true"' \\ ---form 'pdfa="PDF/A-1a"' \\ +--form 'pdfa="PDF/A-1b"' \\ -o my.pdf `;