Report selbst bauen

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 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. 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):== * Syntaxbeschreibung anzeigen und ausprobieren * 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 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=== * Quelle "File" * Quelle "Work" * Quelle "Result" * 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.