Author: Stefan Spaeth
Description: Beschreibung der Konfigurationseinträge für createPhotoWebPages.pl

# createPhotoWebPages.pl - Konfigurationseinträge

zurück zur Hauptseite

Alle Einträge werden mit Großbuchstaben gebildet. Sie können in verschiedene Gruppen eingeteilt werden. Jeder Eintrag ist von einem bestimmten Typ. Typen und Eintragskategorien werden in den folgenden Abschnitten erläutert.

- Eintragstypen
- Grundlegende, allgemeine Einträge
- Allgemeine Einstellungen zum script
- Umbenennungs-Parameter
- Parameter zur Bilderzeugung
- Weitere Bilderzeugungs-Parameter
- HTML Farben
- Allgemeine HTML Parameter
- HTML Format Parameter
- HTML Dateinamen Parameter
- HTML Parameter für die Startseite (Top-Seite)
- Thumbnail HTML Seiten Parameter
- Bild Parameter

## Eintragstypen

Type | Beschreibung
--- | ---
String (string) | Eine beliebige Textzeile die auch Leerzeichen enthalten darf. Selbst HTML-Elemente sind kein Problem. Es muss ein einzeiliger Eintrag sein. Manche Einträge sind im Feld Vorbelegung als <multiline> gekennzeichnet. Dies bedeutet, daß der Eintrag mehrfach hintereinander auftauchen darf und dann als eine Liste von Strings behandelt wird. Mehrzeileneinträge sind nicht vorbelegt.
Wort (word) | Ein Textelement aus beliebigen Zeichen welches keine Leerzeichen enthalten darf. Es muss ein einzeiliger Eintrag sein. Normalerweise ergeben sich sinnvolle gültige Zeichen aus dem Zusammenhang.
Pfadname (pathname) | Ein Datei oder Verzeichnisname mit zugehöriger Pfadangabe.
Schalter (boolean) | Hier sind nur die Werte 0 und 1 erlaubt. 1 = Schalter ein, 0 = Schalter aus.
Farbe (color) | Eine Farbe im HTML-Format. Das Format besteht aus einem führenden "#" Zeichen und 6 folgenden Hexadezimalziffern (Groß- und Kleinschreibung erlaubt).
Ganzzahl (integer) | Eine beliebige ganze Zahl. Meistens ist der gültige Wertebereich noch zusätzlich eingeschränkt.
Festkommazahl (fixed) | Eine beliebige Festkommazahl oder ganze Zahl. Meistens ist der gültige Wertebereich noch zusätzlich eingeschränkt.

Zurück nach oben

## Grundlegende, allgemeine Einträge

Eintrag | Typ | Vorbelegung | Beschreibung
--- | --- | --- | ---
TITLE | String | Photo Thumbnails Web Page | Der Titel des HTML-Documents, bzw. der gesamten HTML-Seiten.
EMAIL | Wort | S.Spaeth@z.zgs.de | Email des HTML-Authors (erwartet ein "@" Zeichen)
AUTHOR | String | Stefan Spaeth | Name des HTML-Authors
COPYRIGHT | String | Copyright © 2002 Stefan Spaeth | Copyright Text
LEVEL_UP | Pfadname | ../index.html | Beschreibt den Pfadnamen der übergeordneten HTML-Seite. Ein Link wird darauf gesetzt wenn der Wert nicht leer ist.
WEB_READY | Schalter | 0 | Bestimmt die Betriebsart: 1 = Web-Ready Modus 0 = Dateisystem-Modus
TARGET_DIR | Pfadname | ./test/ | Nur im Web-Ready Modus. Beschreibt das Zielverzeichnis. Es ist ein relativer Pfadname erforderlich. Das angegebene Verzeichnis muss bereits existieren.
IVIEW_SELECTION_FILE | Pfadname | Slideshow.lst | Benennt die Datei in der Pfadnamen in einer für das Programm "iview" geeigneten Weise abgelegt werden. Eine leerer Eintrag verhindert, daß die Liste geschrieben wird. Die Datei wird dort angelegt wo auch die HTML Index Dateien abgelegt werden.

Zurück nach oben

## Allgemeine Einstellungen zum script

Die hier angegebenen Einträge werden in einer späteren Version in Konfigurationsoptionen umgewandelt.

Eintrag | Typ | Vorbelegung | Beschreibung
--- | --- | --- | ---
USE_JPEGTRAN_JHEAD | Schalter | 1 | Dieser Schalter gibt an ob die Hilfsprogramme "jhead" und "jpegtran" verfügbar sind. In einigen Fällen kann auf diese Programme verzichtet werden. Dort wird dieser Schalter eingesetzt. 1 = verfügbar, 0 = nicht verfügbar.

Zurück nach oben

## Umbenennungs-Parameter

