Asciidoctor :: Discussion

Renderer to PDF

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

3 messages Options

ggrossetie

Renderer to PDF

Hi,

I think that rendering an AsciiDoc file to PDF should be simpler. The only way to achieve this (I hope I didn't miss something on the documentation) is to use fopub. Don't get me wrong fopub is really great but you need to:
- clone a GitHub repository,
- have a JRE,
- configure your enterprise firewall (to be able to download Gradle)
- and write some commands lines

For a developer this is OK but I want to promote Asciidoctor to non-developer.

What do you think about some automation to be able to render pdf with the asciidoctor cli ?

The command, asciidoctor -b pdf mysample.adoc, should take care of all the details. For example we can automatically convert to docbook then to pdf with fopub ? or add pdfkit[1] to renderer to html5 + css then to pdf ?

What do you think ?

[1] https://github.com/pdfkit/pdfkit

LightGuardjp

Re: Renderer to PDF

We've looked at a lot of options for building PDFs, and surprisingly there isn't really a simple solution anywhere. The majority of options are to take existing DocBook and convert that to PDF via xsl:fo or convert the DocBook to latex then convert the latex to PDF.

There isn't a clean solution for AsciiDoc to PDF yet. Fopub is basically a stopgap. The more longterm solution is probably going to be http://prawn.majesticseacreature.com[Prawn]. However, to get that to the same level as our current style sheets is certainly going to take time.

You're more than welcome to use other options if something fits your organization better. For example, loading the HTML in chrome and doing a print as PDF would probably work just as well for people as fopub.

Part of asciidoctor core is keeping it lite and hopefully zero dependencies for many things (obviously you need some dependencies for highlighting or other backends). I imagine PDF will be the same, unless we decide to make prawn an optional dependency for PDF. I'm not really sure what the thinking is on that one.

—
Sent from Mailbox for iPhone

On Sat, Nov 30, 2013 at 11:36 AM, ggrossetie [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hi,

I think that rendering an AsciiDoc file to PDF should be simpler. The only way to achieve this (I hope I didn't miss something on the documentation) is to use fopub. Don't get me wrong fopub is really great but you need to:
- clone a GitHub repository,
- have a JRE,
- configure your enterprise firewall (to be able to download Gradle)
- and write some commands lines

For a developer this is OK but I want to promote Asciidoctor to non-developer.

What do you think about some automation to be able to render pdf with the asciidoctor cli ?

The command, asciidoctor -b pdf mysample.adoc, should take care of all the details. For example we can automatically convert to docbook then to pdf with fopub ? or add pdfkit[1] to renderer to html5 + css then to pdf ?

What do you think ?

[1] https://github.com/pdfkit/pdfkit

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Renderer-to-PDF-tp1162.html

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

mgreau

Re: Renderer to PDF

Hi,

There is a thread on this forum about PDF creation [1] which list differents solutions.
On my side I will take a look at flyingsaucer [2] (HTML to PDF).

[1] http://discuss.asciidoctor.org/PDF-creation-with-Gradle-td661.html
[2] https://github.com/flyingsaucerproject/flyingsaucer

mgreau.com/posts => HubPress Blog :)