===== Der schnelle Einstieg =====

Lithron benötigt zur Erstellung von PDF Dateien nur einen entsprechenden XML-String. Dieser wird in der Regel aus einer Template Datei generiert und beinhaltet die [[xml-tags| Layoutelemente]], welche mit [[xml-attributes|Attributen]] versehen sind, die das Layout beschreiben.

=== render.php ===
<code>
// using php as a template engine ;) Greetings to Jens
$file = "path/to/my/template.xml.php";
ob_start();
include($file);
$xml = ob_get_clean();
</code>
Um dynamisch XML-Dateien zu generieren wird per PHP die Template-Datei inkludiert und dann als String in die Variable **xml** eingelesen.

<code>
// invoke lithron rendering process
$L = new Lithron();
$L->setXMLString($xml);
$L->init();
$L->work();
</code>
Ein neues lithron-Objekt wird erzeugt und die Eigenschaft **XMLString** wird gesetzt.
Danach wird der Renderer initialisiert und beginnt den XML-Code abzuarbeiten.

<code>
foreach ($L->Files as $file)
{
  // download links
  echo '<h2>Download</h2>';
  echo '<div id="DownloadPanel">';
  echo '<a target="_blank" href="'.$file->FilePath.'">'.$file->propName().'</a>';
}
</code>

Zur den fertigen PDF Dateien gelangt man über die Eigenschaft **Files**.
Der **FilePath** wird global gesetzt und der Dateiname wird aus dem Attribut **name** der **file**-Tags im Template gelesen.

=== Hello World! ===
Dieses Template erzeugt eine DINA4 Seite mit dem Text "Hello World!"
<code>
<?xml version="1.0" encoding="UTF-8"?>
<lithron>
    <file name="demo001.pdf">
        <page>Hello World!</page>
    </file>
</lithron>
</code>
Nach dem obligatorischen XML-Prolog steht das root-Tag **lithron**.\\
Eine neue Datei wird mit dem **file** Tag erzeugt, welches hier als Attribut den '**name**' der Datei trägt.\\
Als Kind des **file**-Tags steht ein **page**-Tag, der eine neue Seite erzeugt.\\
Darin befindet sich ein kurzer Text, welcher mit der Standardschrift gerendert wird.\\

Die fertige PDF-Datei {{:demo001.pdf|}}.


Neugierig geworden? Hier geht es [[examples|zu den weiteren Beispielen]].