Diese Parameter entscheiden im Suchmodus darüber wie ein eingelesener Bilddateiname in einen "IMAGE_NAME" Eintrag umgewandelt wird.
Beim Umbenennen wiederum werden die gleichen Regeln angewandt um aus dem "IMAGE_NAME" Eintrag einen neuen Dateinamen zu erzeugen.
Beispiele zu den folgenden Einträgen sin in der Beschreibung zu den Umbenennungsregeln zu finden.

Eintrag | Typ | Vorbelegung | Beschreibung
--- | --- | --- | ---
IMG_NAME_NO_ALPHA_PREFIX | Schalter | 1 | Dieser Eintrag wirkt nur beim Einlesen der Konfigurationsdatei. Beim Erzeugen von Dateinamen hat er keine Bedeutung. Wenn der Schalter auf 1 gesetzt ist, dann wird ein vorhandener aus Kleinbuchstaben bestehender Dateinamens-Vorspann (Prefix) nicht in den "IMAGE_NAME" Eintrag übernommen. Siehe auch Prefix-Option.
IMG_NAME_NO_NUMBER_PREFIX | Schalter | 0 | Dieser Eintrag wirkt nur beim Einlesen der Konfigurationsdatei. Beim Erzeugen von Dateinamen hat er keine Bedeutung. Wenn der Schalter auf 1 gesetzt ist, dann wird ein vorhandener aus Ziffern bestehender Dateinamens-Vorspann (Prefix) nicht in den "IMAGE_NAME" Eintrag übernommen.
IMG_NAME_NO_NUMBER_SUFFIX | Schalter | 1 | Beim Lesen eines Dateinamens wird zwischen einen Buchstaben und Ziffern am Ende des Dateinamens ein Leerzeichen gesetzt. Beim Erzeugen eines Dateinamens werden mit Leerzeichen getrennte Ziffern am Ende wieder an die Buchstaben angefügt und die Leerzeichen entfernt. Das Verhalten kann durch Setzen des Wertes auf 0 abgeschaltet werden.
IMG_NAME_REPLACE_UNDERSCORE | Schalter | 1 | Wenn dieser Schalter auf 1 gesetzt ist dann werden beim Einlesen Unterstriche durch ein Leerzeichen ersetzt, und beim Erzeugen des Dateinamens Leerzeichen durch Unterstriche ersetzt.Das Verhalten kann durch Setzen des Wertes auf 0 abgeschaltet werden.
IMG_NAME_REPLACE_DASH | Schalter | 0 | Wenn dieser Schalter auf 1 gesetzt ist dann werden beim Einlesen Bindestriche durch ein Leerzeichen ersetzt, und beim Erzeugen des Dateinamens Leerzeichen durch Bindestriche ersetzt. Das Verhalten kann durch Setzen des Wertes auf 0 abgeschaltet werden.
IMG_NAME_BLANK_BEFORE_CAPS | Schalter | 1 | Dieser Eintrag bewirkt beim Setzen auf 1, daß ein Großbuchstabe der auf einen Kleinbuchstaben folgt durch ein Leerzeichen getrennt wird. Umgekehrt werden Leerzeichen beim Erzeugen von Dateinamen wieder entfernt. Das Verhalten kann durch Setzen des Wertes auf 0 abgeschaltet werden.

Zurück nach oben

## Parameter zur Bilderzeugung

