Italiano English
Locked History Actions

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