One figure containing multiple images.

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
8 messages Options
Reply | Threaded
Open this post in threaded view
|

One figure containing multiple images.

Jeremie Bresson
In LaTeX documents we are using this structure:

<pre style="border: 1px solid #a0a0a0;width:50%;background-color:#F8F8F8;border-radius:5px;padding:10px;">
\begin{figure}
\includegraphics[width=4.5cm]{screenshot1.png} \hspace{3mm}
\includegraphics[width=4.5cm]{screenshot2.png} \hspace{3mm}
\includegraphics[width=4.5cm]{screenshot3.png}
\caption{Three stages}
\figlabel{screenshots}
\end{figure}
</pre>

The idea is to have multiple images (png) using the same figure (only one caption and one anchor).

Is this possible with Asciidoctor?
Reply | Threaded
Open this post in threaded view
|

Re: One figure containing multiple images.

mojavelinux
Administrator
Jeremie,

This is not currently possible, though it's a very interesting idea. We added something similar to this in the video macro by supporting a playlist of videos.

[source,asciidoc]
----

video::SCZF6I-Rc4I,AsKGOeonbIs,HwrPhOp6-aM[youtube, 640, 360]

----

We could do something similar for the block image macro by allowing a comma-separated list of image paths...then lay them out in various arrangements controlled by the stylesheet.

[source,asciidoc]
----

.Three stages
image::screenshot1.png,screenshot2.png,screenshot3.png[]

----

If we think about this semantically, it's important to have the images as part of the same macro definition so it's clear they belong together.

This could be faked today by using 3 block images and only putting the title on the last one.

[source,asciidoc]
----

image::screenshot1.png[]

image::screenshot2.png[]

.Three stages
image::screenshot3.png[]

----

Obviously, being able to supply an image list in the target of a single macro is the ideal solution. File an issue? I'm not sure when I can get to it, but definitely an idea worth capturing.

(Of course, you also have the option of implementing this as a block macro extension).

Cheers,

-Dan

On Sun, Feb 22, 2015 at 11:32 PM, Jeremie Bresson [via Asciidoctor :: Discussion] <[hidden email]> wrote:
In LaTeX documents we are using this structure:

<pre style="border: 1px solid #a0a0a0;width:50%;background-color:#F8F8F8;border-radius:5px;padding:10px;">
\begin{figure}
\includegraphics[width=4.5cm]{screenshot1.png} \hspace{3mm}
\includegraphics[width=4.5cm]{screenshot2.png} \hspace{3mm}
\includegraphics[width=4.5cm]{screenshot3.png}
\caption{Three stages}
\figlabel{screenshots}
\end{figure}
</pre>

The idea is to have multiple images (png) using the same figure (only one caption and one anchor).

Is this possible with Asciidoctor?



If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/One-figure-containing-multiple-images-tp2788.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Reply | Threaded
Open this post in threaded view
|

Re: One figure containing multiple images.

Jeremie Bresson
Thank you for your answer.

---

I have submitted issue #1287
https://github.com/asciidoctor/asciidoctor/issues/1287

I hope this is the correct repository.

---

The macro idea seems to be a possibility, but macros are too advanced for me for the moment.
Reply | Threaded
Open this post in threaded view
|

Re: One figure containing multiple images.

mojavelinux
Administrator

That's the one!

Thanks,

-Dan

On Feb 24, 2015 3:21 AM, "Jeremie Bresson [via Asciidoctor :: Discussion]" <[hidden email]> wrote:
Thank you for your answer.

---

I have submitted issue #1287
https://github.com/asciidoctor/asciidoctor/issues/1287

I hope this is the correct repository.

---

The macro idea seems to be a possibility, but macros are too advanced for me for the moment.


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/One-figure-containing-multiple-images-tp2788p2792.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
Reply | Threaded
Open this post in threaded view
|

Re: One figure containing multiple images.

Jeremie Bresson
In reply to this post by mojavelinux
http://discuss.asciidoctor.org/One-figure-containing-multiple-images-td2788.html 
I have found the time to try the proposed workaround.

There is still a problem with the anchor; I have put it near the first image:

[source,asciidoc]
----
[[img-screenshots]]
image::screenshot1.png[]
image::screenshot2.png[]
.Three stages
image::screenshot3.png[]

----

But now the text is wrong in the text:

This asciidoctor code:
 [source,asciidoc]
----
Execute the steps described in figure <<img-screenshots>>.
----

Is rendered as:
Execute the steps described in figure [img-screenshots_stringfield].

This is correct, but I should have the caption of the following image. I would like to have something like:
Execute the steps described in figure Three stages

My guess is that this is not possible. I really need to understand the macro solution.
Reply | Threaded
Open this post in threaded view
|

Re: One figure containing multiple images.

Jeremie Bresson
Quick update.

I have discovered that it is possible to provide a text when the anchor is defined: [[id,xreflabel]]

I have updated the workaround:

[source,asciidoc]
----
[[img-screenshots, Three stages]]
image::screenshot1.png[]
image::screenshot2.png[]
.Three stages
image::screenshot3.png[]
----

Now the link <<img-screenshots>> are working.
Reply | Threaded
Open this post in threaded view
|

Re: One figure containing multiple images.

mojavelinux
Administrator

On Wed, Apr 29, 2015 at 11:55 AM, Jeremie Bresson [via Asciidoctor :: Discussion] <[hidden email]> wrote:
I have discovered that it is possible to provide a text when the anchor is defined: [[id,xreflabel]]

Indeed! I filed an issue to document this more explicitly. See https://github.com/asciidoctor/asciidoctor.org/issues/380.

(In AsciiDoc, it's call the reftext, though it maps to the xreflabel attribute in the DocBook output).

Reply | Threaded
Open this post in threaded view
|

Re: One figure containing multiple images.

mojavelinux
Administrator
In reply to this post by Jeremie Bresson

On Wed, Apr 29, 2015 at 11:55 AM, Jeremie Bresson [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Now the link <<img-screenshots>> are working.

Excellent!