Eintrag | Typ | Vorbelegung | Beschreibung
--- | --- | --- | ---
IMG_BORDER_COLOR | Farbe | #000000 | Farbe des optionalen Rahmens der erzeugten Bilder
IMG_SHADOW_COLOR | Farbe | #333333 | Farbe des optionalen Schattens der erzeugten Bilder
IMG_BORDER_WIDTH | Ganzzahl | 1 | Dicke des optionalen Rahmens der erzeugten Bilder, 0 = kein Rahmen gewünscht. Werte von 0 bis 128 sind erlaubt.
IMG_SHADOW_ENABLE | Schalter | 1 | Schaltet die Schattenbildung bei erzeugten Bildern ein. 0 = kein Schatten gewünscht.
IMG_SHADOW_OFFSET | Ganzzahl | 3 | Gibt die Schattentiefe für Thumbnail-Bilder an. Wert in Pixel. Für Button-Bilder gilt der gleiche Wert. Für Websize-Bilder wird ein doppelt so großer Wert genommen. Werte von 0 bis 128 sind erlaubt.
IMG_SHADOW_BLUR | Ganzzahl | 5 | Gibt die Unschärfetiefe für den Schatten der Thumbnail-Bilder an. Wert in Pixel. Für Button-Bilder gilt der gleiche Wert. Für Websize-Bilder wird ein doppelt so großer Wert genommen. Werte von 0 bis 128 sind erlaubt.
THUMBNAIL_ROTATION_ANGLE | Festkommazahl | 0 | Gibt den maximalen Rotationswinkel für Thumbnail-Bilder an. 0 = nicht rotieren. Werte von 0 bis 10.0 erlaubt. Werte kleiner als 0.1 werden ignoriert.
THUMBNAIL_RANDOM_ROTATE | Schalter | 0 | Entscheidet ob alle Thumbnail-Bilder mit dem gleichen Winkel rotiert werden oder ob der Winkel ein Maximal-Wert ist und der tatsächliche Winkel per Zufallswert aus dem Bereich plus Maximal-Wert bis minus Maximal-Wert ermittelt wird. 1 = Zufallswerte benutzen. 0 = fester Rotationswinkel.
WEBSIZE_ROTATION_ANGLE | Festkommazahl | 0 | Gibt den maximalen Rotationswinkel für Websize-Bilder an. 0 = nicht rotieren. Werte von 0 bis 5.0 erlaubt. Werte kleiner als 0.1 werden ignoriert.
WEBSIZE_RANDOM_ROTATE | Schalter | 0 | Entscheidet ob alle Websize-Bilder mit dem gleichen Winkel rotiert werden oder ob der Winkel ein Maximal-Wert ist und der tatsächliche Winkel per Zufallswert aus dem Bereich plus Maximal-Wert bis minus Maximal-Wert ermittelt wird. 1 = Zufallswerte benutzen. 0 = fester Rotationswinkel.
IMG_JPEG_QUALITY | Zahl | 75 | Gibt den Kompressionsgrad für die erzeugten JPEG-Bilder an. Werte zwischen 0 und 100 sind erlaubt. 100, 90, 75 und 50 sind sinnvolle Werte.
IMG_JPEG_PROGRESSIVE | Schalter | 1 | Entscheidet ob das Websize-Bild im Progressive JPEG Modus gespeichert wird. 1 = Progressive Mode, 0 = nicht im Progressive Mode.
IMG_IMPRINT_DEFAULT | String |  | Dieser Text wird bei allen Websize-Bildern rechts unten im Bild eingeblendet. Hier kann man zum Beispiel allgemeine Copyright- oder Kamerainformation unterbringen. Ein fehlender Wert unterdrückt die Einblendung. Zu beachten ist, daß HTML-Elemente hier nicht verwendet werden können. Der Eintrag IMAGE_IMPR der jedem Bild separat zugeordnet werden kann überschreibt die Voreinstellung.
IMG_ADD_JPG_INFO_PAGE | Schalter | 0 | Mit diesem Schalter kann entschieden werden ob per Voreinstellung immer eine JPEG-EXIF-Informationsseite erzeugt werden soll. 1 = Info-Seite erzeugen, 0 = keine Info-Seite erzeugen. Der Eintrag IMAGE_INFO der jedem Bild separat zugeordnet werden kann überschreibt die Voreinstellung.

Zurück nach oben

## Weitere Bilderzeugungs-Parameter

Die folgenden Parameter legen die konkreten Abmessungen, Namensbestandteile sowie Zielverzeichnisse der zu generierenden Bilder fest.

