23.3 Locating graphics files for HTML

For standard HTML output to be viewed with a browser, you can place graphics files in the same directory as the HTML files, or in any other directory relative to that directory. For other HTML output types, graphics placement is restricted:

• For HTML Help and OmniHelp, graphics must be located either in the same directory as the HTML files, or in a subdirectory at any level below the directory containing the HTML files.

• For JavaHelp and Oracle Help, graphics must be located in a subdirectory of the helpset directory, at the same level as the directory containing the HTML files.

Graphics in directory with HTML files

If graphics are in the same directory as the HTML files, references to those graphics via <img> tags do not need a path component, and whatever path information is already present in FrameMaker must be removed.

To remove path information from graphics file names:

[Graphics]

; StripGraphPath = No (default)

;  or Yes (remove path from referenced graphics)

StripGraphPath = Yes

When StripGraphPath=Yes, Mif2Go omits any path information from references in generated <img> tags.

Graphics in a different directory

If graphics will be in a directory different from the directory for HTML files, you must specify the path from the HTML files to the graphics directory, so Mif2Go can include the path in the generated <img> tags.

To specify where a browser (or Help viewer) should look for graphics:

[Graphics]

; GraphPath = path to use (replacing any previous) for all graphics

GraphPath = path/to/graphics/files

GraphPath specifies the location of graphics files relative to the location of HTML files. For Web-hosted systems, GraphPath must be the path to the graphics on the Web server, which might be different from the file path on the conversion system. Although you can specify an absolute path, relative is almost always what you want.

Note:  Absolute paths do not work if the graphics are on a UNIX server. 

Default path

The default value of GraphPath is the directory designated by [Automation]WrapPath (see §35.6 Assembling files for distribution); if WrapPath is not specified, the default is the project directory. For JavaHelp and Oracle Help only, the default value of GraphPath is the directory designated by [JavaHelpOptions]GraphSubdir, prefixed with “../”. See §11.3.7.2 Letting Mif2Go set up the directory structure and copy files.

If you do not specify a value for GraphPath, the value of StripGraphPath determines whether Mif2Go includes the original path from your FrameMaker document, or no path at all, in generated <img> tags.

GraphPath does not move files!

In HTML references to images, the GraphPath setting prefixes the path specified by GraphPath to the name of each graphics file, in place of whatever other path was there in your FrameMaker document. This option sets the src attribute of the <img> tags; it does not change the location of the graphics files themselves. You must either copy the graphics files to their specified location, or have Mif2Go copy them for you. See §35.7.1 Copying referenced graphics to a distribution directory.

See also:

§35.7 Placing graphics files for distribution

§9.3.10 Locating graphics files for HTML Help

§10.3.9 Getting OmniHelp supporting files in the right place

§11.3.7.3 Locating graphics files for JavaHelp and Oracle Help

§31.3.1.1 Specifying graphics location for HTML

---

> 23 Including graphics in HTML > 23.3 Locating graphics files for HTML