<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>AiutoSuMacro/Includi</title></articleinfo><section><title>Include</title><para>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! </para><section><title>Utilizzo:</title><screen><![CDATA[<<Include(pagename, heading, level, from="regex", to="regex", sort=ascending|descending, items=n, skipitems=n, titlesonly, editlink)>>]]></screen><glosslist><glossentry><glossterm>pagename</glossterm><glossdef><para>Nome della pagina da includere, se comincia con &quot;<code>^</code>&quot;, la regex del nome delle pagine da includere. </para></glossdef></glossentry><glossentry><glossterm>heading</glossterm><glossdef><para> Testo per il titolo generato che verrà collegato alla pagina inclusa (opzionale). </para></glossdef></glossentry><glossentry><glossterm>level</glossterm><glossdef><para>   Livello (1..5) del titolo generato (opzionale). </para></glossdef></glossentry><glossentry><glossterm>from</glossterm><glossdef><para>    Marcatore parziale del punto iniziale di inclusione (opzionale). </para></glossdef></glossentry><glossentry><glossterm>to</glossterm><glossdef><para>      Marcatore parziale del punto finale di inclusione (opzionale). </para></glossdef></glossentry><glossentry><glossterm>sort</glossterm><glossdef><para>    Ordinamento nel caso in cui il nome pagina sia una regex, cioè comincia con &quot;<code>^</code>&quot; (opzionale). </para></glossdef></glossentry><glossentry><glossterm>items</glossterm><glossdef><para>   Numero massimo di pagine da includere. </para></glossdef></glossentry><glossentry><glossterm>skipitems</glossterm><glossdef><para>Numero di pagine iniziali da scartare (opzionale). </para></glossdef></glossentry><glossentry><glossterm>titlesonly</glossterm><glossdef><para>Include solo un collegamento alla pagina, non il contenuto (opzionale). </para></glossdef></glossentry><glossentry><glossterm>editlink</glossterm><glossdef><para>Inserisce un piè di pagina che collega alla pagina inclusa, sia normale che in modifica (opzionale, disponibile a partire da <ulink url="http://research.math.uvt.ro/wiki/AiutoSuMacro/Includi/wiki/MoinMoin#">MoinMoin</ulink> 1.3.4). </para></glossdef></glossentry></glosslist><para>Tutti i parametri eccetto <code>pagename</code> sono opzionali, ma occorre seguire l'ordine dato. Volendo omettere <code>heading</code>, è necessario lasciare il secondo parametro vuoto. </para><para><code>from</code> e <code>to</code> riconoscono quanto specificato anche nei commenti. Fare quindi attenzione ai commenti che fermano l'inclusione inaspettatamente. </para></section><section><title>Esempi</title><itemizedlist><listitem><para>Include la pagina di testo <code>FooBar</code> nel paragrafo corrente:  </para><screen><![CDATA[<<Include(FooBar)>>]]></screen></listitem><listitem><para>Aggiunge un titolo H1 collegato contenente 'Foo Bar' seguito dal testo: </para><screen><![CDATA[<<Include(FooBar,"Foo Bar" )>>]]></screen></listitem><listitem><para>Aggiunge un H2 con 'Foo Bar': </para><screen><![CDATA[<<Include(FooBar, , 2)>>]]></screen></listitem><listitem><para>Aggiunge un H2 con 'Tutto su Foo Bar': </para><screen><![CDATA[<<Include(FooBar, 'Tutto su Foo Bar', 2)>>]]></screen></listitem><listitem><para>Include solo i contenuti a partire dalla prima linea orizzontale: </para><screen><![CDATA[<<Include(FooBar, , from="^----$")>>]]></screen></listitem><listitem><para>Include solo i contenuti fino alla prima linea orizzontale: </para><screen><![CDATA[<<Include(FooBar, , to="^----$")>>]]></screen></listitem><listitem><para>Genera l'elenco delle pagine in ordine discendente: </para><screen><![CDATA[<<Include(^FooBar/.*, , sort=descending)>>]]></screen></listitem><listitem><para>Include al massimo tre pagine: </para><screen><![CDATA[<<Include(^FooBar/.*, , items=3)>>]]></screen></listitem><listitem><para>Mostra al massimo una settimana di un blog: </para><screen><![CDATA[<<Include(^BlogBase/.*,, to="^----$", sort=descending, items=7)>>]]></screen></listitem><listitem><para>Mostra solo i titoli della settimana precedente: </para><screen><![CDATA[<<Include(^BlogBase/.*,, to="^----$", sort=descending, items=7, skipitems=7, titlesonly)>>]]></screen></listitem><listitem><para>È possibile utilizzare ciò che segue con MoinMoin:MonthCalendar per i blog: </para><itemizedlist><listitem><para>Mostra il contenuto dei primi tre giorni nel calendario di un mese </para><screen><![CDATA[<<Include(^FirstnameLastname/20..-..-..,,to="^----",sort=descending,items=3)>>]]></screen></listitem><listitem><para>Mostra solo i titoli dei quattro giorni successivi </para><screen><![CDATA[<<Include(^FirstnameLastname/20..-..-..,,to="^----",sort=descending,items=4,skipitems=3,titlesonly)>>]]></screen></listitem></itemizedlist></listitem></itemizedlist></section></section></article>