More Advanced Procedures > Using HTML Templates

In this topic:

You can reference external graphics in HTML templates – Help & Manual parses the template code for image references and automatically includes the graphics in your output.

In addition to this you can also embed graphics in your project by adding them to the Baggage section. Baggage graphics are always exported automatically when you compile and they can be referenced without any path information in all HTML-based output formats. See below for details.

Supported graphics types:

•	You can use .JPG, .GIF and .PNG images. It is best to store your external graphics in the project directory (i.e. in the same directory as the .HMX project file) so that you can reference them as filenames only without path information.

•	If your graphics are not stored in the project directory use relative path names to reference them. (If you reference directories outside the project directory the image references will fail when you move the directory to another computer.)

Supported HTML image reference tags:

This function only supports image references in the following three HTML tags:

<BODY>

Images referenced with the BACKGROUND="" attribute.

Images referenced within the STYLE="" attribute using the syntax

STYLE="background: #FFFFFF url(image.jpg)"

(this can be combined with other style elements, of course)

<IMG>

Images referenced with the SRC="" attribute

<TABLE>

Images referenced with the BACKGROUND="" attribute.

All other image tags and attributes are ignored. If you reference graphics in your templates in any other way you must take steps yourself to make sure they are exported with your project. In particular, this also includes the variant images for mouseover buttons as they are not referenced with the tags listed above!

For more details on using image references and an example see Graphics in HTML templates in the Reference section.

Adding graphics to the Baggage section:

In addition to this function you can also add graphics and other files to the Baggage section. All files included in the Baggage section are integrated in your project automatically and can be referenced in your template code without any path information.

However, please note that Baggage graphics are physically embedded in your .HMX project file, so this function is only suitable for a relatively small number of small graphics files. Don't use it for large graphics images as this will radically increase the size of your project file!

•	For more information see Using Baggage Files.