Asciidoctor :: Discussion

Embed vector formats (svg, ps or pdf)

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

6 messages Options

ferrao

Embed vector formats (svg, ps or pdf)

Is it possible to embed vector formats like svg, postscript or pdf inside an asciidoctor document?
It seems very strange to me how can someone properly write a book/document with asciidoctor if jpg/pngs are all we can embed as images. The output of such images when converted to PDF will probably look awful.

Can someone clarify how this is achieved?

Thanks in advance!

ch007m

Re: Embed vector formats (svg, ps or pdf)

Hi,

Until now the only way to achieve that is to enclose/encapsulate your HTML content using inline pass through (+++) - http://asciidoctor.org/docs/user-manual/#passthrough-macros. Here is an example :

+++
<embed width="400" height="50" src="bookmark.swf" wmode=transparent type=application/x-shockwave-flash/>
+++

I have opened a ticket to add a macro to support embed attribute : https://github.com/asciidoctor/asciidoctor/issues/881

Regards,

Charles Moulliard
Apache Committer / Technologist Evangelist / Blogger / MiddleWare Specialist
Twitter : @cmoulliard

ferrao

Re: Embed vector formats (svg, ps or pdf)

Dear Charles,

Thank you for the quick answer, please allow me to detail a bit more what i am after, on the hope that you can point me in the right direction.

My goal was to use the docbook5 (and maybe pdf) backends.

Getting tired of constantly fitting with wysiwyg word processors, I have been looking for an easy and professional way in which to write our product documentation and PDF outputs are a must.

Recently we have been working on producing a docbook5 template, but i was not very happy with writing the actual documentation contents in the extremely verbose XML format, until i came across asciidoc and the asciidoctor project, which seems a perfect fit, except for this issue.

We like to retain the possibility of zooming our PDFs without loosing any image quality and unless we can embed some sort of vector format that is hard to do. Having huge images embedded in the resulting PDFs is not an option for us, as it makes it extremely hard to mail the resulting files.

The PDF embedding within asciidoc would be great for us, as we can print into pdf directly from just about every other software application out there.

Jmm

Re: Embed vector formats (svg, ps or pdf)

In reply to this post by ferrao

I am using the docbook toolchain based on asciidoc and that works with svg.

Not sent from my PC

Le 30 janv. 2014 13:00, "ferrao [via Asciidoctor :: Discussion]" <[hidden email]> a écrit :

Is it possible to embed vector formats like svg, postscript or pdf inside an asciidoctor document?
It seems very strange to me how can someone properly write a book/document with asciidoctor if jpg/pngs are all we can embed as images. The output of such images when converted to PDF will probably look awful.

Can someone clarify how this is achieved?

Thanks in advance!

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Embed-vector-formats-svg-ps-or-pdf-tp1334.html

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

Jmm

Re: Embed vector formats (svg, ps or pdf)

In reply to this post by ferrao

Hello Ferrao

Would you be interested by a sample asciidoc / docbook / pdf toolchain example based on Maven ? I also included the generation of uml graphics in that demo.

It is not published yet because I am working on an archetype (generation of a sample/demo document project)

If you're interested, I could upload the sample to github as an early version of the archetype.

Jmm

Not sent from my PC

Le 30 janv. 2014 16:35, "ferrao [via Asciidoctor :: Discussion]" <[hidden email]> a écrit :

Dear Charles,

Thank you for the quick answer, please allow me to detail a bit more what i am after, on the hope that you can point me in the right direction.

My goal was to use the docbook5 (and maybe pdf) backends.

Getting tired of constantly fitting with wysiwyg word processors, I have been looking for an easy and professional way in which to write our product documentation and PDF outputs are a must.

Recently we have been working on producing a docbook5 template, but i was not very happy with writing the actual documentation contents in the extremely verbose XML format, until i came across asciidoc and the asciidoctor project, which seems a perfect fit, except for this issue.

We like to retain the possibility of zooming our PDFs without loosing any image quality and unless we can embed some sort of vector format that is hard to do. Having huge images embedded in the resulting PDFs is not an option for us, as it makes it extremely hard to mail the resulting files.

The PDF embedding within asciidoc would be great for us, as we can print into pdf directly from just about every other software application out there.

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Embed-vector-formats-svg-ps-or-pdf-tp1334p1336.html

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

ferrao

Re: Embed vector formats (svg, ps or pdf)

Yes please, i would really appreciate that.

Thanks!

Jmm wrote

Would you be interested by a sample asciidoc / docbook / pdf toolchain
example based on Maven ? I also included the generation of uml graphics in
that demo.

It is not published yet because I am working on an archetype (generation of
a sample/demo document project)

If you're interested, I could upload the sample to github as an early
version of the archetype.