## Please edit system and help pages ONLY in the moinmaster wiki! For more
## information, please see MoinMaster:MoinPagesEditorGroup.
##master-page:HelpOnMacros/Include
##master-date:2006-06-08 11:01:46
#acl MoinPagesEditorGroup:read,write,delete,revert All:read
#format wiki
#language it
<<Navigation(siblings)>>
<<BR>><<BR>>

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 MoinMoin: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
