Table of Contents

Running WebConvert from the Command Line





WebConvert may be run in a "silent mode" by passing arguments to the program. This will enable the user to convert documents one at a time without displaying the program dialog boxes and/or error messages.


Arguments



The program arguments are as follows:

<executable name> <source file> <target file> <target format> <HTML Style Template name>


Executable name



This is the name of the program executable file. After installation of WebConvert, this will be "wcvt32.exe".


Source file name



This is the full path name of the source document file.


Target file name



This is the full path name of the converted document file. If converting to HTML, this will be the name of the first page in a Web page link. If the style template specifies a TOC, then the name of the TOC page will be this target name with "TOC" appended to it before the extension. If the style template specifies the use of frames, then the top frame file will be this target name with "Frm" appended to it.


Target format



This is the desired format to which the source document will be converted. The choices are as follows:

HTMLhtml

MS Word 6ww6

ASCII textascii


HTML Style name



This is the full path name of the HTML style template to be used if the target format is HTML.




Considerations



At minimum, there must be the 3 arguments following the program name:

<source file> <target file> <target format>

with the fourth argument being necessary when the target format is HTML. An example of a command line session would be:

wcvt32.exe c:\docs\word8.doc c:\outputdir\word8.htm html c:\webconvert\styles\arch.cfg



This example would convert the document "word8.doc" in the folder "c:\docs" to the HTML document "word8.htm" in the folder "c:\outputdir" using the stylesheet "arch.cfg". Let us assume that the style sheet specified generating a Table of Contents as a frame and that page breaks would occur on every hard page break in the source document which resulted in 3 HTML pages to be placed in a sub-folder, then the total output would be as follows:

Word8Frm.htmThe main frame page

Word8TOC.htmThe Table of Contents page

Word8.htmThe first page in the link

Word8\Word8_1.htmThe second page in the link

Word8\Word8_2.htmThe third page in the link

Thus, the user would launch "Word8Frm.htm" that would then link to all the pages and the Table of Contents frame.

The user must also keep in mind that it is only possible to convert one document at a time and that any batch processing of documents would have to be done independent of WebConvert. Also, the same copy protection would apply so that the user is licensed only for the machine on which it is installed.


Error Messaging





Since all dialog boxes are disabled in the command line mode, error messages will be written to a disk file named "ERROR.LOG" located in the same directory as the main program executable. The messages will include the source file name and the error message separated by a semicolon. The error log file is appended to at each session so the user is responsible for deletion when a new error log is desired.