# Template Wizard

The Template Wizard is a Visual Basic program that provides an easy-to-use graphical user interface to the Export technology. It is an example of how to use most of the properties, methods, and events available in the COM Automation Server. See COM Interface Methods and Events and COM Interface Properties for more information on the properties and methods.

The Template Wizard converts documents based on the predefined templates. Several templates are supplied with HTML Export, and they can be customized to suit your needs. See Explore Conversion Options with the Sample Programs for details on the template files.

NOTE: The Template Wizard requires a COM server to be registered. See Use the COM Implementation of the API.

You can use the Template Wizard to modify existing template files to create your own customized files, and to convert documents to HTML. However, the Template Wizard does not allow you to modify all structures in the template files. To control some display options, you might have to modify the template files directly or use the API.

## Convert Documents to HTML by Using the Template Wizard

To convert a document to HTML

1. Launch HTML Export Template Wizard.

2. Click Choose Template.

3. Select one of the templates listed in the Choose Template dialog box, or click the browse button to select another template file. The template files are located in the `programs\ini` directory. Click OK.

4. Select an input file by using the browse button next to the Input File field.

5. Click Convert to HTML to produce an HTML file of the source document.

6. Click View HTML to open the converted file in your browser. To specify which browser is used to view the converted HTML files, click Change Browser.

   When you change the default browser, the location of the browser's executable file is written to a file named `browser.wiz`. If the browser is not changed, the default browser is the Visual Basic web browser object\OCX.

## Change the Output Directory

By default, the output file is stored in the `programs\tempout` directory. To change this directory, click the browse button next to the Output Directory field and select a new directory.

If you change the default output directory, you must make the following modifications to the templates:

1. Update the HTML markup so that any images used by the templates (such as backgrounds or corporate logos) are found by the browser. The markup contains relative references to the image files (`..\images`).

2. Update the templates so that the Java applet (`JVTree.jar`) is found.

   NOTE: `JVTree.jar` is used to display a expandable table of contents. JVTree for more information on `JVTree.jar`.

To delete the HTML and image files created in the output directory, click Delete Created Output Files.

## Modify a Template in the Wizard

The Template Wizard provides limited control over the templates. You might wish to modify the template files directly in a text editor to provide maximum customization of the converted HTML. See Explore Conversion Options with the Sample Programs.

To modify the default options specified in the Wizard

1. Click Modify Template.

2. Modify the properties in the Options dialog box. The template parameters associated with each option in the Options dialog box are listed below and are described in HTML Export API Structures.

   Wizard field | Template parameter
   --- | ---
   All Formats tab
   Use text color in the original document | `bUseDocumentColors`
   Use font information in the original document | `bUseDocumentFontInfo`
   Use font face attributes in the document | `bSupportFontFace`
   Set font size relative to base font size | `bDisplayRelativeFontSize`
   Support user font size mapping | `bSupportUserFontSizeMapping`
   User Font Size Map | `FontSizeMap`
   Emit `<td>$nbsp;</td>` for empty cells | `bNbspEmptyCells`
   Support "col=x" HTML parameter | `bSupportRFC1942_cols`
   Convert tabs to tables | `bTabsToTables`
   Table Border | `SATableBorder`
   Table Cell Width | `nTableBorderWidth`
   Output Language ID | `OutputLanguageID`
   Style Sheet Type | `eStyleSheetType`
   Replace Character | `cReplaceChar`
   Redact Character | `cRedact`
   Word Processing tab
   Minimum length of paragraph | `minParaLen`
   Maximum length of paragraph | `maxParaLen`
   Minimum font size | `fontSizeMin`
   Maximum font size | `fontSizeMax`
   Required space before paragraph | `mSpaceBefore`
   Required space after paragraph | `mSpaceAfter`
   Must be bold | `bMustBeBold`
   Must be italic | `bMustBeItalic`
   Must be underlined | `bMustBeUnderlined`
   Can be non-zero indent | `bNonZeroIndent`
   Cannot contain tab | `bNoTabs`
   Cannot contain two or more spaces | `bNoMultiSpaces`
   Heading Create Options | `headingCreateType`
   Force source character set | `bForceSrcCharSet`
   Source Character Set | `eSrcCharSet`
   Force output character set | `bForceOutputCharSet`
   Output Character Set | `OutputCharSet`
   Spreadsheet tab
   Support column width | `bSupportColumnWidth`
   Generate column headings | `bSupportColumnHeadings`
   Generate row headings | `bSupportRowHeadings`
   Support cell span | `bSupportCellSpan`
   Support row span | `bSupportRowSpan`
   Remove empty columns | `bRemoveEmptyColumns`
   Enable empty rows | `bEnableEmptyRows`
   Specify maximum rows per table | `nRowsBeforeSplit`
   Presentation/Image tab
   Output any raster images to the following format | `OutputRasterGraphicType`
   Output any vector images to the following format | `OutputVectorGraphicType`
   Resolution of output image in x direction | `cxVectorToRasterXRes`
   Resolution of output image in y direction | `cyVectorToRasterYRes`
   Output presentation graphics as text and images | `bRasterizeFiles`
   No pictures | `bNoPictures`
   Compression quality | `nCompressionQuality`
   Paragraph Styles tab
   Style Name | `StyleName`
   MarkUpStart | `MarkUpStart`
   MarkUpEnd | `MarkUpEnd`
   Heading 1 | `Flags=KVSTYLE_HEADING1` (see Flags for Defining Styles)
   Heading 2 | `Flags=KVSTYLE_HEADING2` (see Flags for Defining Styles)
   Heading 3 | `Flags=KVSTYLE_HEADING3` (see Flags for Defining Styles)
   Heading 4 | `Flags=KVSTYLE_HEADING4` (see Flags for Defining Styles)
   Heading 5 | `Flags=KVSTYLE_HEADING5` (see Flags for Defining Styles)
   Heading 6 | `Flags=KVSTYLE_HEADING6` (see Flags for Defining Styles)
   PRE | `Flags=KVSTYLE_PRE` (see Flags for Defining Styles)
   Redact | `Flags=KVSTYLE_REDACT` (see Flags for Defining Styles)
   Order List | `Flags=KVSTYLE_ORDERLIST` (see Flags for Defining Styles)
   Unordered List | `Flags=KVSTYLE_UNORDERLIST` (see Flags for Defining Styles)
   Delete Content | `Flags=KVSTYLE_DELETECONTENT` (see Flags for Defining Styles)
   On Consecutive Paragraphs | `Flags=ONCONSECUTIVEPARAGRAPHS` (see Flags for Defining Styles)

3. You can use the Paragraph Styles tab to map paragraph and character styles in any word processing document that contains styles (such as Microsoft Word, RTF, or Folio Flat File) to arbitrary markup.

4. To create a new template that preserves any modifications that have been made, click Save Template as Ini File.

_FT_HTML5_bannerTitle.htm