Dieses Makro fügt den formatierten Inhalt der angegebenen Seite(n) ein und macht dabei ggf. auch rekursive Include-Aufrufe. Wenn die Rekursion einen Zyklus generieren würde, wird dies bemerkt und verhindert!
Benutzung:
<<Include(pagename, heading, level, from="regex", to="regex", sort=ascending|descending, items=n, skipitems=n, titlesonly, editlink)>>
- pagename
Name der Seite, die eingefügt werden soll - wenn er mit einem "^" anfängt, ein regulärer Ausdruck von Seiten, die eingefügt werden sollen.
- heading
- Text für die generierte Überschrift (optional).
- level
- Ebene (1-5) der generierten Überschriften (optional).
- from
- Start-Markierung für teilweises Einlesen (optional).
- to
- End-Markierung für teilweises Einlesen (optional).
- sort
Sortierreihenfolge, wenn pagename ein regulärer Ausdruck ist, also mit einem "^" anfängt (optional).
- items
- Maximale Anzahl der einzufügenden Seiten (optional).
- skipitems
- Anzahl der vom Start her zu überspringenden Seiten (optional).
- titlesonly
- Nur einen Link zur Seite einfügen, keinen Seiteninhalt (optional).
- editlink
- Fügt einen Footer mit Verweis auf die einzufügende Seite hinzu, als auch einen Verweis, um die Seite zu bearbeiten (optional).
Alle Parameter außer pagename sind optional, Sie müssen aber die angegebene Reihenfolge einhalten! Wenn Sie "heading" auslassen wollen, müssen Sie den zweiten Parameter leer lassen.
Beispiele:
<<Include(FooBar)>> -- fügt den Text der Seite FooBar in den aktuellen Absatz ein
<<Include(FooBar, )>> -- hinzufügen einer H1 namens 'Foo Bar' gefolgt vom Text
<<Include(FooBar, , 2)>> -- hinzufügen einer H2 namens 'Foo Bar'
<<Include(FooBar, 'Alles über Foo Bar', 2)>> -- hinzufügen einer H2 namens 'Alles über Foo Bar'
<<Include(FooBar, , from="^----$")>> -- nur den Inhalt nach dem ersten Horizontaltrenner einfügen
<<Include(FooBar, , to="^----$")>> -- nur den Inhalt bis zum ersten Horizontaltrenner einfügen
<<Include(^FooBar/.*, , sort=descending)>> -- die Seitenliste absteigend sortieren
<<Include(^FooBar/.*, , items=3)>> -- maximal drei Seiten einfügen
<<Include(^BlogBase/.*,, to="^----$", sort=descending, items=7)>> -- Anzeigen maximal einer Woche eines Blogs
<<Include(^BlogBase/.*,, to="^----$", sort=descending, items=7, skipitems=7, titlesonly)>> -- nur die Titel der vorhergehenden Woche anzeigen
Sie können dies mit MonthCalendar zum sog. Blogging benutzen:
<<Include(^FirstnameLastname/20..-..-..,,to="^----",sort=descending,items=3)>> -- 3 Einträge eines Monatskalenders anzeigen
<<Include(^FirstnameLastname/20..-..-..,,to="^----",sort=descending,items=4,skipitems=3,titlesonly)>> -- die nächsten 4 Einträge nur mit Titeln anzeigen