Eintrag | Typ | Vorbelegung | Beschreibung
--- | --- | --- | ---
THUMBNAIL_SIZE | Ganzzahl | 128 | Die maximale Breite oder Höhe (die größere Seite entscheidet) des zu erzeugenden Thumbnail-Bildes. Erlaubte Werte liegen zwischen 64 und 256.
BUTTON_SIZE | Ganzzahl | 64 | Die maximale Breite oder Höhe (die größere Seite entscheidet) des zu erzeugenden Button-Bildes. Erlaubte Werte liegen zwischen 32 und 256.
WEBSIZE_SIZE | Ganzzahl | 640 | Die maximale Breite oder Höhe (die größere Seite entscheidet) des zu erzeugenden Websize-Bildes. Erlaubte Werte liegen zwischen 256 und 1024.
ALWAYS_WEBSIZE | Schalter | 0 | Wenn die Breite oder Höhe (die größere Seite entscheidet) des Bildes den Wert von WEBSIZE_SIZE überschreitet, wird das Bild auf Websize verkleinert. Wird dieser Schalter auf "1" gesetzt, wird ein kleineres Bild notfalls auch vergrößert. Ein Wert von "0" beläßt ein kleineres Bild in Originalgröße.
FULLSIZE_SIZE | Ganzzahl | 800 | Die maximale Breite oder Höhe (die größere Seite entscheidet) des zu erzeugenden Fullsize-Bildes (siehe FULLSIZE_ENABLE). Erlaubte Werte liegen zwischen 512 und 4096.
FULLSIZE_ENABLE | Schalter | 0 | Schaltet die Erzeugung und Nutzung eines großformatigen Bildes ("Fullsize") ein. Dieses wird dann an Stelle des Original-Bildes benutzt. Dieser Eintrag ist insbesondere im Web-Ready-Modus) interessant.
THUMBNAIL_SUFFIX | Wort | _thumbnail | Der hier angegebene Namensbestandteil wird an den Dateinamen des Originalbildes angeängt, was zusammen den Namen des Thumbnail-Bildes ergibt.
THUMBNAIL_DIR | Wort | thumbnails | In diesem Verzeichnis werden alle generierten Thumbnail-Bilder abgelegt. Es befindet sich entweder dort wo das Originalbild abgelegt ist (Dateisystem-Modus), oder in dem durch den "TARGET_DIR" Eintrag festgelegten Zielverzeichnis (Web-Ready-Modus).
BUTTON_SUFFIX | Wort | _button | Der hier angegebene Namensbestandteil wird an den Dateinamen des Originalbildes angeängt, was zusammen den Namen des Button-Bildes ergibt.
BUTTON_DIR | Wort | buttons | In diesem Verzeichnis werden alle generierten Button-Bilder abgelegt. Es befindet sich entweder dort wo das Originalbild abgelegt ist (Dateisystem-Modus), oder in dem durch den "TARGET_DIR" Eintrag festgelegten Zielverzeichnis (Web-Ready-Modus).
WEBSIZE_SUFFIX | Wort | _websize | Der hier angegebene Namensbestandteil wird an den Dateinamen des Originalbildes angeängt, was zusammen den Namen des Websize-Bildes ergibt.
WEBSIZE_DIR | Wort | websize | In diesem Verzeichnis werden alle generierten Websize-Bilder abgelegt. Es befindet sich entweder dort wo das Originalbild abgelegt ist (Dateisystem-Modus), oder in dem durch den "TARGET_DIR" Eintrag festgelegten Zielverzeichnis (Web-Ready-Modus).
FULLSIZE_SUFFIX | Wort | _fullsize | Der hier angegebene Namensbestandteil wird an den Dateinamen des Originalbildes angeängt, was zusammen den Namen des Fullsize-Bildes ergibt.
FULLSIZE_DIR | Wort | fullsize | In diesem Verzeichnis werden alle generierten Fullsize-Bilder abgelegt. Es befindet sich entweder dort wo das Originalbild abgelegt ist (Dateisystem-Modus), oder in dem durch den "TARGET_DIR" Eintrag festgelegten Zielverzeichnis (Web-Ready-Modus).
THUMBNAILS_PER_ROW | Ganzzahl | 4 | Dieser Wert bestimmte die maximale Anzahl Thumbnail-Bilder die auf einer Thumbnail-HTML-Seite in einer Zeile stehen können. Die erlaubten Werte liegen zwischen 3 und 8.
THUMBNAILS_MAX_ROWS | Ganzzahl | 3 | Dieser Wert bestimmt die maximale Zahl Thumbnail-Bild-Zeilen in der Thumbnail-HTML-Seite bevor eine neue Thumbnail-HTML-Seite begonnen wird. Die erlaubten Werte liegen zwischen 1 und 128. Zu beachten ist, daß diese Beschränkung nicht für die Top-Thumbnail-HTML-Seite gilt. Dort wird angenommen, daß sich die Zahl der "SUBTITLE"-Einträge im Rahmen halten wird.

Zurück nach oben

## HTML Farben

Die in diesem Abschnitt beschriebenen Farb-Parameter erlauben es alle möglichen in HTML definierten Farben enzustellen.

Eintrag | Typ | Vorbelegung | Beschreibung
--- | --- | --- | ---
HTML_BG_COLOR | Farbe | #ffffdd | Hintergrundfarbe der HTML-Seiten
HTML_TEXT_COLOR | Farbe | #000000 | Textfarbe der HTML-Seiten
HTML_LINK_COLOR | Farbe | #3333ff | Farbe der Links in den HTML-Seiten
HTML_VLINK_COLOR | Farbe | #993399 | Farbe der besuchten Links in den HTML-Seiten
HTML_ALINK_COLOR | Farbe | #000099 | Farbe der aktiven Links in den HTML-Seiten

Zurück nach oben

## Allgemeine HTML Parameter

Mit diesen Parametern werden allgemeine Anzeigeteile in den HTML-Seiten gesteuert.

