Website auf Jinja2-Basis
=========================

Die Website auf Mason2-Basis (bzw. Mason1 auf der digi-Instanz) soll durch eine
Eigenimplementierung auf Jinja2 migriert werden.

Jinja2 läuft auf Django- oder auf Flask-Basis. Wir bevorzugen Flask, da wir
mutmaßlich keine Datenbank brauchen werden, worauf das mächtigere Django
stark ausgerichtet ist. Flask ist in der Beziehung leichtgewichtiger.

`flask`
-----------

Unser auf Jinja2-basierter Application Server mit flask.


`templates` und Layoutkaskaden
----------------------------------

`**/layout.jtml` heißen die kaskadenartig angewendeten Layoutdateien. Wird eine normale Seite mit der
Dateinamensendung `.html` aufgerufen, wird zunächst versucht, eine Datei namens `layout.jtml` aus dem
gleichen Verzeichnis zu laden. Schlägt dies fehl, wird die Suche auf der nächsthöheren Verzeichnisebene
fortgesetzt, und so weiter. Das gleiche geschieht, wenn für eine `layout.jtml` wiederum die nächsthöhere
gefunden werden soll, aber nur solange jeweils die erste Zeile darin lautet:

    {% extends layout() %}

Anstelle von `layout()` kann auch der Dateipfad von einem beliebigen anderen Template stehen.
Dieses wird dann verwendet. Enthält es aber selbst wiederum `{% extends layout() %}`, wird zu derselben
Kaskade zurückgekehrt, als würde es in der eigentlich aufgerufenen Seite stehen.
Jedwedes direkt angegebene Template außer `layout()` schiebt sich gewissermaßen zwischen
die aufgerufene Seite und die weitere, normale Layoutkaskade.

`DSL.*`
-------

Jinja2-Migrationen der Mason-Snippets (`<& /nav1/img, name => "neu" &>`) sind aufrufbar wie folgt:

    `{{ DSL.img(name="neu") }}`


Sprachinfix
-----------

Der Dateiendung der aufgerufenen Seite kann ein `de.`, `en.`, `fr.` oder `it.` vorangehen. Weitere
Sprachen können jederzeit hinzugefügt werden. Da es aber auch Top-Level-Verzeichnisse mit zwei
Buchstaben langen Namen geben kann (z.B. `nc/`), werden nur registrierte Sprachkürzel nach dieser
Logik berücksichtigt.

Erscheint in der URL als erstes Pfadsegment nach der Domain ein Sprachinfix (statt "en" geht
auch "Englisch/", "English", groß oder klein geschrieben), so wird bevorzugt die
entsprechende Fassung aufgerufen.

Alternativ, sollte die angefragte Fassung der Seite nicht gefunden werden, wird die englische bzw. die
deutsche Fassung genommen.

Aufrufe der Funktion `DSL.i18n(de="Text in deutscher Sprache", en="...", ...)` lösen sich entsprechend
der gefundenen Fassung auf, wenn der Textstring in der angefragten Sprache nicht verfügbar ist. Danach
wird die englische, dann die deutsche Fassung probiert.

Gleiches gilt für `DSL.i18n` im Filtermodus: `{% filter DSL.i18n %}...{% endfilter %}` kann immer dann
benutzt werden, wenn für unterschiedliche Sprachen verschiedene HTML-Markups verwendet werden sollen. Alle
von diesem Filter umfassten Inhalte werden gefiltert nach Elementen mit lang-Attribut. Nur diejenigen
dieser Elemente, die auf die angefragte bzw. gefundene Sprachfassung passen, werden samt Inhalt angezeigt.


Markdown
--------

Es wird ein Filter `markdown` definiert. In der Layout-Datei kann man diesen wie folgt nutzen:

    {% filter markdown %}
    {% block content %}Diese Seite hat keinen Inhalt, denn es ist nur die layout.jtml-Datei.{% endblock %}
    {% endfilter %}