Questa macro include il contenuto formattato di una o più pagine wiki locali date, eseguendo inclusioni ricorsive nel caso vengano incontrate. Nel caso le ricorsioni creano dei cicli, vengono rilevati e cancellati!
Utilizzo:
<<Include(pagename, heading, level, from="regex", to="regex", sort=ascending|descending, items=n, skipitems=n, titlesonly, editlink)>>
- pagename
Nome della pagina da includere, se comincia con "^", la base del nome delle pagine da includere.
- heading
- Testo per il titolo generato che verrà collegato alla pagina inclusa (opzionale).
- level
- Livello (1..5) del titolo generato (opzionale).
- from
- Marcatore parziale del punto iniziale di inclusione (opzionale).
- to
- Marcatore parziale del punto finale di inclusione (opzionale).
- sort
Ordinamento nel caso in cui il nome pagina sia una base, cioè comincia con "^" (opzionale).
- items
- Numero massimo di pagine da includere.
- skipitems
- Numero di pagine iniziali da scartare (opzionale).
- titlesonly
- Include solo un collegamento alla pagina, non il contenuto (opzionale).
- editlink
Inserisce un piè di pagina che collega alla pagina inclusa, sia normale che in modifica (opzionale, disponibile a partire da MoinMoin 1.3.4).
Tutti i parametri eccetto pagename sono opzionali, ma occorre seguire l'ordine dato. Volendo omettere heading, è necessario lasciare il secondo parametro vuoto.
from e to riconoscono quanto specificato anche nei commenti. Fare attenzione ai commenti che fermano l'inclusione inaspettatamente.
Esempi:
<<Include(FooBar)>>: include la pagina di testo FooBar nel paragrafo corrente
<<Include(FooBar,"Foo Bar" )>>: aggiunge un titolo H1 collegato contenente 'Foo Bar' seguito dal testo
<<Include(FooBar, , 2)>>: aggiunge un H2 con 'Foo Bar'
<<Include(FooBar, 'Tutto su Foo Bar', 2)>>: aggiunge un H2 con 'Tutto su Foo Bar'
<<Include(FooBar, , from="^----$")>>: include solo i contenuti a partire dalla prima linea orizzontale
<<Include(FooBar, , to="^----$")>>: include solo i contenuti fino alla prima linea orizzontale
<<Include(^FooBar/.*, , sort=descending)>>: ordina la lista in un elenco in ordine discendente
<<Include(^FooBar/.*, , items=3)>>: include la massimo tre pagine
<<Include(^BlogBase/.*,, to="^----$", sort=descending, items=7)>>: mostra al massimo una settimana di un blog
<<Include(^BlogBase/.*,, to="^----$", sort=descending, items=7, skipitems=7, titlesonly)>>: mostra solo i titoli della settimana precedente
È possibile utilizzare ciò che segue con MonthCalendar per i blog:
<<Include(^FirstnameLastname/20..-..-..,,to="^----",sort=descending,items=3)>>: mostra il contenuto dei primi tre giorni nel calendario di un mese
<<Include(^FirstnameLastname/20..-..-..,,to="^----",sort=descending,items=4,skipitems=3,titlesonly)>>: mostra solo i titoli dei quattro giorni successivi