[jakarta.ee-spec.committee] Asciidoctor PDF reference

[David Blevins <dblevins@xxxxxxxxxxxxx>]

I've got a TODO to send out a reference on how to use the Asciidoctor PDF plugin.  Here's an example ultimately taken from CDI:

 - https://github.com/eclipse/microprofile-jwt-auth/blob/master/spec/pom.xml#L45

Here's where you say what the "main" asciidoc file is:

 - https://github.com/eclipse/microprofile-jwt-auth/blob/master/spec/pom.xml#L87

This must be a file in src/main/asciidoc/.  This file typically is filled with includes and cover information:

 - https://raw.githubusercontent.com/eclipse/microprofile-jwt-auth/master/spec/src/main/asciidoc/microprofile-jwt-auth-spec.asciidoc

Here's how the spec looks in the end:

 - https://github.com/eclipse/microprofile-jwt-auth/releases/download/1.1.1/microprofile-jwt-auth-spec.pdf

Though we don't use it, you can actually supply a template the adds fancy covers and branding on the pages.

-- 

David Blevins

http://twitter.com/dblevins
http://www.tomitribe.com

310-633-3852