======Report selbst bauen======
====Allgemein====
{{  de:media:report-example.png?35%}}
Diese Seiten sind ganz normale Textseiten. Damit sie individuell gestaltet werden können, sind
Formatierungsanweisungen direkt im Text untergebracht. Die Formatierungsanweisungen teilen dem
Anzeigesystem mit, wie die Seite dargestellt werden soll. Der Text mit den Formatierungsanweisungen
ist der //Quelltext// der Seite.

Klicken sie auf den Link zur Seite **[[wiki:syntax|Syntax]]** um die Beispiele zu sehen. Den Quelltext jeder Seite können sie einsehen und
auch bearbeiten.

Die Quelltexte der Seiten werden im Programmverzeichnis im Ordner //**/doku**// abgelegt, nach
jeweiliger Sprache getrennt.

Die Report-Seiten liegen im Ordner //**doku/<sprachkürzel>/report/**// vor. **//<Sprachkürzel>//**
ist hierbei der jeweilige ISO-Ländercode, für Deutschland z.B. **//"de"//**. Deutschsprachige
Seiten liegen demnach im Ordner

**//doku/de/report/**//

**Bilder und andere Mediendateien** werden in einem Unterordner **//media//** abgelegt. Für Reports
demnach unter

//**doku/de/report/media/**//

Änderungen an den Seiten werden in die jeweiligen **Dateien** gespeichert. Beim Erstellen von 
neuen Seiten wird die entsprechende Ordnerstruktur und Seitendatei automatisch erzeugt (sofern möglich).
**Diese doku-Seiten** sind dynamisch gezeichnete Dokumente, ähnlich einer HTML-Seite, nur mit einer viel __einfacheren Syntax__.

====Wie funktionierts?====
**Neue Seiten** können angelegt werden, indem man einfach einen Link auf die (noch) nicht existierende Seite in eine vorhandene Seite schreibt und diesen Link dann aufruft.

[[report:test|Diese Seite]] existiert beispielsweise noch nicht. Wenn sie auf den Link klicken, gelangen sie zu einer Seite, welche einen "Nicht-gefunden"-Hinweis enthält. Wenn sie dort den Knopf **[//Diese Seite bearbeiten//]** anwählen, können sie die Seite mit Inhalten füllen und speichern. Wenn sie eine Seite löschen wollen, speichern sie die Seite einfach ohne Inhalt.

**Zum Bearbeiten des Reports** klicken sie im Report rechts oben auf den Knopf **[//Diese Seite bearbeiten//]**

Die Formatierung in den Seiten wird durch einfache Formatierungsbefehle vorgenommen.

==Formatierungen in den Seiten & Pragma's (Platzhalter):==
  * [[wiki:syntax|Syntaxbeschreibung anzeigen und ausprobieren]]
  * [[de:doku:report-pragmas|Pragma's (Platzhalter) zum Einbetten von Werten]]


----
====Werte & Ergebnisse aus der aktuellen Laborierung====
**Die Werte aus der aktuellen Laborierung und deren Ergebnisse** lassen sich in doku-Seiten einbetten. Das Auslesen eines Wertes erfolgt mit einem sog. **"Pragma"**. Ein Pragma ist eine Anweisung die mit doppelten Tilde-Symbolen ("~~") eingeschlossen wird.

**Die Werte** sind in //Quellen// eingeordnet. Jede Quelle hat wiederum verschiedene //Eigenschaften// (Werte) die man auslesen kann.
Um einen bereitgestellten Wert auszulesen, gibt man die **//Quelle//** gefolgt von einem **//Punkt//** und den **//Eigenschaftsnamen//** an:

===Quelltext===
  ~~quelle.eigenschaft~~

**Listenwerte** sind Werte die mehr als einen Eintrag zur Verfügung stellen. Diese Werte benötigen eine
Zahl **beginnend mit 0 (Null)** für den gewünschten Listeneintrag:
===Quelltext===
  ~~quelle.eigenschaft[zahl]~~

**Die Werte** stellen entweder //Text// oder //Zahlenwerte// bereit. Werte die //Zahlenwerte// bereitstellen, können in der Ausgabe mit einer Formatierung gesteuert werden. Ist eine Zahlenformatierung gewünscht, werden zusätzlich in //Klammern// und //Anführungsstriche// die **[[de:doku:report-formatstring|Formatierungszeichen]]** als Parameter angegeben:
===Quelltext===
  ~~quelle.eigenschaft~~                //automatisch, Ggf. inkl. Maßeinheit
  ~~quelle.eigenschaft[zahl]~~          //automatisch, Ggf. inkl. Maßeinheit (Listeneintrag)
  ~~quelle.eigenschaft("#.000")~~       //nach Vorgabe, ohne Ausgabe der Maßeinheit
  ~~quelle.eigenschaft[zahl]("#.000")~~ //nach Vorgabe, ohne Ausgabe der Maßeinheit (Listeneintrag)
  ~~quelle.eigenschaft("#.000 mm²")~~   //mit gewünschter Maßeinheit, automatische Umrechung sofern möglich


===Quellen und Eigenschaften===
  * **[[de:doku:report-file|Quelle "File"]]**
  * **[[de:doku:report-work|Quelle "Work"]]**
  * **[[de:doku:report-result|Quelle "Result"]]**
  * **[[de:doku:report-caliber|Quelle "Caliber"]]**


===Hinweis===
Bitte beachten sie, dass die Ausgabe von Zahlenwerten nach der **ISO-Norm** erfolgt, d.h. der Dezimalpunkt ist tatsächlich ein **Punkt**! Die sogutwie nur im deutschen gebräuchliche Notation mit "Komma" als Dezimalpunkt wird hier **nicht** verwendet.