The phpWebLog reference for portability
-/*/------------------------------------------------------/*/-------

This document will attempt to explain how the layout design works in
phpWebLog, hopefully making it easier to port applications into its system
ala modules.


When phpWeblog prints the HTML out to the browser, the different areas are
basically divided into 7 sections.

Story
Summary
Comment
Block
Main
Header
Footer

The Header and Footer parsers are being called when you include
header.inc.php and footer.inc.php from the include/ directory. This leaves
you 5 different types of areas. The Story, Summary, and Comment areas are 
handled when you browse/view the stories.  This is pretty much done internally.
Blocks are handled internally as well when you call the header/footer.

This leaves you with one area to work with, Main.  To print a main area,
simply construct a string for the header and the content.  The function that
you will pass this to is called F_drawMain();

For clarity, here is a sample static HTML page that is properly written to be
handled by phpWebLog.

<?
/* always include these files, as well as the footer at the bottom */
include("include/common.inc.php");
include("include/header.inc.php");



## draw main template
$main["Heading"] = "Sample Heading";
$main["Content"] = <<<EOD
	this is a test.
	<p>
	<div align="left">Build your string, and it will be passed.</div>
	<br>
EOD;
F_drawMain($main);

include("include/footer.inc.php");
?>




The example is using PHP4's heredoc method of contructing the string.  You can
inter-weave PHP into the string as well.


<?
$main["Heading"] = "We will now count to 100!";
for ($i=0;$i<100;i++) {
	$main["Content"] .= "Number {$i}<br>";
}
F_drawMain($main);
?>





So that's it.  Now you can do whatever you want to do, and phpWebLog will
support you.  Share your work with us at http://phpweblog.org if you want it
included in the distribution (exciting cheap thrill!)