===========================================================================
BILDER-GALERIE »KOBOLD« - KURZE BEDIENUNGSHILFE
===========================================================================
0. KURZANLEITUNG

1. Bilder (JPG, PNG) in das Verzeichnis »gallery/pictures« kopieren
2. Shellskript »create-gallery.sh« aufrufen

    bash create-gallery.sh

3. Fertig! - Bildergalerie mit den Basisfunktionen

HINWEIS: Es werden Ausgangsbilder in der Groesze bis 8000 x 6000 Pixel
unterstuetzt.

===========================================================================
INHALTSVERZEICHNIS

0. Kurzanleitung
1. Allgemeine Regeln
2. Bildergalerie erstellen
3. Zusätzliche Werkzeuge
  3.1 Bildtitel anlegen, neu einfügen oder löschen
  3.2 Konvertierung: LINUX/UNIX <-> DOS/WINDOWS
  3.3 EXIF-Daten der Bilder löschen
  3.4 Galerietitel ändern, überschreiben
  3.5 Links zu einzelnen Bildkapiteln einfügen bzw. löschen
  3.6 HTML-Seiten (1-5) in die Galerie einfügen bzw. löschen
4. Bilder in eine bereits erstellte Bildergalerie einfügen bzw. löschen
5. Abschließende Arbeiten
6. Hinweise


===========================================================================
1. ALLGEMEINE REGELN

- die Bilder (JPG, PNG) für die Galerie sind im Verzeichnis »pictures« zu
  speichern
- die beiden Shellskripte »create-gallery.sh« und »gallery-tools.sh« müssen
  ausführbar sein (Zugriffsrechte »ls -l«: 0700 bzw. -rwx------)

  chmod 0700 create-gallery.sh
  chmod 0700 gallery-tools.sh

- die beiden Shellskripte erfordern zur Erstellung einer Bildergalerie einige
  zusätzliche Programme; falls diese Programme noch nicht installiert sind,
  so werden Sie von den Shellskripten darauf hingewiesen
- die Shellskripte zur Erstellung einer Bildergalerie erfordert die UTF-8
  Textkodierung für das Linux-System; verwendet das Linux-System eine andere
  Kodierung, so versuchen die Shellskripte mittels des Programms »recode«
  die Textkodierung der HTML-Dateien ins UTF-8 Format zu konvertieren

  HINWEIS: Die System-Textkodierung können Sie mit dem Terminalprogramm
  »locale« ermitteln.

  ACHTUNG: Die Konvertierung ins UTF-8 Format wird möglicherweise auf einigen
  wenigen Linux-Systeme nicht funktionieren. Die Shellskripte geben in diesem
  Fall eine entsprechende Fehlermeldung aus.

- das Shellskript »gallery-tools.sh« sollte immer erst aufgerufen werden, wenn
  bereits über das Shellskript »create-gallery.sh« eine Bildergalerie erstellt
  wurde
- die Sortierreihenfolge durch das Shellskript muss nicht mit der Reihenfolge
  im Dateibrowser übereinstimmen;

  HINWEIS: Bei der folgenden Syntax für die Bildnamen [a-z]_[0-9].jpg bzw.
  [a-z]_[0-9].png (englisches Aplphabet, Unterstrich und Zahlen mit führenden
  Nullen 0001 .. 0123; Beispiel: picture_4225.jpg) ist die Sortierreihenfolge
  der Bilder im Dateibrowser und durch das Shellskript identisch.

  ACHTUNG: Die länderspezifischen Einstellungen (deutsch, us­-englisch etc.) 
  beeinflussen die Sortierreihenfolge.

- Es werden nur JPEG- bzw. PNG-Bilder berücksichtigt. Alle anderen Dateien
  werden beim Aufruf des Shellskripts automatisch gelöscht.
- JPEG- bzw. PNG-Bilder die die minimale bzw. maximale Bildgröße unter- bzw.
  überschreiten, werden ebenfalls durch das Shellskript gelöscht.
  min. Bildgröße: 40x30 Pixel
  max. Bildgröße: 4000x3000 Pixel
- Bilder die größer sind als 800 x 600 Pixel (siehe auch: config/config_xx.txt)
  werden entsprechend verkleinert. Bilder die kleiner sind als 800 x 600 Pixel
  werden auf die entsprechende Zielgröße vergrößert.
  Sehr kleine Bilder (< 320 x 240 Pixel) werden ins Zentrum eines weißen Bildes
  hineinkopiert.
