8.3 Problems that can occur

These are the kinds of problems that can occur in WebMaker during the conversion process:

: Because RapidRules is not perfect, you may encounter some strange effects when your document is converted. See Section 3.10, "Troubleshooting RapidRules output" for some tips on how to resolve some of the problems peculiar to RapidRules.

: Sometimes a document looks fine in FrameMaker, but when you convert it to HTML, you find problems with the output. Documents that can be converted smoothly and cleanly are those that follow the suggestions in Chapter 7, "FrameMaker Style Recommendations". You might also find that if you use tricky techniques in FrameMaker, those techniques might not work well when converting to HTML. For example, one document could use autonumbers in some paragraph tags and make the autonumbers invisible in the FrameMaker document. The autonumbers are still present in the document and its MIF file; therefore they are visible in the HTML files generated by WebMaker (that is, if you use the Default rule, or other rules that display the autonumber).

: These problems are unlikely if you simply include the library WML files, and map your paragraphs to the predefined rules. However, if you write new WML rules or modify existing ones, it is always possible to introduce an error. WML is a programming language, and any WML code you write could be either correct or incorrect. When you open a WML file, WebMaker parses the WML. If WebMaker discovers a problem in the WML file, it tries to give an information message in the log or in a notification window.

: If your output does not look right on one browser, it is sometimes helpful to view it with a different browser. One example is that older versions of Mosaic do not handle HTML tables. If you use a newer version of Mosaic or another browser, the tables appear correctly.

: If you find a problem with WebMaker itself (such as WebMaker crashing), please contact WebMaker support by electronic mail:
: webmaker-support@harlequin.com
: Provide the following information: the version you are running (choose WebMaker > About WebMaker in the main window), any information from the log file (choose WebMaker > Log in the main window), and a complete description of what you were doing when the problem occurred. Please fill out the customer support form included with WebMaker. Please be sure the information you give is as complete as possible. The more information you can provide, the more we can help you solve your WebMaker problems.