Eintrag | Typ | Vorbelegung | Beschreibung
--- | --- | --- | ---
HTML_TEXT_BACK | String | [Bildauswahl] | Dieser Text wird benutzt um zu den einzelnen Thumbnail-HTML-Seiten bzw. zur Top-Thumbnail-HTML-Seiten zu verweisen.
HTML_CSS_ENABLE | Schalter | 0 | Wird der Wert auf 1 gesetzt, so werden CSS-Stylesheets für die Font-Einstellung benutzt. 0 = benutze <font>-Anweisungen.
HTML_CSS_FILENAME | Wort | stylesheet | Dies ist der Name, der mit angehängtem ".css" den Dateinamen des CSS-Stylesheets bildet.
HTML_ADDRESS_TEXT |  | <multiline> | Mit diesem mehrzeiligen Eintrag kann der vordefinierte HTML <address>-Tag in den HTML-Seiten ersetzt werden. Wenn nichts angegeben ist wird in der Voreinstellung ein Text mit Name und Email des Authors, sowie Copyright-Vermerk erzeugt (siehe auch "EMAIL", "AUTHOR", "COPYRIGHT"). Wird eigener Text benutzt entfällt auch die Möglichkeit den Hinweis auf das script ein- und aus-zublenden (siehe "HTML_NO_TOOL_HINT").
HTML_NO_TOOL_HINT | Schalter | 1 | Mit diesem Schalter kann man bestimmen ob im vordefinierten HTML <address>-Tag ein Hinweis auf das script und die script-Version eingeblendet wird. Durch Setzen auf 0 wird kein sichtbarer Hinweis eingeblendet. Im HTML-Header wird aber das script weiterhin als "generator" eingetragen.
LINK_ORIGINAL_IMAGE | Schalter | 1 | Durch Setzen auf 1 wird erreicht, daß im Dateisystem-Modus ein Link auf das Originalbild in Originalgröße gesetzt wird. Ein Wert 0 verhindert daß im Dateisystem-Modus ein Link auf das Originalbild erfolgt. Im "Web-Ready"-Modus wird dieser Link grundsätzlich nicht angelegt.
HTML_NO_PART_NUMBER | Schalter | 0 | Die Bilder werden auf mehrere Thumbnail-HTML-Seiten aufgeteilt. Diese werden durchnumeriert (beginnend mit 1). Diese Nummer wird normalerweise im HTML-Code sichtbar gemacht. Durch Setzen dieses Schalters auf 1 kann die Nummern-Anzeige unterdrückt werden. (siehe auch "HTML_NO_PART_ONE")
HTML_NO_PART_ONE | Schalter | 1 | Siehe auch "HTML_NO_PART_NUMBER". Alternativ zur dort beschriebenen Funktion kann man die Seitennummer auch nur bei der ersten Seite unterdrücken. Damit wird verhindert, daß eine Nummer angezeigt wird wenn nur eine einzige Seite existiert. Dies ist auch die Voreinstellung.

Zurück nach oben

## HTML Format Parameter

Diese Parameter werden z.B. benutzt um in den Thumbnail-HTML-Seiten die Abstände zwischen den Thumbnails nach Wunsch justieren zu können. Zudem wird die grundsätzliche Ausrichtung von Text-Abschnitten festgelegt.
Mit den Werten sollte man etwas experimentieren um die passenden Einstellungen zu erhalten.

Eintrag | Typ | Vorbelegung | Beschreibung
--- | --- | --- | ---
HTML_THUMBNAIL_SPACING | Ganzzahl | 4 | Der Abstand in Pixeln zwischen Thumbnails-Tabellenzellen. Dies entspricht dem "cellspacing" HTML-Tag für Tabellen. Werte zwischen 2 und 16 sind erlaubt.
HTML_THUMBNAIL_DISTANCE | Ganzzahl | 4 | Der zusätzliche Offset auf die maximale Breite des Thumbnail-Bildes der die Breite einer Thumbnail-Tabellenzelle ergibt. Werte zwischen 4 und 128 sind erlaubt.
HTML_IMAGE_SPACING | Ganzzahl | 2 | Der Abstand in Pixeln zwischen Websize-Bild-Tabellenzellen. Dies entspricht dem "cellspacing" HTML-Tag für Tabellen. Werte zwischen 2 und 16 sind erlaubt.
HTML_IMAGE_DISTANCE | Ganzzahl | 12 | Der zusätzliche Offset auf die maximale Breite des Websize-Bildes der die Breite der Websize-Tabellenzelle ergibt. Werte zwischen 4 und 128 sind erlaubt.
HTML_TEXTCELL_HEIGHT | Ganzzahl | 20 | Dieser Wert bestimmt die Tabellenzellen-Höhe einer Zelle die ausschließlich einzeiligen Text enthält. (z.B. Text-Links). Werte zwischen 8 und 128 sind erlaubt.
HTML_TEXT_ALIGN | Wort | center | Dieser Parameter legt die grundsätzliche Ausrichtung von Überschriften, Texten und Tabellen im HTML-Code fest. Nur die Werte "center", "left" und "right" sind zuläßig. Großbuchstaben werden automatisch in Kleinbuchstaben umgewandelt.
HTML_TOP_TEXT_ALIGN | Wort | center | Dieser Parameter legt die Ausrichtung von Texten des HTML_TOP_TEXT Eintrages im HTML-Code fest. Nur die Werte "center", "left" und "right" sind zuläßig. Großbuchstaben werden automatisch in Kleinbuchstaben umgewandelt. Die Ausrichtung des Textes kann mit dem "HTML_TOP_TEXT_ALIGN"-Eintrag angepasst werden.
HTML_SUB_TEXT_ALIGN | Wort | center | Dieser Parameter legt die Ausrichtung von Texten des HTML_SUB_TEXT Eintrages im HTML-Code fest. Nur die Werte "center", "left" und "right" sind zuläßig. Großbuchstaben werden automatisch in Kleinbuchstaben umgewandelt.
HTML_IMG_TEXT_ALIGN | Wort | center | Dieser Parameter legt die Ausrichtung von Texten des IMAGE_TEXT Eintrages im HTML-Code fest. Nur die Werte "center", "left" und "right" sind zuläßig. Großbuchstaben werden automatisch in Kleinbuchstaben umgewandelt.
HTML_IMG_MAKE_DENSE | Schalter | 0 | Dieser Parameter erlaubt es durch Setzen auf "1" den oberen Teil der Bild-HTML-Seite etwas schmaler zu gestalten. Statt üppige Überschriften zu erzeugen, werden Untertitel und Bildname mit in die Tabelle gepackt.
HTML_IMG_CREATE_ALWAYS | Schalter | 0 | Dieser Parameter erlaubt es durch Setzen auf "1" die Generierung der HTML-Seiten generell durchzuführen. Ein Wert von 0 macht die Generierung von einem eventuellen Vorhandensein der Datei und der Update-Erkennung abhängig. Er kann die Optionen-Kombination "-force -html" ersetzen.

