Microsoft KB Archive/160833

= FP97: How FrontPage Handles Document Conversion to HTML =

Article ID: 160833

Article Last Modified on 10/5/2001

-

APPLIES TO


 * Microsoft FrontPage 97 Standard Edition

-



This article was previously published under Q160833



For a Microsoft FrontPage 2000 version of this article, see 205684.

For a Microsoft FrontPage 98 version of this article, see 194212.



SUMMARY
FrontPage can convert pasted text, inserted file segments in HTML pages, or entire files from several formats to HTML. This article presents an overview of how FrontPage handles document conversion to HTML and answers the following questions:

When will FrontPage attempt to convert a file to HTML?

Why does the conversion process show two stages?

How does FrontPage decide which converter to run?

What formats can FrontPage convert to HTML?

How are converters installed and where are they located?



When Will FrontPage Attempt to Convert a File to HTML?
FrontPage attempts to convert a file to HTML when you do any of the following:
 * Paste text from a non-HTML document.
 * Click File on the Insert menu in FrontPage Editor and select a non- HTML document.
 * Use a drag and drop operation. Using the right mouse button, drag a non-HTML document to FrontPage Explorer. When you release the mouse button, click "Copy Here as Web Format" on the shortcut menu.

Why Does the Conversion Process Show Two Stages?
FrontPage first converts documents from their native format to Rich Text Format (RTF), and then it converts the RTF files to Hypertext Markup Language (HTML). If the incoming file is already in HTML format or in simple text, no converter is run. If the incoming file is RTF only, the RTF to HTML converter is run.

How Does FrontPage Decide Which Converter to Run?
When FrontPage imports a file, the algorithm for determining which converter will be run is as follows:

First the conversion routine looks at the extension of the file. For each converter registry entry that matches the extension of the file, that converter's entry point for the IsFormatCorrect routine is run. This routine reads the first few bytes of the incoming file and decides if it understands the format. The first converter that understands the format is then run to convert the file to RTF format.

If FrontPage is unable to locate a converter that understands the file based on its extension, this procedure is repeated for each converter registry entry regardless of the file's extension.

If FrontPage still cannot find a converter to open the file, it displays the "Open File As" dialog box with buttons you can click to open the file as RTF, HTML, or text.

What Formats Can FrontPage Convert to HTML?
FrontPage installs RTF converters for the following formats:
 * Microsoft Excel Worksheet (.xls, .xlw)
 * Word (Asian versions) 6.0/95 (.doc)
 * Word 2.x for Windows (.doc)
 * Word 4.0/5.1 for Macintosh (.mcw)
 * Word 6.0/95 for Windows&Macintosh (.doc)
 * Word 97 (.doc)
 * WordPerfect 6.x (.wps, .doc)
 * Works 3.0 for Windows (.wos)
 * Works 4.0 for Windows (.wps)

These converters convert from the formats above to RTF format. FrontPage also installs the converter to convert a file from RTF to HTML format:
 * HTML Document (.html, .htm, .htx, .asp)

How Are Converters Installed and Where Are They Located?
FrontPage, Office 95, Office 97, and other Microsoft programs use the same location for shared converters (and the same registry keys to point at these converters) Installing or uninstalling any of these programs may change the versions of the converters that you are running.

NOTE: The FrontPage 1.1 "RTF to HTML" converter (Rtf2html.dll) is not included with FrontPage 97 for Windows.

FrontPage Setup does not treat converters as shared components. For additional information about problems that may occur as a result of this behavior, click the article number below to view the article in the Microsoft Knowledge Base:

160226 FP97: Cannot Use Proofing Tools or Text Converters

Additional query words: 97 front page

Keywords: kbinfo kbinterop kb3rdparty KB160833

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.