Webgenz CMS - User Guide - Generation Process

Home |

Try It |

Buy It | Site Map


		Tutorial
		Generation Process
		Project Files
		Template Files
		Content Files
		Command Line

Generation Process

Webgenz CMS generates a Project by executing the following steps:

Webgenz CMS reads in the Project Definition File. For each line in the Project Definition File, Webgenz CMS does the following:
Webgenz CMS reads the Template File and the Content File(s) referenced on the line.
Webgenz CMS processes the Template File one line at a time. As Webgenz CMS finds a Macro reference in the Template File, it searches for the Macro definition in the Content Files.
Webgenz CMS searches for the Macro definition by inspecting the Content File(s). It starts by searching the first Content File defined on the line, and then inspects any inherited Content Files, if they exist. As soon as Webgenz CMS finds the Macro definition, it stops searching.
Webgenz CMS replaces the Macro reference in the Template File with the value of the Macro.
If a Macro definition is not found for the Macro reference (or if the Macro has a blank value) then the entire line in the Template File that includes the Macro reference is deleted. This behavior is usually desirable, however it can be overridden by setting an option on the "Project Properties" screen.
Since Macros can be nested, Webgenz CMS will process the Template File repeatedly until no Macro references remain.

Notes:

In Step 4 above, it is possible to control the starting point from which Webgenz CMS will search for a Macro definition. For example, it is possible to indicate that Webgenz CMS should start searching for the Macro from an inherited Content File. To do this, a special format is used in the Macro reference. That format is:
```
     [@^MY_TAG]
     
```
The "^" in the Macro reference indicates that Webgenz CMS should start looking for the Macro definition one level up in the hierarchy. This feature provides a way to "subclass" Macros.

When Webgenz CMS finds a Macro definition, it may alter the Macro's value before it replaces the Macro reference with the Macro value. Why would Webgenz CMS do this? Webgenz CMS does this in order to preserve the formatting of the HTML document that it generates. Here's an example:

Consider the following Template File:

     <HTML>
     <HEAD>
     <TITLE>My Title</TITLE>
     </HEAD>
     <BODY>
     <TABLE>
       <TR>
         <TD>
           [@MY_CONTENT]
         </TD>
       </TR>
     </TABLE>
     </BODY>
     </HTML>

And the following Content File:

     [@MY_CONTENT]:
     This is a block of content that
     is a few lines long. This is
     just an example.
     [@]

If Webgenz CMS were to simply insert the Macro value in place of the Macro reference, the result would be the following:

     <HTML>
     <HEAD>
     <TITLE>My Title</TITLE>
     </HEAD>
     <BODY>
     <TABLE>
       <TR>
         <TD>
     This is a block of content that
     is a few lines long. This is
     just an example.
         </TD>
       </TR>
     </TABLE>
     </BODY>
     </HTML>

Since the formatting of this output is undesirable, Webgenz CMS will alter the Macro value. Webgenz will add the white space that appears before and after the Macro reference in the Template file to each line of the Macro value. In the example above, the output will be as follows:

     <HTML>
     <HEAD>
     <TITLE>My Title</TITLE>
     </HEAD>
     <BODY>
     <TABLE>
       <TR>
         <TD>
           This is a block of content that
           is a few lines long. This is
           just an example.
         </TD>
       </TR>
     </TABLE>
     </BODY>
     </HTML>

As you can see, this formatting is much more desirable and reflects the formatting that the author of the Template File intended. Take a look at another example to see how Webgenz treats multi-line Macro values that appear on a line with code other than white space:

     <HTML>
     <HEAD>
     <TITLE>My Title</TITLE>
     </HEAD>
     <BODY>
     <TABLE>
       <TR>
         <TD>[@MY_CONTENT]</TD>
       </TR>
     </TABLE>
     </BODY>
     </HTML>

In this case, Webgenz CMS will generate the following:

     <HTML>
     <HEAD>
     <TITLE>My Title</TITLE>
     </HEAD>
     <BODY>
     <TABLE>
       <TR>
         <TD>This is a block of content that
         is a few lines long. This is
         just an example.</TD>
       </TR>
     </TABLE>
     </BODY>
     </HTML>

Note: The example above applies to Webgenz CMS version 6.1.0 and higher.


	Home \| About Us \| License Agreement \| International \| Tell A Friend \| Links

	Copyright 1997-2003. All rights reserved. Webgenz is a trademark.	Last updated: Monday, March 08, 2004