Giter Club home page Giter Club logo

Comments (3)

mojavelinux avatar mojavelinux commented on June 26, 2024 1

Here's what I'm thinking. /Producer can be overridden using the producer attribute, but will default to the Asciidoctor PDF credit line. /Creator can be overridden using the publisher attribute, but will default to the author. (Here I'm remapping the publisher attribute to /Creator instead of /Producer per the description in the PDF specification).

(We always have to populate both fields or Prawn will fill them in with the text "Prawn").

from asciidoctor-pdf.

mojavelinux avatar mojavelinux commented on June 26, 2024

Here are the definitions of these fields according to the PDF specification:

  • /Creator (Optional) If the document was converted to PDF from another format, the name of the conforming product that created the original document from which it was converted.
  • /Producer (Optional) If the document was converted to PDF from another format, the name of the conforming product that converted it to PDF.

It would seem as though the Creator is for whatever product created the AsciiDoc (if relevant) and the Producer is for whatever product generated/produced the PDF (in this case Asciidoctor PDF + Prawn).

I would agree that Producer should be the Asciidoctor PDF credit.

Note that the Producer field can be overridden using the publisher attribute, which was requested/required by one of the users of Asciidoctor PDF long ago. (I think I'll add producer as a fallback just for completeness).

For Creator, I'm not sure. I think perhaps we should default that field to the author, but still allow it to be overridden using the creator attribute.

from asciidoctor-pdf.

mojavelinux avatar mojavelinux commented on June 26, 2024

/Creator can be overridden using the publisher attribute

I sure wish there was a /Publisher field, but there just isn't (and most PDF readers don't show custom fields). So publisher → /Creator just has to mean what the author wants it to mean. What's important is that now you'll have control over both fields, which is the key focus here in my mind.

from asciidoctor-pdf.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.