<?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><para>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! </para><para><emphasis role="strong">Utilizzo:</emphasis> </para><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 base 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 base, 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://www.ninux.org/AiutoSuMacro/Includi/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 attenzione ai commenti che fermano l'inclusione inaspettatamente. </para><para><emphasis role="strong">Esempi:</emphasis> </para><itemizedlist><listitem><para><code>&lt;&lt;Include(FooBar)&gt;&gt;</code>: include la pagina di testo <code>FooBar</code> nel paragrafo corrente </para></listitem><listitem><para><code>&lt;&lt;Include(FooBar,&quot;Foo Bar&quot; )&gt;&gt;</code>: aggiunge un titolo H1 collegato contenente 'Foo Bar' seguito dal testo </para></listitem><listitem><para><code>&lt;&lt;Include(FooBar, , 2)&gt;&gt;</code>: aggiunge un H2 con 'Foo Bar' </para></listitem><listitem><para><code>&lt;&lt;Include(FooBar, 'Tutto su Foo Bar', 2)&gt;&gt;</code>: aggiunge un H2 con 'Tutto su Foo Bar' </para></listitem><listitem><para><code>&lt;&lt;Include(FooBar, , from=&quot;^----$&quot;)&gt;&gt;</code>: include solo i contenuti a partire dalla prima linea orizzontale </para></listitem><listitem><para><code>&lt;&lt;Include(FooBar, , to=&quot;^----$&quot;)&gt;&gt;</code>: include solo i contenuti fino alla prima linea orizzontale </para></listitem><listitem><para><code>&lt;&lt;Include(^FooBar/.*, , sort=descending)&gt;&gt;</code>: ordina la lista in un elenco in ordine discendente </para></listitem><listitem><para><code>&lt;&lt;Include(^FooBar/.*, , items=3)&gt;&gt;</code>: include la massimo tre pagine </para></listitem><listitem><para><code>&lt;&lt;Include(^BlogBase/.*,, to=&quot;^----$&quot;, sort=descending, items=7)&gt;&gt;</code>: mostra al massimo una settimana di un blog </para></listitem><listitem><para><code>&lt;&lt;Include(^BlogBase/.*,, to=&quot;^----$&quot;, sort=descending, items=7, skipitems=7, titlesonly)&gt;&gt;</code>: mostra solo i titoli della settimana precedente </para></listitem><listitem><para>È possibile utilizzare ciò che segue con <ulink url="http://moinmoin.wikiwikiweb.de/MonthCalendar#">MonthCalendar</ulink> per i blog: </para><itemizedlist><listitem><para><code>&lt;&lt;Include(^FirstnameLastname/20..-..-..,,to=&quot;^----&quot;,sort=descending,items=3)&gt;&gt;</code>: mostra il contenuto dei primi tre giorni nel calendario di un mese </para></listitem><listitem><para><code>&lt;&lt;Include(^FirstnameLastname/20..-..-..,,to=&quot;^----&quot;,sort=descending,items=4,skipitems=3,titlesonly)&gt;&gt;</code>: mostra solo i titoli dei quattro giorni successivi </para></listitem></itemizedlist></listitem></itemizedlist></article>