====== Bildergalerien mit dem "Gallery"-Plugin ======

//Hinweis: Dies ist eine Anpassung der hier verwendeten Installation von DokuWiki.//

Auf einigen Seiten, wie z.B. in [[alltagsrad:start|"Show your Alltagsrad"]], findet man Bildergalerien unter Verwendung des "Gallery"-Plugin. Dieses Plugin erlaubt die Anzeige aller Bilder eines [[namespaces|Namensraums]], die mit einem Kleinbuchstaben beginnen.


===== Anwendung =====

Nachdem man in einem Namespace die gewünschten Bilder hochgeladen hat, legt man eine Seite an, die folgenden Inhalt hat:

<code>
====== Beliebige Überschrift ======

Irgendeinen sinnreichen Text....

{{gallery>namespacename}}
</code>

Die dritte Zeile teilt DokuWiki mit, dass in der Seite alle Bilder aus dem angegebenen Namensraum (namespacename) als Vorschau in einer Übersicht ausgegeben werden sollen. Ansonsten kann man die Seite hier beliebig nach eigenen Wünschen gestalten. Wer will, kann die Bilder auch "von Hand" einzeln in der Seite einbinden - es ist nicht zwingend notwendig, das "Gallery"-Plugin zu verwenden.

Standardmässig wird die Galerie zentriert angezeigt, man kann aber analog zu Einzelbildern mit einem Leerzeichen am Anfang die Ausrichtung auch linksbündig vornehmen:

<code>
{{gallery>namespacename }}
</code>

Sofern JavaScript aktiv ist, werden die Bilder mit einer "Lightbox" angezeigt, d.h. beim Anklicken erscheint das Bild vergrößert und man kann alle vorhandenen Bilder durchblättern. Ohne JavaScript nur das jeweilige Bild einzeln angezeigt.

Eine ausführlichere Beschreibung findet man hier: [[http://www.dokuwiki.org/plugin:gallery]].

==== Zur "Lightbox" ====

Wenn im Browser JavaScript aktiv ist, erscheint beim Anklicken eines Bilds das jeweilige Bild in einem "Bilderrahmen" in voller Grösse oder so gross, wie es das Browserfenster zulässt. Solange dieser Rahmen geöffnet ist, kann man auch mit der Tastatur die Anzeige steuern:

  * Mit den Pfeiltasten links/rechts bzw. "n" oder "p" kommt man zum vorherigen oder nächsten Bild
  * Mit "x", "c" oder "Esc" schliesst man die Ansicht wieder

Falls das Bild verkleinert wurde, weil es im Original nicht in das Browserfenster passen würde, erscheint in links oben ein entsprechendes Symbol, mit dem man zwischen Originalgrösse und angepasster Darstellung wechseln kann.


===== Nachträglich hochgeladene Bilder erscheinen nicht sofort? =====

DokuWiki hält jede Seite in einem lokalen Cache. Wenn man nun Bilder in einem Namespace hinzufügt, ohne aber den Inhalt der Seite zu ändern, wird auch die Bildergalerie auf der Seite nicht neu erzeugt.

Abhilfen:

  - Seiteninhalt ändern (Leerzeile einfügen/löschen etc.) und die Seite speichern
  - Am Ende der Seite eine Zeile mit dem Text ''%%~~NOCACHE~~%%'' einfügen - dadurch wird sie bei jedem Aufruf neu aufgebaut, und nicht nur bei Änderungen