<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kile "<application
>Kile</application
>">
  <!ENTITY latex "L<superscript
>A</superscript
>T<subscript
>E</subscript
>X">
  <!ENTITY tex "T<subscript
>E</subscript
>X">
  <!ENTITY tetex "<application
>teT<subscript
>E</subscript
>X</application
>">
  <!ENTITY bibtex "BibT<subscript
>E</subscript
>X">
  <!ENTITY gnuplot "<application
>GnuPlot</application
>">
  <!ENTITY kde "<acronym
>KDE</acronym
>">
  <!ENTITY kdvi "<application
>KDVI</application
>">
  <!ENTITY kappname "&kile;">
  <!ENTITY package "kdeextragear-2">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>

<book lang="&language;">

<bookinfo>
<title
>Il Manuale di &kile;</title>

<authorgroup>
	<author
><firstname
>Jonathan</firstname
><surname
>Pechta</surname
> <affiliation
> <address
><email
>jrpechta@yahoo.com</email
></address>
		</affiliation>
	</author>
	<author
><firstname
>Federico</firstname
><surname
>Zenith</surname
> <affiliation
> <address
><email
>zenith@chemeng.ntnu.no</email
></address>
	</affiliation>
	</author>
	<othercredit role="developer"
><firstname
>Jeroen</firstname
><surname
>Wijnhout</surname
> <affiliation
> <address
><email
>Jeroen.Wijnhout@kdemail.net</email
></address>
		</affiliation>
	</othercredit>
</authorgroup>

<othercredit role="translator"
><firstname
>Federico</firstname
> <surname
>Zenith</surname
><affiliation
><address
> <email
>zenith@chemeng.ntnu.no</email
></address
></affiliation
> <contrib
>Traduzione della documentazione in italiano</contrib
></othercredit
> 

<copyright>
<year
>2003</year>
<holder
>Jonathan Pechta</holder>
</copyright>

<copyright>
<year
>2003</year>
<holder
>Federico Zenith</holder>
</copyright>

<date
>2003-11-29</date>
<releaseinfo
>1.6</releaseinfo>

<legalnotice>
&FDLNotice;
</legalnotice>

<abstract>
<para
>&kile; è un editor di sorgenti &latex;, shell &tex; e interfaccia &gnuplot;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdenonbeta</keyword>
<keyword
>Kile</keyword>
<keyword
>LaTeX</keyword>
<keyword
>TeX</keyword>
</keywordset>

</bookinfo>

<chapter id="preface">

<title
>Prefazione</title>

	<sect1 id="preface_sect">

		<title
></title>

		<sect2>

			<title
>Requisiti</title>

			<para
>Per eseguire &kile;, ti sarà necessario avere i seguenti componenti installati sulla tua distribuzione Linux: </para>

			<itemizedlist>
				<listitem
><para
><ulink url="http://www.kde.org/"
>Ambiente desktop &kde;</ulink
>: &kde; è un popolare ambiente desktop open source.</para
></listitem>
				<listitem
><para
><ulink url="http://www.trolltech.com/products/qt/"
>Qt</ulink
>: Qt è uno strumento di sviluppo in C++ necessario per compilare &kile;.</para
></listitem>
				<listitem
><para
><ulink url="http://www.ctan.org/"
>&latex;</ulink
>: programma tipografico di alta qualità. Quasi sicuramente avrai (o vorrai) il pacchetto &tetex;, visto che sei su un sistema di tipo Unix.</para
></listitem>
			</itemizedlist>

			<para
>Pacchetto raccomandato:</para>

			<itemizedlist>
				<listitem
><para
><ulink url="http://devel-home.kde.org/~kdvi/"
>&kdvi;</ulink
>: anteprima DVI per &kde;.</para
></listitem>
			</itemizedlist>

			<para
>Alcuni di questi elementi potrebbere essere inclusi nella tua distribuzione Linux; per piacere riferisciti alla documentazione della tua distribuzione, o riferisciti al tuo CD o DVD di installazione per aggiungere questi pacchetti sul tuo sistema.</para>

			<para
>Il progetto &kile; include diversi pacchetti di &kile; che possono essere facilmente installati e avviati senza bisogno di compilazione; controlla la <ulink url="http://kile.sourceforge.net/"
>homepage di &kile;</ulink
>.</para>

			<para
>Requisiti di sistema suggeriti:</para>

			<itemizedlist>
				<listitem
><para
><hardware
>Processore</hardware
> compatibile Pentium o più veloce</para
></listitem>
				<listitem
><para
>128MB di <hardware
>RAM</hardware
></para
></listitem>
				<listitem
><para
>Da 400 MB a 4 GB di spazio su <hardware
>disco fisso</hardware
>, a seconda del numero di programmi installati</para
></listitem>
				<listitem
><para
><hardware
>Mouse</hardware
> e <hardware
>tastiera</hardware
></para
></listitem>
			</itemizedlist>

		</sect2>

		<sect2>

			<title
>Uditorio</title>

			<para
>Questo manuale può essere usato da chiunque, indipendentemente dalla sua esperienza con &latex;, &kde;, &kile; o Linux.</para>

			<para
>Gli utenti avanzati probabilmente non leggeranno questo manuale, ma tutti i suggerimenti sono ben accetti. Se volessi contribuire a questo progetto o alla documentazione, per piacere consulta la <ulink url="http://kile.sourceforge.net/"
>pagina web di &kile;</ulink
>. I commenti sulla documentazione possono essere inviati a <email
>jrpechta@yahoo.com</email
>.</para>

			<para
>Hai bisogno di risposte su &kile;? Sei bloccato con una compilazione? Vuoi una funzione nuova? Il modo migliore di fare domande tecniche o avviare una discussione è usare la nostra mailing list: <email
>kile-devel@lists.sourceforge.net</email
>.</para>

		</sect2>

		<sect2>

			<title
>Cosa c'è di nuovo in &kile;?</title>

			<para
>La versione attuale di &kile; è 1.6. Qui ci sono alcuni dei cambiamenti più significativi e funzionalità che sono state implementate rispetto all'ultima versione di &kile; (versione 1.5).</para>

			<para
>Nuove funzionalità:</para>

			<itemizedlist>
				<listitem
><para
>Gestione di progetti</para
></listitem>
				<listitem
><para
>Un nuovo e più potente editor interno (katepart)</para
></listitem>
				<listitem
><para
>Tutti gli strumenti standard sono configurabili</para
></listitem>
				<listitem
><para
>File e progetti ripristinati all'avvio</para
></listitem>
				<listitem
><para
>Migliore evidenziazione della sintassi <itemizedlist>
						<listitem
><para
>Incorpora ambienti verbatim</para
></listitem>
						<listitem
><para
>Evidenziazione all'interno di ambienti matematici</para
></listitem>
					</itemizedlist>
				</para
></listitem>
				<listitem
><para
>Inserisci citazioni da bibliografie &bibtex; usando gBib o pyBliographer</para
></listitem>
				<listitem
><para
>Conteggio delle parole</para
></listitem>
				<listitem
><para
>Strumenti standard configurabili dall'utente</para
></listitem>
				<listitem
><para
>Etichette configurabili dall'utente</para
></listitem>
			</itemizedlist>

			<para
>Correzioni:</para>
			<para
>Correzioni minori in tutto il programma</para>

		</sect2>

		<sect2>

			<title
>Accordo di licenza</title>

			<para
>Se usi &kile;, accetti di essere vincolato dai termini dell'Accordo di Licenza Pubblica Generale GNU. I dettagli della GPL possono essere trovati su <ulink url="http://www.gnu.org/copyleft/gpl.html"
>questa pagina web</ulink
>.</para>
			<para
>Per piacere leggi <xref linkend="credits"/> per maggiori informazioni.</para>

		</sect2>

	</sect1>

</chapter>

<chapter id="introduction">

	<title
>Introduzione</title>

	<sect1 id="intro_about">

		<title
></title>

		<sect2>

			<title
>Informazioni su &kile;</title>

			<para
>&kile; è un ambiente &latex; integrato per il desktop &kde;. &kile; ti dà la possibilità di usare tutte le funzionalità di &latex; in un'interfaccia grafica, dandoti un accesso facile, immediato, e personalizzato a tutti i programmi per gli strumenti relativi a &latex; per la compilazione, il postprocessing, il debugging, la conversione e la visualizzazione; hai a disposizione anche degli assistenti molto comodi, un riferimento &latex;, interfacce con &gnuplot; e XFig, e la gestione dei progetti. </para>

		</sect2>

		<sect2>

			<title
>Cos'è &latex;</title>

			<para
>&latex; è un sistema di trattamento testi derivato da &tex;, un programma sviluppato originariamente nel 1977 per aiutare gli autori a presentare il loro lavoro professionalmente, ottenendo un lavoro simile a quello di un tipografo; il tipografo è colui che imposta l'aspetto di un documento a seconda delle specifiche del tipo di documento. &latex; è stato creato per dare agli autori un tipografo automatico, specialmente per quanto riguardava la costosa e complicata tipografia delle formule e delle espressioni matematiche, che <emphasis
>assolutamente non per caso</emphasis
> sono racchiuse da segni del dollaro in &latex;. Oggi, i programmi di trattamento testi permettono a ogni utente di essere il tipografo; ma ciò di cui tu hai bisogno è un bel documento, non uno su cui hai speso ore per renderlo bello. &latex; si fa carico di questo compito, e ti lascia pensare al documento, non alla tipografia. E, sì, <emphasis
>sarà</emphasis
> bello!</para>

		</sect2>

		<sect2>

			<title
>Come si pronuncia? Perché si scrive così strano?</title>

			<para
>C'è una buffa tradizione per la quale i pacchetti relativi a &tex; hanno la pronuncia e la grafia più strane possibile. Si suppone che &tex; sia arrivato dal greco <emphasis
>τεχ</emphasis
>, in lettere latine <emphasis
>tech</emphasis
>. Ci sono molte spiegazioni possibili sul perché, ma la più probabile è che &latex; fu originariamente concepito per i rapporti tecnici, e infatti la sua abilità principale era la scrittura facile e corretta delle formule matematiche, ai tempi un affare estremamente costoso, tedioso e frustrante.</para>
			<para
>La pronuncia dovrebbe essere come segue: <emphasis
>TE</emphasis
> come in italiano, e <emphasis
>X</emphasis
> come nel tedesco i<emphasis
>ch</emphasis
>. Se non sai come suona <emphasis
>ch</emphasis
>, è più o meno come il suono di un gatto che soffia; il simbolo IPA è /ç/. Molte persone sostengono la diversa pronuncia di <emphasis
>ach</emphasis
> (simbolo IPA /x/), ma ho personalmente chiesto a dei greci, e posso confermare la prima versione. Dovresti sapere che molti pronunciano erroneamente /teks/ o /tek/.</para>
			<para
>Infine, in &latex; la parte L<superscript
>A</superscript
> è pronunciata come l'inglese <emphasis
>lay</emphasis
> ("profano"): l'idea è che, mentre il &tex; grezzo è difficile, anche un profano può usare le macro di &latex;. Adesso lo sai!</para>

		</sect2>

	</sect1>

	<sect1 id="intro_latexbasics">

		<title
