<?php 
/*! 
@mainpage 
 
%Xyndravandria is the name of a collection of projects designed and developed by Mauro Di Girolamo ([email protected]); he is therefore the copyright (c) owner of %Xyndravandria itself and all of its projects. 
 
%Xyndravandria Mondraviel is released under the terms of the %Xyndravandria PHP License (XyndravandriaPHPLicense.txt). You should be given a copy of the %Xyndravandria PHP License (XyndravandriaPHPLicense.txt) within the same directory as the README.md; if not, you can get a copy at http://Xyndravandria.ohost.de/XyndravandriaPHPLicense.txt . There might be a release under a freer license for a later, more stable version. 
 
All projects: 
 
<table> 
 
   <tr> 
      <th>Project</th> 
      <th>Language</th> 
      <th>Description</th> 
   </tr> 
    
   <tr> 
      <td>%Xyndravandria Averazain<br>http://github.com/MauroDiGirolamo/Xyndravandria_Averazain</td> 
      <td>PHP</td> 
      <td>Averazain is an Ajax framework supporting also JavaScript disabled clients perfectly - including search engines like Google.</td> 
   </tr> 
   <tr> 
      <td>%Xyndravandria Dyverath<br>http://github.com/MauroDiGirolamo/Xyndravandria_Dyverath</td> 
      <td>PHP</td> 
      <td>Dyverath is a database access wrapper.</td> 
   </tr> 
   <tr> 
      <td>%Xyndravandria Erozaver<br>http://github.com/MauroDiGirolamo/Xyndravandria_Erozaver</td> 
      <td>PHP</td> 
      <td>Erozaver is a class extending the type hinting given by the PHP engine (additional support for basic type hinting and size constraints).</td> 
   </tr> 
   <tr> 
      <td>%Xyndravandria Mondraviel<br>http://github.com/MauroDiGirolamo/Xyndravandria_Mondraviel</td> 
      <td>PHP</td> 
      <td>Mondraviel is a class used to separate HTML from PHP code by firstly register models - files containing place holders embedded in HTML code - and then later fill them dynamically with content by passing values for the place holders.</td> 
   </tr> 
    
</table> 
 
In the following, the usage of Mondraviel will be explained roughly; if you would like to know more detailled information, you can take a look at the in-depth documentation by browsing through either the namespaces or the data structures in the navigation above. 
 
@section S1 I. Overview 
Mondraviel is a class used to separate HTML from PHP code by firstly register models - files containing place holders embedded in HTML code - and then later fill them dynamically with content by passing values for the place holders. 
 
@section S2 II. Models 
A model is a file containing place holders embedded in HTML code. Place holders look like PHP variable, so they start with a leading $. @n 
You have to use @ref Xyndravandria::Mondraviel::Mondraviel::RegisterModel( ) "Mondraviel::RegisterModel( )" to register a model. @n 
Please read the documentation of @ref Xyndravandria::Mondraviel::Mondraviel::RegisterModel( ) "Mondraviel::RegisterModel( )" for more information. 
 
@section S3 III. Filling a model 
Use @ref Xyndravandria::Mondraviel::Mondraviel::FillModel( ) "Mondraviel::FillModel( )" to fill a model which has been registered earlier. You will be returned the combined content. @n 
Of course, you can fill one and the same model with different values. The model itself will never be changed after it has been registered (unless you change the file used as a model). @n 
Furthermore, you do not have to pass values for the place holders if you would just like to have a static HTML file as a model. @n 
You should, additionally, read the documentation of @ref Xyndravandria::Mondraviel::Mondraviel::FillModel( ) "Mondraviel::FillModel( )" for details. 
 
@section S4 IV. Example 
@verbatim 
<!-- 
################## 
#   Index.html   # 
################## 
--> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
       "http://www.w3.org/TR/html4/loose.dtd"> 
<html> 
 
   <head> 
      <title> 
         $Title 
      </title> 
   </head> 
 
   <body> 
      $Body 
   </body> 
    
</html> 
@endverbatim 
<br> 
@verbatim 
<?php 
################# 
#   Index.php   # 
################# 
require_once( 'Xyndravandria/Mondraviel/Implement.php' ); 
use Xyndravandria\Mondraviel\Mondraviel; 
 
Mondraviel::RegisterModel( 'Index.html' ); 
 
$Filling = array( 'Title' => 'Testing Mondraviel', 
                  'Body' => 'This is a test.' ); 
 
echo Mondraviel::FillModel( 'Index', $Filling ); 
exit; 
?> 
@endverbatim 
<br> 
Output: 
@verbatim 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
       "http://www.w3.org/TR/html4/loose.dtd"> 
<html> 
 
   <head> 
      <title> 
         Testing Mondraviel 
      </title> 
   </head> 
 
   <body> 
      This is a test. 
   </body> 
    
</html> 
@endverbatim 
*/ 
?> 
 
 |