Hi,
Thanks from me too to Ivar, great piece of help ;)
Kind regards,
Arjan
On Mon, Mar 27, 2017 at 11:43 PM, Will Hopkins <will.hopkins_at_oracle.com>
wrote:
> Hi Ivar,
>
> I merged your PR and tried it out -- the PDF output looks much better, and
> title-page, TOC issues are fixed. Thanks! There are a few other issues I'd
> like to resolve, but won't be able to look at them for a little while; when
> I do, I may reach out to you again.
>
> Will
>
>
> On 03/19/2017 04:25 AM, Ivar Grimstad wrote:
>
> Hi Will,
>
> You should be able to add stuff on the first page. That's worked fine for
> me with the same setup and maven plugin.
>
> I have submitted a PR you can look at. It generates the pdf fine, but not
> sure if I got it right with the jboss jdocbook plugin. Haven't used that
> one before..
>
> https://github.com/javaee-security-spec/security-spec/pull/1
>
> Ivar
>
> On Sat, Mar 18, 2017 at 9:49 PM Will Hopkins <will.hopkins_at_oracle.com>
> wrote:
>
>> The plugin is the latest-but-one, I believe, and some of the limitations
>> were documented on the asciidoctor site. I have note yet tried vanilla
>> Asciidoc; it if works, that may be an option, although it does mean we'd
>> have to check asciidoc into our repositories or rely on manual steps to
>> build the spec.
>>
>>
>> Will
>>
>>
>> On 03/16/2017 01:38 PM, Werner Keil wrote:
>>
>> I'm not sure if it was exactly the same problem but also faced issues
>> with Asciidoctor in the past.
>> I know it may not be as comfortable as the Maven plugin, but if the
>> latest version of that plugin and Asciidoctor are used, did you try "low
>> level" Asciidoc to see if the problem persists?
>>
>> Werner
>>
>>
>> On Thu, Mar 16, 2017 at 6:28 PM, Will Hopkins <will.hopkins_at_oracle.com>
>> wrote:
>>
>> Hi All,
>>
>> As I was updating the spec for the EDR, I found myself wrestling a lot
>> with AsciiDoctor. It seems to do pretty well for HTML output, but it's got
>> a lot of problems with PDF. For example:
>>
>> - I couldn't find any way to get anything other than the title (e.g.,
>> author, date, version, etc.) onto the title page. The asciidoc
>> documentation says you should be able to put at least one line after the
>> title, for author/version, and that worked for HTML output, but not PDF
>> (and one line is not much).
>>
>>
>> - I couldn't find a good way to do front-matter, in particular for
>> the license page. It can't come before the ToC, and the ToC has problems
>> with it.
>>
>>
>> - Couldn't get "hard breaks" to work for the license text, no matter
>> which syntax I used (trailing "+", [hardbreaks], etc.). Had to resort to
>> putting blank lines between lines that should have been together, but with
>> hard breaks.
>>
>>
>> - The "Table of Contents" title didn't print for the ToC.
>>
>>
>> - Page numbering wasn't right (might be able to fix this). Seemed to
>> print a page number for the Title page.
>>
>>
>> - Would like to omit the blank pages it prints when the previous
>> section ends on an even page, since this will (probably) never be printed
>> as a physical book where left/right matters for page numbers.
>>
>> Take a look at the published EDR to see what I mean. Overall, I think the
>> PDF output is not good enough for final publication. Hopefully there are
>> ways to fix this -- maybe a different backend, or manually using asciidoc
>> instead of maven/asciidoctor, or maybe I'm just using the markup correctly
>> -- but we have to find some way to get better output.
>>
>> Suggestions welcome. ;)
>>
>> Will
>>
>> --
>> Will Hopkins | WebLogic Security Architect | +1.781.442.0310 <+1%20781-442-0310>
>> Oracle Application Development
>> 35 Network Drive, Burlington, MA 01803
>>
>>
>>
>> --
>> Will Hopkins | WebLogic Security Architect | +1.781.442.0310 <%28781%29%20442-0310>
>> Oracle Application Development
>> 35 Network Drive, Burlington, MA 01803
>>
>> --
>
> Java Champion, JCP EC/EG Member, JUG Leader
>
>
> --
> Will Hopkins | WebLogic Security Architect | +1.781.442.0310 <(781)%20442-0310>
> Oracle Application Development
> 35 Network Drive, Burlington, MA 01803
>
>