>Fondamenti di &latex;</title>

		<para
>Il sistema di tipografia di &latex; è simile ad altri linguaggi a marcatori come XML, usato per molti tipi di documenti (incluso quello che stai leggendo), o HTML, usato per le pagine web. L'idea generale è avere parole chiave impacchettate in modo particolare, dette <emphasis
>tag</emphasis
>, che dicono a un programma (un elaboratore di testi, un browser web, o il compilatore di &kile;) come presentare il testo. </para>

		<para
>Sebbene proveremo a darti una buona idea di cosa sia &latex;, questa non è La Bibbia Definitiva di &latex;. Se vuoi imparare &latex; bene, potresti prendere un libro nella tua biblioteca. L'autore ha avuto una buona esperienza con il testo A Guide to &latex;, di H. Kopka e P. W. Daly, e lo tiene ancora sullo scaffale. </para>

		<para
>Come altri linguaggi a marcatori, &latex; contiene un <emphasis
>preambolo</emphasis
>, che imposta i comandi globali, come la dimensione della carta, la numerazione delle pagine, le dimensioni del testo sulla pagina, e un <emphasis
>corpo</emphasis
>, che contiene il testo del documento; il preambolo contiene almeno il comando \documentclass, e precede il corpo, che inizia con il comando <userinput
>\begin{document}</userinput
>, ed è piuttosto prevedibilmente concluso dal comando <userinput
>\end{document}</userinput
>. </para>

	</sect1>

	<sect1 id="intro_mainfeat">

		<title
>Funzionalità principali di &kile;</title>

		<sect2 id="intro_docwizard">

			<title
>Assistente dei documenti</title>

			<para
>L'assistente integrato di &kile; è una comoda funzione per farti iniziare a creare documenti con &kile;. Scegliendo l'assistente dalla barra delle applicazioni ti verranno offerte varie scelte per la creazione del tuo documento: articolo, libro, lettera, rapporto o vuoto; puoi anche specificare subito alcune opzioni relative al documento. </para>

			<para
>Opzioni dell'assistente:</para>

			<itemizedlist>
				<listitem
><para
><guilabel
>Tipo del documento</guilabel
>: che tipo di documento stai creando? Articolo, lettera, rapporto, libro?</para
></listitem>
				<listitem
><para
><guilabel
>Dimensione caratteri</guilabel
>: che dimensione, in punti, stai usando?</para
></listitem>
				<listitem
><para
><guilabel
>Dimensione carta</guilabel
>: di quali dimensioni sarà la carta che userai per il tuo documento?</para
></listitem>
				<listitem
