Include

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