www.stefanheymann.de
Stefan Heymann
Home | Fotografie · Hasselblad · Galerie | Ruler · XML · HomePump · HomeGallery
In den Templates können Platzhalter für verschiedene Inhalte gesetzt werden. Ein
Platzhalter ist links und rechts durch je zwei Raute-Zeichen eingeschlossen. Beispiel:
##IMAGE##
Manche Platzhalter besitzen noch Attribute (analog zu HTML/XML). Hier können
weitere Angaben gemacht werden.
Beispiel: ##IMGWIDTH add="8"##
Platzhalter, die eine URL zurückgeben werden stets ohne umschließende Anführungszeichen ersetzt.
Das Attribut "add" addiert zu dem Wert, der normalerweise
eingesetzt würde noch eine Zahl (die auch negativ sein kann).
Beispiel: Wenn ein Bild 600 Pixel breit ist, dann wird ##IMGWIDTH
add="8"##
durch 608 ersetzt.
Das Attribut "mul" multipliziert den Wert, der normalerweise
eingesetzt würde mit der angegebenen Zahl. Diese muss mit einem Punkt (.) als
Dezimaltrenner angegeben werden. Nach der Multiplikation wird ein ggf. per
"add"-Attribut angegebener Wert hinzuaddiert.
Beispiel: Wenn ein Bild 600 Pixel breit ist, dann wird ##IMGWIDTH
mul="0.66" add="8"##
durch 404 (600*0,66+8) ersetzt.
Diese Platzhalter können an jeder Stelle eingesetzt werden.
Platzhalter | Bedeutung | Attribute |
---|---|---|
CALLINGPAGE | Die aufrufende Seite (entspricht dem Inhalt des Feldes "Aufrufende Seite" im Programm). Damit kann auf die Startseite oder eine Galerie-Übersicht zurück verlinkt werden, ohne dass die URL dazu fest im Template stehen muss. | |
CREATIONDATE | Datum der Erzeugung der Galerie-HTML-Seiten. Das Datum hat defaultmäßig das Format DD.MM.YYYY. Ein anderes Format kann über den Parameter "format" angegeben werden, z. B. ##CREATIONDATE format="YYYY-MM-DD, HH:NN:SS" ## | format |
GALLERYDESCRIPTION | Die Beschreibung der Galerie. Gut geeignet als Bildüberschrift auf der Übersichts-Seite. Muss bei den Kopfdaten der Galerie eingegeben werden. | |
GALLERYNAME | Der Name der Galerie. Gut geeignet für TITLE-Tags oder Überschriften. Muss bei den Kopfdaten der Galerie eingegeben werden. | |
HGVERSION | Name und aktuelle Versionsnummer von HomeGallery | |
IMAGEBORDER | Breite in Pixeln des Randes um die Bilder | |
IMGCOUNT | Anzahl Bilder | |
JPEGQUALITY | Eingestellte JPEG-Quality in ganzen % | |
THUMBS | Die Thumbnail-Tabelle der Übersichts-Seite |
Diese Platzhalter können auf der Bild-Seite und innerhalb der Thumbnail-Zelle verwendet werden.
Zu den Platzhaltern, die ihre Daten aus den EXIF-Metadaten beziehen gibt es eine eigene Dokumentation.
Platzhalter | Bedeutung | Attribute |
---|---|---|
BACK | URL für den Sprung um ein Bild zurück | |
BACKLINK | Ein kompletter Link zum vorherigen Bild. Folgende Attribute werden
unterstützt:
Beispiel: ##BACKLINK pre=" | " text="Zurück" none="--" target="_blank"## |
pre, text, post, none, A-Attribute |
CAPTION | Caption-Feld des aktuellen Bildes | |
DATE | Bild-Datierung | |
DESCRIPTION | Bild-Beschreibung | |
EXIF-... | Einbinden von EXIF-Feldern. Weitere Informationen dazu | tagid, format, index, default |
FIRST | URL für den Sprung zum ersten Bild der Galerie | |
FIRSTLINK | Link zum ersten Bild. Weiteres siehe BACKLINK. | pre, text, post, none, A-Attribute |
IMAGE | Das Bild für die Ansichts-Seite. Dieser Platzhalter wird durch das komplette <img>-Tag ersetzt. ALT-Text ist der Inhalt des ALT-Feldes. Das <img>-Tag kann alternativ auch mit anderen Platzhaltern zusammengebaut werden. Beispiel: <img src="##IMGSRC##" alt="##IMGALT##" title="##IMGALT##" width="##IMGWIDTH##" height="##IMGHEIGHT##" border="##IMAGEBORDER##"> |
|
IMGALT | Der in das ALT-Feld eingegebene Text | |
IMGALTTEXT | Der in das ALT-Feld eingegebene Text bzw. der Caption-Text, wenn ersterer leer ist | |
IMGID | ID-Nummer des Bildes. Diese ID-Nummer kann beliebig vergeben werden (z.B. Bildnummer im eigenen Archivierungs-System) und auch in mehreren Galerien auftauchen. Im Gegensatz dazu steht die IMGGUID, die Galerie übergreifend eindeutig ist. | |
IMGGUID | Galerie übergreifend eindeutige ID. Diese wird von Windows als GUID
erzeugt (Globally Unique Identifier). Die Erzeugung erfolgt auf
Benutzer-Anforderung (Button "Erzeugen") oder wenn die GUID
über den ##IMGGUID##-Platzhalter abgerufen wird. Kann beispielsweise
für Web-Applikationen verwendet werden. Beispiel: {4966BEBF-F886-41F0-ABB0-1166107FA990} |
|
IMGHEIGHT | Höhe des Ziel-Bildes in Pixeln | add, mul |
IMGINDEX | Lfd. Nr. des Bilds, beginnend bei 1 | add |
IMGJPEGQUALITY | Die für das Bild gültiger JPEG-Kompressions-Qualität in ganzen %. Dieser Wert steht auf 100 für Bilder, bei denen das JPEG lediglich kopiert wird | |
IMGORIGHEIGHT | Höhe des Original-Bildes in Pixeln | add, mul |
IMGORIGWIDTH | Breite des Original-Bildes in Pixeln | add, mul |
IMGSIZE | Dateigröße des Bildes (mit einer Nachkommastelle und automatisch gewählter Einheit Byte/KB/MB/GB/TB). Kann auf der Bilderseite oder in der Thumbnail-Zelle verwendet werden. | |
IMGSRC | URL für die Bild-Datei | |
IMGWIDTH | Breite des Ziel-Bildes in Pixeln | add, mul |
LAST | URL für den Sprung zum letzten Bild der Galerie | |
LASTLINK | Link für den Sprung zum letzten Bild der Galerie. Weiteres siehe BACKLINK. | pre, text, post, none, A-Attribute |
NEXT | URL für den Sprung um ein Bild vorwärts | |
NEXTLINK | Link für den Sprung um ein Bild vorwärts. Weiteres siehe BACKLINK. | pre, text, post, none, A-Attribute |
NEXTTHUMB | IMG-Tag für das Thumbnail für das nächste Bild | |
NEXTTHUMBURL | URL für das Thumbnail für das nächste Bild (damit kann das IMG-Tag selbst zusammengebaut werden) | |
ORIGPATH | Pfad des Original-Files | |
ORIGFILE | Dateiname des Original-Files mit Extension | |
ORIGFILEONLY | Dateiname des Original-Files ohne Extension | |
ORIGIMGSIZE | Dateigröße des Original-Bildes. Über das Attribut "decsep" kann der Dezimal-Trenner angegeben werden, z.B. ##ORIGIMGSIZE decsep="."## | decsep |
OVERVIEW | URL für den Sprung zur Übersicht. Sind mehrere Übersichts-Seiten angelegt, zeigt die URL auf die zum Bild gehörende Übersichts-Seite. | |
PREVTHUMB | IMG-Tag für das Thumbnail für das vorherige Bild | |
PREVTHUMBURL | URL für das Thumbnail für das vorherige Bild (damit kann das IMG-Tag selbst zusammengebaut werden) | |
TECHNICALS | Technische Daten zum Bild |
Mit diesen Platzhaltern kann die Navigation über mehrere Übersichts-Seiten hinweg aufgebaut werden.
Platzhalter | Bedeutung | Attribute |
---|---|---|
PAGECOUNT | Anzahl Seiten | |
PAGEINDEX | Nummer der aktuellen Seite. Die erste Seite hat die Nummer 1 | add |
PAGENEXT | URL der nächsten Seite. Von der letzten Seite aus geht's wieder zur ersten. | |
PAGENEXTLINK | Link zur nächsten Seite. Weiteres siehe BACKLINK | pre, text, post, none, A-Attribute |
PAGEPREV | URL der vorigen Seite. Von der ersten Seite aus geht's zur letzten. | |
PAGEPREVLINK | Link zur vorigen Seite. Weiteres siehe BACKLINK | pre, text, post, none, A-Attribute |
PAGEFIRST | URL der ersten Seite | |
PAGEFIRSTLINK | Link zur ersten Seite. Weiteres siehe BACKLINK. | pre, text, post, none, A-Attribute |
PAGELAST | URL der letzten Seite | |
PAGELASTLINK | Link zur letzten Seite. Weiteres siehe BACKLINK. | pre, text, post, none, A-Attribute |
PAGEFIRSTIMGINDEX | Lfd. Nr. des ersten Bilds auf der Seite | add |
PAGELASTIMGINDEX | Lfd. Nr. des letzten Bilds auf der Seite | add |
Innerhalb des TD-Codes für eine Zelle der Thumbnail-Tabelle oder innerhalb des Templates für eine Bild-Seite können folgende Platzhalter verwendet werden:
Platzhalter | Bedeutung | Attribute |
---|---|---|
THUMBURL | URL des Thumbnails innerhalb des TD-Blocks | |
THUMBBORDER | Dicke des Rahmens für das Thumbnail | |
THUMBHEIGHT | Höhe des Thumbnails innerhalb des TD-Blocks | add, mul |
THUMBWIDTH | Breite des Thumbnails innerhalb des TD-Blocks | add, mul |
IMGURL | URL für die Ansichts-Seite des Bilds |
Siehe eigene Dokumentation der EXIF-Platzhalter.