3.12 Skribilo User Manual — Images
Contents↑ Standard Markups

Images are defined by the means of the image function

(image :file [:zoom] [:height] [:width] [:url] [:class] [:ident] comment)
:ident The node identifier. html lout latex context info xml
:class The node class. html lout latex context info xml
:file The file where the image is stored on the disk (see image path). The image is converted (see convert-image) into a format supported by the engine. This option is exclusive with the :url option. html lout latex context info
:url The URL of the file. This option is exclusive with the option. html lout latex context info
:width The width of the image. It may be an integer for a pixel size or a floating point number for a percentage. html lout latex context info
:height The height of the image. It may be an integer for a pixel size or a floating point number for a percentage. html lout latex context info
:zoom A zoom factor. lout latex context
comment A text describing the image.
Ex. 17: The image markup

... produces:

A first imageA smaller oneA second image

Files passed as a :file argument to image are searched in the current image path, which is defined by the *image-path* SRFI-39 parameter. This parameter contains a list of directories and its value can be obtained using (*image-path*). Its value can be altered using the -P command-line option of the skribilo compiler (see Chapter 14 for details).

3.12.1 Image formats

Images are unfortunately unportable. The various Skribe output formats support different image formats. For instance, HTML supports gif and jpeg while the LaTeX back-end only supports ps. Skribe tries, only when needed, to automatically convert images to a format supported by the target to be produced. For this, it uses external tools. The default Skribe translation scheme is:

Engines support different image formats. Each engine may specify a converter to be applied to an image. The engine custom image-format specifies the list of supported image formats. This list is composed of a suffix such as jpeg or gif.

The function convert-image tries to convert an image according to a list of formats. All the specified formats are successively tried. On the first success, the function convert-image returns the name of the new converted image. On failure, it returns #f.

(convert-image file formats)
file The image file to be converted. The file is searched in the *image-path*image path.
formats A list of formats into which images are converted to.
See also *image-path* .
(made with skribilo)