Die Erzeugung der Galerie wird gestartet durch:
bilderwichtel
‹konfigurationsdatei›
Konfigurationsdatei:
Leere Zeilen und Zeilen, die mit #
beginnen, werden ignoriert.
Bausteine zur Erzeugung der Galerie
-
bilderverzeichnis
‹directory1› …Basisverzeichnis für die Originalbilder.
Die Bild-Originale in der Datenbank-CSV-Datei werden relativ zu einem dieser Verzeichnisse angegeben.
Dieser Befehl darf mehrfach benutzt werden.
-
datenbankdatei
‹bilderdaten.csv›Diese CSV-Datei enthält die Dateipfade aller Bilder, die in die Galerie aufgenommen werden sollen, zusammen mit deren Klassifizierung und Verschlagwortung.
Dieser Befehl darf mehrfach benutzt werden; die Dateien werden in der angegebenen Reihenfolge gelesen.
-
datenbankfeld
‹feld1› ‹feld2› ‹held3› …Die Spalten der CSV-Datei werden benannt, um darauf zugreifen zu können.
Zur Erzeugung der Galerie-Seiten wird jeweils eine Auswahl der Zeilen benutzt; bei
werden so viele Zeilen ausgewählt, wie die ausgewählte Spalte eindeutige Werte hat, und zwar für jeden Wert die erste Zeile, in der das Feld diesen Wert hat. (kleines Beispiel?)je
‹feldname› -
setze
‹virtuelles_feld› ‹wert_mit_platzhaltern›Dieser Befehl erzeugt virtuelle Felder in der Datenbank, deren Wert Platzhalter enthält, die mit den Werten anderer Felder gefüllt werden.
Dieser Befehl darf mehrfach benutzt werden, um mehrere virtuelle Felder zu erzeugen.
-
textverzeichnis
‹directory1› …Basisverzeichnis für längere Texte.
Langtexte werden relativ zu einem dieser Verzeichnisse angegeben.
Dieser Befehl darf mehrfach benutzt werden.
-
layoutverzeichnis
‹directory1› …Basisverzeichnis für HTML-Seitenvorlagen.
Die HTML-Vorlagen für die erzeugten Seiten werden in diesen Verzeichnissen gesucht.
Dieser Befehl darf mehrfach benutzt werden.
Hilfswerte
-
makro
‹name› ‹wert›Dieser Befehl erzeugt Abkürzungen für häufig verwendete Strings. Der Wert kann Platzhalter für Variablen enthalten, die erst bei der Nutzung des Makros bekannt sind. Diese Platzhalter haben die Form
$‹format›{‹variable›}
. Eine neue Zeile im Wert wird mit\n
angegeben. -
bildgroesse
‹name› ‹max-breite› ‹max-hoehe› ‹max-pixels›Die Originalbilder können für die Galerie skaliert werden. Die gewünschten Größen werden hier konfiguriert und benannt.
Galerie-Ziel
-
zielverzeichnis
‹directory›Basisverzeichnis der erzeugten Galerie. Die Pfade der zu erzeugenden Objekte werden relativ zu diesem Verzeichnis angegeben.
Galerie
-
je
‹feldname1› …Aus der Datenbank-CSV wird je Kombination der Werte der angegebenen Felder der erste Eintrag ausgewählt, dessen Werte mit dieser Wertekombination übereinstimmen.
wählt alle Einträge aus,je *
ohne Feldname wählt den ersten Eintrag aus.je
-
sort
‹feldname1› …Sortiert die mit
ausgewählten Einträge nach den Werten der angegebenen Felder.je
-
gruppe
‹gruppenname› ‹feld1› …Erzeugt ein virtuelles Datenbankfeld, in dem je Eintrag eine List alle Einträge gespeichert wird, die in allen ausgewählten Feldern die gleichen Werte haben wie dieser Eintrag.
-
bild
‹bildquellen_feldname› ‹ziel_pfad› ‹groessen_id› ‹virtueller_feldname›Bildskalierung für Galerie. Der Pfad des Originalbildes (relativ zu einem der Bilderverzeichnisse) wird aus dem angegebenen Feld der Bild-Datenbank-CSV entnommen.
Das skalierte Bild wird unter dem angegebenen Pfad (relativ zum Zielverzeichnis gespeichert.
Zielgröße ist die mit ‹groessen_id› benannte
bildgroesse
.Der Zielpfad ist gleichzeitig die relative Ziel-URL; er wird in einem virtuellen Datenbankfeld gespeichert, dessen Namen mit ‹virtueller_feldname› bestimmt wird.
-
seite
‹layout_vorlage› ‹ziel_uri›Der Inhalt der Layout-Vorlage wird nach Makroersetzung unter der angegebene Ziel-Uri gespeichert.
Makro-Expansion:
Makro-Aufrufe haben die Form:
$‹fn›.‹f2›.‹f1›{‹field›}
Auf den Wert des Feldes für das gerade ausgewählte Datenbank-Element werden die Funktionen in der Reihenfolge von rechts nach links angewandt. Die Funktionsliste darf auf leer sein.
Folgende Funktionen sind definiert:
- count:
-
Zählt die Wörter (durch Leerzeichen getrennt) im Argument:
→Sehr schön. :-)
3
- html:
-
Wandelt die Zeichen
&
,<
,>
,"
und'
in HTML-Entities:
→<A&B>
<A&B>
- id:
-
Reduziert das Argument auf eine Id, die nur aus
-a
undz
besteht:_
→Häuser GmbH&Co Kg
haeuser_gmbh_co_kg
- int:
- Wandelt das Argument in eine Ganzzahl.
- lc:
- Wandelt das Argument nach Kleinschreibung.
- monat:
-
Konvertiert
1
bis12
zu deutschen Monatsnamen. - nobrk:
- Konvertiert die Leerzeichen im Argument in geschützte Leerzeichen.
- noext:
-
Entferne die Datei-Erweiterung vom Argument:
→test.txt.gz
test.txt
- para:
-
Erzeugt aus einem Langtext
<p>
-geklammerte Absätze. - patch:
- Expandiert das Argument ein zweites Mal.
- plural_en:
-
Erzeugt ein
en
, wenn das Argument nicht1
ist. - plural_er:
-
Erzeugt ein
er
, wenn das Argument nicht1
ist. - rlink:
- Macht eine Uri relativ zur gerade erzeugten Seite.
- rlinks:
-
Macht alle
- undhref=
-Uris relativ zur gerade erzeugten Seite.src=
- text_‹id›:
-
Ersetzt das Argument durch den Langtext mit index
‹id›:‹argument›
. - uc:
- Wandelt das Argument nach Großschreibung.
- years:
-
Konvertiert ein angegebenes Jahr zu
‹jahr›-‹dieses_jahr›
. - ‹table›:
-
Übersetzung durch Table-Lookup:
Wenn das Makro
definiert ist, wird das Argument durch den Wert dieses Makros ersetzt.‹table›_‹argument›
Ansonsten, wenn das Makro
definiert ist, wird das Argument durch den Wert dieses Makros ersetzt.‹table›_default
- ‹loop›:
-
Erzeugt Listen oder Tabellen aus den Mitgliedern der im Argument angegebenen Gruppe.
Die Einträge werden per Default mit dem Makro
dargestellt. Weitere Makros werden (optional) genutzt:‹loop›
‹loop›_self
wenn der bearbeitete Eintrag identisch dem Gruppenmitglied ist ‹loop›_next
wenn der bearbeitete Eintrag identisch dem Vorgänger des Gruppenmitglieds ist ‹loop›_prev
wenn der bearbeitete Eintrag identisch dem Nachfolger des Gruppenmitglieds ist ‹loop›_prefix
Wird vor dem ersten Element ausgegeben ‹loop›_infix
Wird zwischen zwei Elementen ausgegeben ‹loop›_infix‹n›
Wird nach je ‹n› Elementen statt ‹loop›_infix ausgegeben. ‹loop›_suffix
Wird nach dem letzten Element ausgegeben