Readme zur Benutzung der Umgebung
=================================

Kompilieren
-----------

Hierfür `make -B` aufrufen, die Webseite wird dann zusammengesetzt im Ordner `online` ausgegeben. Vorhandene html-Dateien im Ordner `online` werden direkt überschrieben. Da es sich bei den html-Dateien im Ordner `online` quasi um Kompilierprodukte handelt, werden diese im SVN auch per Property ignoriert.

**Wichtig:** vorher im Ordner `experiments` Symlinks zu den MVNX Dateien anlegen und benötigte Programme installieren (siehe unten).

**Nachtrag:** Das Ziel `experiments` wurde entfernt, da `gnumeric` (`ssconvert`)
auf dem Server nicht intalliert ist.

Menüreihenfolge
---------------

Das Menü wird automatisch in aufsteigender Reihenfolge der Präfixe (`1-`, `2-` erstellt).

Platzhalter
-----------

Aktuell werden folgende automatischen Platzhalter verwendet:
<dl>
        <dt>{{content}}</dt>
        <dd>Hier wird der Inhalt der einzelnen html-Seiten eingesetzt.</dd>
        <dt>{{date}}</dt>
        <dd>Datum und Uhrzeit der Erstellung der Datei.</dd>
        <dt>{{menu}}</dt>
        <dd>Hier wird das Menü eingesetzt.</dd>
        <dt>{{TITLE}}</dt>
        <dd>Hier wird der Name der Datei ohne Präfix eingesetzt.</dd>
	<dt>{{XSENS}}</dt>
	<dd>Hier wird der Name des XSens Anzuges eingesetzt.</dd>
	<dt>{{table::path-to-table-without-extension}}</dt>
	<dd>Der Inhalt der CSV-Datei wird in thead- und tbody-tags gepackt eingesetzt.</dd>
	<dt>{{exechelp::path-to-script}}</dt>
	<dd>Das Skript wird mit Parameter `-h` ausgeführt und die Ausgabe in pre-tags gepackt eingesetzt.</dd>
	<dt>{{gallery::path-to-info-file?w200nosync[image1, image1]}}</dt>
	<dd>Die Bilder in der genannten Informationsdatei werden als Galerie mit
        Bildunterschrift aus der Informationsdatei eingefügt. Optional können
        auch nur bestimmte Bilder herausgefiltert werden (in eckigen Klammern).
        Der Wert `w200` steht für die Breite der Bilder und ist **nicht**
        optional. Es ist möglich ein `nosync` an die Bildbreite anzuhängen, was
        verhindert, dass die figure-Container zur Synchronisierung der Höhe
        berücksichtigt werden.</dd>
</dl>

Folgende Platzhalter werden aktuell in der **Makefile** gesteuert:
<dl>
        <dt>{{jquery}}</dt>
        <dd>Fügt die Javaskriptdateien für JQuery ein.</dd>
        <dt>{{metano}}</dt>
        <dd>Fügt ein `no` in den robots Angaben hinzu.</dd>
        <dt>{{lightbox}}</dt>
        <dd>Fügt die Javaskriptdateien für einen Lightbox Klon ein.</dd>
</dl>

Benötigte Programme
-------------------

Zum Konvertieren wird eine funktionierende Installation von 
<ul>
	<li>**R**</li>
	<li>**RScript**</li>
	<li>**GNU make**</li>
	<li>**Gawk**</li>
	<li>**ssconvert** (in **Gnumeric** enthalten)</li>
</ul>
 vorausgesetzt.

Folgende R Bibliotheken werden verwendet:
<ul>
	<li>getopt</li>
	<li>scatterplot3d</li>
	<li>XML</li>
</ul>