users@javaee-security-spec.java.net

[javaee-security-spec users] [jsr375-experts] Re: AsciiDoctor Problems

From: Ivar Grimstad <ivar.grimstad_at_gmail.com>
Date: Tue, 28 Mar 2017 07:04:38 +0000

Glad to help :)

Ivar

On Tue, Mar 28, 2017 at 12:26 AM arjan tijms <arjan.tijms_at_gmail.com> wrote:

> 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
>
>
> --

Java Champion, JCP EC/EG Member, JUG Leader