4 Special Processing

• 4.1 Making a Named Anchor
• 4.2 Footnote/Endnote Processing
• 4.3 Discarding Unwanted Text
• 4.4 Imbedding HTML in a Document

In the following discussion of SPECIAL processing
, I will assume that rtftohtml has not been customized. If it has, the text styles used to create special effects may be different.

4.1 Making a Named Anchor

To make a named anchor, you simply enter the name in the document where you would like the anchor to appear. Then format the text using Outline and Hidden. Be careful in formatting the text that you format ONLY the name - be careful not to format leading and trailing spaces or paragraph marks. As an example, if the text - Named Anchor Example - were formatted with Outline and Hidden, it would produce the HTML output :

<a name="Named Anchor Example"></a>

To change the formatting that produces named anchors, you need to modify the entry in html-trans that specifies "_Name" formatting.

4.2 Footnote/Endnote Processing

If your RTF document contains footnotes or endnotes, the filter will place the text of the footnote in aseparate HTML document. At the footnote reference mark, the filter will generate a hypertext link to the text of the footnote. This works with either automatically numbered footnotes[3], or user supplied footnote reference marks[+]

4.3 Discarding Unwanted Text

If you have text that you do not want to appear in the HTML output, simply format the text as Hidden and Plain (that is, no underline, outline...).

If you wish to modify the formatting that discards text, you need to change the entry in html-trans that specifies "_Discard".

4.4 Imbedding HTML in a Document

Normally, if your RTF document contained the text "<cite>hello</cite>", the translator would output this as: "&lt;cite&gt;hello&lt;/cite&gt;". This ensures that the text would appear in your HTML output exactly as it appeared in the original RTF document. If, however, you want the <cite></cite> to be interpreted as HTML markup, you must format the tags using Hidden and Shadow. The filter will then send the tags through without translation.

When the rtftohtml filter produces HTML markup, it keeps track of the nesting level of tags
to ensure that you don't get something like <b><cite>hello</b></cite> which would be incorrect markup. If you imbed HTML markup in your document, the filter will NOT be aware of it. You must ensure that your markup appears correctly nested.

If you wish to modify the formatting for imbedded HTML, you need to change the entry in html-trans that specifies "_Literal
".