22.3 Locating graphics files for HTML
For standard HTML output to be viewed with a browser, you can place graphics files in the same folder as the HTML files, or in any other folder relative to that folder. For other HTML output types, graphics placement is restricted:
• For HTML Help and OmniHelp, graphics must be located either in the same folder as the HTML files, or in a subfolder at any level below the folder containing the HTML files.
• For JavaHelp and Oracle Help, graphics must be located in a subfolder of the helpset folder, at the same level as the folder containing the HTML files.
Graphics in folder with HTML files
If graphics are in the same folder 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:
; StripGraphPath = No (default)
; or Yes (remove path from imported graphics)
Graphics in a different folder
If graphics will be in a folder different from the folder for HTML files, you must specify the path to the graphics folder, so Mif2Go can include the path in the generated <img> tags. To specify where a browser (or Help viewer) should look for graphics:
; GraphPath = path to use (replacing any previous) for all graphics
GraphPath=path/to/graphics/files
When you provide a value for GraphPath, also set StripGraphPath=No.
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. Absolute paths do not work if the graphics are on a UNIX server.
If your document includes indented tables or figures, and you want them to be indented in HTML output, make sure Mif2Go knows where to write the spacer graphic, 1p.gif. See §22.6.4 Locating, replacing, or omitting the indent spacer graphic. |
The default value of GraphPath is the folder designated by [Automation]WrapPath (see §33.4 Assembling files for distribution); if WrapPath is not specified, the default is the project folder. For JavaHelp and Oracle Help only, the default value of GraphPath is the folder designated by [JavaHelpOptions]GraphSubdir, prefixed with "../". See §10.2.7.2 Letting Mif2Go set up the folder structure and copy files.
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 §33.5.1 Copying graphics files to the assembly folder or subfolder.
§33.5 Placing graphics files for distribution
§8.2.9 Locating graphics files for HTML Help
§9.3.10 Getting OmniHelp supporting files in the right place
§10.2.7.4 Locating graphics files for JavaHelp and Oracle Help
§29.3.1.1 Specifying graphics location for HTML
> 22 Including graphics in HTML > 22.3 Locating graphics files for HTML