This chapter describes document properties.
The following topics are covered in this section:
The Add Document Property page allows you to add or remove document properties. There are two types of document properties: predefined and custom.
Predefined properties are metadata fields stored in many file formats. An example of this is the Primary author, which is the author of the input document. Exactly which properties are available is highly dependent on the input file format, and in most cases it also depends on whether or not the author provided this information.
Custom properties are defined by the author. These can be used to insert arbitrary text and HTML markup into the output files.
The template author can choose predefined properties from the document to be output as metadata or as content in the output. Custom properties can also be created for insertion into the head and/or body of the output file. For each property, the template author can specify a default value to be inserted into the document should a value not be available, either from the document or the runtime API. The meta tag name is the name that identifies the property when placed in a <meta> tag in the head of the document. If the property is to be output in the body of the document, the text can be formatted using the specified output format.
By default, no document properties are defined. In order to include them in the output from the conversion, each desired document property must first be defined here. They must then be added to the output from the conversion by inserting them into page layouts defined in the Output Page Layouts page.
The following steps allow you to define document properties:
In the Predefined drop-down box, select from a list of metadata fields stored in many file formats.
In the Custom text box, you may include properties not listed in the Predefined drop-down. To do this, click on the Custom button and type in either the property name as it appears in the source document, or a new property name that you will create. Property names are case-sensitive.
If there is no author specified in the input document then the meta tag generated will be:
<meta name="author" content="Unknown">
While providing a meta tag name is optional, it must be specified if the property is to be included with the rest of the meta tags in the <head> of the output files. Properties that have a meta tag name defined are automatically added to the <head>; the user cannot add properties via the Head layout section.