Bug 147105 - Document the various new PDF export options in command-line
Summary: Document the various new PDF export options in command-line
Status: RESOLVED FIXED
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
7.4.0.0 alpha0+
Hardware: All All
: medium normal
Assignee: Not Assigned
URL:
Whiteboard: target:7.6.0 target:24.2.0
Keywords:
: 147387 (view as bug list)
Depends on:
Blocks: HelpGaps-NewFeatures Commandline
  Show dependency treegraph
 
Reported: 2022-02-01 07:53 UTC by Miklos Vajna
Modified: 2024-05-03 14:12 UTC (History)
3 users (show)

See Also:
Crash report or crash signature:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Miklos Vajna 2022-02-01 07:53:03 UTC
Since https://gerrit.libreoffice.org/c/core/+/128849, the PDF export options on master can be also set from the cmdline. We have a rich set of PDF export options, which were only available to extensions/macros previously. The commit message contains some examples, but the full set of options is available in filter/source/pdf/pdfexport.cxx.

It would be nice to document these, similar to how the CSV export options are documented in

https://help.libreoffice.org/7.4/en-US/text/shared/guide/start_parameters.html

and

https://help.libreoffice.org/7.4/en-US/text/shared/guide/csv_params.html
Comment 1 Mike Kaganski 2022-02-12 08:15:19 UTC
*** Bug 147387 has been marked as a duplicate of this bug. ***
Comment 2 Olivier Hallot 2022-02-19 16:18:42 UTC
In the example from the patch message, 

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

can you give the source of information for pdf filter parameters (e.g. "PageRange", ...) above?

Users will surely ask for all available options.
Comment 3 Miklos Vajna 2022-02-21 07:47:26 UTC
The source code has the list of all possible option names:

https://github.com/libreoffice/core/blob/62a8580587aec1c1a3070448b063889c01ac5c11/filter/source/pdf/pdfexport.cxx#L491-L618

There is also some info in the old wiki at:

https://wiki.openoffice.org/wiki/API/Tutorials/PDF_export#General_properties

My expectation is that the "string", "long"/"short" and "boolean" types are what you are able to specify from convert-to.
Comment 4 Commit Notification 2023-04-22 10:21:00 UTC
Olivier Hallot committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/8c0b0a8e0aad857b7089883f7c4fabbe8d9d64de

tdf#147105 Document the various new PDF export options in command-line
Comment 5 Olivier Hallot 2023-04-22 11:35:46 UTC
The Help page needs more work, some export options are not well documented.

https://help.libreoffice.org/master/en-US/text/shared/guide/pdf_params.html

Help is appreciated.

PreparedPasswords
PreparedPermissionPassword
SignatureCertificate
SignCertificateSubjectName
Comment 6 Commit Notification 2023-05-02 11:55:19 UTC
Olivier Hallot committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/8526bfa2d6570e05906ab96b195dc1c773a734d7

tdf#147105 Fix inconsistencies in pdf param descriptions
Comment 7 Mike Kaganski 2023-08-14 15:18:36 UTC
(In reply to Olivier Hallot from comment #5)

SinglePageSheets is also undocumented; it is about this feature: https://wiki.documentfoundation.org/ReleaseNotes/6.4#Full-Sheet_Previews
Comment 9 Commit Notification 2023-08-31 19:21:20 UTC
Olivier Hallot committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/d686d91fb8d108c8283dd8d9f537224ed43ac6ac

tdf#147105 More PDF export param documented