In Redmine sind Makros so etwas wie kleine, vorgefertigte Bausteine die man in einen Inhalt (z.B. eine Wikiseite) integriert, um diesen um nützliche Informationen aus anderen Bereichen zu erweitern oder schnell darauf zugreifen zu können.
Makros erleichtern die Arbeit
Redmine liefert von Haus aus eine Reihe an Standardmakros, die man in Wikiseiten implementiert. Je nachdem mit welchen Plugins man arbeitet stehen dem Anwender Zusatzmakros zur Verfügung.
Die Makros erleichtern das Erstellen von dynamischen Inhalten und die Implementation interaktiver Elemente wie beispielsweise Tabellen, Slides, Videos. Etwa wenn man eine Liste der aktuellen Aufgaben ausgeben will. Oder alle aktiven Team-Mitglieder darstellen muss.
Werden Listen manuell erstellt ist es notwendig diese auch regelmäßig zu aktualisieren. Das bedeutet nicht nur zusätzlichen Zeitaufwand, sondern sorgt auch für unnötige Fehler.
Möchte man Videos von bekannten Plattformen integrieren wird man schnell an die Grenzen der normalen Wikisyntax kommen. Meist geht nur die Verlinkung auf externe Inhalte was den Mehrwert einer Wikiseite schmälert. Dafür sind Makros ideal einsetzbar. Sie erleichtern nicht nur die Arbeit, sondern sorgen auch für eine bessere Strukturierung der Inhalte in Redmine. Auf Wikiseiten und teilweise auch im Beschreibungsfeld von Tickets.
Makro Parameter
Makros werden in der Form
{{ "*Makroname*" }}
in Wiki-Seiten integriert. Hier ein Beispiel für das Makro “Table of content (toc)” welches ein Inhaltsverzeichnis für Wikiseiten ausgibt:
{{toc}}
Viele Makros haben optionale Parameter mit denen man die Ausgabe des Makros kontrollieren kann. Nutzt man beispielsweise das mit dem kostenlosen Zusatzplugin Additionals (externer Link zu Github) gelieferte Makro für einen Kalender
{{calendar}}
hat man folgende Parameter zur Auswahl:
- year (int) – z.B. 2015
- month (int) – z.B. 4
- show_weeks (bool) – zeigt die Kalenderwoche an, wenn es auf true steht.
{{calendar(year=2015, month=4, show_weeks=true)}}
Welche Makros kann ich nutzen?
Möchte man wissen welche Makros einem auf der aktuell eingesetzten Redmine Installation zur Verfügung stehen implementiert man auf eine Wikiseite folgendes Makro:
{{macro_list}}
Dieses zeigt dann eine Liste aller verfügbaren Makros an inklusive einer kurzen Beschreibung zum möglichen Einsatzzweck.
Spickzettel für Redmine Makros
Wie bereits erwähnt gibt es zahlreiche Plugins, welche ebenfalls Makros liefern. In unserem Redmine Macro Cheat Sheet haben wir eine Liste nützlichen Makros aus kostenlosen Redmine Plugins für euch zusammen getragen. Die könnt ihr euch herunter laden und sehen ob das eine oder andere Plugin die gewünschten Informationen zur Verfügung stellt, die dann mit Hilfe eines Makros in die Wiki implementiert werden kann.
Tipp: Redmine Support vom Profi
Gerne sind wir euch bei der Installation von Redmine Plugins behilflich. Falls ihr in unserer Pluginsammlung nicht fündig werden, übernehmen wir für euch auch die Entwicklung eigener Plugins, sowie Erweiterung bestehender Plugins um die von euch benötigte Funktionalität.