mkhtmsld

MKHTMSLD, Make HTML Slide List

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 [options] [filelist]

filelist The ordered list of image files, seperated by spaces. If no filelist is specified and the "-a" option is not used, the list will be obtained from stdin (one file name per line).

options:

-a Automatically determines the file list from all of the image files (*.jpg and *.gif) in the current directory. Must not be used with filelist.

-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.

-gfilename Specifies the name of the configuration file (default = "mkhtm.ini").

-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.

-i Reads the dimensions of each image file, and adds them to the supplimentary information for each slide. The index can then display the dimensions of each image. (note: currently, image dimensions are only extracted from JPEG image files).

-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.

-sheight 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).

-sheight,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).

-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
Usage Example:: dir /b *.jpg | mkhtmsld -h -tMy_Title -v

`-a`		Automatically determines the file list from all of the image files (.jpg and .gif) in the current directory. Must not be used with `filelist`.
`-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.
`-gfilename`		Specifies the name of the configuration file (default = "mkhtm.ini").
`-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.
`-i`		Reads the dimensions of each image file, and adds them to the supplimentary information for each slide. The index can then display the dimensions of each image. (note: currently, image dimensions are only extracted from JPEG image files).
`-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.
`-sheight`		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).
`-sheight,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).
`-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.