You can edit the file htmstd.cfg in the HoTMetaL PRO keyword directory to configure some aspects of how the filters used by HoTMetaL PRO's Open... command convert a document from word-processor formats into HTML.
The sections below will display some sample lines from this configuration file, explain how they're used, and give their default values.
The following setting tells HoTMetaL PRO to look for headings in word-processor documents.
Support heading="YES"
The default value is YES, so you actually don't have to include this setting in the htmstd.cfg file unless you want to change it. If you don't want HoTMetaL PRO to look for headings, change `Support heading' to NO.
Support heading in table="NO"
This setting means that HoTMetaL PRO will not try to find headings inside a table. The default value is NO. If you want HoTMetaL PRO to look for headings in a table, change `Support heading in table' to YES. We don't recommend this, however.
Maximum heading length=40
This setting tells HoTMetaL PRO to treat only paragraphs in the word-processor document that have 40 characters or less as possible headings. This is to avoid interpreting ordinary lines of text as headings. The default for this setting is 40 characters. The possible values are between 5 and 32767 characters, inclusive.
HoTMetaL PRO uses the font size and font style of paragraphs to identify possible headings.
By default, HoTMetaL PRO regards paragraphs in an emphasized (bold, italic, or bold-italic) font style as possible headings. Unless you specify otherwise, the first emphasized paragraph in the document whose length is less than or equal to the maximum heading length will be surrounded with the H1 element. Subsequently, any paragraphs that have the same font and font style as the first H1 will also be surrounded by an H1. Similarly, the second emphasized paragraph in the document whose length is less than or equal to the maximum heading length, and whose font size is different from that of any of the preceding paragraphs, will be surrounded with the H2 element. Subsequently, any paragraphs that have the same font and font style as the first H2 will also be surrounded by an H2. This pattern is followed for the other heading levels.
The following are examples of settings that let you specify more precisely what font size and font style a paragraph in the word-processor file should have in order for HoTMetaL PRO to interpret it as a heading of a particular type.
Heading 1 font size="=20I" Heading 2 font size="=18B" Heading 3 font size="=12BI" Heading 4 font size="10"
`Heading 1 font size' specifies the criteria for an H1 heading, `Heading 2 font size' the criteria for an H2 heading, and so forth.
If you just want to specify the font size, as in the `Heading 4' example above, then the size is the only value you have to enter. This example tells HoTMetaL PRO to surround any paragraph with an H4 element if it is in 10 point type and an emphasized style, and its length is less than or equal to the maximum heading length.
If you want to specify the font style-bold (B), italic (I), or bold-italic (BI)- in addition to the size, then you have to put an `=' sign directly before the font size (this means that there are actually two `=' signs in the line) and the appropriate abbreviation (B, I, or BI) after the font size. The `Heading 1' example tells HoTMetaL PRO to surround a paragraph with an H1 element if it is in 20 point italic type, and its length is less than or equal to the maximum heading length. The `Heading 2' example tells HoTMetaL PRO to surround a paragraph with an H2 element if it is in 18 point bold type, and its length is less than or equal to the maximum heading length. The `Heading 3' example tells HoTMetaL PRO to surround a paragraph with an H3 element if it is in 12 point bold-italic type, and its length is less than or equal to the maximum heading length.
Note that if you make a precise specification, a paragraph will be assigned the heading element only if it matches the specification exactly. In the examples above, a paragraph that is in 24 point type will not be surrounded by H1, even though it is larger than some paragraphs that would be surrounded by this element.
You can specify only even point sizes for headings.
The following setting is equivalent to the default behavior:
Heading 1 font size="0"
The following setting tells HoTMetaL PRO to look for lists in word-processor documents.
Support list="YES"
The default value is YES, so you actually don't have to include this setting in the htmstd.cfg file unless you want to change it. If you don't want HoTMetaL PRO to look for lists, change `Support list' to NO.
HoTMetaL PRO regards paragraphs that start with a `bullet character' or a number as list items.
You can also specify `alternate list characters', which are the characters that HoTMetaL PRO will regard as the start of a list item, in addition to the normal list bullets. For example:
Bullet list char="-,*,.,"
The value of this setting should be a list of up to 3 characters, separated by commas, with a comma at the end.
Minimum list items=2
This setting specifies the minimum number of successive list items (whether they start with a bullet character or one of the `alternate list characters') that HoTMetaL PRO must find before it will create a list. The possible values can be any number between 1 and 4; the default is 2.
The following setting tells HoTMetaL PRO to look for blockquotes in word-processor documents.
Support blockquote="YES"
The default value is YES, so you actually don't have to include this setting in the htmstd.cfg file unless you want to change it. If you don't want HoTMetaL PRO to look for blockquotes, change `Support blockquote' to NO.
HoTMetaL PRO will surround a paragraph with a BLOCKQUOTE element if its length is greater than or equal to the minimum blockquote length, it is not in an emphasized font style, it contains no `return' characters, and it consists of:
The acceptable quote characters are straight double quotes from the keyboard, opening and closing double quotes, European quotes (double angle quotes), and smart quotes (Word 6 only).
Minimum blockquote length=40
This setting tells HoTMetaL PRO to treat only paragraphs in the word-processor document that have 40 characters or more as possible blockquotes. This is to avoid interpreting a few words of quoted text as a blockquote. The default for this setting is 40 characters. The possible values are between 5 and 32767 characters, inclusive.
The following setting should not be changed:
Picture filename="WITH_PATH_NAME"