- Bilder die etwa mehr als 10% vom vorgegebenen Seitenverhältnis 4:3 (z.B.
  800 x 600 Pixel) bzw. 16:9 (z.B. 800 x 450 Pixel) abweichen, erhalten oben
  und unten bzw. links und rechts einen weißen Farbbalken.
  siehe auch: config/config_xx.txt

xx ... Kurzzeichen für die Bedienungs- und Galeriesprache

TIPP: EINFACH AUSPROBIEREN - MIT WENIGEN SEHR UNTERSCHIEDLICHEN BILDERN.

===========================================================================
2. BILDERGALERIE ERSTELLEN

- kopieren Sie einige Bilder (JPG, PNG) in das Verzeichnis »pictures«
- wechseln Sie über den Dateibrowser in das Verzeichnis »gallery/programs/«
  und rufen über das Kontextmenü ein Terminal auf; der aktuelle Pfad sollte
  im Terminal bereits eingetragen sein; rufen Sie jetzt das Shellskript für
  die Erstellung der Bildergalerie »create-gallery.sh« auf

    bash create-gallery.sh

- nach der Auswahl der Bedienungs- und Galeriesprache ist der Haupttitel
  der Bildergalerie (z.B. Urlaub - Sevilla) einzugeben


		GALERIE-TITEL ÄNDERN, ÜBERSCHREIBEN


  Abbrechen ... (0)
  Vorgabe-Titel: Picture-Gallery ... (1)

Geben Sie einen neuen Galerietitel oder eine Zahl ein (0 ... 1): 


- befinden sich für die ausgewählte Sprache im Verzeichnis »programs/txt«
  Textdateien, so werden diese durch das Shellskript »create-gallery.sh«
  ausgewertet (siehe: Pkt. 3).
- bei vielen Bildern kann die Erstellung der Bildergalerie einige Zeit in
  Anspruch nehmen -> ES IST ALSO DIE RECHTE ZEIT SICH EINEN GEMÜTLICHEN
  KAFFEE ZU GÖNNEN!

HINWEIS: Die Erstellung der Bildergalerie kann einige Zeit in Anspruch nehmen.
BITTE WARTEN .....


- die fertige Bildergalerie kann jetzt über die Dateien »kobold/index.html«
  bzw. »kobold/gallery/index.htm« aufgerufen werden

HINWEIS: Mit dem zweiten Shellskript »gallery-tools.sh« können Bildtitel,
zusätzliche HTML-Dateien und Kapitel-Links (Sprungmarken) eingefügt werden.


===========================================================================
3. ZUSÄTZLICHE WERKZEUGE 

BEDINGUNG: Durch das Shellskript »create-gallery.sh« wurde bereits eine
Bildergalerie erstellt.

HINWEIS: Wurden an den Bildern der Galerie keine Änderungen (Reihenfolge,
Einfügung, Löschung) vorgenommen und es sollen nur einige Änderungen an den
HTML-Dateien erfolgen, so ist der Aufruf des Shellskriptes »gallery-tools.sh«
der deutlich schnellere Weg zu einer aktualisierten Bildergalerie.

- wechseln Sie über den Dateibrowser in das Verzeichnis »gallery/programs/«
  und rufen über das Kontextmenü ein Terminal auf; der aktuelle Pfad sollte
  im Terminal bereits eingetragen sein; rufen Sie jetzt das Shellskript für
  die zusätzliche Bearbeitung der Bildergalerie »gallery-tools.sh« auf

    bash gallery-tools.sh

- nach der Auswahl der Bedienungs- und Galeriesprache gelangen Sie zum
  Hauptmenü »ZUSÄTZLICHE WERKZEUGE«

  HINWEIS: Es ist immer die Bedienungs- und Galeriesprachen auszuwählen,
  mit der die bereits vorhandene Bildergalerie erstellt wurde.

  AUSNAHMEN: Punkt 2 (Konvertierung: LINUX/UNIX <-> DOS/WINDOWS) und
  Punkt 3 (EXIF-Daten der Bilder löschen) - hier spielt die gewählte
  Bedienungs- und Galeriesprache keine Rolle.


		 ZUSÄTZLICHE WERKZEUGE 


  Abbrechen ... (0)
  Bildtitel anlegen, neu einfügen oder löschen ... (1)
  Konvertierung: LINUX/UNIX <-> DOS/WINDOWS ... (2)
  EXIF-Daten der Bilder löschen ... (3)
  Galerietitel ändern, überschreiben ... (4)
  Links zu einzelnen Bildkapiteln einfügen bzw. löschen ... (5)
  HTML-Seiten (1-5) in die Galerie einfügen bzw. löschen ... (6)

