|heitml Pretty Printing|
Pretty Printing displays heitml Source Code in your Browser using various colors and text styles to highlight portions of your code, thus making it easier for the programmer to see how various factors relate to and interact with one another. One of the design goals of the heitml Programming Language was to enable heitml Functions, Tags and Procedures to merge with HTML in as seamless a manner as possible. There are times, however, when it is useful to be able to visually identify various components of a heitml Web Page, and Pretty Printing serves this need.
heitml automatically displays a page in Pretty Printing mode when a syntax error is detected (as part of the runtime error display), or if you explicitly request heitml to show a page in Pretty Printing mode by appending ?$debug=pp to the URL.
Below is the list of color values and text attributes Pretty Printing employs:
The following example shows part of the Counter Page Source Code in Pretty Printing mode:
heitml Source Display
// Filename: counter.hei <HTML> <HEAD> <include heilayout.hei> <include basic.hei> <include counter.hei> </HEAD> <BODY title="Counter Example"> <img src="heitml.jpg"> The following text shows how to include a counter into your Web pages: <p> <? "<Counter name=\"excounter\">"> <p> Afterwards the Counter can be accessed by <Counter name="excounter"> <example text="<? gl.Cnt>"> Now <a href="index.hei"> go back </a> to the examples page. </BODY> </HTML>
Normally, you would be able to click on the filename parameter in the <include> Tags to show the corresponding include file in Pretty Printing mode. You could also click on User-defined Tags to jump to the Tag definition. Note, however, that this does not work in the above example, which is included only for visual reference. You are not allowed to debug the h-e-i Web Site, but once you have heitml installed on your own Web Site or local computer, you should call a few sample heitml Pages using the ?$debug=pp parameter to see how this works.
When looking for bugs, it is very useful to check the colors of the text. Often a forgotten <let statement or a missing closing > can be found very quickly when you use Pretty Printing.
Note: heitml pages containing syntax errors can not be shown in Pretty Printing mode. Instead the page is shown in syntax error mode, as explained in the next section.