• AiutoSuMacro
• Includi

Questa macro include il contenuto formattato di una o più pagine wiki locali date, eseguendo inclusioni ricorsive nel caso vengano incontrate. Nel caso le ricursioni creino dei cicli, vengono prevenuti 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

Levello (1..5) del titolo generato (opzionale).

from

Marcatore parziale del punto d'inizio inclusione (opzionale).

to

Marcatore parziale del punto di fine 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

Includi solo un collegamento alla pagina, non al contenuto della stessa (opzionale).

editlink

inserisci 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", devi lasciare il secondo parametro vuoto.

from e to riconoscono quanto specificato anche nei commenti, per cui fai attenzione ai commenti che fermano un'include 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

• Puoi utilizzare ciò che segue con MonthCalendar per i tuoi 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 4 giorni sucessivi