Geben Sie eine Zahl ein (0 ... 6): 

---------------------------------------------------------------------------
3.1 Bildtitel anlegen, neu einfügen oder löschen

		 ERSTELLUNG VON BILDTITELN 


  Abbrechen ... (0)
  Datei für die Bildtitel automatisch erstellen ... (1)
  Datei für die Bildtitel manuell erstellen ... (2)
  Bildtitel in die Bildergalerie einfügen ... (3)
  Bildtitel aus der Bildergalerie entfernen ... (4)

Geben Sie eine Zahl ein (0 ... 4): 

-----------------------------
(1) ... Datei für die Bildtitel automatisch erstellen
Mit der Eingabe der Zahl 1 und der Bestätigung mit der ENTER-Taste, wird
im Verzeichnis »txt« die Textdatei »picture-title_xx.txt« neu angelegt.
Die einzelnen Bildtitel können mit einem beliebigen Texteditor in dieser Datei
nach dem Doppelpunkt eingetragen werden.

		BILDNUMMERN AUTOMATISCH EINTRAGEN

Die Datei für die Bildtitel im Verzeichnis »txt« wurde erstellt.
Die Bildtiteln können mit einem beliebigen Texteditor dort eingetragen werden.
Der Bereich nach dem Doppelpunkt (:) kann auch leer bleiben.
Die Länge der Bildtitel sollte 60 Zeichen nicht überschreiten.

Datei: »txt/picture-title_xx.txt«
1:Urlaubstag Nr. 1
2:
3:unser Hotel
4:das Frühstücksmenü
[...]

Nachdem die Bildtitel in die Datei eingetragen wurden, ist das Shellskript
»gallery-tools.sh« erneut aufzurufen.

HINWEIS: Existiert bereits eine Textdatei »picture-title_xx.txt« für die
Bildtitel, so wird diese Datei vorher umbenannt in »picture-title_xx_OLD.txt«.

xx ... Kurzzeichen für die Bedienungs- und Galeriesprache

-----------------------------
(2) ... Datei für die Bildtitel manuell erstellen
Mit der Eingabe der Zahl 2 und der Bestätigung mit der ENTER-Taste, wird ein
Untermenü aufgerufen.

		BILDNUMMERN MANUELL EINTRAGEN


  Abbrechen ... (0)
  Anzahl der Bilder, die die Galerie aufnehmen soll, hier eintragen.

Geben Sie eine Zahl ein (1 ... 99999):

Tragen Sie dort die Anzahl der Bilder ein und schließen die Eingabe mit der
ENTER-Taste ab. Im Verzeichnis »txt« wird daraufhin die Textdatei
»picture-title_xx.txt« neu angelegt. Die einzelnen Bildtitel können mit einem
beliebigen Texteditor in dieser Datei nach dem Doppelpunkt eingetragen werden.

		HINWEIS: BILDTITEL EINTRAGEN

Die Datei für die Bildtitel im Verzeichnis »txt« wurde erstellt.
Die Bildtiteln können mit einem beliebigen Texteditor dort eingetragen werden.
Der Bereich nach dem Doppelpunkt (:) kann auch leer bleiben.
Die Länge der Bildtitel sollte 60 Zeichen nicht überschreiten.

Datei: »txt/picture-title_xx.txt«
1:Urlaubstag Nr. 1
2:
3:unser Hotel
4:das Frühstücksmenü
[...]

Nachdem die Bildtitel in die Datei eingetragen wurden, ist das Shellskript
»gallery-tools.sh« erneut aufzurufen.

HINWEIS: Existiert bereits eine Textdatei »picture-title_xx.txt« für die
Bildtitel, so wird diese Datei vorher umbenannt in »picture-title_xx_OLD.txt«.

xx ... Kurzzeichen für die Bedienungs- und Galeriesprache

