Use the Export Demo Program

The easiest way to get started with Export is to become familiar with its capabilities through the Visual Basic sample program, Export Demo.

The source code for the program is in the directory install\htmlexport\programs\ExportDemo, where install is the path name of the Export installation directory.

Export Demo is for Windows only, and requires Internet Explorer 4.01 with Service Pack 1 or higher.

The output options that control the look of the output files are predefined in Export Demo and cannot be changed in the user interface. Export Demo uses a small sample of the options available in the Export API. The Template Wizard sample program is an example of a Visual Basic program that does allow the user to control some of the output options by using template files. You can use the sample documents in the directory install\testdocs to experiment with converting different file formats.

To launch the sample program, select Export Demo from Start > Programs > Autonomy > Export SDK > HTML Export. The following dialog box appears:

Export Demo: Launching

NOTE: Note: XML conversion using XML Export is available in Export Demo if you have XML Export installed. If you do not have XML Export installed, the XML button is unavailable.

Change Input/Output Directories

If HTML Export is installed in the default directory, the output and input directories are automatically set.

The default location for source files is the install\testdocs directory.

The default location for output files is the install\htmlexport\programs\tempout directory.

If HTML Export is installed in a directory other than the default, you are prompted to select an output and input directory when you first start Export Demo.

To change the default directories for the source and output files

  1. Select Options > Set Directories.

    Export Demo: Setting Directories

  2. From the tree view, select the drive letter and directory for the source or output files.

  3. In Change Location, select which files are stored in the directory, either Source or HTML.

  4. Click Change. The Current Locations fields are updated with the new selection.

  5. Follow the same procedure for the other file types. When you are finished, click OK.

Set Configuration Options

With HTML Export, you can configure options prior to the document conversion. Export Demo demonstrates this functionality, and enables you to:

Convert PDF Files

In Export Demo, you can convert PDF documents in one of two ways:

Export Demo provides an option to select the type of reader that you want to use to convert PDF documents. By default, the basic reader (pdfsr) is used to convert PDF documents.

To specify that the graphic-based reader be used to convert PDF documents

  1. Ensure that Export Demo is not running.

  2. Set the appropriate configuration file options. See Convert PDF Files to Raster Images.

  3. Start the Export Demo program.

  4. Select Options > HTML Config > Set Hifi.

    NOTE: Note: You can also convert PDF documents to a logical reading order by using the pdfsr PDF reader. This feature is demonstrated in the cnv2html C sample program, and the HtmlTest Java sample program. Convert PDF Files to a Logical Reading Order.

Convert Rotated Text

In HTML Export, you can specify how rotated text is displayed in the HTML output. By default, rotated text in a file is displayed in its original position, at the original font size, and at zero degrees rotation. Because the text is the original size, but might be displayed in a smaller space, the text might overlap adjacent text in the HTML output. You use the text rotation configuration option to avoid this problem. If you set this option, rotated text is displayed at the bottom of the page on which it appears. See Convert Rotated Text. Currently, this configuration option applies only to PDF files.

To specify that rotated text be displayed at the bottom of the page on which it appears, select Options > HTML Config > Set Text Rotate.

Convert Files

To convert a single file

  1. Select Options > Convert > Single file.

  2. Select the document from the file list. Click HTML in the Convert file to pane.

To convert files in a directory

  1. Select Options > Convert > Entire directory.

  2. Click HTML in the Convert directory to pane.

To view a converted file, double-click the output file in the Output Files pane, or select the output file, and then click View. The converted file is displayed in the view pane:

Export Demo: Converting Files

To view the original document, select the document from the file list, and then click Open. If you have an application on your system associated with the file, the file is displayed in that application.

To delete output files, select the file in the Output Files pane and click Delete.