Füge das Galerie-Makro ein
Confluence Cloud Dokumentation
Im Juni 2025 hat Atlassian die bevorstehende Abschaffung des Legacy-Editors (Englisch) sowie Informationen zur Umstellung auf den Cloud-Editor angekündigt.
Bevor die Abschaffung im Januar 2026 beginnt, funktioniert dieses Makro weiterhin. Weitere Infos findest du im Artikel Im Cloud-Editor nicht verfügbare oder eingeschränkte Makros.
Das Galerie-Makro zeigt eine Sammlung von Vorschaubildern in einer Tabelle an, basierend auf den Bildern, die an eine Confluence-Seite angehängt sind. Beim Betrachten der Seite kann eine Person auf ein Vorschaubild klicken, um in ein bildschirmgroßes Bild hineinzuzoomen, und die Bilder anschließend als Diashow ansehen.
Überblick:
- Die in der Galerie gezeigten Bilder stammen aus den Dateien, die an die Confluence-Seite angehängt sind. Du kannst auch eine andere Seite angeben, auf der sich die Anhänge befinden. Infos zum Anhängen von Bildern an eine Seite findest du unter Eine Datei hochladen.
- Die Bildunterschriften unter den Bildern stammen aus den Kommentaren zu den Anhängen. Infos zum Hinzufügen von Kommentaren zu Anhängen findest du unter Eine Datei hochladen.
- Standardmäßig enthält die Galerie alle an die Seite angehängten Bilder. Du kannst Bilder mithilfe von Parametern auch aus- oder einschließen.
- Du kannst deine Bilder in einer bestimmten Reihenfolge sortieren.
- Du kannst einen Titel für die Galerie festlegen und außerdem konfigurieren, wie viele Spalten die Tabelle haben soll, in der deine Bilder angezeigt werden.
Verwendung des Galerie-Makros
So fügst du das Galerie-Makro hinzu:
- Wähle beim Bearbeiten ➕▾ in der Symbolleiste aus
- Suche das Makro nach Namen und wähle es aus
- Konfiguriere es nach Bedarf
Du kannst auf der Seite auch / eingeben, um dieselbe Liste zu öffnen, die du auch über ➕▾ in der Symbolleiste siehst. Tippe weiter den Namen des Makros ein, um die Liste zu filtern.
So bearbeitest du das Galerie-Makro:
- Wähle den Makro-Platzhalter aus.
- Wähle das ✏️-Symbol aus, um das Konfigurationsfenster zu öffnen.
- Konfiguriere die Parameter. Deine Änderungen werden automatisch gespeichert.
- Setze die Bearbeitung der Seite fort, dann schließt sich das Fenster.
Du kannst außerdem die Symbole für zentriert, mittelbreit und vollbreit auswählen, um die Breite einiger Makros anzupassen. Wähle das 🗑️-Symbol aus, um das Makro zu entfernen.
Parameter
Parameter sind Optionen, mit denen du den Inhalt oder das Format der Makro-Ausgabe steuern kannst. Wenn der im Confluence-Cloud-Speicherformat verwendete Parametername vom Label abweicht, das beim Einfügen von Makros über den Browser oder den Slash-Befehl angezeigt wird, steht er unten in Klammern (example).
Die vollständige Liste der Parameter zeigt die folgende Tabelle. Falls der Name einer angehängten Datei oder Seite ein Komma enthält, kannst du ihn in den entsprechenden Parametern unten in einfachen oder doppelten Anführungszeichen angeben, zum Beispiel "this,that.jpg", theother.png.
| Parameter | Standard | Beschreibung |
|---|---|---|
| Galerietitel ( title) |
Keiner | Lege einen Titel für deine Galerie fest. |
| Anzahl der Spalten ( columns) |
4 | Lege die Anzahl der Spalten für deine Tabelle fest. |
| Auszuschließende Bilder ( exclude) |
Keine Ausschlüsse. Alle Bilder auf der Seite werden einbezogen. |
Die Galerie ignoriert alle angegebenen Bilder. Du kannst mehr als ein Bild angeben, getrennt durch Kommas. Hinweis: Dateiname und Dateityp sind bei diesem Parameter groß-/kleinschreibungsabhängig. Zum Beispiel wird „mein bild.PNG“ nicht als „mein bild.png“ erkannt. |
| Nur diese Bilder einschließen ( include) |
Alle Bilder auf der Seite werden einbezogen. |
Wenn du gezielt ein oder mehrere Bilder einschließt, zeigt die Galerie nur diese Bilder an. Du kannst mehr als ein Bild angeben, getrennt durch Kommas. Dateiname und Dateityp sind bei diesem Parameter groß-/kleinschreibungsabhängig. Zum Beispiel wird „mein bild.PNG“ nicht als „mein bild.png“ erkannt. |
| Bilder mit diesen Stichwörtern ausschließen ( excludeLabel) |
Keine Ausschlüsse. Alle Bilder auf der Seite werden einbezogen. |
Die Galerie ignoriert alle Bilder mit dem angegebenen Stichwort. Du kannst mehr als ein Stichwort angeben, getrennt durch Kommas. Infos zum Versehen von Anhängen mit Stichwörtern findest du unter Stichwörter zum Organisieren von Inhalten und Anhängen verwenden. |
| Nur Bilder mit diesen Stichwörtern einschließen ( includeLabel) |
Keine. Die Bilder werden nicht nach Stichwort gefiltert. |
Filtert die anzuzeigenden Bilder anhand einer Liste von Stichwörtern. Trenne mehrere Stichwörter durch Kommas. Confluence zeigt jedes Bild an, das mindestens eines der angegebenen Stichwörter trägt (eine ODER- statt UND-Verknüpfung). Infos zum Versehen von Anhängen mit Stichwörtern findest du unter Stichwörter zum Organisieren von Inhalten und Anhängen verwenden. |
| Bilder von diesen Seiten verwenden ( page) |
Falls keine Seite angegeben ist, zeigt das Galerie-Makro die Bilder an, die an die Seite angehängt sind, auf der das Makro verwendet wird. |
Gib den Titel der Seite an, die die anzuzeigenden Bilder enthält. Du kannst mehr als einen Seitennamen angeben, getrennt durch Kommas. Um eine Seite in einem anderen Bereich anzugeben, verwende folgende Syntax: SPACEKEY:Page Title |
| Bilder sortieren nach ( sort) |
Keine. Die Sortierreihenfolge ist nicht festgelegt und daher nicht vorhersehbar. |
Gib ein Attribut an, nach dem die Bilder sortiert werden sollen. Die Sortierreihenfolge ist aufsteigend, außer du wählst den Parameter Sortierung umkehren (siehe unten). Optionen sind: name – Dateiname. comment – mit der angehängten Datei verknüpfter Kommentar. date – Datum/Uhrzeit der letzten Änderung. size – Größe der angehängten Datei. |
| Sortierung umkehren ( reverse) |
Aus. Sortierreihenfolge ist aufsteigend |
Wird in Kombination mit dem Parameter Bilder sortieren nach oben verwendet. Verwende Sortierung umkehren, um die Sortierreihenfolge von aufsteigend auf absteigend zu ändern. Verfügbare Werte im Speicherformat und Wiki-Markup: true –Sortierreihenfolge ist absteigend. false – Sortierreihenfolge istaufsteigend. |
Bilddateiformate
Du kannst Bilddateien in jedem Format an eine Seite anhängen. Confluence unterstützt folgende Bildformate im Galerie-Makro und beim Anzeigen eines Bilds auf einer Seite:
- gif
- jpeg
- png
- bmp (abhängig von der Browser-Unterstützung)
Wiki-Markup-Beispiel
Wiki-Markup ist nützlich, wenn du ein Makro außerhalb des Editors hinzufügen musst, zum Beispiel als benutzerdefinierten Inhalt in der Seitenleiste, Kopf- oder Fußzeile eines Bereichs.
Makroname: gallery
Makro-Body: Keiner.
1{gallery:title=My holiday pictures|reverse=true|sort=size|page=My page1, ds:Welcome to Confluence|excludeLabel=badlabel1, badlabel2|columns=3|exclude=badpicture.png}