Asciidoctor :: Discussion

HMTL5 backend image processing errors

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

3 messages Options

fork

HMTL5 backend image processing errors

Hello guys,

I want to transfer my whole documentations to asciidoc but I stumbled upon an issue in the HTML5 output processor and I can't solve it on my own.
I created a test setup where the problem can be reproduced:

https://github.com/asciidoctor/asciidoctor/issues/1803#issuecomment-242657192

The HTML Backend wont copy the images to the output directory. Im not good in ruby and can't figure out where to start looking for the problem.

Maybe someone of the pro's can give it a quick fix?

Greetings.

mojavelinux

Re: HMTL5 backend image processing errors

Administrator

Welcome to the club, @fork!

On Wed, Sep 7, 2016 at 4:29 AM, fork [via Asciidoctor :: Discussion] <[hidden email]> wrote:

The HTML Backend wont copy the images to the output directory.

That's correct, the Asciidoctor core processor only converts the AsciiDoc source to another format, such as HTML. It does not copy any other resources / assets. (There are a few small exceptions pertaining to stylesheets, but that's mostly for convenience).

So how do the images get copied, you ask? That's where a build tool comes in. There are many of them. The two most notable in the Asciidoctor ecosystem are Gradle and Maven. Both of the Asciidoctor plugins for those build tools handle copying the images and other resources to the output directory.

* Gradle plugin - https://github.com/asciidoctor/asciidoctor-gradle-plugin

* Gradle examples - https://github.com/asciidoctor/asciidoctor-gradle-examples

* Maven plugin - https://github.com/asciidoctor/asciidoctor-maven-plugin

* Maven examples - https://github.com/asciidoctor/asciidoctor-maven-examples

There are plugins for other build tools as well. Let me know if you are using a different build tool and I'll help you find it.

Cheers,

-Dan

p.s. You might pick up that Asciidoctor follows the strategy of composition. Instead of one big monolithic tool, we develop smaller modules that get combined to accomplish various tasks.

Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

fork

Re: HMTL5 backend image processing errors

Hi Dan,

I still don't get it.
I'm using the gradle plugin. But recursive includes get broken.
See this issue I created with a sample project:
https://github.com/asciidoctor/asciidoctor-gradle-plugin/issues/200

Greetings

Christian