Conversion options are parameters that determine the content, structure, and appearance of the XML output. For example, you can specify:
You can set the conversion options either in the API or in the template files. Regardless of the method used to set the options, the values are ultimately passed to the API and used to populate the following
The conversion options are described in XML Export API Structures.
Use the following functions to set conversion options:
XML Export includes templates in the form of initialization files (.ini
). The templates provide a quick and easy way to modify the conversion options without programming at the API level. However, the template files do not give you complete control of the conversion process. To control some features, you must use the API directly.
You can use a text editor to customize the template files. For example, to change the output character set from the default KVCS_UNKNOWN
to KVCS_SJIS
in the default.ini
template, make the following change shown in bold:
[KVXMLOptions] eOutputCharSet=KVCS_SJIS bForceOutputCharSet=TRUE
To create valid XML, a template file must define at least two structures: KVXMLTemplateEx
and KVXMLOptionsEx
NOTE: If you enter markup in the template files that is not compliant with XML standards, XML Export inserts the markup into the output file unchanged. This might result in a malformed XML file.
An application must then read the template file and write the data to the appropriate Export structures. In the sample program xmlini
, a template file is supplied as a command-line argument
The template files for the C API implementation are in the directory install\xmlexport\programs\ini
, where install
is the path name of the Export installation directory. The following templates are provided:
Template | Description |
---|---|
Cascading style sheet (xml_css.ini ) |
This template writes style sheet information to an external CSS file. This makes the XML output significantly smaller because the information is not stored in the output file. See Use Style Sheets and Use Style Sheets with xmlini for more information on using an external CSS file. |
Index (xml_index.ini ) |
Converts a source document into a single, largely unformatted XML file that is appropriate for use with an indexing engine. |
Single file( xml1file.ini ) |
|
Single file for presentations (xml1file_pg.ini ) |
This template is designed specifically for presentation formats.
|
Single file with table of contents (xml1filetoc.ini ) |
|
|