-----------------------------
(3) ... Bildtitel in die Bildergalerie einfügen
Mit der Eingabe der Zahl 3 und der Bestätigung mit der ENTER-Taste, werden die
Bildtitel aus der Textdatei »txt/picture-title_xx.txt« in die Bildergalerie
eingearbeitet.

xx ... Kurzzeichen für die Bedienungs- und Galeriesprache

-----------------------------
(4) ... Bildtitel aus der Bildergalerie entfernen
Mit der Eingabe der Zahl 4 und der Bestätigung mit der ENTER-Taste, werden die
Bildtitel aus der gesamten Bildergalerie entfernt.

HINWEIS: Die Textdatei »picture-title_xx.txt« mit den alten Bildtiteln, wird in
»picture-title_xx_OLD.txt« umbenannt.

xx ... Kurzzeichen für die Bedienungs- und Galeriesprache

---------------------------------------------------------------------------
3.2 Konvertierung: LINUX/UNIX <-> DOS/WINDOWS

		KONVERTIERUNG: LINUX/UNIX <-> DOS/WINDOWS


  Abbrechen ... (0)
  LINUX/UNIX --> DOS/WINDOWS ... (1)
  DOS/WINDOWS --> LINUX/UNIX ... (2)

Geben Sie eine Zahl ein ( 0 ... 2):

Die verschiedenen Betriebssysteme (Linux, Unix, Windows) benutzen für das
Zeilenende jeweils ein anderes nicht sichtbares Steuerzeichen (Linux \n;
UNIX \n; MAC \r; Windows \r\n). Mit dem Shellskript werden die Zeilenumbrüche
der Textdateien (HTML, CSS) ins gewählte Format (DOS/WINDOWS bzw. LINUX/UNIX)
konvertiert.

(1) ... Mit der Eingabe der Zahl 1 und der Bestätigung mit der ENTER-Taste,
        werden alle Textdateien der Galerie (Endung: .htm, .html, .css und
        .txt) ins DOS/WINDOWS-Format konvertiert, umgewandelt.
(2) ... Mit der Eingabe der Zahl 2 und der Bestätigung mit der ENTER-Taste,
        werden alle Textdateien der Galerie (Endung: .htm, .html, .css und
        .txt) ins LINUX/UNIX-Format konvertiert, umgewandelt.

ANMERKUNG: Ohne die Konvertierung würde der Seitenquelltext der HTML-Seiten,
die unter Linux erstellt wurden, unter Windows in einer einzigen Zeile
angezeigt (gilt auch für die CSS-Datei). Die Funktionsweise der Bildergalerie
sollte durch die einzeilige Darstellung des Seitenquelltextes aber nicht
eingeschränkt sein. Die einzeilige Darstellung von Quelltexten gilt aber als
schlechter Stil (schwer lesbar, mitunter eine eingeschränkte Funktion von
Javaskripten).

---------------------------------------------------------------------------
3.3 EXIF-Daten der Bilder löschen

		EXIF-DATEN AUS DEN BILD-DATEIEN LÖSCHEN


  Abbrechen ... (0)
  EXIF-Daten löschen ... (1)

Geben Sie eine Zahl ein (0 ... 1): 

Mit der Eingabe der Zahl 1 und der Bestätigung mit der ENTER-Taste, werden
die EXIF-Daten (Datum- und Zeitstempel, Kamera-Modell, GPS-Daten, ...)
unwiederbringlich aus allen Bildern in den Verzeichnissen »pictures«,
»thumbnails«, »extra« und »css« entfernt. 

---------------------------------------------------------------------------
3.4 Galerietitel ändern, überschreiben

		GALERIE-TITEL ÄNDERN, ÜBERSCHREIBEN


  Abbrechen ... (0)
  Vorgabe-Titel: Picture-Gallery ... (1)

Geben Sie einen neuen Galerietitel oder eine Zahl ein (0 ... 1):

Mit der Eingabe eines neuen Galerietitels (maximal 128 Zeichen) und der
Bestätigung mit der ENTER-Taste, wird der neue Galerietitel in die
Textdatei »gallery-title_xx.txt« im Verzeichnis »txt« eingetragen, sowie
in die entsprechende HTML-Datei (index.htm) eingearbeitet.

HINWEIS: Falls die Textdatei »gallery-title_xx.txt« noch nicht existiert,
so wird sie vom Shellskript automatisch neu angelegt.

