Eine Seite anlegen

Mit dem bevorzugten Editor können nun die einzelnen Seite angelegt werden. Seiten können entweder im JSON- oder YAML-Format gespeichert werden. Eine Kombination von Dateien beider Formate ist möglich.

Über die Dateiendung wird festgelegt, welcher Parser zum Einsatz kommt.

In diesem Beispiel wird YAML verwendet. Wir erstellen eine Seite mit dem Name home.yml:

cat <<EOF > application/config/pages/home.yml

template: rhea/main

EOF

Die Seitendefinition besteht aus verschiedenen Variablen und Abschnitten. Die wichtigste Variable ist dir für das Template template. Mit der Variable Template wird das zu verwendende Template festgelegt.

Der Wert des Templates besteht aus dem Namen des Templates und der zu verwendenden HTML-Datei name/datei ohne Dateierweiterung. In dem Beispiel oben, wird die Datei main.html vom Template rhea verwendet.

Für das Haupttemplate main.html kann die verkürzte Schreibweise rhea verwendet werden.

Die URL wird aus dem Dateinamen gewonnen. Die URL für die Datei home.yml ist /home. Für die Datei de.info.impressum.yml ist die URL /de/info/impressum. Wie man sieht, werden Punkte durch einen Schrägstrich ersetzt.

Möchte man die URL explizit angeben, so kann man die URL über den Schlüssel url definieren.

cat <<EOF > application/config/pages/home.yml

url: /

template: rhea/main

EOF

Mit den Befehl build kann die Seite jetzt erstellt werden. Der Parameter URL ist unter anderem für den Canonical Tag wichtig.

./minerva.phar build --url https://www.example.com/

Das Ergebnis liegt jetzt im Verzeichnis deployment/build.

Als nächster Schritt wird die Seite mit Inhalten gefüllt.