<?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>AiutoSuTemi</title></articleinfo><para><ulink url="http://research.math.uvt.ro/wiki/AiutoSuTemi/wiki/AiutoContenuti#">AiutoContenuti</ulink> &gt; <ulink url="http://research.math.uvt.ro/wiki/AiutoSuTemi/wiki/AiutoPerAmministratori#">AiutoPerAmministratori</ulink> &gt; <ulink url="http://research.math.uvt.ro/wiki/AiutoSuTemi/wiki/AiutoSuConfigurazione#">AiutoSuConfigurazione</ulink> &gt; AiutoSuTemi </para><para>MoinMoin dispone di un sistema per la gestione dei temi che semplifica la modifica dell'aspetto del wiki senza modificare il codice sorgente. Come utenti è possibile scegliere tra diversi temi preinstallati<footnote><para>&quot;In un'installazione standard di !MoinMoin questi sono ''classic'', ''modern'' e ''rightsidebar''&quot;</para></footnote> direttamente nelle proprie preferenze (questo è possibile solamente se l'amministratore del wiki non ha forzato un tema specifico, disabilitando così la possibilità di cambiare tema). </para><section><title>Installare temi</title><para>È possibile trovare molti temi da scaricare presso MoinMoin:ThemeMarket. Assicurarsi che il tema selezionato sia compatibile con la versione di MoinMoin in uso. </para><para>Per installare un nuovo tema non è sufficiente copiare il file nella directory dei temi del wiki. Per installarlo seguire le istruzioni fornite dall'autore del tema. Tipicamente sono presenti due posizioni per i temi: </para><orderedlist numeration="arabic"><listitem><para>La directory dove sono archiviati tutti i temi </para><itemizedlist><listitem><para>Decomprimere l'archivio e inserivi la directory del tema (che contiene due directory <code>css/</code> e <code>img/</code>) </para></listitem></itemizedlist></listitem><listitem><para>La directory <code>data/plugin/theme/</code> </para><itemizedlist><listitem><para>Spostare lo script del tema in questa directory (tale script ha lo stesso nome del tema e termina con <code>.py</code>). </para></listitem></itemizedlist></listitem></orderedlist><para>Il tema dovrebbe essere ora disponibile. Potrebbe essere necessario rieseguire l'accesso o pulire la cache. Per le opzioni di configurazione, consultare <ulink url="http://research.math.uvt.ro/wiki/AiutoSuTemi/wiki/AiutoSuConfigurazione#">AiutoSuConfigurazione</ulink>. </para></section><section><title>Personalizzare i temi</title><para>È possibile personalizzare i temi pre-installati, ma è sempre meglio partire da una copia di un tema. Procedere come segue (viene usato il tema <emphasis>modern</emphasis> come esempio): </para><orderedlist numeration="arabic"><listitem><para>Fare una copia del tema <emphasis>modern</emphasis> presente nella directory dei temi e chiamarlo <emphasis>miotema</emphasis>. </para></listitem><listitem><para>Fare una copia del file di script <code>MoinMoin/theme/modern.py</code> in <code>data/plugin/theme/miotema.py</code>. </para></listitem><listitem><para>Modificare il file <code>miotema.py</code> e cambiare almeno la variabile <code>name = &quot;modern&quot;</code> in <code>name = &quot;miotema&quot;</code>. </para></listitem><listitem><para>Dovrebbe essere possibile quindi vedere il nuovo tema. In un wiki locale potrebbe essere necessario riavviare il server. </para></listitem><listitem><para>Ora è possibile iniziare a modificare i file presenti nella directory dei temi. </para></listitem></orderedlist><para>La posizione della directory dei temi dipende dall'installazione del wiki (consultare <ulink url="http://research.math.uvt.ro/wiki/AiutoSuTemi/wiki/AiutoSuInstallazione#">AiutoSuInstallazione</ulink>). </para><para>Il miglior modo per modificare l'aspetto del proprio wiki è quello di partire ereditando lo stile di MoinMoin modificando solo quello che si vuole adattare alla proprie esigenze. Questo evita il problema di copiare i nuovi stili aggiunti durante lo sviluppo dei propri fogli di stile. Per fare questo, usare l'istruzione <code>@import</code> dei CSS in questo modo: </para><screen><![CDATA[@import url("/moin_static170/modern/css/common.css");
]]><![CDATA[
h1,h2,h3,h4,h5 {
    background-color: #88CCFF;
}]]></screen><para>Nella prima riga viene importato lo stile predefinito come distribuito da MoinMoin. Potrebbe essere necessario modificare l'URL in base alla configurazione della versione MoinMoin. </para><para>Nella riga successiva viene semplicemente modificato il colore dei titoli. </para><para>Per maggiori informazioni consultare il wiki <ulink url="http://css-discuss.incutio.com/">css-discuss</ulink>. </para><para>Per vedere come rendere i CSS <emphasis>wiki-modificabili</emphasis>, consultare <ulink url="http://research.math.uvt.ro/wiki/AiutoSuTemi/wiki/ESW%3Aplain.css#">ESW:plain.css</ulink>. </para></section><section><title>Modificare la configurazione del wiki</title><informaltable><tgroup cols="3"><colspec colname="col_0"/><colspec colname="col_1"/><colspec colname="col_2"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para> page_footer1 </para></entry><entry colsep="1" rowsep="1"><para> <code>&quot;&quot;</code> </para></entry><entry colsep="1" rowsep="1"><para> Codice HTML inviato <emphasis>prima</emphasis> del footer di sistema. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> page_footer2 </para></entry><entry colsep="1" rowsep="1"><para> <code>&quot;&quot;</code> </para></entry><entry colsep="1" rowsep="1"><para> Codice HTML inviato <emphasis>prima</emphasis> del footer di sistema. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> page_header1 </para></entry><entry colsep="1" rowsep="1"><para> <code>&quot;&quot;</code> </para></entry><entry colsep="1" rowsep="1"><para> Codice HTML inviato <emphasis>prima</emphasis> dell'header / title di sistema ma <emphasis>dopo</emphasis> il tag body. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> page_header2 </para></entry><entry colsep="1" rowsep="1"><para> <code>&quot;&quot;</code> </para></entry><entry colsep="1" rowsep="1"><para> Codice HTML inviato <emphasis>dopo</emphasis> l'header / title di sistema e del tag body. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> stylesheets </para></entry><entry colsep="1" rowsep="1"><para> <code>[(media, csshref), ...]</code> </para></entry><entry colsep="1" rowsep="1"><para> Elenco di tuple (media, csshref) da inserire dopo il CSS del tema, prima dei CSS degli utenti. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> html_head </para></entry><entry colsep="1" rowsep="1"><para> <code>&quot;&quot;</code> </para></entry><entry colsep="1" rowsep="1"><para> Tag &lt;HEAD&gt; aggiuntivi per tutte le pagine. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> html_head_posts </para></entry><entry colsep="1" rowsep="1"><para> robots: noindex,nofollow </para></entry><entry colsep="1" rowsep="1"><para> Tag &lt;HEAD&gt; aggiuntivi per le richieste POST. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> html_head_index </para></entry><entry colsep="1" rowsep="1"><para> robots: index,follow </para></entry><entry colsep="1" rowsep="1"><para> Tag &lt;HEAD&gt; aggiuntivi per alcune delle pagine indice. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> html_head_normal </para></entry><entry colsep="1" rowsep="1"><para> robots: index,nofollow </para></entry><entry colsep="1" rowsep="1"><para> Tag &lt;HEAD&gt; aggiuntivi per la maggior parte della pagine normali. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> html_head_queries </para></entry><entry colsep="1" rowsep="1"><para> robots: noindex,nofollow </para></entry><entry colsep="1" rowsep="1"><para> Tag &lt;HEAD&gt; aggiuntivi per le richieste con stringhe di interrogazione, come le azioni. </para></entry></row></tbody></tgroup></informaltable><para>È possibile personalizzare il wiki modificando la configurazione del wiki come segue: </para><orderedlist numeration="arabic"><listitem><para>head </para><itemizedlist><listitem><para>config.html_head viene aggiunto nell'elemento &lt;head&gt; di <emphasis role="strong">tutte</emphasis> le pagine, mentre </para></listitem></itemizedlist></listitem><listitem><para>body </para><itemizedlist><listitem><para>è possibile usare alcuni frammenti di HTML per personalizzare l'output di moin (alcuni temi potrebbero essere diversi da quello <emphasis>classic</emphasis>). Questa è la sequenza di come viene dato l'output: </para></listitem><listitem><para>header: </para><itemizedlist><listitem><para>config.page_header1 </para></listitem><listitem><para>config.logo_string - usare questo per modificare il logo (tipicamente in alto a sinistra) </para></listitem><listitem><para>username, title </para></listitem><listitem><para>iconbar </para></listitem><listitem><para>config.navi_bar - è un elenco di nomi di pagine aggiunte nell'area <emphasis>title</emphasis>, se <code>None</code> non aggiunge nulla </para></listitem><listitem><para>trail </para></listitem><listitem><para>config.page_header2 </para></listitem><listitem><para>msg </para></listitem></itemizedlist></listitem><listitem><para>pagina wiki </para></listitem><listitem><para>footer: </para><itemizedlist><listitem><para>config.page_credits </para></listitem><listitem><para>config.page_footer1 </para></listitem><listitem><para>EditText, search forms, actions </para></listitem><listitem><para>config.page_footer2 </para></listitem></itemizedlist></listitem></itemizedlist></listitem><listitem><para>Come utente wiki, è possibile escludere le impostazioni CSS del tema usando un URL con un CSS personalizzato all'interno delle proprie preferenze. Questo CSS viene caricato dopo i CSS del tema. Il file deve essere codificato in UTF-8 (anche ASCII va bene, dato che è un sottoinsieme di UTF-8). </para></listitem></orderedlist><para><code>page_header1</code>, <code>page_header2</code>, <code>page_footer1</code> e <code>page_footer2</code> sono ora &quot;chiamabili&quot; e vengono chiamati con unico argomento l'oggetto &quot;request&quot; (è necessario accettare qualsiasi argomento per essere compatibili con le versioni future). </para></section><section><title>Creare un nuovo tema</title><para>È possibile creare un nuovo tema. Il modo migliore per iniziare è quello di copiare un tema esistente come <emphasis>modern</emphasis>. Sarà necessario rinominare lo script del tema e modificare la variabile <code>name</code> all'interno dello script. Se si conosce il linguaggio di programmazione Python è anche possibile scrivere una nuova interfaccia scrivendo un nuovo script per il proprio tema. Con gli aggiornamenti di MoinMoin i temi personali non sono toccati, funzioneranno anche con le nuove versioni, ci sarà solo da fare qualche piccola modifica dovuta al cambiamento delle API (per maggiori informazioni consultare MoinMoin:MoinDev/ThemeDevelopment). </para></section></article>