'Building' a file is the process by which finished HTML files are made by MacroHTML. When you press the
button, the selected file source file (that is, the file that you have been editing) will be read from disk, pre-compiled and then compiled, producing the final HTML page.
Pre-compilation. In this phase, the source is analysed and 'include directives' such as <<header.inc>> cause files (in this case the file 'header.inc') to be recursively loaded by the pre-compiler, and each expanded out until the result is a fully expanded stream of text, most likely with pseudo-html structures in it. Checks are made during pre-compilation for inadvertant looping, where one include file includes another which includes itself, and a waring will be written into the stream if this happens.
Compilation. This is the second phase, in which pre-defined macros or tokens found in the text stream are expanded to full HTML. During this phase links are also extracted and link-checking can be performed later. Both the links and the compiler progress is written to the IDE's 'Compiler progress' tabbed page:
The
button performs exactly the same opearation as the Build button except it does so for all the files in the project.