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. Export Demo is for Windows only.
The source code for the program is in the directory install\
, where install
is the path of the Export installation directory.
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 with template files. install\testdocs
to experiment with converting different file formats.
When you start the program, the following dialog appears:
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 disabled.
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 directory install\testdocs
.
The default location for output files is the directory install\
.
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
-
Select Options > Set Directories. The following dialog appears:
Export Demo: Setting Directories
-
From the tree view, select the drive letter and directory for the source or output files.
-
In Change Location, select which files are stored in the directory, either Source or HTML.
-
Click Change. The Current Locations fields are updated with the new selection.
-
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 conversionKVHTMLConfig()
function
-
Specify a PDF reader.
-
Specify whether rotated text in a PDF file is displayed in its original position or at the bottom of the page.
Convert PDF Files
In Export Demo, PDF documents can be converted in one of two ways:
-
generate a raster image for each page of the PDF file by using a graphic-based PDF reader (
kppdfrdr
orkppdf2rdr
). See Convert PDF Files to Raster Images.
Export Demo provides an option to select the type of reader 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
-
Ensure that Export Demo is not running.
-
Set the appropriate configuration file options. See Use a Graphic-Based Reader.
-
Start the Export Demo program.
-
Select Options > HTML Config > Set Hifi.
NOTE: You can also convert PDF documents to a logical reading order by using the
pdfsr
PDF reader. This feature is demonstrated in thecnv2html
sample program . See 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 this option is set, 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
-
Select Options > Convert > Single file.
-
Select the document from the file list, and then click HTML in the Convert file to pane.
To convert files in a directory
-
Select Options > Convert > Entire directory.
-
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.