><para
><guilabel
>Codifica</guilabel
>: quale codifica userai per il file sorgente? Userai quasi sempre le codifiche Latin 1 o Utf-8, per poter scrivere parole come <userinput
>così</userinput
> direttamente, e non attraverso la conversione ASCII <userinput
>cos\`\i</userinput
>.</para
></listitem>
				<listitem
><para
><guilabel
>Autore</guilabel
>: metti il tuo nome qui.</para
></listitem>
				<listitem
><para
><guilabel
>Titolo</guilabel
>: aggiungi qui il titolo del tuo documento.</para
></listitem>
				<listitem
><para
><guilabel
>Altre opzioni</guilabel
>: questo ti permette di impostare altre opzioni per la stampa, le bozze, ecc.</para
></listitem>
			</itemizedlist>

		</sect2>

		<sect2 id="intro_templates">

			<title
>Modelli predefiniti</title>

			<para
>I modelli predefiniti in &kile; sono:</para>

			<itemizedlist>
				<listitem
><para
>Documento vuoto: gli uomini veri partono da zero!</para
></listitem>
				<listitem
><para
>Articolo: imposta il formato articolo, per un documento abbastanza breve da non aver bisogno di essere diviso in capitoli.</para
></listitem>
				<listitem
><para
>Rapporto: imposta il formato rapporto, per documenti di media grandezza, con per esempio la numerazione delle pagine sul margine esterno.</para
></listitem>
				<listitem
><para
>Libro: imposta il formato libro, una versione full optional, così potente da essere usata per scrivere molti testi universitari.</para
></listitem>
				<listitem
><para
>Lettera: imposta il formato lettera, che può automaticamente sistemare quelle noiose indentazioni che nessuno riesce a ricordare.</para
></listitem>
			</itemizedlist>

			<para
>I nuovi utenti non si devono preoccupare, queste sezioni sono solo una breve descrizione delle funzionalità, e maggiore attenzione sarà data al completamento nei dettagli di questi obiettivi nella sezione Avvio rapido.</para>

		</sect2>

		<sect2 id="intro_highlight">

			<title
>Evidenziazione della sintassi</title>

			<para
>&kile; è simile ai programmi che lavorano con codice sorgente, ed evidenzierà automaticamente comandi, opzioni ed elementi, usati e abusati. &kile; rende così possibile avvistare facilmente i problemi: per esempio, se vedi grosse aree di testo verde, è probabile che tu abbia dimenticato di chiudere un ambiente matematico da qualche parte; te ne saresti accorto comunque da quanto scadente sarebbe stato il file di output, ma l'evidenziazione ti risparmia un bel po' di tempo e frustrazioni.</para>

		</sect2>

		<sect2 id="intro_autocoml">

			<title
>Autocompletamento degli ambienti</title>

			<para
>Di nuovo in questa versione di &kile; c'è l'autocompletamento degli ambienti; ciò significa che quando inizi un nuovo ambiente scrivendo <userinput
>\begin{environment}</userinput
>, &kile; aggiungerà automaticamente un comando <userinput
>\end{environment}</userinput
>, con una linea in mezzo per il tuo testo. Puoi ovviamente disattivarlo, se vuoi, in <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura &kile;...</guimenuitem
><guilabel
>LaTeX</guilabel
></menuchoice
>.</para>

		</sect2>

		<sect2 id="intro_jump">

			<title
>Saltare agli elementi struttura</title>

			<para
>Tutti i documenti normalmente sono strutturati con una gerarchia di un certo tipo. &latex; ti permette di spezzare i documenti nella seguente gerarchia (part è l'elemento più alto della gerarchia, e subparagraph il più basso) </para>

			<itemizedlist>
				<listitem
><para
>\part</para
></listitem>
				<listitem
><para
>\chapter</para
></listitem>
				<listitem
><para
>\section</para
></listitem>
				<listitem
><para
>\subsection</para
></listitem>
				<listitem
><para
>\subsubsection</para
></listitem>
				<listitem
><para
>\paragraph</para
></listitem>
				<listitem
><para
>\subparagraph</para
></listitem>
			</itemizedlist>

			<para
>Quando guardi un documento nella vista struttura, puoi saltare tra gli elementi facendo clic sull'elemento che vuoi vedere.</para>

		</sect2>

		<sect2 id="intro_inverse">

			<title
>Ricerca all'indietro</title>

			<para
>Quando crei i tuoi file &latex;, la ricerca all'indietro può essere molto utile. Una volta che hai creato un file DVI (DeVice Independent File, file indipendente dal dispositivo), quando fai clic con il bottone centrale del mouse nel visualizzatore DVI, &kile; salterà alla linea corrispondente nel codice sorgente &latex;.</para>

			<para
>Definizione di DVI: un DVI è un tipo di file contenente una descrizione di un documento formattato, insieme ad altre informazioni, incluso il tipo di carattere, ed è l'output tipico di &tex;/&latex;. Esiste un certo numero di programmi per visualizzare e stampare file DVI su vari sistemi e dispositivi. Un file DVI è a volte anche noto come metafile.</para>

		</sect2>

		<sect2 id="intro_forward">

			<title
>Ricerca in avanti</title>

			<para
>Usando la ricerca all'indietro, la selezione di elementi nei file DVI è associata all'editor, così quando fai clic sul file DVI, la finestra principale salta alla sezione corrispondente di codice &latex; nell'editor. La ricerca in avanti ne è l'esatto opposto. La ricerca in avanti ti permetterà di fare clic su una sezione di testo specifica nel codice &latex;, e saltare alla posizione associata nella finestra del visualizzatore DVI.</para>

		</sect2>

	</sect1>

	<sect1 id="intro_toolbar">

		<title
>La barra degli strumenti: una guida di riferimento alle funzioni</title>

		<itemizedlist>
			<listitem
><para
><guibutton
>Nuovo</guibutton
>: inizia un nuovo documento.</para
></listitem>
			<listitem
><para
><guibutton
>Apri</guibutton
>: apri un nuovo documento.</para
></listitem>
			<listitem
><para
><guibutton
>Chiudi</guibutton
>: chiudi il tuo documento.</para
></listitem>
			<listitem
><para
><guibutton
>Definisci il documento come 'documento principale'</guibutton
>: questo si usa lavorando con file multipli. Avere un documento principale ti permetterà di includere altri file .tex nel tuo documento.</para
></listitem>
			<listitem
><para
><guibutton
>Costruzione rapida</guibutton
>: compila il tuo codice sorgente &latex; e mostrane i risultati automaticamente, a meno di avere errori nel codice.</para
></listitem>
			<listitem
><para
><guibutton
>Sorveglia file</guibutton
>: questa modalità "sorveglierà" eventuali cambiamenti del file DVI, e lo aggiornerà automaticamente senza dover riavviare &kdvi;</para
></listitem>
			<listitem
><para
><guibutton
>Visualizza file di log</guibutton
>: visualizza il file .log, in modo da poter vedere gli errori.</para
></listitem>
			<listitem
><para
><guibutton
>Errore precedente</guibutton
>: salta all'indietro nel file .log e evidenzia gli errori nel sorgente.</para
></listitem>
			<listitem
><para
><guibutton
>Errore successivo</guibutton
>: salta in avanti nel file .log e evidenzia gli errori nel sorgente.</para
></listitem>
			<listitem
><para
><guibutton
>Ferma</guibutton
>: ferma la funzione attuale.</para
></listitem>
			<listitem
><para
><guibutton
>LaTeX</guibutton
>: esegui &latex; sul documento attivo.</para
></listitem>
			<listitem
><para
><guibutton
>Visualizza DVI</guibutton
>: avvia il visualizzatore DVI.</para
></listitem>
			<listitem
><para
><guibutton
>Da DVI a PS</guibutton
>: converte un file DVI in un PostScript (PS).</para
></listitem>
			<listitem
><para
><guibutton
>Visualizza PS</guibutton
>: avvia il visualizzatore PostScript (PS).</para
></listitem>
			<listitem
><para
><guibutton
>PDFLaTeX</guibutton
>: crea un PDF dal sorgente &latex;, se hai un'intestazione &latex;.</para
></listitem>
			<listitem
><para
><guibutton
>Visualizza PDF</guibutton
>: visualizza il file PDF.</para
></listitem>
			<listitem
><para
><guibutton
>Da DVI a PDF</guibutton
>: converte un DVI in un PDF.</para
></listitem>
			<listitem
><para
><guibutton
>Da PS a PDF</guibutton
>: converte un PS in un PDF.</para
></listitem>
			<listitem
><para
><guibutton
>Da LaTeX a HTML</guibutton
>: crea codice HTML da sorgente &latex;.</para
></listitem>
			<listitem
><para
><guibutton
>Visualizza HTML</guibutton
>: visualizza l'HTML creato.</para
></listitem>
			<listitem
><para
><guibutton
>Ricerca &kdvi; in avanti</guibutton
>: salta alla pagina che corrisponde alla linea attuale nell'editor.</para
></listitem>
		</itemizedlist>

		<para
>Se guardi la barra degli strumenti Modifica, noterai tre grandi menu a cascata. I menu a cascata sono stati progettati per farti rapidamente aggiungere funzionalità nel tuo documento. Il primo menu a cascata è usato per dividere rapidamente il tuo documento in parti, capitoli, sezioni, ecc.; i comandi disponibili per aggiungere elementi di segmentazione al tuo codice sorgente &latex; sono:</para>

		<itemizedlist>
			<listitem
><para
><guilabel
>part</guilabel
>: Livello massimo di sezionamento per un documento.</para
></listitem>
			<listitem
><para
><guilabel
>chapter</guilabel
>: Inizia un nuovo capitolo.</para
></listitem>
			<listitem
><para
><guilabel
>section</guilabel
>: Crea una nuova sezione.</para
></listitem>
			<listitem
><para
><guilabel
>subsection</guilabel
>: Crea una nuova sottosezione.</para
></listitem>
			<listitem
><para
><guilabel
>subsubsection</guilabel
>: Una sezione secondaria tra sottosezione e paragrafo.</para
></listitem>
			<listitem
><para
><guilabel
>paragraph</guilabel
>: Crea un nuovo paragrafo.</para
></listitem>
			<listitem
><para
><guilabel
>subparagraph</guilabel
>: Crea un nuovo sottoparagrafo.</para
></listitem>
		</itemizedlist>

		<para
>Il menu a cascata chiamato <guilabel
>label</guilabel
> è usato per inserire nel tuo documento elementi come indici, note a pie' di pagina, referenze. I comandi disponibili per aggiungere elementi al tuo codice sorgente &latex; sono: </para>

		<itemizedlist>
			<listitem
><para
><guilabel
>label</guilabel
>: Comando che produce un un'etichetta per un livello.</para
></listitem>
			<listitem
><para
><guilabel
>index</guilabel
>: Crea una voce per l'indice con suffisso file .idx.</para
></listitem>
			<listitem
><para
><guilabel
>footnote</guilabel
>: Crea una nota a pie' di pagina nel tuo documento.</para
></listitem>
			<listitem
><para
><guilabel
>ref</guilabel
>: Usato per riferirsi a un'etichetta già definita, che scegli da una lista a cascata.</para
></listitem>
			<listitem
><para
><guilabel
>pageref</guilabel
>: Crea un numero di pagina nel tuo documento che corrisponda a un'etichetta.</para
></listitem>
			<listitem
><para
><guilabel
>cite</guilabel
>: Crea una citazione da una bibliografia nel tuo documento.</para
></listitem>
		</itemizedlist>

		<screenshot>
			<screeninfo
>Il menu a cascata label</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_ref_choose.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Il menu a cascata label</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<screenshot>
			<screeninfo
>Selezione dell'etichetta di una referenza</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_ref_select.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Selezione dell'etichetta di una referenza</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<para
>Usando <guilabel
>cite</guilabel
>, ti viene presentata una lista a cascata di bibitem, ma se stai usando &bibtex; questo sistema non funzionerà. Puoi in questo caso usare gBib o pyBliographer, o farlo a mano.</para>

		<para
>L'ultimo menu a cascata, etichettato <guilabel
>tiny</guilabel
>, è usato per impostare la dimensione del tuo testo. Hai la possibilità di impostare la dimensioni di testo, note a pie' di pagina, ecc.; i comandi disponibili per aggiungere una dimensione di testo al tuo codice sorgente &latex; sono:</para>

		<itemizedlist>
			<listitem
><para
><guilabel
>tiny</guilabel
>: piccolissimo</para
></listitem>
			<listitem
><para
><guilabel
>scriptsize</guilabel
>: molto piccolo</para
></listitem>
			<listitem
><para
><guilabel
>footnotesize</guilabel
>: più piccolo</para
></listitem>
			<listitem
><para
><guilabel
>small</guilabel
>: piccolo</para
></listitem>
			<listitem
><para
><guilabel
>normalsize</guilabel
>: normale</para
></listitem>
			<listitem
><para
><guilabel
>large</guilabel
>: grande</para
></listitem>
			<listitem
><para
><guilabel
>Large</guilabel
>: più grande</para
></listitem>
			<listitem
><para
><guilabel
>LARGE</guilabel
>: ancora più grande</para
></listitem>
			<listitem
><para
><guilabel
>huge</guilabel
>: molto grande</para
></listitem>
			<listitem
><para
><guilabel
>Huge</guilabel
>: grandissimo</para
></listitem>
		</itemizedlist>

	</sect1>

</chapter>

<chapter id="quickstart">

	<title
>Avvio rapido</title>

	<sect1 id="quick_begin">

		<title
>Stesura di un documento &latex; con &kile; per principianti</title>

		<para
>Ogni utente di &kile; ha due scelte quando comincia un nuovo documento: può usare l'assistente per cominciare un nuovo documento, selezionando il tipo di documento che vorrebbe creare, e opzioni come la dimensione dei caratteri, della carta, ecc.; l'altra possibilità è scrivere il codice a mano.</para>

		<screen
><userinput>
                \documentclass[12pt]{article}
                \begin{document}
                Qui c'è un pacco di codice LaTeX.
                \end{document}
                </userinput
></screen>

		<para
>Ogni documento in &latex; comincia con il comando <userinput
>\documentclass{TipoDelDocumento}</userinput
>, a meno che tu stia usando una versione obsoleta di &latex;; in quel caso il comando è <userinput
>\documentstyle{TipoDelDocumento}</userinput
>. Ci sono attualmente due versioni comuni di &latex; in cui potresti incappare: la versione 2.09, che usa <userinput
>\documentstyle</userinput
>, e la versione 2<subscript
>ε</subscript
>, che usa <userinput
>\documentclass</userinput
> per cominciare un documento. Il comando <userinput
>\documentclass</userinput
> segue sempre la sintassi <userinput
>\documentclass[argomento opzionale]{classe}</userinput
>.</para>

		<para
>Inserire l'esempio di codice della casella di testo sopra ti restituirà il seguente output:</para>

		<screen
><computeroutput>
                Qui c'è un pacco di codice LaTeX.
                </computeroutput
></screen>

		<para
>Le parentesi quadre che vengono dopo il comando <userinput
>\documentclass</userinput
> denotano un'opzione per il commando. L'opzione <userinput
>[12pt]</userinput
> imposta la dimensione dei caratteri per il tuo articolo; se non imposti la dimensione dei caratteri all'inizio, la puoi impostare più avanti nel testo.</para>

		<para
>Una volta che hai inserito l'esempio di codice dalla casella sopra, dovrai compilare il tuo codice &latex;. Il modo più facile per compilare &latex; è usare il menu Costruzione, o usare il pulsante Costruzione rapida.</para>

		<para
><keycombo
><keycap
>Alt</keycap
><keycap
>2</keycap
></keycombo
> è la scorciatoia da tastiera per compilare il tuo codice sorgente.</para>

		<para
>Devi salvare il tuo codice sorgente prima di poter compilare; &kile; lo farà automaticamente per te, ma solo per il documento principale; se hai documenti figli, devi salvarli a mano.</para>

		<para
>Se il tuo documento non è stato compilato correttamente, controlla se ci sono errori nel log. Usando il pulsante Costruzione rapida, il visualizzatore &kdvi; dovrebbe essere lanciato automaticamente, sennò, controlla se ci sono errori nel log.</para>

	</sect1>

	<sect1 id="quick_env">
		<title
>Ambienti</title>

		<para
>Un ambiente è un comando che ti permette di gestire un segmento di testo diversamente dal resto del tuo documento. Per esempio, crei un rapporto con dimensione dei caratteri pari a 12, ma hai bisogno di cambiare la dimensione dei caratteri per poche frasi. I comandi <userinput
>\begin{ambiente}</userinput
>, <userinput
>\huge</userinput
> and <userinput
>\end{ambiente}</userinput
> ti permetteranno di alterare temporaneamente il testo all'interno dei comandi ambiente affinché il testo sia di dimensione molto grande.</para>

		<para
>Insomma, i cambiamenti hanno effetto da <userinput
>\begin{ambiente}</userinput
> a <userinput
>\end{ambiente}</userinput
>. Non ci sono limiti a quanti cambiamenti puoi fare all'interno di un ambiente.</para>

		<para
>Ci sono molte funzioni che puoi aggiungere al tuo documento che lo renderanno più leggibile e semplice. Puoi aggiungere al tuo documento oggetti come tipi di carattere specifici, grassetto, corsivo, sottolineato, ecc., e questi comandi si concluderanno o con un comando <userinput
>\end</userinput
>, o alla fine del tuo ambiente.</para>

		<itemizedlist>
			<listitem
><para
><userinput
>\begin{emph}</userinput
> o <userinput
>\begin{em}</userinput
>: questo comando scrive il testo in corsivo, ed è valido finché il codice non raggiunge un <userinput
>\end{em}</userinput
>, <userinput
>\end{emph}</userinput
>, o la fine dell'ambiente. Per rendere una parola in corsivo in una frase, puoi usare la sintassi: questa è la <userinput
> \em{mia}</userinput
> frase.</para
></listitem>
			<listitem
><para
><userinput
>\bfseries{Sto scrivendo questo testo all'interno delle parentesi in grassetto}</userinput
>: questo comando scrive il tuo testo in grassetto. Il comando grassetto continuerà finché non sarà trovata una graffa chiusa.</para
></listitem>
			<listitem
><para
><userinput
>\quote</userinput
>: per creare una citazione all'interno del tuo documento, inizia la tua citazione <userinput
>\begin{quote}</userinput
> e finiscila con <userinput
>\end{quote}</userinput
>.</para
></listitem>
			<listitem
><para
><userinput
>\center</userinput
>: centra il testo.</para
></listitem>
			<listitem
><para
><userinput
>\verse</userinput
>: crea un'indentazione adatta alla poesia.</para
></listitem>
			<listitem
><para
><userinput
>\itemize</userinput
>: fai una lista di oggetti.</para
></listitem>
		</itemizedlist>

	</sect1>

	<sect1 id="quick_using">

		<title
>Uso di &kile;</title>

		<para
>Adesso che ti abbiamo dato un'infarinatura su come scrivere codice usando il linguaggio &latex;, ti mostreremo come creare un documento passo-passo usando &kile;.</para>

		<procedure>
        		<step
><para
>Avvia &kile;.</para
></step>
			<step
><para
>Crea un nuovo documento, usando <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Nuovo</guimenuitem
><guilabel
>Documento vuoto</guilabel
></menuchoice
>.</para
></step>
			<step
><para
>Scegli <menuchoice
><guimenu
>Assistente</guimenu
><guimenuitem
>Avvio rapido</guimenuitem
></menuchoice
>, quindi scegli un formato, e imposta le tue preferenze nell'assistente.</para
></step>
			<step
><para
>Una volta che l'assistente avrà inserito del testo, fai un po' di personalizzazione per rendere il documento più leggibile, aggiungi almeno una citazione, un grassetto, corsivi, e un verso per vedere le differenze tra i vari comandi.</para
></step>
			<step
><para
>Salva il tuo file, e dagli il nome <filename
>intro.tex</filename
>.</para
></step>
			<step
><para
>Compila il tuo file usando <keycombo
><keycap
>Alt</keycap
> <keycap
>2</keycap
></keycombo
>, o il pulsante etichettato LaTeX.</para
></step>
			<step
><para
>Seleziona <guibutton
>Visualizza DVI</guibutton
>.</para
></step>
			<step
><para
>Controlla tutto il tuo testo nuovo.</para
></step>
			<step
><para
>Quando hai finito di guardare il documento, fai clic sul pulsante <guibutton
>Vista editor</guibutton
> per ritornare all'editor.</para
></step>
		</procedure>

		<para
>È tutto! Hai appena creato il tuo primo documento &latex;. Per poter modificare ulteriormente il file, vai a <menuchoice
><guimenu
>Visualizza</guimenu
><guimenuitem
>Vista editor</guimenuitem
></menuchoice
>, e ritornerai all'editor di codice sorgente (se stavi usando il visualizzatore integrato).</para>

		<para
>Se costruisci il tuo documento, ma non vedi testo, controlla di aver impostato il tuo visualizzatore nell'angolo in alto a sinistra dello schermo. Quando compili il sorgente, la Costruzione rapida centrerà il tuo testo nel mezzo dello schermo, ma usare &latex; per costruire e poi <guibutton
>Visualizza DVI</guibutton
> non centrerà automaticamente il tuo testo sullo schermo.</para>

		<para
>Una volta che hai creato il tuo DVI, potrai stampare il tuo documento, o cambiarlo in un file postscript o PDF, se vuoi. Sperimenta e divertiti!</para>

	</sect1>

	<sect1 id="quick_dvi">

		<title
>File DVI</title>

		<para
>DVI significa file indipendente dal dispositivo (<emphasis
>DeVice Independent</emphasis
>). Questi file sono prodotti da &tex; o &latex; per essere letti da un driver sul tuo sistema. Ci sono molti tipi diversi di output a cui si può inviare un .dvi, come una stampante, un convertitore a file postscript o PDF, o lo schermo del tuo computer.</para>

	 	<sect2 id="quick_viewdvi">

			<title
>Visualizzare un DVI</title>

			<para
>Hai già visto come visualizzare un file DVI su schermo usando il pulsante <guibutton
>Visualizza DVI</guibutton
> nella barra degli strumenti.</para>

		</sect2>

		<sect2 id="quick_printdvi">

        	<title
>Stampare un DVI</title>

			<para
>Per stampare un DVI, puoi usare lo stesso processo che hai usato per creare il tuo documento prima (vedi <xref linkend="quick_using"/>). Al passo 7, dopo aver fatto clic su <guibutton
>Visualizza DVI</guibutton
>, seleziona <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Stampa</guimenuitem
></menuchoice
> nel visualizzatore, e se hai configurato correttamente la tua stampante, il file DVI sarà stampato.</para>

		</sect2>

		<sect2 id="quick_manprint">

			<title
>Stampare un DVI manualmente</title>

			<para
>Per stampare manualmente un DVI da <application
>Konsole</application
>, usa il comando <guibutton
>Da DVI a PS</guibutton
> nella barra degli strumenti, o scrivi <userinput
>dvips intro.dvi</userinput
>. Il comando convertirà il tuo DVI in un file postscript. Una volta che il tuo file è convertito, puoi stamparlo usando la voce menu <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Stampa</guimenuitem
></menuchoice
> nel visualizzatore, o scrivendo in una console <userinput
>lpr intro.ps</userinput
>.</para>

		</sect2>

		<sect2 id="quick_exportdvi">

			<title
>Esportare un DVI</title>

			<para
>La barra degli strumenti ti dà la possibilità di esportare un DVI a diversi formati. Una volta che hai creato un DVI dal tuo codice sorgente &latex;, dovresti poterlo esportare nel formato di tua scelta usando i pulsanti della barra degli strumenti.</para>

		</sect2>

	</sect1>

	<sect1 id="quick_inverseforward">

		<title
>Ricerche in avanti e all'indietro</title>

		<sect2>

			<title
>Ricerca in avanti</title>

			<para
>Il comando Ricerca in avanti usa &kdvi; e un file esterno (i file esterni sono chiamati <emphasis
>pacchetti</emphasis
> in &latex;) chiamato <filename
>srcltx.sty</filename
>. Dovrai fare una ricerca tra i tuoi file per controllare se la tua distribuzione include <filename
>scrltx.sty</filename
>. Se è incluso, devi impostare il comando seguente nel preambolo.</para>

			<screen
><userinput>
                \documentstyle[12pt, a4paper]{book}
                \usepackage[active]{scrltx}
                \pagestyle{empty}
                \renewcommand{\baselinestretch}{2}
                \begin{document}
                \begin{verse}
                L'editor di codice sorgente \LaTeX\ &kile; per &kde; è il mio preferito.
                \em{Perché} è facile da usare!
                \end{verse}
                \end{document}
                        </userinput
></screen>

			<para
>Una volta che hai aggiunto il pacchetto <filename
>scrltx</filename
>, puoi lasciare &kdvi; aperto. La Ricerca in avanti ti permetterà di fare clic su una sezione di testo specifica nel codice &latex;, e saltare alla posizione associata nella finestra del visualizzatore DVI.</para>

		</sect2>

		<sect2>

			<title
>Ricerca all'indietro</title>

			<para
>La Ricerca all'indietro non può funzionare a meno che:</para>

			<itemizedlist>
				<listitem
><para
>La Ricerca in avanti sia attivata e funzionante.</para
></listitem>
				<listitem
><para
>Il file sorgente sia già stato compilato.</para
></listitem>
				<listitem
><para
>&kdvi; sa quale editor vorresti usare (vedi <xref linkend="quick_dviprefs"/>).</para
></listitem>
			</itemizedlist>

			<para
>Per usare la ricerca all'indietro, salva e compila il tuo sorgente &latex; e apri il visualizzatore DVI usando il pulsante Visualizzatore DVI nella barra degli strumenti.</para>

			<para
>Una volta che il visualizzatore DVI è aperto, fai clic con il pulsante centrale del tuo mouse su un segmento di testo, e dovresti essere rimandato nell'editor, alla sezione di codice sorgente su cui hai fatto clic centrale nel visualizzatore DVI.</para>

			<para
>Con questa funzionalità di &kdvi;, un clic sul pulsante centrale del mouse nel documento &DVI; farà aprire a &kile; il documento &tex; corrispondente gli farà cercare di raggiungere la linea corrispondente. Affinché questo funzioni, il documento &tex; deve essere già compilato, e la Ricerca in avanti &kdvi; deve essere in funzione.</para>

		</sect2>

		<sect2 id="quick_dviprefs">

			<title
>Preferenze e impostazioni DVI</title>

			<para
>Per rendere &kile; il tuo editor predefinito in &kdvi;, inserisci il seguente comando nell'area della linea di comando:</para>

        	<para
><computeroutput
>kile %f --line %l</computeroutput
>; l'ultima opzione è una L minuscola, non un numero 1.</para>

			<screenshot>
				<screeninfo
>Configurazione di &kdvi;...</screeninfo>
				<mediaobject>
				<imageobject>
				<imagedata fileref="snap_kdvi_settings.png" format="PNG"/>
				</imageobject>
				<textobject>
				<phrase
>Configurazione di &kdvi;...</phrase>
				</textobject>
				</mediaobject>
			</screenshot>

		</sect2>

		<sect2>

			<title
>Risoluzione degli errori</title>

			<para
>Se stai cercando di usare la Costruzione rapida, e il visualizzatore DVI non si apre, è probabile che ci sia un errore. Se c'è un errore, è visibile nell'area dei messaggi e del file di log, e verrà presentato un riassunto degli errori.</para>

			<para
>Il file di log spiegherà l'origine dell'errore nel tuo codice. Nell'editor, puoi usare i pulsanti nella barra degli strumenti chiamati <guibutton
>Errore LaTeX precedente</guibutton
> e <guibutton
>Errore LaTeX successivo</guibutton
> per saltare avanti e indietro tra gli errori. Il file di log dichiara sempre in quale riga è occorso l'errore. Per vedere la riga dove è avvenuto l'errore, fai clic sull'errore nella finestra del log, e &kile; ti porterà sulla linea corrispondente all'errore.</para>

		</sect2>

	</sect1>

</chapter>

<chapter id="startnew">

	<title
>Iniziare un nuovo documento</title>

	<sect1 id="startnew_sect">

		<title
></title>

		<sect2>

			<title
></title>

			<para
>Quando fai clic sul pulsante nella barra degli strumenti per cominciare un nuovo documento, appare una finestra di dialogo, che ti chiede quale tipo di modello vorresti usare per scrivere il tuo documento. Le tue scelte predefinite sono:</para>

			<itemizedlist>
				<listitem
><para
>Documento vuoto</para
></listitem>
				<listitem
><para
>Lettera</para
></listitem>
				<listitem
><para
>Libro</para
></listitem>
				<listitem
><para
>Articolo</para
></listitem>
				<listitem
><para
>Rapporto</para
></listitem>
			</itemizedlist>

			<para
>Se hai selezionato un <guilabel
>Documento vuoto</guilabel
>, puoi iniziare a scrivere un documento da zero, o puoi usare l'assistente per iniziare rapidamente un nuovo documento (vedi <xref linkend="intro_docwizard"/>)</para>

		</sect2>

		<sect2>
			<title
>Modelli</title>

			<para
>Gli utenti abituali di &latex; di solito usano lo stesso preambolo per quasi ogni documento che fanno. Normalmente aggiustano i parametri a loro piacimento. Iniziando un nuovo documento sarebbe comodo se &kile; partisse subito con questo documento definito dall'utente. I modelli ti permettono di ottenere questo; un qualsiasi utente &kile; che scriva continuamente lo stesso tipo di documento può avvantaggiarsi di questa capacità di &kile; di crearsi i propri modelli.</para>

		</sect2>

		<sect2>

			<title
>Crea un nuovo modello</title>

			<para
>Per creare un nuovo modello, devi prima o aprire un file &tex; / &latex;, o crearne uno da te. &kile; può generare un modello da un documento esistente aprendo il documento desiderato e selezionando <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Crea modello da documento</guimenuitem
></menuchoice
>.</para>

		</sect2>

		<sect2>

			<title
>Configurazione delle sostituzioni automatiche</title>

			<para
>Nella creazione di un nuovo documento selezionando un modello da <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Nuovo</guimenuitem
></menuchoice
>, certe combinazioni di caratteri saranno sostituite da dati come il tuo nome, o la codifica che stai usando. Queste variabili possono essere configurate in <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura &kile;</guimenuitem
></menuchoice
>. Modifica le Variabili dei modelli come vuoi.</para>

			<para
>Se stai ideando il tuo modello, è utile sapere quali combinazioni di caratteri sono sostituite da quali variabili dei modelli:</para>

			<itemizedlist>
				<listitem
><para
><userinput
>$$AUTHOR$$</userinput
>: Questa stringa sarà rimpiazzata dalla variabile autore.</para
></listitem>
				<listitem
><para
><userinput
>$$DOCUMENTCLASSOPTIONS$$</userinput
>: Questa stringa sarà sostituita dalla variabile opzioni del tipo di documento. Tipicamente viene usato come di seguito: <userinput
>\documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}</userinput
>.</para
></listitem>
				<listitem
><para
><userinput
>$$INPUTENCODING$$</userinput
>: Se la variabile codifica è impostata, per esempio, a <userinput
>latin1</userinput
> questa stringa è rimpiazzata da <userinput
>\input[latin1]{inputenc}</userinput
>.</para
></listitem>
			</itemizedlist>

		</sect2>

		<sect2 id="templ_wiz">

			<title
>Crea modelli con l'assistente</title>

			<para
>Il modo più semplice di creare modelli è partire con l'assistente, e poi aggiungere comandi all'editor sulla destra. Una volta che il documento è impostato come vuoi:</para>

			<procedure>
				<step
><para
>Salva il tuo file</para
></step>
				<step
><para
>Vai a <guimenu
>File</guimenu
></para
></step>
				<step
><para
>Scegli <guimenuitem
>Crea modello dal documento</guimenuitem
></para
></step>
				<step
><para
>Fai qualsiasi correzione necessaria al modello</para
></step>
				<step
><para
>Inserisci un nome per il tuo nuovo modello</para
></step>
				<step
><para
>Fai clic su <guibutton
>OK</guibutton
> per aggiungere il tuo modello al menu</para
></step>
			</procedure>

			<para
>La prossima volta che inizierai un documento, potrai scegliere il tuo modello personalizzato invece che i normali lettera, rapporto, libro, articolo o documento vuoto.</para>

		</sect2>

		<sect2>

			<title
>Creare un modello da un file qualsiasi</title>

			<para
>Un modello può essere creato da qualsiasi file. Se stai cercando un modo facile per configurare un modello, vai a cercarne uno che ti piaccia su Internet e segui gli stessi passi elencati in <xref linkend="templ_wiz"/>.</para>

			<para
>Per esempio, potresti voler creare un perfetto poster A0. Questi poster si vedonoregolarmente alle conferenze scientifiche, e &latex; ti aiuterà a fare un poster attraente e interessante. Puoi ottenere un modello per poster A0 alla <ulink url="http://lars.nummedal.net/?RC=a0poster"
>home page di Lars Nummedal</ulink
>, purtroppo i commenti sono solo in norvegese. Ricorda che avrai bisogno del pacchetto <filename
>a0poster</filename
>, che normalmente non è incluso in un'installazione &tetex; standard.</para>

		</sect2>

		 <sect2 id="templ_rem">

	 		<title
>Rimuovere un modello</title>

			<para
>Per rimuovere un modello da &kile;, vai a:</para>

			<itemizedlist>
				<listitem
><para
><menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Rimuovi modello...</guimenuitem
></menuchoice
></para
></listitem>
				<listitem
><para
>Apparirà una finestra di dialogo con elencati tutti i modelli</para
></listitem>
				<listitem
><para
>Scegli un modello</para
></listitem>
				<listitem
><para
>Fai clic su Rimuovi, e il tuo modello sarà rimosso</para
></listitem>
				<listitem
><para
>I modelli segnati con un * non possono essere rimossi senza i permessi necessari.</para
></listitem>
			</itemizedlist>

		</sect2>

	</sect1>

</chapter>

<chapter id="editing">

	<title
>Modificare i documenti &latex;</title>

	<para
>L'editor interno che &kile; usa è Kate. Kate è un editor di testo creato per programmatori, che include la capacità di leggere ed evidenziare molti tipi diversi di file di testo, tra cui &latex; e &bibtex;.</para>

	 <para
>Per saperne di più su Kate e sulle sue possibilità, vedi il <ulink url="help:kate"
>manuale di Kate</ulink
>. Gli utenti di &kile; possono iniziare a leggere dal capitolo <quote
>Lavorare con l'editor Kate</quote
>.</para>

	 <sect1 id="editing_sect">

		<title
></title>

	 	<sect2>

	 		<title
>Movimenti del cursore</title>

			<para
>Se vuoi selezionare del testo, hai le seguenti possibilità:</para>

			<itemizedlist>
				<listitem
><para
>Tieni premuto il pulsante sinistro del mouse, e trascina per evidenziare del testo</para
></listitem>
				<listitem
><para
>Fai clic una volta su una parola per muovervi il cursore</para
></listitem>
				<listitem
><para
>Fai clic due volte su una parola per selezionare l'intera parola</para
></listitem>
				<listitem
><para
>Fai clic tre volte per selezionare l'intera frase</para
></listitem>
			</itemizedlist>

			<para
>Mantenere premuto il pulsante sinistro del mouse, e trascinare sul testo che vuoi selezionare, copia automaticamente il testo selezionato negli appunti.</para>

			<para
>Mantere premuto shift e usare i tasti freccia ti permette di selezionare porzioni del codice sorgente nella finestra dell'editor.</para>

		</sect2>

		<sect2>

			<title
>Completamento e tracciamento delle parentesi</title>

			<para
>Il completamento delle parentesi è uno strumento visuale che la vista editor usa per indicare quali parentesi corrispondono a quali. Se apri un qualsiasi file .tex, e selezioni delle qualsiasi parentesi, siano esse tonde (), quadre [] o graffe {}, l'editor evidenzierà la parentesi e la sua corrispondente in giallo (questo colore predefinito può essere cambiato). Quindi, per esempio, puoi posizionare il cursore sulle graffe di <userinput
>\section{Introduction}</userinput
>, e vedresti <userinput
>\section{Introduction}</userinput
> nell'evidenziazione gialla predefinita, mostrandoti la posizione delle parentesi iniziale e finale.</para>

		</sect2>

		<sect2>

			<title
>Evidenziazione</title>

			<para
>&kile; ha la capacità di cercare ed evidenziare diversi tipi di codice. Per esempio, i comandi &latex; sono distinti dal testo normale, rendendoti facile distinguerli. Anche le formule sono evidenziate in un colore diverso. </para>

		</sect2>

		<sect2>

			<title
>Completamento automatico degli ambienti</title>

			<para
>Una novità in questa versione di &kile; è l'autocompletamento degli ambienti; quando inizi un ambiente, per esempio scrivendo <userinput
>\begin{environment}</userinput
>, &kile; aggiungerà automaticamente un comando <userinput
>\end{environment}</userinput
>, con in mezzo una riga per il tuo testo.</para>

			<para
>L'autocompletamento può essere disattivato nella sezione &latex; di <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura &kile;</guimenuitem
></menuchoice
>. </para>

			<screenshot>
				<screeninfo
>Completamento di un ambiente equazione</screeninfo>
				<mediaobject>
				<imageobject>
				<imagedata fileref="snap_autocomplete.png" format="PNG"/>
				</imageobject>
				<textobject>
				<phrase
>Completamento di un ambiente equazione</phrase>
				</textobject>
				</mediaobject>
			</screenshot>

		</sect2>

	</sect1>

</chapter>

<chapter id="latex">

	<title
>Usare la libreria di etichette &latex;</title>

	<para
>&latex; ha centinaia di etichette che possono essere inserite per rappresentare simboli e caratteri speciali. Il modo più facile per inserire un carattere speciale è usare il menu tra il visualizzatore dell'albero dei file e la finestra del codice sorgente.</para>

	<screenshot>
		<screeninfo
>Il menu della barra laterale</screeninfo>
		<mediaobject>
		<imageobject>
		<imagedata fileref="snap_sidebarmenu.png" format="PNG"/>
		</imageobject>
		<textobject>
		<phrase
>Il menu della barra laterale</phrase>
		</textobject>
		</mediaobject>
	</screenshot>

	<para
>Per aggiungere un carattere speciale, fai clic sul tipo di carattere che vorresti aggiungere. Puoi aggiungere le seguenti categorie di caratteri:</para>

	<itemizedlist>
		<listitem
><para
>Simboli relazionali</para
></listitem>
		<listitem
><para
>Lettere greche</para
></listitem>
		<listitem
><para
>Frecce</para
></listitem>
		<listitem
><para
>Delimitatori</para
></listitem>
		<listitem
><para
>Simboli vari</para
></listitem>
		<listitem
><para
>Caratteri stranieri</para
></listitem>
	</itemizedlist>

	<sect1 id="latex_bib">

     	<title
>Usare i bibitem</title>

		<para
><userinput
>\bibitem</userinput
> è un comando usato per inserire una referenza in un ambiente <userinput
>thebibliography</userinput
> nel tuo documento. La sintassi per usare <userinput
>\bibitem</userinput
> è <userinput
>\bibitem[etichetta]{chiave}</userinput
>.</para>

		<para
>L'<userinput
>[etichetta]</userinput
> opzionale ti serve per aggiungere il tuo sistema di etichettamento per la voce della bibliografia. Se non viene impostata nessuna etichetta, le voci saranno poste in ordine numerico: [1], [2], [3], ecc.</para>

		<para
>L'argomento <userinput
>{chiave}</userinput
> è usato per referenziare e collegare i comandi <userinput
>\bibitem</userinput
> e <userinput
>\cite</userinput
> l'uno all'altro e le informazioni che essi contengono. Il comando <userinput
>\cite</userinput
> contiene l'etichetta associata al <userinput
>\bibitem</userinput
> desiderato, che è situato all'interno di un ambiente <userinput
>thebibliography</userinput
>, e contiene i dati della referenza. Sia <userinput
>\bibitem</userinput
> che il corrispondente <userinput
>\cite</userinput
> devono avere la stessa <userinput
>{chiave}</userinput
>; il modo più semplice per organizzare le chiavi è il cognome dell'autore. Le graffe secondarie in <userinput
>{thebibliography}</userinput
> indicano l'etichetta più lunga che puoi avere nella bibliografia. Quindi, inserire {pippo} indica che puoi avere qualsiasi etichetta più corta o lunga uguale all'espressione "pippo". Impostare male questo parametro potrebbe risultare in un'indentazione non troppo gradevole nella tua bibliografia.</para>

		<para
>La bibliografia è una sezione separata dal tuo documento principale, e un esempio di codice per la bibliografia è il seguente:</para>

		<screen
><userinput>
                \begin{thebibliography}{50}
                \bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm... ciambelle}.
                Evergreen Terrace Printing Co., Springfield, DaqualchepartenegliUSA, 1998.
                \end{thebibliography)
                </userinput
></screen>

		<para
>Poi, il tuo codice sorgente principale conterrebbe l'indirizzo dell'informazione relativa al <userinput
>\bibitem</userinput
> usando <userinput
>\cite</userinput
>. Quel codice sorgente assomiglierebbe a questo:</para>

		<screen
><userinput>
                La mia tesi riguardo alla filosofia dei Simpson\copyright
                viene dal mio libro preferito \cite{Simpson}.
                </userinput
></screen>

		<para
>Siccome spesso è difficile ricordarsi l'esatta chiave di citazione una volta che hai molte referenze, &kile; ti dà un modo semplice per inserire una citazione. Sulla barra degli strumenti Modifica, fai clic sul secondo menu a cascata (normalmente c'è scritto "label"), e seleziona "cite". Sarà mostrata una lista con tutte le chiavi di citazione, seleziona la referenza corretta e una citazione sarà inserita nel tuo documento. Per aggiornare la lista delle chiavi, salva il file, oppure scegli "Aggiorna struttura" dal menu Modifica.</para>

		<para
>Il prodotto finale nella bibliografia del tuo documento sarebbe più o meno come questo:</para>

		<para
><computeroutput
>[1] Homer J. Simpson. Mmmmm... ciambelle. Evergreen Terrace Printing Co., Springfield, DaqualchepartenegliUSA, 1998.</computeroutput
></para>

		<para
>Il modo più facile di lavorare con i <userinput
>bibitem</userinput
> e <userinput
>cite</userinput
> è usare l'opzione del menu a cascata chiamato <guilabel
>cite</guilabel
>. Quando selezioni una citazione da inserire, ti sarà data la lista dei <userinput
>bibitem</userinput
> che hai creato fino a quel momento, e potrai scegliere la referenza da quella lista. &kile; può ora lavorare insieme ad applicazioni editor di &bibtex;, come gBib e pyBliographer, per renderti più facile lavorare con le citazioni.</para>

	</sect1>

	<sect1 id="latex_usertags">

		<title
>Etichette utente</title>

		<para
>&kile; ti dà la possibilità di fare etichette per i tuoi documenti. Un'etichetta è simile a una scorciatoia che lancia i tuoi comandi o scrive del testo che usi spesso nei tuoi documenti. Per esempio, quando scrivo io uso spesso nei miei testi le frasi "Preferisco LaTeX a TeX" e "Cosa farei senza Linux?". Per farne delle etichette utente, dovrei:</para>

		<itemizedlist>
			<listitem
><para
>Selezionare <guimenu
>Utente</guimenu
> dal menu</para
></listitem>
			<listitem
><para
>Selezionare <guisubmenu
>Etichette utente</guisubmenu
></para
></listitem>
			<listitem
><para
>Selezionare <guimenuitem
>Modifica etichette utente</guimenuitem
></para
></listitem>
		</itemizedlist>

		<para
>Questo mi porterà a una finestra di dialogo dove posso creare le mie etichette utente.</para>

		<screenshot>
			<screeninfo
>La finestra di dialogo Modifica etichette utente</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_editusertag.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>La finestra di dialogo Modifica etichette utente</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<screenshot>
			<screeninfo
>Chiamare un'etichetta utente</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_usertag.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Chiamare un'etichetta utente</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<para
>Nel creare le mie due etichette utente che uso spesso quando scrivo, darò loro un nome che le possa identificare chiaramente. Il nome che dai alla tua etichetta viene inserito nella sezione chiamata <guilabel
>Elemento del menu</guilabel
>, e il testo del comando che uso spesso sarebbe inserito nella sezione etichettata <guilabel
>Valore</guilabel
>. Una volta che li ho inseriti entrambi, posso usarli rapidamente nel mio testo usando la scorciatoia <keycombo
><keycap
>Ctrl</keycap
><keycap
>Shift</keycap
><keycap
>1</keycap
></keycombo
> affinché la mia prima etichetta inserisca "Preferisco LaTeX a TeX" e <keycombo
><keycap
>Ctrl</keycap
><keycap
>Shift</keycap
><keycap
>2</keycap
></keycombo
> per inserire "Cosa farei senza Linux?". </para>

		<sect2 id="latex_usertags_uc">

			<title
>Caratteri univoci nelle etichette utente</title>

			<para
>Ci sono diversi caratteri univoci in &kile;; questi caratteri hanno un significato univoco nelle etichette utente, e sono %, %S, %M, %C e %env.</para>

			<itemizedlist>
				<listitem
><para
><userinput
>%</userinput
>: un carattere usato per commentare il tuo codice sorgente.</para
></listitem>
				<listitem
><para
><userinput
>%S</userinput
>: sostituisce il nome del file sorgente.</para
></listitem>
				<listitem
><para
><userinput
>%M</userinput
>: questo sta per il testo evidenziato; il testo selezionato è inserito al suo posto quando si usano le etichette utente.</para
></listitem>
				<listitem
><para
><userinput
>%C</userinput
>: questo è dove il cursore sarà posizionato dopo aver usato un'etichetta utente.</para
></listitem>
			</itemizedlist>

			<para
>Per mostrarti come funziona, diciamo per esempio che io abbia un'etichetta utente, che contenga il valore <userinput
>\bfseries{%M}%C</userinput
>, e abbia una selezione di testo evidenziata nel mio documento che voglia trasformare in grassetto. Quindi, evidenzio la frase <userinput
>Adoro il venerdì</userinput
>, applico la mia etichetta utente premendo <keycombo
><keycap
>Ctrl</keycap
><keycap
>Shift</keycap
><keycap
>1</keycap
></keycombo
>, e ottengo la frase <userinput
>\bfseries{Adoro il venerdì}</userinput
>, con il cursore posizionato alla fine dell'espressione.</para>

		</sect2>

	</sect1>

</chapter>

<chapter id="build">

	<title
>Usare gli strumenti di costruzione</title>

	<sect1 id="build_sect">

		<title
></title>

		<sect2>

			<title
>Compilare &latex;, PDF&latex;</title>

			<para
>Per convertire il tuo documento a un altro formato, devi prima compilarne il sorgente dal tuo ambiente &latex;.</para>

			<para
>Per compilare il tuo codice sorgente per visualizzatori a schermo come &kdvi;, altri visualizzatori DVI o conversione a PostScript (PS), puoi usare la scorciatoia <keycombo
><keycap
>Alt</keycap
><keycap
>2</keycap
></keycombo
> o <menuchoice
><guimenu
>Strumenti</guimenu
><guimenuitem
>LaTeX</guimenuitem
></menuchoice
> dal menu. Questo compila il sorgente per questi diversi formati, e poi avrai le opzioni di:</para>

			<itemizedlist>
				<listitem
><para
>Visualizzare il file DVI (userà il tuo visualizzatore predefinito); <keycombo
><keycap
>Alt</keycap
><keycap
>3</keycap
></keycombo
></para
></listitem>
				<listitem
><para
>Convertire da DVI a PS; <keycombo
><keycap
>Alt</keycap
><keycap
>4</keycap
></keycombo
></para
></listitem>
				<listitem
><para
>Visualizzare il file PS; <keycombo
><keycap
>Alt</keycap
><keycap
>5</keycap
></keycombo
></para
></listitem>
			</itemizedlist>

			<para
>Ci sono diversi modi di compilare il tuo documento. Per esempio, se volessi compilare il tuo documento e trasformarlo direttamente in un PDF, dovresti eseguire PDF&latex; per compilare il tuo sorgente, che puoi dopo convertire a un file PDF. Ciò viene fatto usando la scorciatoia <keycombo
><keycap
>Alt</keycap
><keycap
>6</keycap
></keycombo
>, o selezionando <menuchoice
><guimenu
>Strumenti</guimenu
><guimenuitem
>PDF&latex;</guimenuitem
></menuchoice
> dal menu. Questo processo costruisce il tuo documento in modo che il tuo visualizzatore o altri programmi possano leggerlo.</para>

			<itemizedlist>
				<listitem
><para
>Visualizza il file PDF; <keycombo
><keycap
>Alt</keycap
><keycap
>7</keycap
></keycombo
></para
></listitem>
				<listitem
><para
>Da PS a PDF; <keycombo
><keycap
>Alt</keycap
><keycap
>8</keycap
></keycombo
></para
></listitem>
				<listitem
><para
>Da DVI a PDF; <keycombo
><keycap
>Alt</keycap
><keycap
>9</keycap
></keycombo
></para
></listitem>
			</itemizedlist>

		</sect2>

		<sect2>

			<title
>Formati di file grafici</title>

			<para
>Nota come PDF&latex;, quando usato con i pacchetti <userinput
>graphics</userinput
> o <userinput
>graphicx</userinput
>, possa compilare correttamente i file PNG e JPG nel PDF, ma non è in grado di gestire i file EPS. Di converso, il processo di compilazione in DVI e conversione a PS e PDF supporta EPS, e non supporta PNG e JPG. Per superare questa impasse frustrante, nel caso che tu abbia sia file EPS che PNG o JPG, hai dei sistemi per aggirare il problema:</para>

			<itemizedlist>
				<listitem
><para
>Puoi convertire i file EPS a PNG o altri formati con applicazioni come <ulink url="http://www.gimp.org/"
><application
>Gimp</application
></ulink
>, e quindi usare PDF&latex;.</para
></listitem>
				<listitem
><para
>Puoi convertire nell'altro senso, e usare &latex; e la conversione PS-PDF; questo non è raccomandato perché l'incapsulazione EPS di file JPG o PNG produce file generalmente più grandi, che quindi producono documenti inutilmente grandi; questo però dipende dall'applicazione grafica che usi, perché EPS può incapsulare altri file grafici, ma non tutte le applicazioni supportano perfettamente questa possibilità; puoi per esempio usare il programma jpg2ps.</para
></listitem>
				<listitem
><para
>Se hai bisogno di un file in formato PS, ma hai file grafici JPG o PNG, puoi semplicemente usare prima PDF&latex;, e poi usare l'istruzione da linea di comando pdftops, o, meglio ancora, implementare la tua etichetta utente (vedi <xref linkend="latex_usertags"/>).</para
></listitem>
			</itemizedlist>

			<para
>Usa il formato giusto per il grafico giusto!</para>

		 	<itemizedlist>
			 	<listitem
><para
>EPS è una specie di linguaggio script a vettori, che descrive tutte le linee e punti di cui un grafico è composto; non perde molto quando viene ingrandito, e si adatta al meglio ai diagrammi e alla grafica vettoriale prodotta nativamente in EPS. Puoi convertire file JPG con il programma jpg2ps, ma diventeranno un po' più grandi.</para
></listitem>
				<listitem
><para
>PNG (o GIF) è un formato senza perdita, con buone compressione e qualità. È molto buono per diagrammi, scansioni di disegni, o qualsiasi cosa di cui vuoi mantenere la definizione. È a volte esagerato per le foto, e non può essere ingrandito a piacimento come EPS.</para
></listitem>
				<listitem
><para
>JPG è un formato con perdita, che comprime i file meglio di PNG al prezzo di qualche perdita nei dettagli delle immagini. Questo è normalmente irrilevante per le foto, ma potrebbe causare una cattiva qualità per diagrammi e disegni, e potrebbe far sparire del tutto le linee più sottili; in questi casi usa EPS o PNG. I file JPG non possono essere ingranditi a piacimento come i file EPS:</para
></listitem>
			</itemizedlist>

			<para
>Ma ricorda sempre il principio di conservazione della rumenta: nessuna conversione abbellirà una cattiva immagine.</para>

		</sect2>

		<sect2 id="build_cl">

			<title
>Passare parametri di linea di comando</title>

			  <para
>Forse vorresti passare alcuni parametri di linea di comando speciali agli strumenti per compilare e convertire i tuoi file. Gli strumenti standard possono essere configurati in <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura &kile;</guimenuitem
></menuchoice
>. </para>

		</sect2>

		<sect2>

			<title
>Documento principale</title>

			<para
>Definire il tuo documento come principale ti permette di lavorare con file separati, che vuol dire avere un documento principale e documenti figli che costituiscono un'opera completa. Dopo aver definito il tuo documento principale, tutti i comandi del menu <guimenu
>Strumenti</guimenu
> si applicheranno solo a questo documento, anche se starai lavorando sui documenti figli. Puoi anche chiudere il documento principale.</para>
		</sect2>

		<sect2>

			<title
>Gestione avanzata degli errori</title>

  			<para
>Dopo aver eseguito &latex;, &kile; dà un'occhiata ai messaggi d'errore generati da &latex;. Se ci sono errori o avvertimenti, saranno riportati nella finestra Log/Messaggi. Si può dare un'occhiata alla finestra più da vicino selezionando <menuchoice
><guimenu
>Costruzione</guimenu
><guimenuitem
>Visualizza log</guimenuitem
></menuchoice
>, o usando la scorciatoia da tastiera <keycombo
><keycap
>Alt</keycap
><keycap
>0</keycap
></keycombo
>. Il log generato da &latex; è quindi mostrato nella vista Log/Messaggi; gli errori e gli avvertimenti sono evidenziati.</para>

			<screenshot>
				<screeninfo
>Visione del log...</screeninfo>
				<mediaobject>
				<imageobject>
				<imagedata fileref="snap_compile_error.png" format="PNG"/>
				</imageobject>
				<textobject>
				<phrase
>Visione del log...</phrase>
				</textobject>
				</mediaobject>
			</screenshot>

			<para
>Puoi facilmente saltare da un messaggio all'altro nel file di log usando gli elementi del menu <menuchoice
><guimenu
>Costruzione</guimenu
><guimenuitem
>Errore / Avvertimento LaTeX Successivo / Precedente</guimenuitem
></menuchoice
>, o usando i pulsanti corrispondenti nella barra degli strumenti.</para>

			<para
>Per saltare alla linea del codice &latex; dove è avvenuto l'errore, fai semplicemente clic sull'errore / avvertimento nella vista Log/Messaggi. &kile; ti porterà automaticamente alla linea incriminata.</para>

		</sect2>

		<sect2>

			<title
>Visualizzare il tuo documento</title>

			<para
>Per visualizzare il tuo documento una volta che hai compilato il sorgente usando &latex; o <keycombo
><keycap
>Alt</keycap
><keycap
>2</keycap
></keycombo
>, puoi usare il tuo lettore DVI predefinito; usa il pulsante nella barra degli strumenti o <keycombo
><keycap
>Alt</keycap
><keycap
>3</keycap
></keycombo
>.</para>

		</sect2>

		<sect2>

			<title
>Uso di Sorveglia file</title>

			<procedure>
				<step
><para
>Lancia il comando <guimenuitem
>Costruzione rapida</guimenuitem
>.</para
></step>
				<step
><para
>Lascia aperto &kdvi; e seleziona <guimenuitem
>Sorveglia file</guimenuitem
> per questo programma.</para
></step>
			</procedure>

			<para
>Ogni volta che avvii la <guimenuitem
>Costruzione rapida</guimenuitem
>, il documento DVI sarà aggiornato automaticamente, senza che &kdvi; venga riavviato.</para>

			<para
>Questa modalità funziona anche con <application
>KGhostView</application
>, ma non funzionerà con i visualizzatori integrati.</para>

		</sect2>

		<sect2>

			<title
>Convertire il tuo documento</title>

			<para
>Una volta che avrai compilato il tuo sorgente &latex; dall'editor, lo potrai convertire nel formato che ti fa più comodo.</para>

			<sect3>

				<title
>Conversioni standard (<userinput
>dvips</userinput
>, <userinput
>ps2pdf</userinput
>, <userinput
>dvipdf</userinput
>, ecc.)</title>

				<para
>Selezionare gli strumenti di conversione dal menu, o usare le scorciatoie, ti permette di convertire il documento in una forma diversa. Le conversioni comuni sono verso i formati seguenti:</para>

				<itemizedlist>
					<listitem
><para
>DVI</para
></listitem>
					<listitem
><para
>PS</para
></listitem>
					<listitem
><para
>PDF</para
></listitem>
					<listitem
><para
>HTML</para
></listitem>
				</itemizedlist>

				<para
>Nota come PDF&latex; converta il tuo documento direttamente in PDF.</para>

			</sect3>

		</sect2>

	</sect1>

</chapter>

<chapter id="navigating">

	<title
>Navigare nel sorgente &latex;</title>

	<sect1 id="navigating_struct">

		<title
>Usare la vista struttura</title>

		<para
>La vista <guilabel
>struttura</guilabel
> mostra la gerarchia del documento creato in &kile;, e ti permette di navigare rapidamente nel documento, mostrandone la segmentazione. Per navigare nel tuo documento, tutto quello che devi fare è fare clic sinistro su un qualsiasi capitolo, sezione, sottosezione, etichetta, eccetera, e sarai portato all'inizio dell'area corrispondente.</para>

		<sect2 id="navigating_labels">

			<title
>Clic su etichette e sezioni</title>

			<para
>Usando la vista <guilabel
>Struttura</guilabel
>, puoi saltare facilmente tra etichette, sezioni e sottosezioni facendo clic sull'elemento nella vista Struttura, dopodiché sarai portato a quella sezione nella vista editor. Le sezioni e le sottosezioni sono chiaramente segnate con caratteri speciali che le rendono facili da identificare.</para>

			<screenshot>
				<screeninfo
>Uso della vista Struttura</screeninfo>
				<mediaobject>
				<imageobject>
				<imagedata fileref="snap_structview_label.png" format="PNG"/>
				</imageobject>
				<textobject>
				<phrase
>Uso della vista Struttura</phrase>
				</textobject>
				</mediaobject>
			</screenshot>

		</sect2>

		<sect2 id="navigating_input">

			<title
>Doppio clic su input, include</title>

			<para
>Se includi un file nel tuo documento &latex; usando le etichette <userinput
>\input</userinput
> o <userinput
>\include</userinput
>, la vista <guilabel
>Struttura</guilabel
> conterrà un elemento che rappresenterà questo file. Fare doppio clic sul nome del file farà mostrare a &kile; questo file incluso.</para>

		</sect2>

		<sect2 id="navigating_update">

			<title
>Aggiornare la struttura</title>

			<para
>Per aggiornare la tua vista struttura puoi andare a <menuchoice
><guimenu
>Modifica</guimenu
><guimenuitem
>Aggiorna struttura</guimenuitem
></menuchoice
>, e ciò aggiornerà la tua vista <guilabel
>Struttura</guilabel
>.</para>

			<para
>Dopo aver salvato il tuo documento, &kile; aggiornerà automaticamente la vista <guilabel
>Struttura</guilabel
>.</para>

		</sect2>

		<sect2>

			<title
>Segnalibri</title>

			<para
>I segnalibri sono il tuo riferimento a un segmento di testo o una linea all'interno di &kile;. Per usare un segnalibro, puoi selezionare una riga di testo specifica nel tuo documento alla quale vorresti tornare, quindi premi <keycombo
><keycap
>Ctrl</keycap
><keycap
>B</keycap
></keycombo
>, e &kile; aggiungerà automaticamente un segnalibro a quella riga. Alternativamente, puoi anche impostare un segnalibro evidenziando la riga alla quale vorresti tornare, e scegliere il menu chiamato <guimenu
>Segnalibri</guimenu
>.</para>

			<para
>Per rimuovere i tuoi segnalibri, seleziona <menuchoice
><guimenu
>Segnalibri</guimenu
><guimenuitem
>Pulisci i segnalibri</guimenuitem
></menuchoice
>.</para>

		</sect2>

	</sect1>

</chapter>

<chapter id="projects">

	<title
>Lavorare con i progetti</title>

	<para
>Quando lavori in &kile; hai la possibilità di creare e lavorare con file progetto. Un progetto è un gruppo di documenti &latex;, &tex;, o di altro tipo, che gestisce tutte le informazioni relative al tuo documento. Un esempio tipico dell'uso di un progetto sarebbe un documento costituito da diversi capitoli, scritti in diversi file <filename
>.tex</filename
>; tutti potrebbero essere inclusi in un progetto, per rendere più facile da gestire il documento complessivo. Puoi anche aggiungere file non sorgente come i file grafici. Le specificazioni del progetto sono conservate in un file speciale, con l'estensione .kilepr.</para>

	<para
>Un progetto aggiunge le seguenti funzionalità:</para>

	<itemizedlist>
		<listitem
><para
>Non devi impostare un documento principale, &kile; lo fa automaticamente;</para
></listitem>
		<listitem
><para
>I file del progetto possono essere archiviati assieme;</para
></listitem>
		<listitem
><para
>La vista <guilabel
>File e progetti</guilabel
> mostra le relazioni tra i file nella gerarchia del tuo documento;</para
></listitem>
		<listitem
><para
>Dopo aver aperto un progetto, ogni file precedentemente aperto sarà ripristinato con la codifica e l'evidenziazione originali.</para
></listitem>
	</itemizedlist>

	<sect1 id="projects_creating">

		<title
>Creare un progetto</title>

		<para
>Per creare un progetto, seleziona <menuchoice
><guimenu
>Progetto</guimenu
><guimenuitem
>Nuovo progetto...</guimenuitem
></menuchoice
>. Ti saranno chieste le seguenti informazioni per creare il tuo progetto:</para>
		<itemizedlist>
			<listitem
><para
>Titolo del tuo progetto</para
></listitem>
			<listitem
><para
>Nome del progetto con estensione .kilepr</para
></listitem>
			<listitem
><para
>Nome file</para
></listitem>
			<listitem
><para
>Tipo del file da creare: Documento vuoto, Articolo, Libro, Lettera, Rapporto</para
></listitem>
		</itemizedlist>

		<para
>Quando crei un nuovo progetto, la casella di testo <guilabel
>File del progetto</guilabel
> è dove inserisci un nome per il tuo progetto con l'estensione .kilepr. Quando compili la sezione <guilabel
>Nome file</guilabel
>, devi includere un percorso per il tuo documento relativo a dove è tenuto il file di progetto .kilepr.</para>

		<para
>Un'installazione nuova di &kile; potrebbe non avere i pulsanti per creare, aprire, chiudere progetti direttamente nella barra degli strumenti. Puoi comunque aggiungerli alla barra andando a Impostazioni, Configura le barre degli strumenti.</para>

	</sect1>

	<sect1 id="projects_view">

		<title
>Uso della vista File e progetto</title>

		<para
>La vista <guilabel
>File e progetto</guilabel
> è un pulsante ordinato verticalmente che assomiglia a due fogli. Da questa vista, puoi vedere la struttura del tuo progetto, i file nel tuo progetto, e il nome del file .kilepr in cui sono salvate le informazioni del progetto. Dalla vista <guilabel
>File e progetto</guilabel
> si possono aggiungere, rimuovere o cambiare le opzioni del tuo progetto.</para>

		<screenshot>
			<screeninfo
>La vista File e progetto</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_projectview.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>La vista File e progetto</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

	</sect1>

	<sect1 id="projects_adding">

		<title
>Aggiunta e rimozione di file</title>

		<para
>Per aggiungere un file al tuo progetto, apri un qualsiasi file &tex;, fai clic destro sul suo nome nella vista <guilabel
>File e progetto</guilabel
>, e seleziona <guilabel
>Aggiungi al progetto</guilabel
>. Se hai più progetti aperti, una finestra di dialogo ti chiederà a quale progetto debba essere aggiunto.</para>

		<para
>Se hai più file da aggiungere a un progetto, puoi selezionare il progetto dalla vista <guilabel
>File e progetto</guilabel
> e fare clic destro, quindi selezionare <guilabel
>Aggiungi file</guilabel
>; potrai quindi selezionare i tuoi file in una finestra di dialogo.</para>

		<screenshot>
			<screeninfo
>Aggiunta di un file a un progetto</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_projectview_add.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Aggiunta di un file a un progetto</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<para
>Per rimuovere un file da un progetto, fai semplicemente clic destro su un file, seleziona <guilabel
>Rimuovi dal progetto</guilabel
>, e il tuo file sarà rimosso dal progetto. Questo non <emphasis
>cancella</emphasis
> il tuo file, ma lo rimuove soltanto dalla lista dei file contenuta nel file con estensione .kilepr.</para>

	</sect1>

	<sect1 id="projects_options">

		<title
>Cambiare le opzioni del tuo progetto</title>

		<para
>&kile; ha alcune opzioni relative al tuo progetto che possono essere impostate. Per cambiarle, fai clic destro sul titolo del tuo progetto e seleziona <guilabel
>Opzioni progetto</guilabel
>, e avrai la possibilità di cambiare:</para>

		<itemizedlist>
			<listitem
><para
>Il titolo del tuo progetto;</para
></listitem>
 			<listitem
><para
>Il comando di archiviazione;</para
></listitem>
 			<listitem
><para
>Le estensioni riconosciute per i file non sorgente;</para
></listitem>
 			<listitem
><para
>L'opzione di utilizzare le estensioni dei file come espressioni regolari.</para
></listitem>
		</itemizedlist>

		<sect2 id="projects_archive">

			<title
>Archiviazione del tuo progetto</title>

			<para
>&kile; ti permette di fare facilmente una copia di sicurezza del tuo progetto salvando tutti i file del progetto in un singolo archivio. Per archiviare il tuo progetto fai clic destro sul nome del progetto nella vista <guilabel
>File e progetto</guilabel
>, o seleziona <menuchoice
><guimenu
>Progetto</guimenu
><guimenuitem
>Archivia</guimenuitem
></menuchoice
>. </para>

			<para
>Come impostazione predefinita, tutti i file di un progetto sono aggiunti all'archivio. Se non vuoi includere un certo file nell'archivio, fai clic destro su questo file nella vista <guilabel
>File e progetto</guilabel
>, e deseleziona l'opzione <guilabel
>Includi in archivio</guilabel
>.</para>

			<para
>I comandi di archiviazione sono comandi shell che vengono eseguiti dalla cartella del progetto (dove è situato il file .kilepr). I simboli speciali che possono essere usati scrivendo il comando sono:</para>

			<itemizedlist>
			<listitem
><para
><userinput
>%S</userinput
>: questo è sostituito dal nome del tuo progetto senza l'estensione .kilepr.</para
></listitem>
			<listitem
><para
><userinput
>%F</userinput
>: questo comando è usato per sostituire la lista dei file inclusi nell'archivio.</para
></listitem>
			</itemizedlist>

		</sect2>

		<sect2 id="projects_ext">

			<title
>Estensioni per i file non sorgente</title>

			<para
>I file non sorgente sono file come immagini, PDF, PostScript, ecc., che devono essere inclusi nel progetto, ma che non sono file sorgente con estensione .tex. Hai la possibilità di usare le tue espressioni regolari personalizzate per identificare i file non sorgente.</para>

		</sect2>

	</sect1>

	<sect1 id="projects_closing">

		<title
>Chiusura di un progetto</title>

		<para
>Per chiudere un progetto, seleziona la vista <guilabel
>File e progetto</guilabel
> dalla barra degli strumenti verticale, fai clic destro sul titolo del tuo progetto, e quindi seleziona <guimenuitem
>Chiudi</guimenuitem
>. Questo chiuderà il tuo progetto, tutti i file associati con il progetto, e inoltre ne aggiungerà il nome in <guisubmenu
>Apri progetto recente...</guisubmenu
> nel menu <guimenu
>Progetto</guimenu
>.</para>

	</sect1>

</chapter>

<chapter id="lang">

	<title
>Preparare un documento in una codifica alternativa</title>

	<para
>Uno dei grandi vantaggi nell'usare &kile; è la capacità di leggere, scrivere, convertire e impostare con facilità il testo nella codifica di cui hai bisogno. Questo ti permette di usare lettere e simboli non standard; puoi usare, per esempio, i caratteri accentati per l'italiano e il francese. La selezione della codifica può essere fatta in tre modi:</para>

	<itemizedlist>
		<listitem
><para
>Un modo di impostare la codifica è usare la casella <guilabel
>Imposta codifica</guilabel
>, situata in fondo alla vista <guilabel
>Apri file</guilabel
>.</para
></listitem>
		<listitem
><para
>Un altro modo è usare il sottomenu <menuchoice
><guimenu
>Visualizza</guimenu
><guisubmenu
>Imposta la codifica</guisubmenu
></menuchoice
>.</para
></listitem>
		<listitem
><para
>Un secondo modo per impostare la codifica per un documento è impostarne l'opzione quando usi l'assistente per creare un nuovo documento.</para
></listitem>
	</itemizedlist>

	<para
>C'è anche una codifica separata per il sistema tipografico &latex;. Tradizionalmente, &latex; capisce solo un insieme molto limitato di caratteri, quindi non avresti la possibilità di usare caratteri accentati direttamente. Per usare lettere accentate, &latex; ha creato una sintassi per aggirare il problema e includere queste lettere, per esempio <userinput
>\"e</userinput
> per <computeroutput
>ë</computeroutput
>. C'è un pacchetto per aiutarti in ciò, chiamato <application
>inputenc</application
>, ed è incluso nel preambolo usando <userinput
>\usepackage[latin1]{inputenc}</userinput
>, dove l'argomento opzionale è la codifica che vuoi usare (nella maggior parte dei casi <userinput
>latin1</userinput
>). Ciò dice a &latex; di tradurre tutte le <userinput
>ë</userinput
> nel tuo documento in <userinput
>\"e</userinput
>. Per piacere vedi direttamente la documentazione di <application
>inputenc</application
> per ulteriori informazioni. Ricordati di assicurarti che il file sia davvero codificato nella stessa codifica che hai indicato a <application
>inputenc</application
>!</para>

	<screenshot>
			<screeninfo
>Scelta della codifica del file sorgente</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_encoding.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Scelta della codifica del file sorgente</phrase>
			</textobject>
			</mediaobject>
	</screenshot>

	<para
>La schiera di diversi caratteri ha creato problemi su molte applicazioni, e c'è accordo generale sul fatto che, prima o poi, tutti si sposteranno a <ulink url="http://www.unicode.org"
>Unicode</ulink
>. Ci sono molte implementazioni di Unicode, e <abbrev
>utf-8</abbrev
> è la più popolare su Linux; Windows&reg; si affida invece alla più ingombrante e meno flessibile <abbrev
>ucs-2</abbrev
>. Alcune distribuzioni, come RedHat, hanno già cominciato a impostare la loro codifica predefinita a <abbrev
>utf-8</abbrev
>, e quindi ti potrebbe interessare molto usare un argomento <userinput
>utf-8</userinput
> per il pacchetto <userinput
>inputenc</userinput
>.</para>

	<para
>La cattiva notizia è che non è ancora incluso in &tetex; al momento della scrittura di questo documento; la buona notizia è che <emphasis
>c'è</emphasis
> un pacchetto &latex; che può fare proprio quello, e lo puoi installare da te.</para>

	<para
>Vai alla home page di <ulink url="http://www.unruh.de/DniQ/latex/unicode/"
>Supporto Unicode per &latex;</ulink
>, di Dominique Unruh dell'università di Karlsruhe. Segui le istruzioni lì presenti per installare il pacchetto e usarlo.</para>

</chapter>

<chapter id="credits">

	<title
>Riconoscimenti e licenza</title>

	<para
>&kile; è un editor di codice sorgente &latex; e &tex; open source e facile da usare. Funzionerà sui sistemi con ambiente desktop &kde; installato. &kde; è disponibile per diverse architetture con Linux e altri sistemi simili a Unix. &kile; è anche parte del progetto Fink, il che vuol dire che puoi far funzionare &kile; anche su un Mac con OS-X! </para>

	<para
>Molti ringraziamenti sono dovuti a tutti coloro che lavorano per continuare il progetto &kile;, per le molte ore contribuite a sviluppare strumenti che possiamo usare tutti sotto la licenza <acronym
>GNU</acronym
>. Ecco una breve lista di programmatori, revisori, traduttori, scrittori, correttori, impacchettatori, sviluppatori Web e utenti che hanno reso possibile questo progetto. </para>

	<para
>Copyright del programma 2003 e responsabile attuale Jeroen Wijnhout <email
>Jeroen.Wijnhout@kdemail.net</email
></para>

	<para
>Copyright del programma 2002-2003 Pascal Brachet</para>

	<para
>&kile; contiene codice sorgente dal programma libero (GPL) <application
>Xgfe</application
> (interfaccia GUI tra X Windows e Gnuplot), Copyright &copy; 1998 David Ishee</para>

	<para
>Copyright della documentazione &copy; 2003 Jonathan Pechta (bozza iniziale), Federico Zenith (rifiniture finali)</para>

	<para
>Contributi da: Rob Lensen, Roland Schulz, Michael Margraf</para>

	<para
>Traduttori: Thomas Basset (fr), Kris Luyten (nl), Alexander Hunziger (de), Stefan Asserhall (se), Alfredo Beaumont (eu), Leopold Palomo Avellaneda (ca), Federico Zenith (it), Quique (es), Maciej Woloszyn (pl). </para>

	<para
>Molte grazie e i migliori auguri a tutti coloro che sono stati coinvolti! </para>
&underFDL; &underGPL; </chapter>

&documentation.index;

</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
-->
