Blog Post - Blog Einträge Makro
Mit dem Blog Einträge Makro (Blog Posts macro) können Sie Blog-Einträge auf einer Confluence Seite anzeigen lassen. Mit einem Klick auf den jeweiligen Titel des Blogs, gelangen Sie zu dem Blog-Eintrag.
Anwendung des Blog Post Makros
So fügen Sie das Blog Post Makro auf einer Seite ein:
- 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.
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. In diesem Beispiel fügen wir das Cheese Makro ein:
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 Blog Post Makros
Parameter sind Optionen, die Sie einstellen könne, 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.
Parameter | Benötigt | Standard-Einstellung | Beschreibung |
---|---|---|---|
Anzuzeigender Inhaltstyp ( | Nein | entire | Zur Verfügung stehende Werte:
|
Zeitrahmen | Nein | Kein Limit | Gebe Sie an, wie weit die anzuzeigenden Blog Einträge zurückliegen dürfen.
|
Auf diese Stichwörter beschränken | Nein | Keine | Sortieren Sie die Ergebnisse nach Stichwörtern. Das Makro wird nur die Blog Einträge anzeigen, die mit den Stichworten versehen sind, die Sie hier angeben. Wenn Sie mehr als ein Stichwort eingeben möchten, trennen Sie jedes Stichwort mit einem Komma oder mit einem einzelnen Leerzeichen.
|
Auf diese Autoren beschränken | Nein | Keine | Filtern Sie die Ergebnisse nach ihrem Autoren. Das Makro wird nur die Blog Einträge anzeigen, die von dem oder den Autoren geschrieben wurden, den Sie hier angeben. |
Auf diese Bereiche beschränken | Nein | @self, z.B. der Bereich, der die Seite beinhaltet, auf der das Makro kodiert wurde | Groß-/Kleinschreibung ist zu beachten. Trennen Sie jedes Element mit einem Komma oder einem einzelnen Leerzeichen. Beispiel: Mit diesem Parameter können Sie den Inhalt je nach Bereich filtern. Das Makro wird nur Seiten anzeigen, die zu dem oder den Bereich(en) gehören, die Sie hier angeben. Sie können einen oder mehrere Bereichs-Schlüssel angeben, jeweils durch ein Komma oder durch ein Leerzeichen getrennt.
Wenn Sie einen persönlichen Bereich angeben, beachten Sie bitte, dass das Tilde Zeichen (~) vor dem Nutzernamen benutzt wird, wie z.B. |
Maximale Anzahl Blog-Einträge | Nein | 100 | Spezifizieren Sie die maximale Anzahl der Ergebnisse, die angezeigt werden sollen. Beachten Sie bitte, dass die Ergebnisse erst sortiert werden und dann dieser Parameter angewandt wird. |
Sortieren nach | Nein | creation | Spezifizieren Sie, wie die Ergebnisse sortiert werden sollen. Wenn dieser Parameter nicht angegeben wird, wird standardgemäß in absteigender Reihenfolge je nach Erstellungsdatum (das neueste zuerst) sortiert.
|
Seitenreihenfolge umkehren | Nein | Nicht aktiviert | Hier können Sie die Seitenreihenfolge von absteigend zu aufsteigend (älteste zuerst) ändern. Benutzen Sie diesen Parameter zusammen mit dem Sortieren nach Parameter. Dieser Parameter wird ignoriert, wenn der Sortieren nach Parameter nicht spezifiziert wurde. Im Storage-Format und im Wiki Markup ändert ein Wert von aktiviert (Häkchen gesetzt) die Sortierreihenfolge. |
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: blog-posts
Macro body: None.
{blog-posts:content=titles|spaces=@self,ds|author=jsmith|time=4w|reverse=true|sort=creation|max=10|label=chocolate,cookie
Ü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.