summaryrefslogtreecommitdiffstats
path: root/tde-i18n-it/docs/kdenetwork/kopete/chatstyle.docbook
diff options
context:
space:
mode:
Diffstat (limited to 'tde-i18n-it/docs/kdenetwork/kopete/chatstyle.docbook')
-rw-r--r--tde-i18n-it/docs/kdenetwork/kopete/chatstyle.docbook668
1 files changed, 668 insertions, 0 deletions
diff --git a/tde-i18n-it/docs/kdenetwork/kopete/chatstyle.docbook b/tde-i18n-it/docs/kdenetwork/kopete/chatstyle.docbook
new file mode 100644
index 00000000000..a42837f2f63
--- /dev/null
+++ b/tde-i18n-it/docs/kdenetwork/kopete/chatstyle.docbook
@@ -0,0 +1,668 @@
+<!-- Copyright (c) 2005 by Michaël Larouche <michael.larouche@kdemail.net
+> -->
+<!-- Licensed under the GNU Free Documentation License -->
+
+<appendix id="chatwindowstyleguide">
+<title
+>Guida per gli stili per la finestra di chat di &kopete;</title>
+<sect1 id="chatstyle-reference">
+<title
+>Guida di riferimento per gli stili della finestra di chat di &kopete;.</title>
+<para
+>A partire da &kopete; 0.12, ora usiamo il formato di <ulink url="http://www.adiumx.com/"
+>Adium</ulink
+> per gli stili delle finestre di conversazione. Il formato del tema è basato su modelli <acronym
+>HTML</acronym
+> e su <acronym
+>CSS</acronym
+>. Sono più facili da creare e sviluppare, richiedono solo la conoscenza di <acronym
+>HTML</acronym
+> e <acronym
+>CSS</acronym
+>. Inoltre gli stili possono avere delle varianti (definite con file <acronym
+>CSS</acronym
+>) che forniscono un valore aggiunto per la personalizzazione. </para>
+
+<sect2 id="chatstyle-reference-guide">
+ <title
+>Guida di riferimento.</title>
+<para
+>Il formato adium consiste di una struttura di directory, di modelli <acronym
+>HTML</acronym
+>, di file <acronym
+>CSS</acronym
+> e di parole chiave che sono sostituite ogni volta che il modello è elaborato. La conversazione finale è una pagina <acronym
+>XHTML</acronym
+> dove i messaggi sono aggiunti con operazioni <acronym
+>DOM</acronym
+>. L'elemento centrale è l'elemento div chiamato <filename
+>Chat</filename
+>. Prima e dopo l'elemento div, vengono i modelli Header e Footer. I messaggi sono figli dell'elemento div <filename
+>Chat</filename
+>. </para>
+
+<sect3 id="chatstyle-refrerence-directory">
+ <title
+>Struttura della directory</title>
+<para
+>Uno stile deve rispettare questa struttura di directory. Il codice di &kopete; è pensato attorno ad essa. Quando archivi lo stile, archivia la directory <filename
+>styleName</filename
+>. La struttura della directory è la struttura di un <quote
+>bundle</quote
+> di <application
+>Mac OS X</application
+>, per chi ha familiarità con tale sistema operativo. Inoltre è importante rispettare le maiuscole qui, perché i sistemi <acronym
+>UNIX</acronym
+> fanno distinzione.</para>
+<programlisting
+>styleName\ (può avere un suffisso .adiumMessageStyle, perché in Mac OS X è un bundle)
+ Contents\
+ Info.plist
+ Resources\
+ main.css
+ Header.html
+ Footer.html
+ Status.html
+ Incoming\ (and Outgoing\)
+ Content.html
+ NextContent.html (for consecutive messages)
+ Context.html (for message history)
+ NextContext.html
+ Action.html
+ Variants\
+ *.css
+</programlisting>
+</sect3>
+
+<sect3 id="chatstyle-reference-divinsert">
+ <title
+>Informazioni su &lt;div id="insert"&gt;&lt;/div&gt;</title>
+ <para
+>Questo è un elemento div speciale usato internamente. È un segnaposto che indica dove inserire il prossimo messaggio. Se è un nuovo messaggio, è rimosso e lo sostituisce il messaggio nuovo. Ma se è un messaggio consecutivo dello stesso utente, l'elemento div è sostituito con il contenuto del nuovo messaggio. Questo elemento div speciale è <emphasis
+>obbligatorio</emphasis
+> nei modelli Content, Context, NextContent, NextContext. Però non fa male nemmeno nei modelli Action e Status. </para>
+</sect3>
+
+<sect3 id="chatstyle-reference-templates">
+ <title
+>Modelli di HTML.</title>
+
+<variablelist
+><title
+>Descrizione del modello.</title>
+
+<varlistentry
+><term
+><filename
+>Header.html</filename
+> (Obbligatorio)</term>
+<listitem>
+<para
+>Usa il modello Header per mostrare una bella intestazione nella conversazione. Questo modello è inserito prima dell'elemento div <filename
+>Chat</filename
+>. Se non lo usi, puoi metterci un file vuoto. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>Footer.html</filename
+> (Obbligatorio)</term>
+<listitem>
+<para
+>È quasi lo stesso di Header, ma è messo in calce alla conversazione. Questo modello è inserito dopo l'elemento div <filename
+>Chat</filename
+>. Se non lo usi, puoi metterci un file vuoto. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>Status.html</filename
+> (Obbligatorio)</term>
+<listitem>
+<para
+>Questo modello è usato per mostrare un messaggio interno. I messaggi interni sono i cambi di stato e i messaggi da Kopete (ad esempio, l'arrivo di un trasferimento di file). Quando lo stile non fornisce un modello Action, è usato anche per i messaggi di azione. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>Incoming/Content.html</filename
+></term>
+ <term
+><filename
+>Outgoing/Content.html</filename
+> (Obbligatorio)</term>
+<listitem>
+<para
+>Il modello Content è il nocciolo del messaggio. Pensalo come un blocco che fa da supporto ai messaggi. Assicurati che sia pronto ad accettare messaggi consecutivi, non progettarlo per mostrare un solo messaggio. I messaggi consecutivi saranno inseriti all'elemento div di inserimento. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>Incoming/NextContent.html</filename
+></term>
+ <term
+><filename
+>Outgoing/NextContent.html</filename
+> (Obbligatorio)</term>
+<listitem>
+<para
+>Il modello NextContent è un frammento di messaggio per messaggi consecutivi. Sarà inserito nel blocco del messaggio principale. Il modello HTML dovrebbe contenere il minimo indispensabile per mostrare il messaggio. </para>
+</listitem>
+</varlistentry>
+
+
+<varlistentry
+><term
+><filename
+>Incoming/Action.html</filename
+></term>
+ <term
+><filename
+>Outgoing/Action.html</filename
+> (Opzionale, estensione di &kopete;)</term>
+<listitem>
+<para
+>Questo modello è un'estensione di &kopete; al formato Adium. È disponibile per le direzioni Incoming e Outgoing. I messaggi di azione sono messaggi speciali che dicono che noi stiamo facendo un'azione. Ad esempio <quote
+>/me sta installando &kopete;</quote
+> potrebbe essere mostrato come <quote
+>DarkShock sta installando &kopete;</quote
+>. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>Incoming/Context.html</filename
+></term>
+ <term
+><filename
+>Incoming/NextContext.html</filename
+></term>
+ <term
+><filename
+>Outgoing/Context.html</filename
+></term>
+ <term
+><filename
+>Outgoing/NextContext.html</filename
+> (Opzionale)</term>
+<listitem>
+<para
+>Questi modelli non sono usati da Kopete. In Adium, sono usati per mostrare la cronologia. Sono quasi identici a Content e NextContent, ma con qualche differenza per distinguerli dai messaggi normali. </para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect3>
+
+<sect3 id="chatstyle-reference-css">
+ <title
+>Informazioni sugli stili CSS e le varianti</title>
+ <para
+>Dei modelli HTML sono usati per descrivere com'è fatta la struttura. Ma tutto lo stile è descritto in file <acronym
+>CSS</acronym
+>. <filename
+>main.css</filename
+> è lo stile principale, dove le varianti sono solo alterazioni dello stile principale. Esempi di varianti sono colori diversi, assenza della visualizzazione della foto dell'utente. Sia <filename
+>main.css</filename
+> che le varianti sono importate nella pagina <acronym
+>XHTML</acronym
+> finale.</para>
+ <sect4 id="chatstyle-reference-css-main">
+ <title
+>-<filename
+>main.css</filename
+></title>
+ <para
+>Questo è il file <acronym
+>CSS</acronym
+> principale che è comune a tutte le varianti. Questo file deve contenere tutte le descrizioni principali dello stile.</para>
+ </sect4>
+ <sect4 id="chatstyle-refrence-css-variants">
+ <title
+>-Varianti</title>
+ <para
+>Le varianti sono file <acronym
+>CSS</acronym
+> presenti nella cartella <filename
+>Variants</filename
+>. Ciascuna variante è un singolo file <acronym
+>CSS</acronym
+> che include <filename
+>main.css</filename
+> ed esegue alterazioni dello stile principale.</para>
+ </sect4>
+</sect3>
+
+<sect3 id="chatstyle-reference-debug">
+ <title
+>Debug degli stili</title>
+ <para
+>Ecco un paio di consigli per verificare il funzionamento di uno stile durante la sua creazione.</para>
+ <sect4 id="chatstyle-reference-debug-save">
+ <title
+>-Salvare una conversazione di esempio.</title>
+ <para
+>Nelle finestre di conversazione puoi <action
+>salvare</action
+> una conversazione. Questa è una copia della pagina XHTML interna che è visualizzata. Usala in <application
+>Konqueror</application
+> per provare i file <acronym
+>CSS</acronym
+>.</para>
+ </sect4>
+ <sect4 id="chatstyle-reference-debug-disable-cache">
+ <title
+>-Disabilitare la cache dello stile.</title>
+ <para
+>Una piccola variabile di configurazione esiste per disabilitare ela cache dello stile. Quando è abilitata, ricarica il modello HTML ogni volta che viene chiesto uno stile. Aggiungi la riga seguente al file <filename
+>kopeterc</filename
+>. È utilissimo per provare uno stile in &kopete;</para>
+ <programlisting
+>[KopeteStyleDebug]
+disableStyleCache=true
+</programlisting>
+ </sect4>
+</sect3>
+
+</sect2>
+
+<sect2 id="chatstyle-reference-keywords">
+ <title
+>Guida di riferimento delle parole chiave</title>
+ <para
+>Le parole chiave sono come buchi da riempire con i dettagli. In ciascun messaggio, sono sostituite dal valore corretto corrispondente al loro contenuto. Per gestire completamente tutte le funzioni di &kopete;, abbiamo aggiunto qualche estensione alle parole chiave di Adium. Inoltre alcune parole chiave sono disponibili solo in certi contesti.</para>
+
+<variablelist
+><title
+>Elenco di parole chiave per i modelli Header e Footer. </title>
+<para
+>Queste parole chiave sono valutate all'inizio di una conversazione.</para>
+<varlistentry
+><term
+><filename
+>%chatName%</filename
+></term>
+<listitem>
+<para
+>Questo è il nome della sessione di conversazione corrente. Per una sessione tipica, mostra il nome del contatto ed il suo stato. Per <acronym
+>IRC</acronym
+>, mostra l'argomento del canale. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>%sourceName%</filename
+></term>
+ <term
+><filename
+>%destinationName%</filename
+></term>
+<listitem>
+<para
+>Questi sono i nomi dei contatti della sessione di conversazione. <filename
+>%sourceName%</filename
+> è il tuo nome. <filename
+>%destinationName%</filename
+> è il nome del contatto con cui stai chiacchierando. È preferibile usare <filename
+>%chatName%</filename
+> rispetto ai precedenti, perché possono essere fonte di confusione nelle discussioni di gruppo o per IRC. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>%incomingIconPath%</filename
+></term>
+ <term
+><filename
+>%outgoingIconPath%</filename
+></term>
+<listitem>
+<para
+>Queste sono le immagini/foto/avatar dei contatti della sessione di conversazione. Incoming rappresenta la foto del contatto e Outgoing la tua. Se non ci sono foto disponibili, verrà usata l'immagine <filename
+>buddy_icon.png</filename
+> che è nella cartella <filename
+>Incoming</filename
+> o <filename
+>Outgoing</filename
+>. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>%timeOpened%</filename
+></term>
+ <term
+><filename
+>%timeOpened{X}%</filename
+></term>
+<listitem>
+<para
+>È l'ora in cui è iniziata la conversazione. <filename
+>%timeOpened%</filename
+> usa il formato predefinito per l'ora nel locale attuale. Se vuoi usare un formato specifico di tempo, usa <filename
+>%timeOpened{X}%</filename
+> dove X è una stringa contenente il formato dell'ora. I parametri dell'ora sono identici a quelli usati dalla funzione della glibc <function
+>strftime</function
+>. Usa <command
+>man strftime</command
+> per vedere l'elenco di formati disponibili. </para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+<variablelist
+><title
+>Elenco delle parole chiave per i modelli Content, NextContent, Context, NextContext e Action</title>
+<para
+>Queste parole chiave sono valutare per ogni messaggio.</para>
+
+<varlistentry
+><term
+><filename
+>%userIconPath%</filename
+></term>
+<listitem>
+<para
+>Questa è l'immagini/foto/avatar del contatto associato al messaggio. Se non ci sono foto disponibili, verrà usata l'immagine <filename
+>buddy_icon.png</filename
+> che è nella cartella <filename
+>Incoming</filename
+> o <filename
+>Outgoing</filename
+>. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>%senderScreenName%</filename
+></term>
+<listitem>
+<para
+>Questo è l'ID del contatto associato al messaggio. Esempi: me@hotmail.com, 45566576, JohnSmith. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>%sender%</filename
+></term>
+<listitem>
+<para
+>Questo è il nome del contatto associato al messaggio. Usa il nome da visualizzare del metacontatto come fonte. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>%service%</filename
+></term>
+<listitem>
+<para
+>Mostra il nome del servizio associato al messaggio. Esempi: Jabber, Yahoo, MSN. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>%textbackgroundcolor{X}%</filename
+></term>
+<listitem>
+<para
+>In &kopete;, questa parola chiave può essere usata per rappresentare il colore per evidenziare lo sfondo. Ignora il parametro fra parentesi graffe ed usalo solo come <filename
+>%textbackgroundcolor{}</filename
+>. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>%senderStatusIcon%</filename
+> (estensione di &kopete;)</term>
+<listitem>
+<para
+>Mostra l'icona di stato del contatto associato al messaggio. È il percorso di un file. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>%senderColor%</filename
+></term
+> <term
+><filename
+>%senderColor{N}%</filename
+> (estensione di &kopete;)</term>
+<listitem>
+<para
+>Genera un colore partendo dall'ID del contatto del mittente. Può essere usato per mostrare un colore diverso per il nick del contatto. </para>
+<para
+><filename
+>%senderColor{N}%</filename
+> dove N è un numero positivo. Se N è più grande di 100, rappresenta un colore più chiaro del colore del contatto. Se vale 150, indica un colore del 50% più chiaro. Se vale meno di 100 è un colore più scuro. È utile per avere uno sfondo colorato in modo diverso per ciascun contatto. </para>
+<para
+>Se vuoi usare questi colori in una variante, ma non nello stile principale, devi ricorrere ad un trucco. <programlisting>
+<![CDATA[
+<div style="color:%senderColor%;border:none;border-color:%senderColor{40}%;"
+><p class="message"
+>...</p
+></div>
+]]>
+</programlisting
+> puoi applicare il colore dell'elemento p.message nel file<filename
+>main.css</filename
+>, e nella variante inserire qualcosa come <programlisting
+>p.message { color:inherit; border-color:inherit; }
+</programlisting>
+
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+<variablelist
+><title
+>Elenco di parole chiave comune per i messaggi e per Status.html</title>
+
+<varlistentry
+><term
+><filename
+>%message%</filename
+></term>
+<listitem>
+<para
+>Il messaggio stesso. È un frammento di HTML. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>%time%</filename
+></term>
+ <term
+><filename
+>%time{X}%</filename
+></term>
+<listitem>
+<para
+>L'ora in cui è stato ricevuto il messaggio. <filename
+>%time%</filename
+> usa il formato orario predefinito per il locale attuale. Se vuoi usare un formato orario specifico, usa <filename
+>%time{X}%</filename
+> dove X è una stringa contenente il formato orario. I parametri del formato sono gli stessi della funzione <function
+>strftime</function
+> della glibc. Usa <command
+>man strftime</command
+> per vedere la lista dei parametri disponibili. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry
+><term
+><filename
+>%messageDirection%</filename
+> (Estensione di &kopete;)</term>
+<listitem>
+<para
+>Rappresenta la direzione del messaggio, se il messaggio deve essere mostrato da destra a sinistra (come per l'arabo) o da sinistra a destra. Vedi <link linkend="chatstyle-guideline-direction"
+>Linee guida per la direzione dei messaggi</link
+> per scoprire come usare in modo appropriato questa parola chiave. </para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+</sect1>
+
+<sect1 id="chatstyle-guideline">
+ <title
+>Linee guida per gli stili della finestra di chat di &kopete;</title>
+<para
+>Le linee guida per gli stili della finestra di conversazione di &kopete; è una raccolta delle cose che lo stile della finestra di conversazione deve supportare per essere compatibile con Kopete.</para>
+<sect2 id="chatstyle-guideline-highlight">
+ <title
+>Gestione dell'evidenziazione</title>
+ <para
+>Il tuo stile deve mostrare delle evidenziazioni, a volte. In Kopete e Adium, <filename
+>%textbackgroundcolor{}%</filename
+> è sostituito con il colore di evidenziazione. Aggiungi questo attributo di stile: <userinput
+>background-color: %textbackgroundcolor{}%</userinput
+> all'elemento HTML che mostra il messaggio.</para>
+</sect2>
+<sect2 id="chatstyle-guideline-consecutive">
+ <title
+>Un modello per i messaggi consecutivi ora è obbligatorio.</title>
+ <para
+>Queste linee guida sono per chi deve riscrivere dei vecchi stili XSL nel nuovo formato. Tutti gli stili devono fornire un modello per i messaggi consecutivi. Ora è una funzione predefinita.</para>
+</sect2>
+
+<sect2 id="chatstyle-guideline-encoding">
+ <title
+>Usa la codifica <acronym
+>UTF-8</acronym
+>.</title>
+ <para
+>Il titolo dice tutto. Devi salvare i file in <acronym
+>UTF-8</acronym
+>.</para>
+</sect2>
+
+<sect2 id="chatstyle-guideline-info">
+ <title
+>Fornisci il file <filename
+>Contents/Info.plist</filename
+> per mantenere l'interoperabilità con <application
+>Adium</application
+></title>
+ <para
+>Il file <filename
+>Contents/Info.plist</filename
+> non è ancora usato da Kopete. Ma se vuoi creare uno stile compatibile con <application
+>Adium</application
+>, devi fornire anche questo file. Ecco un esempio base del file. Le stringhe da sostituire sono racchiuse fra <quote
+>$</quote
+>.</para>
+<programlisting
+><![CDATA[
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+ <key
+>CFBundleDevelopmentRegion</key>
+ <string
+>English</string>
+ <key
+>CFBundleGetInfoString</key>
+ <string
+>$Il nome completo dello stile$</string>
+ <key
+>CFBundleIdentifier</key>
+ <string
+>$L'ID dello stile nella forma: com.adiumx.smooth.operator.style$</string>
+ <key
+>CFBundleInfoDictionaryVersion</key>
+ <string
+>1.0</string>
+ <key
+>CFBundleName</key>
+ <string
+>$Il nome dello stile$</string>
+ <key
+>CFBundlePackageType</key>
+ <string
+>AdIM</string>
+ <key
+>MessageViewVersion</key>
+ <integer
+>3</integer>
+</dict>
+</plist>
+]]>
+</programlisting>
+
+</sect2>
+
+<sect2 id="chatstyle-guideline-buddyicon">
+ <title
+>Fornisci il file <filename
+>buddy_icon.png</filename
+></title>
+ <para
+>Devi mettere un file di nome <filename
+>buddy_icon.png</filename
+> in <filename
+>Incoming</filename
+> e <filename
+>Outgoing</filename
+>. Queste immagini saranno usate quando il contatto non ha una foto.</para>
+</sect2>
+
+<sect2 id="chatstyle-guideline-direction">
+ <title
+>La parola chiave <filename
+>%messageDirection%</filename
+> permette la gestione delle lingue scritte da destra a sinistra.</title>
+ <para
+>La parola chiave <filename
+>%messageDirection%</filename
+> è presente per le lingue del mondo che scrivono da destra a sinistra. Definisce la direzione del messaggio, se è <quote
+>rtl</quote
+> (<emphasis
+>right-to-left</emphasis
+>, da destra a sinistra) o <quote
+>ltr</quote
+> (<emphasis
+>left-to-right</emphasis
+>, da sinistra a destra). Aggiungi questo attributo di stile all'elemento HTML che mostra il messaggio: <userinput
+>direction: %messageDirection%</userinput
+>. L'anteprima dello stile nella configurazione dell'aspetto include un controllo per il testo scritto da destra a sinistra per vedere se lo stile viene mostrato correttamente. Dovrebbe far cominciare la stringa dalla destra.</para>
+</sect2>
+</sect1>
+</appendix>