Zurück nach oben

## HTML Dateinamen Parameter

Mit den folgenden Parametern kann man die Namensgebung für die erzeugten HTML-Dateien beeinflussen.

Eintrag | Typ | Vorbelegung | Beschreibung
--- | --- | --- | ---
HTML_INDEX_NAME | Wort | index | Die Thumbnail-HTML-Dateien haben alle den gleichen Anfangsbestandteil, der mit diesem Parameter eingestellt wurde. Die Voreinstellung ist "index". Die Thumbnail-HTML-Dateien heissen dann z.B. "index_0.html" "index_1.html", usw. Die etsprechende Top-Thumbnail-HTML-Datei heisst dann z.B. "index.html"
HTML_IMAGE_SUFFIX | Wort | _img | Die HTML-Dateien die die Websize-Bilder aufnehmen, und pro Bild erzeugt werden, tragen den Namen des Bildes mit angehängtem Suffix (Voreinstellung ist "_img").
HTML_INFO_SUFFIX | Wort | _info | Die HTML-Dateien die die EXIF-Information aufnehmen, und pro Bild erzeugt werden, tragen den Namen des Bildes mit angehängtem Suffix (Voreinstellung ist "_info").
HTML_WRAPPER_SUFFIX | Wort | _wrap | Die HTML-Dateien die das Original-Bild enthalten (mit Link zurück auf die Original HTML-Bild-Seite), tragen den Namen des Bildes mit angehängtem Suffix (Voreinstellung ist "_wrap").
HTML_FILE_EXTENSION | Wort | html | Mit diesem Parameter kann die HTML-Dateiendung bestimmt werden. Nur "html" und "htm" sind erlaubte Werte.
HTML_IMAGE_DIR | Wort | html | In diesem Unterverzeichnis werden alle Bild-bezogenen HTML-Dateien abgelegt (siehe auch "HTML_INFO_SUFFIX" und "HTML_IMAGE_SUFFIX"). Das Verzeichnis wird entweder im aktuellen Verzeichnis (Aufruf-Verzeichnis "./", im Dateisystem-Modus), oder in dem durch den Eintrag "TARGET_DIR" festgelegten Verzeichnis angelegt.

Zurück nach oben

## HTML Parameter für die Startseite (Top-Seite)

Die hier gelisteten Parameter bestimmen einige Details der Top-Thumbnail-HTML-Seite. Es kann ausgewählt werden ob sie erzeugt werden soll, und welche beschreibenden Texte verwendet werden sollen.
Die Thumbnail-Bilder die auf der Seite erscheinen (eines pro "SUBTITLE"-Eintrag) sind entweder die ersten Thumbnail-Bilder im jeweiligen Abschnitt, oder sind durch einen "IMAGE_SEL"-Eintrag ausgewählt. Es kann immer nur ein Bild pro "SUBTITLE"-Eintrag gewählt werden.

Eintrag | Typ | Vorbelegung | Beschreibung
--- | --- | --- | ---
HTML_CREATE_TOP | Schalter | 1 | Wird der Wert 1 eingestellt, so wird automatisch eine Top-Thumbnail-HTML-Seite erzeugt wenn mindestens ein "SUBTITLE" Eintrag vorhanden sind.
HTML_TOP_TEXT | String | <multiline> | Dieser beschreibende Text (mehrzeilig erlaubt, mit HTML-Elementen verwoben) wird auf die Top-Thumbnail-HTML-Seite gesetzt (wenn vorhanden).
HTML_TOP_CAPTION | String | nbsp; | Dieser beschreibende Untertitel (einzeilig, mit HTML-Elementen verwoben) wird auf die Top-Thumbnail-HTML-Seite gesetzt (wenn vorhanden).
HTML_TOP_BACK | String | [Zurück zur Hauptseite] | Dieser Text-Eintrag wird verwendet um von der Top-Thumbnail-HTML-Seite aus einen Link auf die mit "LEVEL_UP" spezifizierte HTML-Seite zus setzen. Bleibt der Eintrag "LEVEL_UP" leer wird kein Link erzeugt.