xx ... Kurzzeichen für die Bedienungs- und Galeriesprache

---------------------------------------------------------------------------
3.5 Links zu einzelnen Bildkapiteln einfügen bzw. löschen

		 KAPITEL-LINK EINFÜGEN, LÖSCHEN


  Abbrechen ... (0)
  Kapitel-Links einfügen ... (1)
  Kapitel-Links löschen ... (2)

Geben Sie eine Zahl ein (0 ... 2): 


(1) ... Kapitel-Links einfügen
Mit der Eingabe der Zahl 1 und der Bestätigung mit der ENTER-Taste, können
bis zu 5 Kapitel-Links (Hyperlinks) in die Bildergalerie einfügt werden.
Bei weniger als 5 Kapitel-Links ist die letzte Abfrage leer zu lassen und mit
der ENTER-Taste abzuschließen.

		 KAPITEL-LINKS EINFÜGEN


Die Kapitel-Links sind nach dem folgenden Muster einzutragen:

	[BILD-NUMMER]:[LINK-NAME] -> 17:Kapitel 1


Hinweis: Es können bis zu 5 Kapitel-Links eingefügt werden.

  Abbrechen ... (0)


Geben Sie die Bild-Nummer und den Namen für den Kapitel-Link ein: 5:Kapitel 1
Geben Sie die Bild-Nummer und den Namen für den Kapitel-Link ein: 10:Kapitel 2
Geben Sie die Bild-Nummer und den Namen für den Kapitel-Link ein: 15:Kapitel 3
Geben Sie die Bild-Nummer und den Namen für den Kapitel-Link ein: 20:Kapitel 4
Geben Sie die Bild-Nummer und den Namen für den Kapitel-Link ein: 

Mit der Eingabe des letzten Kapitel-Links (Link-Name: maximal 25 Zeichen) und
der Bestätigung mit der ENTER-Taste, werden die Kapitel-Links in die Textdatei
»gallery-chapter-link-name_xx.txt« im Verzeichnis »txt« eingetragen, sowie
in die entsprechende HTML-Datei (index.htm) eingearbeitet.

HINWEIS: Falls die Textdatei »gallery-chapter-link-name_xx.txt« noch nicht
existiert, so wird sie vom Shellskript automatisch neu angelegt.

xx ... Kurzzeichen für die Bedienungs- und Galeriesprache


(2) ... Kapitel-Links löschen
Mit der Eingabe der Zahl 2 und der Bestätigung mit der ENTER-Taste, kann in
einem weiteren Untermenü die Löschung der Kapitel-Links veranlasst werden.

		 KAPITEL-LINKS LÖSCHEN


  Abbrechen ... (0)
  Kapitel-Links löschen ... (1)


Geben Sie eine Zahl ein (0 ... 1):

Mit der Eingabe der Zahl 1 und der Bestätigung mit der ENTER-Taste, werden
die Kapitel-Links aus der entsprechenden HTML-Datei (index.htm) entfernt.

HINWEIS: Die Textdatei »gallery-chapter-link-name_xx.txt« mit den alten
Kapitel-Links wird vom Shellskript gelöscht.

xx ... Kurzzeichen für die Bedienungs- und Galeriesprache

---------------------------------------------------------------------------
3.6 HTML-Seiten (1-5) in die Galerie einfügen bzw. löschen

		 HTML-SEITEN EINFÜGEN, LÖSCHEN


  Abbrechen ... (0)
  HTML-Seiten und Links einfügen ... (1)
  HTML-Seiten und Links löschen ... (2)

Geben Sie eine Zahl ein (0 ... 2): 

(1) ... HTML-Seiten und Links einfügen
Mit der Eingabe der Zahl 1 und der Bestätigung mit der ENTER-Taste, können
bis zu 5 HTML-Seiten in die Bildergalerie einfügt werden.

Befinden sich mehr als 5 HTML-Seiten im Verzeichnis »html/html_xx/«, so
werden im Menü maximal 9 HTML-Seiten (Syntax: [a-zA-Z]_[1-9].{htm,html};
z.B. home_6.htm) angezeigt.

Bei weniger als 5 HTML-Seiten ist die letzte Abfrage leer zu lassen und mit
der ENTER-Taste abzuschließen.

		 HTML-SEITEN EINFÜGEN


