Supported media types for images
The file name extension (remapped to lowercase) is used to determine the supported media type for images and to retrieve its internal preferred dimensions:
- .jpg or .jpeg : bitmap image compressed in the standard JPEG format (this lossy format is most suitable for photographs).
- .png : bitmap image in the Portable Network Graphics format (specified by the W3 Consortium).
- .gif : bitmap image in the legacy Graphics Interchange Format.
- .pdf : multipaged documents in the Portable Document Format (initially specified by Adobe).
Rendering a single image
The full syntax for displaying an image is:
where options can be zero or more of the following, separated by pipes (|):
- Format option: one of border and/or frameless, frame, thumb (or thumbnail);
- Controls how the rendered image is formatted and embedded in the rest of the page.
- Resizing option: one of
- Note that the image will always retain its aspect ratio, and can only be reduced in size if it's not in a scalable media type such as SVG (bitmap images cannot be scaled up).
- The default maximum size depends on the format and the internal image dimensions (according to its media type).
- Horizontal alignment option: one of left, right, center, none;
- Controls the horizontal alignment (and inline/block or floatting styles) of the image within a text (no default value).
- Vertical alignment option: one of baseline, sub, super, top, text-top, middle, bottom, text-bottom;
- Controls the vertical alignment of a non-floatting inline image with the text before or after the image, and in the same block (the default vertical alignment is middle).
- Link option: one of