AiutoSuMacro/Includi

Questa macro include il contenuto formattato di una o più pagine wiki locali, eseguendo inclusioni ricorsive nel caso vengano incontrate. Se la ricorsione crea dei cicli, questo viene rilevato e bloccato!

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 regex 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 regex, 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 quindi attenzione ai commenti che fermano l'inclusione inaspettatamente.

Esempi

Include la pagina di testo FooBar nel paragrafo corrente:
```
<<Include(FooBar)>>
```
Aggiunge un titolo H1 collegato contenente 'Foo Bar' seguito dal testo:
```
<<Include(FooBar,"Foo Bar" )>>
```
Aggiunge un H2 con 'Foo Bar':
```
<<Include(FooBar, , 2)>>
```

Aggiunge un H2 con 'Tutto su Foo Bar':

<<Include(FooBar, 'Tutto su Foo Bar', 2)>>

Include solo i contenuti a partire dalla prima linea orizzontale:
```
<<Include(FooBar, , from="^----$")>>
```
Include solo i contenuti fino alla prima linea orizzontale:
```
<<Include(FooBar, , to="^----$")>>
```
Genera l'elenco delle pagine in ordine discendente:
```
<<Include(^FooBar/.*, , sort=descending)>>
```
Include al massimo tre pagine:
```
<<Include(^FooBar/.*, , items=3)>>
```

Mostra al massimo una settimana di un blog:

<<Include(^BlogBase/.*,, to="^----$", sort=descending, items=7)>>

Mostra solo i titoli della settimana precedente:

<<Include(^BlogBase/.*,, to="^----$", sort=descending, items=7, skipitems=7, titlesonly)>>

È possibile utilizzare ciò che segue con MonthCalendar per i blog:
- Mostra il contenuto dei primi tre giorni nel calendario di un mese
```
<<Include(^FirstnameLastname/20..-..-..,,to="^----",sort=descending,items=3)>>
```
- Mostra solo i titoli dei quattro giorni successivi
```
<<Include(^FirstnameLastname/20..-..-..,,to="^----",sort=descending,items=4,skipitems=3,titlesonly)>>
```