# ImajSite Slide Builder
mkhtmsld

Given an ordered list of image file names, this program creates an HTML file for each image with a link to the next and the previous image. Each page also has a link to a home page. If an HTML file already exists which contains a preformatted text block, the text block will be retained. Any file information in existing HTML files will also be retained.

Usage:`MKHTMSLD` | `[/B] [/D] [/F] [/H | /H:`homefile`] [/M] [/N] [/R | /RS | /RI] [/S:`width`,`height`| /S:`height`[%]] [/T | /T:`title`] [/U] [/V]`

Note: Most of these options have been depricated in favor of configuration file options.

options:

`/B` |  | Use button icons (instead of text links) for "Next", "Prev", and "Home".
`/D` |  | Deletes the text file once it has been successfully added to the HTML file (see the "`/N`" option).
`/F` |  | Creates a forwarding index file called "index.htm" that can be used by an automatic index generator program. If an index file already exists, then its title will be used for the new index. Otherwise the directory name will be used as the new index's title.
`/H[:`homefile`]` |  | Specifies the name of the HTML file used as a link for the "Home" button on all pages. If this option is used and homefile is not specified, then "`index.htm`" will be used as the link for the "Home" button. If the "`/H`" option is not used, then the first slide will be used as the "Home" link.
`/M` |  | Suppresses page numbering in the title.
`/N` |  | If a text file (".txt") exists with the same name as the image and the HTML file does not contain preformatted text, the program normally appends a preformatted section to the HTML file which contains the text. This option disables that action.
`/R[S|I]` |  | Enables frames mode. The corresponding option must also be used in mkhtmidx. If the "`-rs`" option is specified, only the "frameset.htm" file will be generated (not the slide files). If the "`/RI`" option is specified, only slide files will be generated, and the "frameset.htm" file will not be generated.
`/S:`height`,`width |  | Specifies the maximum displayed image dimensions for all slides. Images will be integrally scaled (i.e. 1/2, 1/3, 1/4, ...) to fit this size. If the user clicks on the scaled image, the full size (unscaled) image will be displayed. If this option is not used, then slides are displayed using their actual dimensions (unscaled).
`/S:`height |  | Specifies the displayed image height for all slides. When this option is used, the browser will scale the image to the specified height when it is displayed. The height may be specified in units of pixels (as a decimal number), or in units of percent of client window height (as a decimal number followed by a percent sign). If the user clicks on the scaled image, the full size (unscaled) image will be displayed. If this option is not used, then slides are displayed using their actual dimensions (unscaled).
`/T[:`title`]` |  | Specifies the title to be used for each page (use "_" for spaces). If the "`/T`" option is not used, the title of the currently existing HTML file will be used, if it exists, or the image file name. If the "`/T`" option is used without specifying a title, then the directory name or the title of the index file will be used. Note: This title is not used for the forwarding index, if generated (see the "`/F`" option).
`/U` |  | Update slides only if they have been changed since the last time they were generated (according to the file's date/time stamp). This option works only when frames mode is enabled ("`/R`").
`/V` |  | Verbose mode.

Exit Codes (ERRORLEVEL):
  0 = no errors
  1 = completed with warnings
  2 = one or more files could not be created
  3 = unrecoverable error -- program aborted prematurely

Table of Contents