Voraussetzungen¶

Das Programm benötigt einen beliebigen Webserver und PHP (ab Version 4.3). Empfehlenswert sind die besonders schlanken Webserver lighttpd oder Cherokee (letzterer aus den offiziellen Paketquellen oder via PPA 🇬🇧 installierbar). Aber auch der Einsatz von Apache ist problemlos möglich. Weitere Informationen zur Installation finden sich in den Artikeln:

• lighttpd

• Apache

• PHP (mit der Erweiterung php5-gd)

Herunterladen¶

MiniGal Nano kann als .zip-Archiv von der Homepage 🇬🇧 heruntergeladen werden. Anschließend entpackt ^[1] man das Archiv und verschiebt den entstandenen Ordner mit Root-Rechten ^[2] nach /var/www/html/. Damit ist die Installation abgeschlossen.

Bildkommentare¶

Über die Datei captions.txt können pro Ordner die enthaltenen Bilder mit einem Titel, einer Erklärung oder einem Kommentar versehen werden. Die Struktur dieser Datei ist einfach: sie enthält eine Liste der jeweiligen Bilder, wobei der eigentliche Kommentar hinter dem Trennzeichen | steht. Praktisch sieht das folgendermaßen aus:

bild01.jpg|Bildtitel
bild02.jpg|Bildtitel
bild03.jpg|
bild04.jpg|Bildtitel
bild05.jpg|Bildtitel

Wie im Beispiel ersichtlich, muss nicht zu jedem Bild ein Kommentar vorliegen. In der Praxis ist es noch einfacher: es reicht aus, nur die Bilder aufzulisten, die auch einen Kommentar erhalten sollen. Eine entsprechende Liste läßt sich mit:

ls -1 > captions.txt 

auch bei vielen Dateien schnell erzeugen. Achtung: die Option für ls lautet -1 (eins), nicht -l (kleines L)!

Unterstützung für andere Dateien¶

Sehr praktisch ist die integrierte Unterstützung für andere Dateiformate. So kann man z.B. einen Reisebericht oder ein Protokoll in verschiedenen Formaten mit im Bilderordner abspeichern und später bei Bedarf herunterladen. Die folgenden Dateiformate werden unterstützt:

• PDF

• DOC und DOCX

• XLS und XLSX

• PPT und PPTX

• GZ

• RAR

• TAR

• ZIP

Andere Formate sind möglich, in dem man die Datei in eines der vorhandenen Archivformate einpackt. Fortgeschrittene bearbeiten ^[3] die Datei /var/www/html/minigalnano/index.php, ergänzen das Dateiformat und hinterlegen ein entsprechendes Symbol im Ordner /var/www/html/minigalnano/images. Beispiel (für OpenOffice.org):

// Other filetypes
	$extension = "";
	if (preg_match("/.pdf$/i", $file)) $extension = "PDF"; // PDF
	if (preg_match("/.zip$/i", $file)) $extension = "ZIP"; // ZIP archive
	if (preg_match("/.rar$|.r[0-9]{2,}/i", $file)) $extension = "RAR"; // RAR Archive
	if (preg_match("/.tar$/i", $file)) $extension = "TAR"; // TARball archive
	if (preg_match("/.gz$/i", $file)) $extension = "GZ"; // GZip archive
	if (preg_match("/.doc$|.docx$/i", $file)) $extension = "DOCX"; // Word
	if (preg_match("/.ppt$|.pptx$/i", $file)) $extension = "PPTX"; // PowerPoint
	if (preg_match("/.xls$|.xlsx$/i", $file)) $extension = "XLXS"; // Excel
	if (preg_match("/.odt$/i", $file)) $extension = "ODT"; // OpenOffice.org Writer, Symbol filetype_ODT.png
	if (preg_match("/.odp$/i", $file)) $extension = "ODP"; // OpenOffice.org Impress, Symbol filetype_ODP.png
	if (preg_match("/.ods$/i", $file)) $extension = "ODS"; // OpenOffice.org Calc, Symbol filetype_ODS.png

Update¶

Wenn eine neue Version vorliegt, wird ein dezenter Hinweis in der Bildergalerie eingeblendet.

keine Vorschaubilder¶

Wenn die Galerie funktioniert, aber die Vorschaubilder fehlen, sollte man überprüfen, ob das dafür erforderliche Paket

• php5-gd

installiert ist.

Zugriff einschränken¶

Wer nicht möchte, dass jeder x-beliebige auf die eigenen Bilder zugreifen kann, kann einen Zugriffsschutz einrichten. Dazu verwendet man einfach die vorhandenen Mechanismen des jeweiligen Webservers, also die Datei /etc/lighttpd/conf-enabled/10-auth.conf beim lighty oder .htaccess beim Apache.

Lightbox entfernen¶

Normalerweise wird ein Bild auf einer eigenen Ebene und passend skaliert dargestellt. Wer stattdessen lieber das Originalbild angezeigt bekommen möchte, bearbeitet die jeweils verwendete Vorlage im Ordner /var/www/html/minigalnano/templates und kommentiert die entsprechende Zeile am Anfang der Datei aus. Beispiel:

<!-- script src="<% gallery_root %>js/mediaboxAdv-1.3.4b.js" type="text/javascript"></script -->

Als Nebeneffekt lassen sich so die Originalbilder auch herunterladen.

Datum in Tooltips¶

Innerhalb eines Ordners werden über Tooltips ausgewählte Exif-Informationen zu den Bildern angezeigt (sofern $display_exif = 1; ist, siehe Konfiguration). Falls statt des Datums nur zwei Doppelpunkte (::) sichtbar sind, öffnet man die Datei /var/www/html/minigalnano/index.php, sucht und ersetzt die beiden Doppelpunkte durch $edate | .

Vorschaubilder zwischenspeichern¶

Einer der Nachteile der Originalversion von MiniGal Nano ist bisher die mangelnde Fähigkeit, Vorschaubilder zwischenzuspeichern (cachen). Der Server muss so bei jedem Seitenaufruf alle Bilder entsprechend neu berechnen. Abhilfe schafft eine modifizierte Version 🇬🇧, die sich ansonsten aber genauso wie das Original verhält. Der Ordner /var/www/html/minigalnano/thumbs muss allerdings manuell gepflegt werden, da die Vorschaubilder nicht automatisch mit den Originalbildern gelöscht werden.

Zusätzlich können in der Datei comment.html weitere Informationen (pro Ordner) untergebracht werden. Trotz der Endung .html handelt es sich um eine normale Textdatei – was den Einsatz von HTML-Tags aber nicht ausschließt.