Die Angaben für die HTML-Seiten sind nach dem folgenden Muster einzutragen:

	[HTML-SEITEN-NUMMER]:[LINK-NAME] -> 1:Home


  Abbrechen ... (0)

  page_1.htm ... (1)
  page_2.htm ... (2)
  page_3.htm ... (3)
  page_4.htm ... (4)
  page_5.htm ... (5)

Hinweis: Es können bis zu 5 HTML-Seiten eingefügt werden.

Geben Sie die HTML-Seiten-Nummer und den Link-Namen ein: 1:Home
Geben Sie die HTML-Seiten-Nummer und den Link-Namen ein: 2:Urlaubstagebuch
Geben Sie die HTML-Seiten-Nummer und den Link-Namen ein: 3:Links
Geben Sie die HTML-Seiten-Nummer und den Link-Namen ein:

Mit der Eingabe der letzten HTML-Seite (Link-Name: maximal 25 Zeichen) und
der Bestätigung mit der ENTER-Taste, werden die HTML-Seiten in die Textdatei
»gallery-extra-html-files_xx.txt« im Verzeichnis »txt« eingetragen und die
ausgewählten HTML-Dateien ins Galerieverzeichnis »extra« kopiert, sowie die
Links zu diesen HTML-Dateien in die entsprechende HTML-Datei (index.htm)
eingearbeitet.

ACHTUNG: Vor dem Kopieren der ausgewählten HTML-Seiten durch die Shellskripte,
werden alle bereits vorhandene Verzeichnisse und Dateien im Galerieverzeichnis
»extra« gelöscht.


ANMERKUNG 1: Die Muster der HTML-Seiten im Verzeichnis »html/html_xx/«, müssen
vor dem Einfügen in die Bildergalerie mit einem HTML-Editor nach Ihren Vorgaben
manuell bearbeitet werden. Die von den HTML-Seiten verwendeten Bilder sind im
Verzeichnis »html/html_xx/images« zu speichern.

Das Shellskript kopiert die ausgewählten HTML-Seiten und die zugehörigen Bilder
im Verzeichnis »html_xx/images« in das Galerieverzeichnis »extra«.

siehe auch: Beispiele im Verzeichnis »help/example/start.htm«

HINWEIS: Die von den HTML-Seiten verwendeten Bilder sollten im Dateinamen keine
Leerzeichen enthalten. Für das Leerzeichen ist entweder der Unterstrich (_) oder
das Minuszeichen (-) zu verwenden.


ANMERKUNG 2: Die HTML-Seiten können zwar auch im Galerieverzeichnis »extra«
eingefügt und bearbeitet werden, aber bei einem erneuten Aufruf der Shellskripte
werden diese HTML-Seiten und alle Bilder im Verzeichnis »extra/images« von den
Shellskripten »create-gallery.sh« und »gallery-tools.sh« (Pkt. 4 - Galerietitel
ändern, überschreiben; Pkt. 5 - Links zu einzelnen Bildkapiteln einfügen bzw.
löschen, Pkt. 6 - HTML-Seiten (1-5) in die Galerie einfügen bzw. löschen) erst
gelöscht und dann von den unvollständig oder unbearbeiteten HTML-Seiten im
Verzeichnis »programs/html/html_xx« ersetzt.

HINWEIS: Die Bearbeitung der zusätzlich einzufügenden HTML-Seiten und Bilder
sollte nur im Verzeichnis »programs/html/html_xx« erfolgen.

In die CSS-Datei style.css müssen bei einer veränderten Bildgröße und
längeren Textinhalten eventuell noch Änderungen (height: xxxpx;) eingearbeitet
werden.

[...]
/* EXTRA-HTML-Files */
[...]
#div_extra {
 display: flex;
 justify-content: center;
 align-content: center;
 width: 100%;
 height: 570px;
 overflow-y: auto;
}
[...]

ANMERKUNG 3: Falls die HTML-Seiten im Verzeichnis »html/html_xx/« Javaskript
für die Anzeige von Bildern enthalten und der vollständige Dateipfad zu den
Bildern nicht im HTML-Code enthalten ist, so ist ein HTML-Kommentar nach dem
folgenden Muster einzutragen:

<!-- <img src="./images/picture_name.jpg"> -->

Ohne diesen HTML-Kommentar können die Shellskripte, die von den HTML-Seiten
verwendeten Bildern nicht erkennen.
 
