Image caption

If the image has neither ID nor title nor description nor source, then it does not get a caption at all:

\Image[Tank_man_standing_in_front_of_some_tanks.jpg]

which renders as:

If the image does not have an ID nor title, then it gets an automatically generated ID, just like every other OurBigBook output HTML element, and it is possible for readers to link to that ID on the rendered version, e.g. as:

#_123

Note that the 123 is not linked to the Figure <number>., but just a sequential ID that runs over all elements.

This type of ID is of course not stable across document revisions however, since if an image is added before that one, the link will break. So give an ID or title for anything that you expect users to link to.

Also, it is not possible to link to such images with an cross reference, like any other OurBigBook element with autogenerated temporary IDs.

Another issue to consider is that in paged output formats like PDF, the image could float away from the text that refers to the image, so you basically always want to refer to image by ID, and not just by saying "the following image".

We can also see that such an image does not increment the Figure count:

\Image[Tank_man_standing_in_front_of_some_tanks.jpg]{id=image-my-test-image-count-before}
\Image[Tank_man_standing_in_front_of_some_tanks.jpg]
\Image[Tank_man_standing_in_front_of_some_tanks.jpg]{id=image-my-test-image-count-after}

which renders as:

Figure 16
Figure 17

If the image has any visible metadata such as source or description however, then the caption does show and the Figure count gets incremented:

\Image[Tank_man_standing_in_front_of_some_tanks.jpg]{source=https://en.wikipedia.org/wiki/File:Tianasquare.jpg}
\Image[Tank_man_standing_in_front_of_some_tanks.jpg]{description=This is the description of my image.}

which renders as:

Figure 18. Source.
Figure 19. This is the description of my image.

 Ancestors (5)

 Incoming links (1)

Table