The Help compiler takes all the source files and components (topics, images, windows, and so on) located in the Help project and processes them into one compiled Help file. The compiled Help file is your final Help system. Once compiled, you can test and distribute the Help system to your users - by placing it on a local hard drive, a disk, CD-ROM, or a network. You can also make the Help system available to download from an intranet or the Internet.
You can compile a Help project as many times as you want. Most Help authors compile as they go, rather than waiting until the entire project is complete. The "compile-as-you-go" method allows you to test your design and content ideas first, giving you plenty of time to explore other methods and make adjustments. It's also a good way to manage a project - compile after each section of the Help file is complete. Then you can test the file a little at a time and make sure it looks and acts the way you designed.
When the compiler completes the process, it displays a report that displays the statistics about compilation. The report displays information such as compilation time, names of files compiled into the Help system, number of images, topics, links, and compiler messages.
As the compiler is processing the information, it checks the Help project source files to make sure it can complete the process. If the compiler finds problems, it generates messages to alert you of potential problems. There are different kinds of compiler messages including:
Note. A note alerts you to a condition you should be aware of, but one that probably won't cause a serious problem in the compiled Help file. You can determine whether or not to address a note.
Warning. A warning signals a condition that results in a defective Help file. You should address the warning and correct the condition as soon as possible. For example, if the compiler can't locate an image, it displays a warning and continues the compilation process. You won't notice the problem in the compiled Help file until you go to a topic that should display that image where a "missing graphic" image appears, making it evident there's a problem with the topic.
Error. An error indicates a condition that prevents the Help file from being compiled. If the Help compiler encounters an error, the process stops and the compiler immediately alerts you about the problem. You won't be able to create the compiled Help file until you correct the error.