Beitragende Makro
Das Beitragende Makro zeigt eine Liste der Confluence Benutzer an, die irgendeinen Beitrag zu einer Seite geleistet haben. Es kann auch dazu benutzt werden, die Beobachter einer Seite aufzulisten.
Der Umfang dieses Makros kann dazu erweitert werden, die direkten untergeordneten Seiten oder die Abkömmlinge von spezifischen Seiten mit einzuschliessen. Die Liste der Beitragenden kann darauf basieren, ob die Benutzer:
- die Seite erstellt oder bearbeitet haben.
- Kommentare oder Stichworte zu der Seite hinzugefügt haben.
- einfach nur die Seite beobachten.
Das Beitragende Makro:
Und so konfigurieren Sie es im Makro-Browser:
Anwendung des Beitragende Makros
So fügen Sie das Beitragende Makro auf einer Seite ein:
- Positionieren Sie den Cursor im Bereich-Makro auf der Seite.
- Im Bearbeitungsmodus der Seite klicken Sie oben im Editor Menü auf das
Symbol (Weiteren Inhalt einfügen) und dann auf Andere Makros. - Tippen Sie den Makro Namen oder einen Teil davon ein und suchen Sie das gewünschte Makro aus. Klicken Sie auf das Makro.
- Geben Sie die gewünschten Parameter ein und klicken Sie auf Einfügen.
Schneller geht's mit der Autovervollständigung:
Tippen Sie die sich öffnende geschweifte Klammer '{' und den Beginn des Names des Makros, um eine Liste vorgeschlagener Makros zu sehen.
Editieren eines existierenden Makros
Um ein existierendes Makro zu bearbeiten:
Klicken Sie auf den Makro Platzhalter und dann auf Bearbeiten. Dieses öffnet den Dialog der Makro Details und Sie können die Makro Parameter (wenn vorhanden) bearbeiten.
Parameter des Beitragende Makros
Parameter sind Optionen, die Sie einstellen können, um den Inhalt oder das Format des Makro-Outputs zu bestimmen. Hier wird in Klammern angegeben (Beispiel), wenn der im Confluence Storage-Format oder im Wiki-Markup angegebene Parameter-Name anders ist, als der Name, der im Makro-Browser benutzt wird.
Mit Klick auf Optionen einblenden im Makro-Dialog sehen Sie folgende einstellbare Parameter.
| Parameter | Standard-Einstellung | Beschreibung |
|---|---|---|
Beitragstyp | authors | Sortierung nach dem Typ des Beitrags zur Seite (und optional den dazugehörigen Seiten) oder nach den Beobachtern der Seite. Die verschiedenen Optionen der Beitragstypen sind:
Sie können einen oder mehrere Beitragstypen einsetzen, jeweils durch ein Komma getrennt. |
Sortieren nach | count | Bestimmt die Kriterien zur Sortierung der Beitragenden:
|
| Sortierung umkehren | nicht angeklickt | Kehrt die Sortierungs-Reihenfolge der Beitragenden in der Liste um. Dieser Parameter muss zusammen mit dem Sortieren nach Parameter benutzt werden. |
| Maximale Anzahl Beitragender | leer | Limitiert die Anzahl der Beitragenden auf der Liste. Wenn hier kein Wert angegeben wird, werden alle Beitragenden eingeschlossen. |
| Format anzeigen | inline | Legt fest, wie die Liste der Namen der Beitragenden formatiert wird:
|
| Anonyme Beiträge anzeigen? | nicht angeklickt | Bestimmt, ob diejenigen, die anonym zur Seite beigetragen haben, mit eingeschlossen werden. |
| Anzahl anzeigen? | nicht angeklickt | Legt fest, ob die Anzahl, wie oft jeder Benutzer einen Beitrag des jeweilen Beitragstyps geleistet hat, mit eingeschlossen werden soll. |
| Zeit des letzten Beitrags anzeigen? | nicht angeklickt | Bestimmt, ob die Zeit des letzten Beitrags des jeweiligen Beitragstyps mit eingeschlossen werden soll. |
| Seitenname | leer | Bestimmt die Seite, die benutzt wird, um die Liste der Beitragenden zu erstellen. Wenn die Parameter Seitenname und Bereiche nicht angegeben werden, wird die aktuelle Seite benutzt. |
| Stichwort/Stichwörter | leer | Sortiert die Liste der Beitragenden danach, wer die bestimmten Stichworte von einer Seite erstellt hat. Sie können ein Stichwort oder mehrere angeben, jeweils durch ein Komma getrennt. |
| Bereiche | leer | Gibt den Bereichsschlüssel des Confluence Bereichs an, der die Seite, die unter Seitenname angegeben wurde. Oder gibt alternativ die Bereiche an, die durchsucht werden sollen. Bei Bereichsschlüsseln muss auf Groß- und Kleinschreibung geachtet werden. Diese Parameter sind auch zu beachten:
Sie können einen oder mehr Bereichsschlüssel, durch Komma getrennt, eingeben. Wenn kein Seitenname und keine Stichworte spezifiziert sind, werden alle Seiten der angegebenen Bereich mit eingeschlossen. |
| Inhaltstyp | leer | Beschränkt den Inhaltstypen, der benutzt wird, um die Liste der Beitragenden zu erstellen:
|
| Datum/Blogeintrag | leer | Gibt das Datum der Veröffentlichung eines Blog-Beitrags an. Das benötigte Datumsformat ist: YYYY/MM/DD. |
| Seitenhierachie einbinden | leer | Legt zusätzliche Seiten an, die eingeschlossen werden können:
|
| Ausgewählte Seiten anzeigen | leer | Bestimmt, ob die Liste der Seiten angezeigt wird, die benutzt wurden, um die Liste der Beitragenden zu erstellen. |
| Angepasste "Nicht gefunden" Nachricht | leer | Eingabe der Nachricht, die benutzt wird, um die Standard-Nachricht zu überschreiben, die auf der Seite zu sehen ist, wenn keine Beitragende gefunden wurden. |
Beispiel eines Wiki Markups
Dieses Beispiel ist hilfreich, wenn Sie ein Makro ausserhalb des Editors, z.B. als benutzerdefinierten Inhalt in der Randleiste, der Kopf- oder Fußzeile, hinzufügen möchten.
Macro name: contributors
Macro body: None.
This example specifies a content type of blog posts:
{contributors:limit=10|spaces=ds,@personal|reverse=true|labels=chocolate,cake|showPages=true|noneFoundMessage=Oh dear, no contributors found|showCount=true|contentType=blogposts|include=authors,comments,labels,watches|mode=list|showAnonymous=true|order=update|showLastTime=true|publishDate=2012/06/30}This example specifies a content type of pages:
{contributors:limit=10|spaces=ds,@personal|reverse=true|scope=descendant
Übersicht aller Confluence Makros
Auf dieser Seite finden Sie eine Übersicht aller im Standard von Confluence enthaltenden Makros und allgemeine Informationen über die Anwendung von Makros.