Building files
Previous  Top  Next

'Building' a file is the process by which finished HTML files are made by MacroHTML. When you press the build_btn 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:

compiler_output

The buildall_btn button performs exactly the same opearation as the Build button except it does so for all the files in the project.