Zurück nach oben

## Thumbnail HTML Seiten Parameter

Die Aufteilung der Bilder auf Thumbnail-HTML-Seiten läßt sich durch die Angabe von "SUBTITLE"-Einträgen steuern. Nach jedem Eintrag wird eine neue Thumbnail-HTML-Seite begonnen (unabhäig davon wie sehr die bestehende Seite gefüllt ist).
"SUBTITLE"-Einträge müssen immer zwischen zwei Bildern und nach einem "IMAGE_PATH"-Eintrag stehen, um korrekt interpretiert werden zu können.

Eintrag | Typ | Vorbelegung | Beschreibung
--- | --- | --- | ---
SUBTITLE | String | Photo-Auswahl | Mit diesem Eintrag lassen sich die in der Konfigurationsdatei abgelegten Bilder strukturieren. Die Thumbnail-HTML-Seiten werden in der Voreinstellung bis zur vorgegebenen Anzahl Bilder gefüt bevor eine neue Seite begonnen wird. Ein "SUBTITLE"-Eintrag hingegen erzwingt den Start einer neuen Thumbnail-HTML-Seite. Es empfiehlt sich zumindest einen Eintrag vor dem ersten Bild zu setzen, da der Eintrag zugleich als Untertitel für alle folgenden Thumbnail-HTML-Seiten verwendet wird. Der Eintrag ist immer einzeilig. Wird "NONE" eingetragen (ohne Anführungszeichen, mit optional angefügter Ziffernfolge bei mehreren SUBTITLEs) dann werden die entsprechenden HTML-Einträge unterdrückt. Eine Einteilung in Unterseiten erfolgt trotzdem.
HTML_SUB_TEXT | String | <multiline> | Zu jedem "SUBTITLE"-Eintrag kann zusätzlich noch beschreibender Text angegeben werden. Er wird dann auf der ersten Thumbnail-HTML-Seite plaziert, die zu dem jeweiligen "SUBTITLE"-Eintrag gehört. Der Eintrag kann mehrere Zeilen umfassen und darf HTML-Stilelemente enthalten. Die Ausrichtung des Textes kann mit dem "HTML_SUB_TEXT_ALIGN"-Eintrag angepasst werden.
SUB_PAGES_NO_TEXT | Schalter | 0 | Mit diesem Parameter kann die Angabe von jeglichem Text auf den Thumbnail-Seiten und HTML-Seiten die zu einem "SUBTITLE" gehören unterdrückt werden. Dies betrifft insbesondere automatisch erstellte IMAGE_NAME und IMAGE_CAPT Einträge (Bildunterschriften). Der Eintrag muß exakt vor einem "SUBTITLE"-Eintrag eingetragen werden. Der Parameter ist bisher noch unvollständig implementiert! Vor dem folgenden SUBTITLE sollte man den Schalter wieder ausschalten wenn nötig.

Zurück nach oben

## Bild Parameter

Für jedes Bild kann eine Reihe von Parametern eingestellt werden, die in erster Linie diverse Zusatz-Textinformation beschreiben. Daneben existieren aber auch Parameter die ein eventuell notwendiges Drehen, oder die Auswahl des Bildes für die Top-Thumbnail-HTML-Seite beschreiben.

