Asciidoctor :: Discussion

AsciiDoctor PDF: Setting PDF metadata Description field from the adoc file

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

4 messages Options

jamesh

Apr 23, 2021; 5:11pm

AsciiDoctor PDF: Setting PDF metadata Description field from the adoc file

Hello all,

Finding AD PDF very useful in our documentation efforts, but have a question on setting PDF metadata.

I can set author, keywords and the title is set to the title of the document which is fine, but I have been unable to find a way of setting the Description field directly from the adoc (I can post process with exiftool or similar but that is a PITA), and it would also be useful to be able to set the Producer etc.

I may have just missed this in the documentations, but my google foo hasn't found anything, so any pointers welcome

James

mojavelinux

Apr 23, 2021; 5:21pm

Re: AsciiDoctor PDF: Setting PDF metadata Description field from the adoc file

Administrator

James,

I'm glad to hear the PDF converter is useful in your documentation efforts!

Here's the metadata that Asciidoctor PDF adds to the PDF:

https://github.com/asciidoctor/asciidoctor-pdf/blob/2ea25e8c353197301750e423d0d65ce27f0b93f1/lib/asciidoctor/pdf/converter.rb#L573-L598

Notice that the Producer field is set to match the author specified on the document.

The description attribute is not currently mapped. In reading the PDF 1.7 specification, I do not see a field that could accept this information. If you know of one, please enlighten me and I'd be happy to consider adding it.

Best Regards,

-Dan

On Fri, Apr 23, 2021 at 11:11 AM jamesh [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hello all,

Finding AD PDF very useful in our documentation efforts, but have a question on setting PDF metadata.

I can set author, keywords and the title is set to the title of the document which is fine, but I have been unable to find a way of setting the Description field directly from the adoc (I can post process with exiftool or similar but that is a PITA), and it would also be useful to be able to set the Producer etc.

I may have just missed this in the documentations, but my google foo hasn't found anything, so any pointers welcome

James

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/AsciiDoctor-PDF-Setting-PDF-metadata-Description-field-from-the-adoc-file-tp8594.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

Dan Allen (he, him, his) | @mojavelinux | https://twitter.com/mojavelinux

jamesh

Apr 23, 2021; 5:30pm

Re: AsciiDoctor PDF: Setting PDF metadata Description field from the adoc file

Thanks for the rapid response.

I was able to set a description field using EXIFTool (on Ubuntu) as follows:

exiftool -Description="Testing description metadata" fred.pdf

This is then displayed if you:

exiftool fred.pdf

But I have just noticed its not part of the properties displayed when I use qpdfview, so that's started to make me wonder.

Hmmm

James

jamesh

Apr 26, 2021; 7:49am

Re: AsciiDoctor PDF: Setting PDF metadata Description field from the adoc file

Ah, although exiftool allows you to set a field called Description, it doesn't appear to be a standard option. That threw me in the wrong direction.

There is however "Subject", as pointed to be the code link above, which does what I need so thanks for the pointer!

James