siehe auch: »help/example/gallery/gallery_a/extra/page_4.htm«


HINWEIS: Falls die Textdatei »gallery-extra-html-files_xx.txt« noch nicht
existiert, so wird sie vom Shellskript automatisch neu angelegt.

xx ... Kurzzeichen für die Bedienungs- und Galeriesprache


(2) ... HTML-Seiten und Links löschen
Mit der Eingabe der Zahl 2 und der Bestätigung mit der ENTER-Taste, kann in
einem weiteren Untermenü die Löschung der HTML-Seiten veranlasst werden.

		 HTML-SEITEN LÖSCHEN 


  Abbrechen ... (0)
  HTML-Seiten löschen ... (1)


Geben Sie eine Zahl ein (0 ... 1): 

Mit der Eingabe der Zahl 1 und der Bestätigung mit der ENTER-Taste, werden
die HTML-Seiten gelöscht und die Links aus der entsprechenden HTML-Datei
(index.htm) entfernt.

HINWEIS: Die Textdatei »gallery-extra-html-files_xx.txt« mit den alten
Kapitel-Links wird vom Shellskript gelöscht.

xx ... Kurzzeichen für die Bedienungs- und Galeriesprache


===========================================================================
4. BILDER IN EINE BEREITS ERSTELLTE BILDERGALERIE EINFÜGEN ODER LÖSCHEN

Die nachfolgenden Änderungen betreffen nur das Verzeichnis »pictures«
und evtl. das Verzeichnis »programs/txt«.

- Bilder am Anfang einfügen
  Die am Anfang der Bildergalerie einzufügenden Bilder sind wie folgt
  umzubenennen:
  a01.jpg bzw. a01.png
  a02.jpg bzw. a02.png
  [...]

- Bilder am Ende einfügen
  Die am Ende der Bildergalerie einzufügenden Bilder sind wie folgt
  umzubenennen:
  z01.jpg bzw. z01.png
  z02.jpg bzw. z02.png
  [...]

- Bilder in der Mitte einfügen
  Beispiel: Es sollen einige Bilder nach dem Bild pic00145.jpg eingefügt
  werden.
  Das Bild pic00145.jpg ist umzubenennen in pic00145a.jpg und die neu
  einzufügenden Bilder erhalten die Erweiterung b, c, d, ...
  pic00145a.jpg
  pic00145b.jpg
  pic00145c.jpg
  pic00145d.jpg
  [...]

- Bilder aus der Bildergalerien entfernen
  Die aus der Bildergalerie zu entfernenden Bilder können einfach gelöscht
  werden. Durch den anschließenden Aufruf des Shellskriptes
  »create-gallery.sh« werden alle Dateien der Bildergalerie aktualisiert.
  
Nach den hier beschriebenen Änderungen an einer bestehenden Bildergalerie,
ist anschließend immer das Shellskript »create-gallery.sh« aufzurufen.

    bash create-gallery.sh

Existieren im Verzeichnis »txt« Dateien mit den Bildtiteln und Links zu
einzelnen Bildkapiteln (Sprungmarken), so sind diese vorher anzupassen.

picture-title_xx.txt ... Datei mit den Bildtiteln
gallery-chapter-link-name_xx.txt ... Datei mit den Sprungmarken

xx ... Kurzzeichen für die Bedienungs- und Galeriesprache


===========================================================================
5. ABSCHLIESSENDE ARBEITEN

- das Verzeichnis »gallery/programs/« kann nach Abschluss aller Arbeiten
  vollständig gelöscht werden; vor dem Löschen dieses Verzeichnisses ist es
  aber ratsam, von diesem Verzeichnis ein komprimiertes Archiv (GZIP, ZIP)
  zu erstellen; mit diesem Archiv wird eine evtl. spätere Änderung an einer
  bestehenden Bildergalerie wieder möglich

- Verfügen Sie über Webspace bei einem Webhoster, so können Sie die
  HTML-Bildergalerie auch als eigene Homepage ins Internet stellen.


===========================================================================
6. HINWEISE

Weitere Informationen finden Sie in der vollständige Dokumentation (siehe:
help/DOKUMENTATION_DE.txt).

- Änderung des Designs der Bildergalerie
- Änderung der Bildgrößen
- Hinzufügen weiterer Sprachen
  [...]


===========================================================================
Viel Spaß!