Eintrag | Typ | Vorbelegung | Beschreibung
--- | --- | --- | ---
IMAGE_NAME | String | <automatisch generiert aus dem Dateinamen> (siehe auch Umbenennungs-Regeln) | Dieser Eintrag stellt sozusagen den Bildtitel dar. Er sollte kurz und prägnant sein. Im Falle eines Rename-Laufes wird der Eintrag in einen neuen Dateinamen umgewandelt um die Lesbarkeit der Dateinamen zu verbessern.
IMAGE_CAPT | String | <IMAGE_NAME als Voreinstellung> | Dies ist der Bild-Untertitel.
IMAGE_TEXT | String | <multiline> | Mit diesem mehrzeiligen Parameter kann das Bild mit beschreibendem Text versehen werden. Der Text kann bei Bedarf auch mit HTML-Elementen angereichert werden. Die Ausrichtung des Textes kann mit dem "HTML_IMG_TEXT_ALIGN"-Eintrag angepasst werden.
IMAGE_ROT | Ganzzahl | 0 | Dieser Wert beschreibt die Drehung die auszuführen ist um das Bild in Normallage zu bekommen (Drehung entgegen dem Uhrzeigersinn). 0 bedeutet, daß keine Drehung notwendig ist. Erlaubte Werte sind: 0, 90, 180, 270, -270, -180, -90. Während eines Rename-Laufes wird das Originalbild kopiert (Umbenennung in "Bilddateiname.orig.jpg") und dann das Original entsprechend gedreht. Der "IMAGE_ROT"-Wert wird anschließend auf 0 zurückgesetzt. Ohne Rename-Option wird während der Bilderzeugung zuerst ein gedrehtes Bild angelegt (Dateiname: z.B. "Bilddateiname_90deg.jpg). Dieses gedrehte Bild wird dann für die Erzeugung weiterer Bilder herangezogen.
IMAGE_SEL | Schalter | 0 | Ein Wert von 1 macht dieses Bild zum Auswahlbild für die aktuelle "SUBTITLE"-Gruppe. Es sollte pro "SUBTITLE" maximal ein Bild ausgewählt werden.
IMAGE_ALT | String | <IMAGE_NAME als Voreinstellung> | Dieser Text wird in der "ALT"-Option des "IMG"-HTML-Tags der Thumbnail-Bilder und der Websize-Bilder benutzt. Die Button-Bilder benutzen den "IMAGE_NAME"-Eintrag für die "ALT"-Option.
IMAGE_IMPR | String | <Wert des IMG_IMPRINT_DEFAULT Eintrages> | Der hier angegebene Text (wenn nicht leer) wird in die rechte untere Ecke des Websize-Bildes fest eingeprägt. Zu beachten ist, daß HTML-Elemente hier nicht verwendet werden können. Es ist aber prinzipiell erlaubt Sonderzeichen in der Zeichenkette zu verwenden. In vielen Fällen werden diese korrekt abgebildet. (Die unterstützten Sonderzeichen hängen in erster Linie von der verwendeten Schriftart ab).
IMAGE_EXIF | Schalter | undefiniert | Ist der Wert auf 0 gesetzt dann wird nicht versucht die EXIF-Header-Information zu diesem Bild zu lesen. Ein Setzen des Wertes auf 1 (oder das Löschen des Eintrages) erzwingt das erneute Lesen der EXIF-Header-Information. Existiert diese nicht, oder kann nicht gelesen werden, wird der Wert automatisch auf 0 zurückgesetzt. Beim Schreiben der Konfigurationsdatei wird grundsätzlich nur der Wert 0 geschrieben. Dieser Schalter wird normalerweise nach dem ersten Lesen der Bilder automatisch gesetzt und verhindert dann unnötige "jhead"-Lesevorgänge in weiteren Programmläufen.
IMAGE_INFO | Schalter | <Wert des IMG_ADD_JPG_INFO_PAGE Eintrages> | Ist der Wert auf 1 gesetzt und handelt es sich bei dem Bildtyp um das JPEG-Format so wird zusätzlich eine Info-HTML-Seite erzeugt, die die EXIF-Header-Information darstellt.
IMAGE_DEL | Schalter | 0 | Der Wert 1 entfernt das Bild aus der Konfigurationsdatei und löscht alle erzeugten Bild- und HTML-Dateien (nicht aber die Original-Datei). Die Konfigurationsdatei wird neu geschrieben (der Schalter wird auf 0 zurückgesetzt aber nicht in der Datei abgelegt). Verweise auf diese Dateien werden ebenfalls entfernt.
IMAGE_LINK | Pfadname |  | Wenn ein Bild zu einer zweiten Bildauswahl gehört und nur auf diese verweisen soll, kann der Eintrag "IMAGE_LINK" verwendet werden. Er beschreibt die HTML-Seite auf die mit diesem Thumbnail-Bild verwiesen werden soll. Es wird weder ein Thumbnail-Bild noch eine HTML-Datei erzeugt. Das script nimmt an dass die Ziel-HTML-Datei und das gewuenschte Bild bereits existieren. Die Einträge "IMAGE_ROT" und "IMAGE_DEL" können deshalb auch nicht zusammen mit "IMAGE_LINK" verwendet werden.
IMAGE_PATH | Pfadname | (leerer Wert ist nicht erlaubt!) | Dieser Eintrag beschreibt den Pfadnamen der Bilddatei. Im Web-Ready-Modus werden hier relative Pfadnamen vorausgesetzt. Aus Gründen der Abwärtskompatibilität wird jede Zeile, die kein Kommentar und keien Leerzeile ist und auch keinen Konfigurationseintrag darstellt, als Bilddatei-Pfadname interpretiert. Dies erlaubt es z.B. vorhandene iview-Bildlisten einzulesen. Pfadnamen im DOS-Format dürfen keine Laufwerksinformation enthalten und werden in Unix-kompatibles Format umgewandelt.

Zurück nach oben, zurück zur Hauptseite