Kile"> ATEX"> ATEX"> EX"> teTEX"> TeX Live"> EX"> EX"> ImageMagick"> KDE"> KDVI"> dvipng"> KGhostView"> KPDF"> PostScript"> makeidx"> Kate"> CJK"> ucs"> URL"> ]> JonathanPechta FedericoZenith

zenith@chemeng.ntnu.no

HolgerDanielsson

holger.danielsson@versanet.de

ThomasBraun MichelLudwig

michel.ludwig@kdemail.net

Federico Zenith

zenith@chemeng.ntnu.no

Traduzione della documentazione in italiano 2003 Jonathan Pechta 200320052006 Federico Zenith 20052006 Holger Danielsson 2007 Thomas Braun 2007 Michel Ludwig November 19, 2007 2.0 &FDLNotice; &kile; è un editor di sorgenti e shell di &tex; e &latex;,. KDE kdenonbeta Kile LaTeX TeX Per eseguire &kile;, ti sarà necessario avere i seguenti componenti installati sulla tuo sistema: Ambiente desktop &kde;: &kde; è un popolare ambiente desktop open source. Qt: Qt è una libreria per interfacce e di rete in C++ necessario per compilare &kile;. &latex;: programma tipografico di alta qualità. Quasi sicuramente ti servirà il pacchetto &texlive; (o sui sistemi più vecchi &tetex;), se sei su un sistema di tipo Unix. La maggior parte di questi elementi potrebbero 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. Il progetto &kile; include diversi pacchetti binari di &kile; per diverse distribuzioni che possono essere facilmente installati e avviati senza bisogno di compilazione; controlla la homepage di &kile;. Questo manuale è pensato per chiunque, indipendentemente dalla sua esperienza con &latex;, &kde;, &kile; o Linux. Gli utenti avanzati probabilmente non leggeranno questo manuale, ma tutti i suggerimenti saranno presi in considerazione. Se volessi contribuire a questo progetto o alla documentazione, per piacere consulta la pagina web di &kile;. 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: kile-devel@lists.sourceforge.net. &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 relativi a &latex;, il postprocessing, il debugging, la conversione e la visualizzazione; hai a disposizione anche degli assistenti molto comodi, un riferimento &latex;, e una potente gestione dei progetti. &latex; è un sistema di trattamento testi derivato da &tex;, un programma sviluppato originariamente nel 1977 da Donald Knuth per aiutarlo a presentare il suo 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 da Leslie Lamport per dare agli autori un tipografo automatico, specialmente per quanto riguardava la costosa e complicata tipografia delle formule e delle espressioni matematiche, che assolutamente non per caso 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ì, sarà bello! 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 τεχ, in lettere latine tech. Ci sono molte spiegazioni possibili sul perché, ma la più probabile è che &tex; 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. La pronuncia dovrebbe essere come segue: TE come in italiano, e X come nel tedesco ich. Se non sai come suona ch, è più o meno come il suono di un gatto che soffia; il simbolo IPA è /ç/. Molte persone sostengono la diversa pronuncia di ach (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/. Infine, in &latex; la parte LA è pronunciata come l'inglese lay (profano): l'idea è che, mentre il &tex; grezzo è difficile, anche un profano può usare le macro di &latex;. Una spiegazione meno suggestiva ma più realistica è che venga dal cognome di Leslie Lamport, il creatore di &latex;. Adesso lo sai! Il sistema di tipografia di &latex; è simile ad altri linguaggi a marcatori come l'XML, usato per molti tipi di documenti (incluso quello che stai leggendo), o l'HTML, usato per le pagine web. L'idea generale è avere parole chiave impacchettate in modo particolare, dette tag, che dicono a un programma (un elaboratore di testi, un browser web, o il compilatore &latex;) come presentare il testo. &kile; ti offre un buon numero di questi tag nel menu LaTeX nella barra dei menu. 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. Come altri linguaggi a marcatori, &latex; contiene un preambolo, che imposta i comandi globali, come la dimensione della carta, la numerazione delle pagine, le dimensioni del testo sulla pagina, e un corpo, che contiene il testo del documento; il preambolo contiene almeno il comando \documentclass, e precede il corpo, che inizia con il comando \begin{document}, ed è piuttosto prevedibilmente concluso dal comando \end{document}. L'assistente di avvio rapido integrato in &kile; è una utile funzione per iniziare rapidamente a creare documenti con &kile;. Scegliendo l'assistente dalla barra dei menu ti verranno offerte varie scelte per la creazione del tuo documento. Puoi anche specificare subito alcune opzioni relative al documento. Opzioni della classe: Tipo del documento: scegli il tipo di documento che vuoi creare: articolo, libro, lettera, rapporto, presentazione Beamer o altri tipi, inclusi quelli che potresti aver definito tu. Dimensione caratteri: dì a &kile; quale dimensione dei caratteri (in punti) vuoi usare. Dimensione carta: scegli le dimensioni o lo stile della carta. Codifica: in genere è una buona idea usare la codifica predefinita del tuo sistema. I sistemi più recenti tendono ad adottare UTF-8 come codifica predefinita. Se puoi, usa utf8x (che è davvero scritto così per i documenti &latex;). Altre opzioni: questo ti permette di impostare ulteriori opzioni per la stampa, le bozze, e altro. Pacchetti Questo elenca i pacchetti aggiuntivi più comuni usati in &latex;. Seleziona le caselle per includerli. Proprietà dei documenti Autore: metti qui il tuo nome. Titolo: aggiungi qui il titolo del documento. Data: specifica qui la data. I modelli predefiniti in &kile; sono: Documento vuoto: gli uomini veri partono da zero! Articolo: imposta il formato articolo, per un documento abbastanza breve da non aver bisogno di essere diviso in capitoli. Rapporto: imposta il formato rapporto, per documenti di media grandezza, con per esempio la numerazione delle pagine sul margine esterno. Libro: imposta il formato libro, una versione full optional, così potente da essere usata per scrivere molti testi universitari. Lettera: imposta il formato lettera, che può automaticamente sistemare quelle noiose indentazioni che nessuno riesce a ricordare. Beamer, HA-Prosper: crea delle presentazioni di alta qualità in formato PDF con tutte le potenzialità di &latex;. Scrartcl,Scrbook,Scrreprt,Scrlttr2: le classi di documenti KOMA-Script, particolarmente adatte alla tipografia tedesca. Utili soprattutto per testi in tedesco. 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 in . &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. L'autocompletamento degli ambienti significa che quando inizi un nuovo ambiente scrivendo \begin{ambiente}, &kile; aggiungerà automaticamente un comando \end{ambiente}, con una riga in mezzo per il tuo testo. Puoi ovviamente disattivarlo, se vuoi, in ImpostazioniConfigura Kile...LaTeXAmbienti. Tutti i documenti normalmente sono strutturati con una gerarchia di qualche tipo. &latex; ti permette di spezzare i documenti nella gerarchia seguente (part è l'elemento più alto della gerarchia, e subparagraph il più basso): \part \chapter \section \subsection \subsubsection \paragraph \subparagraph Quando guardi un documento nella vista Struttura, puoi saltare tra gli elementi facendo clic sull'elemento che vuoi vedere. 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), puoi far clic con il pulsante centrale del mouse nel visore &DVI;, e &kile; salterà alla riga corrispondente nel codice sorgente &latex;. Un &DVI; è un tipo di file contenente una descrizione di un documento formattato, insieme ad altre informazioni, incluso il tipo di carattere, e oltre al PDF è l'output tipico di &tex;/&latex;. Esiste un certo numero di programmi per visualizzare, convertire e stampare file &DVI; su vari sistemi e dispositivi. 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 visore &DVI;. Nuovo: inizia un nuovo documento. Apri: apri un nuovo documento. Chiudi: chiudi il tuo documento. Definisci il documento come documento principale: questo si usa lavorando con file multipli. Avere un documento principale ti permetterà di lavorare più facilmente con altri file .tex inclusi nel tuo documento. Se stai usando i progetti, puoi anche impostare un documento principale per tutto il progetto in ProgettoOpzioni del progetto. Costruzione rapida: compila il tuo codice sorgente &latex; e ne mostra i risultati automaticamente, a meno che ci siano errori nel codice. Sorveglia file: questa modalità sorveglierà eventuali cambiamenti del file &DVI;, e non avvierà una nuova finestra di &kdvi; dopo una Costruzione rapida. Visualizza file di log: visualizza il file .log, per avvistare gli errori. Errore precedente: salta all'indietro nel file .log ed evidenzia gli errori nel sorgente. Errore successivo: salta in avanti nel file .log e evidenzia gli errori nel sorgente. Ferma: ferma lo strumento attuale. LaTeX: esegue &latex; sul documento attivo. Visualizza DVI: avvia il visore &DVI;. Da DVI a PS: converte un file DVI in un &postscript; (PS). Visualizza PS: avvia il visore &postscript; (PS). PDFLaTeX: esegue &pdflatex; sul documento attivo. Visualizza PDF: avvia il visore PDF. Da DVI a PDF: converte un DVI in un PDF. Da PS a PDF: converte un PS in un PDF. Visualizza HTML: visualizza l'HTML creato. Ricerca Kdvi in avanti: salta alla pagina che corrisponde alla riga attuale nell'editor. Se guardi la barra degli strumenti Modifica, noterai tre grandi menu a cascata. I menu a cascata sono stati progettati per farti rapidamente aggiungere certe funzionalità comuni nel tuo documento. Il primo menu a cascata è usato per dividere rapidamente il tuo documento in parti, capitoli, sezioni, e così via; i comandi disponibili per aggiungere segmenti al tuo codice sorgente &latex; sono: part: livello massimo di sezionamento per un documento. chapter: inizia un nuovo capitolo. section: crea una nuova sezione. subsection: crea una nuova sottosezione. subsubsection: una sezione secondaria tra sottosezione e paragrafo. paragraph: crea un nuovo paragrafo. subparagraph: crea un nuovo sottoparagrafo. Il menu a cascata chiamato label è usato per inserire nel tuo documento elementi come indici, note a pie' di pagina, referenze. I comandi disponibili sono: label: un comando che produce un un'etichetta per un capitolo, una figura o altro elemento. index: crea una voce per l'indice. footnote: crea una nota a pie' di pagina nel tuo documento. ref: usato per riferirsi a un'etichetta già definita, che scegli da una lista a cascata. pageref: proprio come ref, ma si riferisce a una pagina invece che a un elemento della struttura. cite: crea un riferimento con dati da una bibliografia. cita da vista BibTeX: chiedi tutte le referenze selezionate allo strumento di visualizzazione di BibTeX e inseriscile. Attualmente è disponbile solo con &kbib; come strumento di visualizzazione di BibTeX. Il menu a cascata label Il menu a cascata label Il menu a cascata label Selezione dell'etichetta di una referenza Selezione dell'etichetta di una referenza Selezione dell'etichetta di una referenza Usando cite, ti viene presentata una lista a cascata di bibitem, ma se stai usando &bibtex; ciò funzionerà solo se il file appartiene a un progetto. Per modificare i file &bibtex; si raccomanda l'uso di un programma apposito. L'autore ha buona esperienza con l'uso di &kbibtex; e &kbib;. Ovviamente puoi anche scrivere i file &bibtex; a mano all'interno di &kile;. L'ultimo menu a cascata, etichettato tiny, è usato per impostare la dimensione del tuo testo. Hai la possibilità di impostare la dimensioni di testo, note a pie' di pagina, e così via; i comandi disponibili sono: tiny: piccolissimo. scriptsize: molto piccolo. footnotesize: più piccolo. small: piccolo. normalsize: normale. large: grande. Large: più grande. LARGE: ancora più grande. huge: molto grande. Huge: grandissimo. Gli utenti di &kile; hanno due scelte quando cominciano un nuovo documento: possono usare l'Assistente per cominciare un nuovo documento, selezionare il tipo di documento che vorrebbero creare, e opzioni come la dimensione dei caratteri, della carta, e così via; altrimenti, possono scrivere il codice a mano. \documentclass[12pt]{article} \begin{document} Qui c'è un pacco di codice \LaTeX. \end{document} Ogni documento &latex; comincia con il comando \documentclass[argomento opzionale]{classe}, dove la classe specifica il tipo di documento. Inserire l'esempio di codice della casella di testo sopra ti restituirà il seguente output: Testo compilato nell'output DVI Testo compilato nell'output DVI Testo compilato nell'output DVI Le parentesi quadre che vengono dopo il comando \documentclass contengono le opzioni del commando. L'opzione [12pt] 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. 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. &Alt;2 è la scorciatoia da tastiera per compilare il tuo codice sorgente. Devi salvare il tuo codice sorgente prima di poter compilare; &kile; lo farà automaticamente per te. Se il tuo documento non è stato compilato correttamente, controlla se ci sono errori nel log. Usando il pulsante Costruzione rapida, il visore &kdvi; dovrebbe essere avviato automaticamente; altrimenti, controlla il log. Un ambiente è un segmento di testo gestito 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 \begin{ambiente}, \huge and \end{ambiente} ti permetteranno di alterare temporaneamente il testo all'interno dei comandi ambiente affinché il testo sia di dimensione molto grande. I cambiamenti hanno effetto da \begin{ambiente} a \end{ambiente}. Non ci sono limiti a quanti cambiamenti puoi fare all'interno di un ambiente. 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 \end, o alla fine del tuo ambiente. \begin{emph}: questo comando scrive il testo in corsivo, ed è valido finché il codice non raggiunge un \end{emph} o un altro ambiente. Per rendere una parola in corsivo in una frase, puoi usare la sintassi: questa è la \emph{mia} frase. \textbf{Sto scrivendo questo testo all'interno delle parentesi in grassetto}: questo comando scrive il tuo testo in grassetto. \quote: per creare una citazione all'interno del tuo documento; inizia la tua citazione \begin{quote} e finiscila con \end{quote}. \center: centra il testo. \verse: crea un'indentazione adatta alla poesia. \itemize: fai una lista di oggetti. 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;. Avvia &kile;. Scegli AssistenteAvvio rapido, quindi scegli un formato, e imposta le tue preferenze nell'assistente. Una volta che l'assistente avrà inserito del testo, fai un po' di personalizzazione per rendere il documento più leggibile, aggiungi almeno una citazione, del testo in grassetto, corsivi, e un verso per vedere le differenze tra i comandi. Salva il tuo file, e dagli il nome intro.tex. Compila il tuo file usando &Alt;2, o il pulsante etichettato LaTeX. Seleziona Visualizza DVI. Controlla tutto il tuo testo nuovo. Quando hai finito di guardare il documento, fai clic sul pulsante Vista editor o premi &Ctrl;E per ritornare all'editor se stai usando il visore integrato, o chiudi la finestra del visore se stai usandone uno separato. Ecco fatto! Hai appena creato il tuo primo documento &latex;! 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! DVI significa file indipendente dal dispositivo (DeVice Independent). 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. Hai già visto come visualizzare un file DVI su schermo usando il pulsante Visualizza DVI nella barra degli strumenti. Per stampare un DVI, puoi usare lo stesso processo che hai usato per creare il tuo documento prima (vedi ). Al passo 7, dopo aver fatto clic su Visualizza DVI, seleziona FileStampa nel visore, e se hai configurato correttamente la tua stampante, potrai stampare il file DVI. La barra degli strumenti dà la possibilità di convertire un DVI ad altri formati. Una volta che hai creato un DVI dal tuo codice sorgente &latex;, potrai esportarlo in un formato di tua scelta usando i pulsanti della barra degli strumenti. Le funzioni di ricerca in avanti ti permettono di passare direttamente dall'editor alla posizione associata del file &DVI;. &kile; offre di configurare questa opzione per tutti i file binari &latex;. Vai a ImpostazioniConfigura Kile...StrumentiCostruzione e scegli sempre la configurazione Moderna. Per eseguire una ricerca in avanti, metti il cursore su una riga di codice sorgente, e fai clic su Ricerca in avanti di Kdvi per saltare alla posizione associata nella finestra del visore DVI. La ricerca inversa è una funzionalità utile quando scrivi un documento &latex;. Se tutto è a posto, puoi fare clic nella finestra di &kdvi; con il &MMB; (su alcuni sistemi, quando non hai un mouse a tre pulsanti, puoi usare contemporaneamente i pulsanti sinistro e destro). Dopodiché, &kile; caricherà il file sorgente &latex; e salterà al paragrafo giusto. Per usare la ricerca all'indietro, devi compilare il file di &latex; con la configurazione Moderna. La ricerca all'indietro non può funzionare a meno che: Il file sorgente sia stato compilato correttamente. &kdvi; sappia quale editor vuoi usare. Con questa funzionalità di &kdvi;, un clic sul pulsante centrale del mouse nel documento &DVI; farà aprire a &kile; il documento &latex; corrispondente, e gli farà cercare di raggiungere la riga corrispondente. Ricordati di dire a &kdvi; di usare &kile; come editor di testo, nell'elemento del menu ImpostazioniOpzioni DVI.... Configurazione di &kdvi; Configurazione di &kdvi; Configurare &kdvi; Se stai cercando di usare la Costruzione rapida, e il visore 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. Il file di log spiegherà l'origine dell'errore nel tuo codice. Nell'editor, puoi usare i pulsanti nella barra degli strumenti etichettati Errore LaTeX precedente e Errore LaTeX successivo 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à alla riga dell'errore. Quando fai clic sul pulsante nella barra degli strumenti per cominciare un nuovo documento, appare una finestra, che ti chiede quale tipo di modello vorresti usare per scrivere il tuo documento. Le scelte predefinite sono: Documento vuoto Articolo Beamer Libro HA-Prosper Lettera Rapporto Scrartcl (dal pacchetto di script KOMA) Scrbook (dal pacchetto di script KOMA) Scrlttr2 (dal pacchetto di script KOMA) Scrreprt (dal pacchetto di script KOMA) Se hai selezionato un Documento vuoto, puoi o iniziare a scrivere un documento da zero, o puoi usare l'assistente per iniziare rapidamente un nuovo documento (vedi ). Gli utenti frequenti di &latex; usano tipicamente lo stesso preambolo per quasi ogni documento che usano. Si possono creare, salvare e caricare modelli all'interno di &kile; per facilitare l'inizio di un nuovo documento. 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 FileCrea modello da documento. Nella creazione di un nuovo documento selezionando un modello da FileNuovo, certe combinazioni di caratteri saranno sostituite da dati come il tuo nome, o la codifica che stai usando. Queste variabili possono essere configurate in ImpostazioniConfigura Kile...ImpostazioniGenerale. Nella stesura del tuo modello, è utile sapere quali combinazioni di caratteri sono sostituite da quali variabili dei modelli: $$AUTHOR$$: Questa stringa sarà rimpiazzata dalla variabile autore. $$DOCUMENTCLASSOPTIONS$$: Questa stringa sarà sostituita dalla variabile opzioni del tipo di documento. Tipicamente viene usato come di seguito: \documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}. $$INPUTENCODING$$: Se la variabile codifica è impostata, per esempio, a latin1 questa stringa è rimpiazzata da \input[latin1]{inputenc}. Il modo più semplice di creare un nuovo modello è partire con l'assistente, e poi aggiungere comandi nell'editor. Una volta che il documento è impostato come vuoi: Salva il tuo file; Vai a File; Scegli Crea modello dal documento; Fai qualsiasi correzione necessaria al modello; Inserisci un nome per il tuo nuovo modello; Fai clic su OK per aggiungere il tuo modello al menu. La prossima volta che inizierai un documento, potrai scegliere il tuo modello personalizzato invece dei predefiniti. Un modello può essere creato da qualsiasi file &latex;. 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 . Per esempio, potresti voler creare un perfetto poster A0. Questi poster si vedono regolarmente alle conferenze scientifiche, e &latex; ti aiuterà a fare un poster accattivante e interessante. Puoi ottenere un modello per poster A0 alla home page di Jonathan Marchini, ma ce ne sono molti altri disponibili. Ricorda che avrai bisogno del pacchetto a0poster, che normalmente non è incluso in nelle installazioni &tex; standard. Scaricalo da qui e mettilo nella stessa cartella del tuo file &latex;. Per rimuovere un modello da &kile;, fai come segue: Vai a FileRimuovi modello...; Apparirà un riquadro con elencati tutti i modelli: seleziona un modello; Fai clic su OK, e il tuo modello sarà rimosso. I modelli segnati con un asterisco (*) non possono essere rimossi senza i permessi appropriati. 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;; puoi accedere a molte opzioni di &kate; direttamente dal menu Strumenti di &kile;. Per saperne di più su &kate; e sulle sue possibilità, vedi il manuale di Kate. Gli utenti di &kile; possono iniziare a leggere dal capitolo Lavorare con l'editor Kate. &kile; include un riferimento &latex; molto pratico, cui puoi accedere attraverso AiutoRiferimento LaTeX. Contiene una descrizione completa di quasi tutti i comandi che userai in &latex; e la loro sintassi. Per selezionare del testo, hai le seguenti possibilità: Tieni premuto il pulsante sinistro del mouse, e trascina per evidenziare del testo. Fai clic una volta su una parola per muovervi il cursore. Fai clic due volte su una parola per selezionare l'intera parola. Fai clic due volte su una parola e premi &Ctrl; per selezionare tutta la parola &tex;. Ciò vuol dire che fare clic in questo modo su \par in \par\bigskip seleziona solo \par. Fai clic tre volte per selezionare l'intera frase. Mantenere premuto il pulsante sinistro del mouse, e trascinare sul testo che vuoi selezionare, copia automaticamente il testo selezionato negli appunti. Mantere premuto shift e usare i tasti freccia ti permette di selezionare porzioni del codice sorgente nella finestra dell'editor. 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, se posizionassi il cursore sulle graffe di \section{Introduzione}, vedresti \section{Introduzione} nell'evidenziazione gialla predefinita, mostrandoti la posizione delle parentesi iniziale e finale. &kile; ha la capacità di cercare ed evidenziare diversi tipi di codice. Per esempio, i comandi &latex; sono distinti dal testo normale, e anche le formule matematiche sono evidenziate in un colore diverso. Molti assistenti possono inserire punti opzionali, una specie di segnalibro nel testo. Le voci del menu ModificaPunti, o le scorciatoie da tastiera corrispondenti, ti permetteranno di saltare al punto successivo o al precedente. Ciò evidenzierà il punto, in modo che sia eliminato automaticamente quando inserisci la prima lettera. Punti Punti &Ctrl;&Alt;Destra Punto successivo Passa al punto successivo, se ce n'è uno. &Ctrl;&Alt;Sinistra Punto precedente Passa al punto precedente, se ce n'è uno. Scrivere è ovviamente uno degli aspetti principali quando si usa un programma come &kile;. Sebbene &kate; abbia già grandi capacità, &kile; aggiunge alcune importanti funzionalità, che sono particolarmente utili quando si scrive un sorgente &latex;. &latex; ha sempre bisogno di molti ambienti e gruppi, perciò &kile; supporta comandi molto speciali per selezionarli. Sotto ModificaSeleziona troverai i seguenti comandi per selezionare il testo. Elementi di Modifica->Seleziona Elementi di Modifica->Seleziona &Ctrl;&Alt;S E Ambiente (dentro) Seleziona un ambiente, senza i tag che lo delimitano. &Ctrl;&Alt;S F Ambiente (fuori) Seleziona un ambiente, compresi i tag che lo delimitano. &Ctrl;&Alt;T T Gruppo TeX (dentro) Seleziona un gruppo TeX dentro le graffe che lo delimitano. &Ctrl;&Alt;T U Gruppo TeX (fuori) Seleziona un gruppo TeX insieme alle graffe che lo delimitano. &Ctrl;&Alt;S M Gruppo matematico Seleziona il gruppo matematico attuale insieme ai comandi matematici. &Ctrl;&Alt;S P Paragrafo Seleziona un intero paragrafo, cioè un gruppo di righe di testo separate su ambo i lati da righe vuote. Un paragrafo non vuol dire solo righe contigue di testo, come in altri editor di testo. Questo significato esteso include anche le tabelle, i comandi &latex; e tutte le altre righe del sorgente. L'unica cosa importante per &kile; è che questo tipo di paragrafo sia separato da due righe vuote. &Ctrl;&Alt;S L Riga Seleziona la riga di testo alla posizione attuale del cursore. &Ctrl;&Alt;S W Parola TeX Seleziona la parola alla posizione attuale del cursore. Questa selezione ha anche un significato esteso, perché il comando può anche selezionare i comandi &latex;, che cominciano con una sbarra inversa e possono avere un asterisco opzionale alla file. Per eliminare alcune parti di un documento puoi, ovviamente, selezionarle e usare il tasto Canc. &kate; ha anche il comando &Ctrl;K, che cancella tutta la riga. Però &kile; ha un modo più veloce con i suoi comandi di eliminazione. Sotto ModificaElimina troverai i seguenti comandi per eliminare il testo. Elementi di Modifica->Elimina Elementi di Modifica->Elimina &Ctrl;&Alt;T E Ambiente (dentro) Elimina un ambiente senza i tag che lo delimitano. &Ctrl;&Alt;T F Ambiente (fuori) Elimina un ambiente compresi i tag che lo delimitano. &Ctrl;&Alt;T T Gruppo TeX (dentro) Elimina un gruppo TeX dentro le graffe che lo delimitano. &Ctrl;&Alt;T U Gruppo TeX (fuori) Elimina un gruppo TeX insieme alle graffe che lo delimitano. &Ctrl;&Alt;T M Gruppo matematico Elimina il gruppo matematico attuale insieme ai comandi matematici. &Ctrl;&Alt;T P Paragrafo Elimina un intero paragrafo. Vedi il comando SelezionaParagrafo per come viene definito un paragrafo in &kile;. &Ctrl;&Alt;T I Alla fine della riga Elimina il testo dalla posizione attuale del cursore fino alla fine della riga. &Ctrl;&Alt;T W Parola TeX Elimina una parola o comando &latex; alla posizione attuale del cursore. È già stato detto che gli ambienti sono un punto centrale di &latex;. Perciò &kile; offre altri cinque comandi per rendere il lavoro con &latex; il più facile possibile nei sottomenu ModificaAmbiente. Elementi di Modifica->Ambiente Elementi di Modifica->Ambiente &Ctrl;&Alt;E B Vai all'inizio Questo comando passerà all'inizio dell'ambiente attuale, ovunque tu sia. Il cursore sarà posizionato direttamente davanti al tag di apertura dell'ambiente. &Ctrl;&Alt;E E Vai alla fine Questo comando passerà alla fine dell'ambiente attuale, ovunque tu sia. Il cursore sarà posizionato direttamente dietro al tag di chiusura dell'ambiente. &Ctrl;&Alt;E M Corrispondente Quando il tuo cursore viene messo davanti o sopra il tag \begin{ambiente}, sarà fatto passare all'altro capo dell'ambiente e viceversa. &Ctrl;&Alt;E C Chiudi Scrivendo molti tag annidati, potresti perdere il conto di tutti gli ambienti. Questo comando chiuderà l'ultimo ambiente aperto, in modo che la struttura annidata degli ambienti non sia danneggiata. &Ctrl;&Alt;E C Chiudi tutti Questo chiude tutti gli ambienti aperti, non solo l'ultimo che hai aperto. &kile; offre anche alcuni comandi speciali per i gruppi &latex;, che sono indicati dalle parentesi graffe {...}. Nel sottomenu ModificaGruppo TeX troverai alcuni comandi importanti, che corrispondono a quelli di ModificaAmbiente. Modifica->Gruppo TeX Modifica->Gruppo TeX &Ctrl;&Alt;G B Vai all'inizio Questo comando passerà all'inizio del gruppo attuale, dovunque tu sia. Il cursore sarà spostato direttamente davanti alla graffa di apertura. &Ctrl;&Alt;G E Vai alla fine Questo comando passerà alla fine del gruppo attuale, dovunque tu sia. Il cursore sarà posizionato direttamente dietro alla graffa di chiusura. &Ctrl;&Alt;G M Corrispondente Quando il tuo cursore è posizionato davanti o dietro la graffa di apertura di un gruppo &tex;, sarà spostato all'altro capo del gruppo e viceversa. &Ctrl;&Alt;G C Chiudi Scrivere molte graffe di gruppi annidati potrebbe essere dura. Questo comando chiuderà l'ultimo gruppo aperto, in modo che la struttura annidata dei gruppi di &tex; non sia danneggiata. In &latex;, due virgolette singole vengono interpretate come virgolette doppie. Per aiutarti a inserirle efficientemente, &kile; ti permette di premere " per inserire due virgolette singole di apertura. Inoltre, se vuoi chiudere una citazione, dovrai premere ". &kile; sarà abbastanza intelligente da riconoscere questo caso e inserire due virgolette di chiusura per &latex;. Per avere un carattere di virgolette doppie sull'altro lato, premi due volte ". Puoi abilitare o disabilitare questo inserimento automatico dell'apertura e della chiusura delle virgolette doppie nella sezione ImpostazioniConfigura Kile...LaTeX. Virgolette Virgolette Se includi anche opzioni specifiche per la tua lingua come ngerman o french, potrai anche usare le virgolette doppie tedesche o francesi. Sono disponibili molte altre lingue. Se premi &Shift;Invio, &kile; inserisce un ritorno a capo intelligente. Se la tua posizione attuale è in un ambiente a elenco come enumerate o itemize, &kile; non solo inserirà un ritorno a capo, ma aggiungerà anche un comando \item. Se sei all'interno di un ambiente tabulare, &kile; finirà la riga attuale con \\, seguito da un ritorno a capo. Se sei all'interno di un commento &latex;, &kile; comincerà la prossima riga con %. Inoltre, &kile; è abbastanza intelligente da supportare ambienti &latex; predefiniti e definiti dall'utente, che possono essere aggiunti nella sezione ImpostazioniConfigura Kile...LaTeX. Alcuni utenti preferiscono ordinare le colonne degli ambienti tabulari e mettere tutti i caratteri ampersand & uno sotto l'altro. &kile; prova ad aiutarli. Se premi &Shift;&Alt;&, &kile; cercherà il prossimo tabulatore nella riga sopra. Sebbene possa non essere il tabulatore corrispondente, &kile; aggiungerà dello spazio per regolare la posizione della colonna con il tabulatore attuale. Sebbene &kate; offra già un buon modo di completamento, di &kile; ha esteso il completamento del codice per supportare alcuni metodi particolari per &latex;. Sono stati integrate cinque diverse modalità. Tre di esse funzionano a richiesta, le altre due sono modalità di autocompletamento. Tutte le modalità possono essere configurate per funzionare molto diversamente in ImpostazioniConfigura Kile.... Quando inizi un nuovo ambiente, scrivendo \begin{ambiente}, &kile; aggiungerà automaticamente un comando \end{ambiente}, con in mezzo una riga per il tuo testo. L'autocompletamento può essere disattivato nella sezione &latex; di ImpostazioniConfigura Kile...LaTeXAmbienti. Completamento di un ambiente equazione Completamento di un ambiente equazione Completamento di un ambiente equazione Quando scrivi alcune lettere, puoi attivare questa modalità di autocompletamento per i comandi &latex; e le parole normali con ModificaCompletaComando (La)TeX o con la scorciatoia &Ctrl;Spazio. &kile; prima legge le lettere dalla posizione attuale del cursore a sinistra, e si ferma al primo carattere non letterale o sbarra inversa. &kile; entrerà nella modalità di autocompletamento per i comandi &tex; o &latex;. Altrimenti entra nella modalità di dizionario normale, dove non troverai nessun comando &latex;. A seconda della modalità scelta, sarà aperto un riquadro di completamento. Vedrai tutti i comandi o parole il cui inizio coincide con lo schema selezionato. Puoi navigare l'elenco con i tasti cursore, e selezionare una voce con il tasto &Enter; o fare doppio clic con il mouse. Completamento di un comando LaTeX Completamento di un comando LaTeX Quando premi il tasto &Backspace;, l'ultima lettera del tuo schema sarà eliminata, e l'elenco di completamento potrebbe aumentare. D'altro canto, se scrivi un'altra lettera, lo schema si allungherà e l'elenco potrebbe ridursi. Se decidi di non selezionare nessuno dei suggerimenti, puoi abbandonare questa finestra premendo &Esc;. Vedrai che tutti i comandi sono scritti con delle brevi descrizioni dei loro parametri. Queste descrizioni sono ovviamente rimosse quando selezioni un comando. A scelta puoi lasciare che &kile; inserisce dei punti al loro posto, in modo da poter passare facilmente a queste posizioni con ModificaPuntiPunto successivo e inserire il parametro che vuoi. Completamento di un comando LaTeX Completamento di un comando LaTeX Vai a ImpostazioniConfigura Kile...KileCompleta per configurare uno o più di questi elenchi. Puoi scegliere diversi elenchi di comandi &tex; e &latex; e diverse modalità dizionario per le parole normali. La modalità comando non serve a completare gli ambienti. Devi sempre scrivere alcune lettere di \begin, e invocare la modalità di completamento risulterà in un grande elenco di tag di ambienti. D'altro canto, gli ambienti sono usati così spesso che &kile; offre una modalità particolare di completamento degli ambienti. Lascia stare l'apertura e scrivi, per esempio, eq. Quando chiami la modalità di completamento con ModificaCompletaAmbiente o la scorciatoia da tastiera &Alt;Spazio, il tag di apertura viene inserito automaticamente, e vedrai \begin{eq}. Dopo questa modifica, l'elenco di completamento è molto meno affollato. Completamento di un comando LaTeX Completamento di un comando LaTeX Adesso seleziona un ambiente e vedrai che viene anche chiuso automaticamente. Inoltre, se &kile; lo riconosce come ambiente elenco, inserirà anche un primo tag \item. Completamento di un comando LaTeX Completamento di un comando LaTeX Vai a ImpostazioniConfigura Kile...KileCompleta per configurare uno o più di questi elenchi. Questa modalità usa gli stessi elenchi di parole della modalità di completamento dei comandi &tex; e &latex;. &kile; supporta gli elenchi di abbreviazioni definite dagli utenti, che sono sostituite a richiesta da stringhe di testo più lunghe. Vedi ImpostazioniConfigura Kile...KileCompleta per configurare uno o più di questi elenchi. Nell'esempio qui riportato, deve essere scelto l'elenco di abbreviazioni example.cwl. In questo file troverai, per esempio, la voce L=\LaTeX. Per esempio, scrivi solo la lettera L. Adesso chiama la modalità abbreviazione del completamento delle parole con ModificaCompletaAbbreviazione, o la scorciatoia &Ctrl;&Alt;Spazio, e la lettera L verrà sostituita dalla stringa \LaTeX. Puoi anche abilitare una modalità di autocompletamento per i comandi &latex;. Quando viene inserito un certo numero di lettere (tre come impostazione predefinita), si apre una finestra a comparsa con un elenco di tutti i comandi &latex; corrispondenti. Puoi selezionare uno di questi comandi, o ignorare questa finestra e scrivere altre lettere. Le voci del riquadro di completamento cambieranno sempre e corrisponderanno alla parola che stai scrivendo. Vai a ImpostazioniConfigura Kile...KileCompleta per abilitare o disabilitare questa modalità, o cambiare il numero di soglia. Completamento di un ambiente equazione Completamento di un ambiente equazione I grandi dizionari non sono utili nella modalità di autocompletamento. Però, abbiamo visto che ci sono molte parole che sono scritte più di una volta in un documento. Perciò &kile; offre un completamento per tutte le parole del documento che l'utente ha già scritto. Se vuoi attivare o disattivare questa modalità, vai a ImpostazioniConfigura Kile...KileCompleta. In questa finestra di configurazione puoi anche cambiare la soglia a cui appare il riquadro. La specifica del formato dei file di completamento può essere trovata nella specifica del formato dei file CWL. I file di completamento possono essere installati nella cartella Home di un utente nella cartella ~/.trinity/share/apps/kile/complete/<modalità>/, dove <modalità> sta per abbreviation, dictionary o tex. La finestra Includi grafica rende il più semplice possibile l'inserimento di elementi grafici. Dai un'occhiata al e al per avere una panoramica di alcuni concetti fondamentali sui formati grafici. Includere un elemento grafico Includere un elemento grafico Scegli un file grafico. Può essere un file JPEG, PNG, EPS o anche un file EPS compresso. Se hai installato &imagemagick; e hai anche configurato &kile; per usarlo (ImpostazioniConfigura Kile...LaTeXGenerale), l'altezza e la larghezza dei file grafici sono mostrate automaticamente. Se &imagemagick; può determinare una risoluzione, la dimensione dell'immagine viene mostrata anche in centimetri. Decidi se la tua immagine deve essere nel centro della pagina. Scegli il normale &latex; o &pdflatex;. Ricordati che &pdflatex; può anche creare file DVI, non solo PDF. Puoi scegliere se il nome del file debba essere inteso come relativo. Questo è il modo preferito quando usi il comando \graphicspath. Come impostazione predefinita i file devono essere nella stessa cartella del tuo documento principale. Però è possibile metterli in altre cartelle per mantenere le cose in ordine. Senza un comando \graphicspath, &kile; includerebbe il percorso per il file grafico. Però se usi \graphicspath, come: \graphicspath{{/percorso/ai/miei/file/grafici}{altro/percorso/ad/altri/grafici}} e segni questa opzione, &kile; userà solo il nome di base del file grafico. Un altro esempio: se imposti il comando \graphicspath come: \graphicspath{{./}{macchinaFotografica/}{immagini/}} &latex; cercherà nella cartella attuale, poi in macchinaFotografica, e infine in immagini per trovare il tuo file. Se scegli un'altezza o una larghezza, tutto il file sarà riscalato in proporzione. Se imposti i due valori allo stesso tempo, la larghezza e l'altezza potrebbero essere riscalate con fattori diversi, e questo potrebbe non essere quello che avevi in mente. Vedi anche le informazioni in alto nella finestra per conoscere le dimensioni originali dell'immagine. Inserisci un angolo di cui ruotare il file in senso antiorario. Le informazioni sul riquadro di delimitazione sono impostate automaticamente quando scegli un file di grafica. Queste informazioni sono necessarie solo quando lavori con il &latex; normale e con la grafica bitmap. Vedi il discorso sulla grafica EPS. La tua ultima scelta è se incorporare questa immagine in un ambiente di figura. Se decidi di farlo, puoi anche inserire una didascalia e un'etichetta. È una buona idea aggiungere un diverso prefisso a diversi tipi di etichette. È comune usare il prefisso fig: per le immagini. Uno dei lavori più noiosi che si possano fare in &latex; è scrivere una matrice o un ambiente tabella. Si deve tener conto di tutti gli elementi, assicurarsi che l'ambiente sia ben formato, e che tutte le cose siano dove devono essere. Una buona indentazione aiuta, ma c'è un modo più semplice: usare il menu Assistente di &kile;. Contiene Tabella e Matrice (usato negli ambienti matematici). Apparirà quindi uno schema a forma di matrice che puoi facilmente riempire con le tue voci. Questa finestra offre anche alcune opzioni per impostare il tipo di carattere degli elementi della tabella. Inserimento di un ambiente matrice Inserimento di un ambiente matrice L'opzione Tabulazione farà apparire un menu più semplice per impostare un ambiente di tabulazione. In tutti questi ambienti, puoi facilmente impostare il numero di righe e colonne, insieme ad altri parametri specifici. I file PS non sono popolari come i PDF, ma sono un ottimo punto di partenza per le manipolazioni e i riordinamenti delle pagine. Se vuoi un file PDF, puoi riordinare le pagine con dei programmi &postscript;, e poi convertire in PDF con ps2pdf. L'Assistente &postscript; suggerirà gli ordinamenti più comuni, ma sei libero di fare la tua scelta. Il lavoro viene fatto dai programmi pstops e psselect, che troverai nella maggior parte delle distribuzioni nel pacchetto psutils. Se uno di questi programmi non è disponibile, l'elemento corrispondente non sarà visibile. Finestra degli strumenti PS Finestra degli strumenti PS Per prima cosa scegli il tuo file iniziale. Se &kile; trova un file PS corrispondente al tuo documento principale attuale, questo verrà suggerito come file iniziale, ma sei libero di scegliere un altro file. Quindi, scegli un file di output e seleziona uno dei compiti. Infine devi decidere se vuoi solo la conversione o se vuoi anche chiamare &kghostview; per visualizzare il risultato. 1 pagina + pagina vuota A5 --> A4 Metti insieme una pagina A5 con una pagina vuota su una pagina A4. Ogni volta che due pagine A5 sono messe insieme, sono ruotate di 90 gradi e saranno posizionate orizzontalmente su una pagina A4. A5 + pagina vuota A5 + pagina vuota 1 pagina A5 + duplicato --> A4 Metti insieme una pagina A5 e una sua copia su una pagina A4. duplica pagine A5 Duplica una pagina A5 2 pagine A5 --> A4 Metti insieme due pagine A5 consecutive su una pagina A4. Metti insieme due pagine A5 Metti insieme due pagine A5 2 pagine A5L --> A4 Metti insieme due pagine A5 orizzontali consecutive su una pagina A4. 4 pagine A5 --> A4 Metti insieme quattro pagine A5 consecutive su una pagina A4. Le pagine A5 devono essere riscalate con un fattore di 0,7 per adattarsi alla pagine. 4 pagine A5 --> A4 Quattro pagine A5 --> A4 1 pagina A4 + pagina vuota --> A4 Metti assieme una pagina A4 con una pagina vuota su una pagina A4. Ogni volta che due pagine A4 sono messe assieme in una pagina A4, devono essere riscalate con un fattore di 0,7, e saranno ordinate verticalmente. 1 pagina A4 + pagina vuota --> A4 1 pagina A4 + pagina vuota --> A4 1 pagina A4 + duplicato --> A4 Metti una pagina A4 e una sua copia in una pagina A4. 1 pagina A4 + duplicato --> A4 1 pagina A4 + duplicato --> A4 2 pagine A4 --> A4 Metti assieme due pagine A4 consecutive su una pagina A4. Metti insieme due pagine A4 Metti insieme due pagine A4 2 pagine A4L --> A4 Metti assieme due pagine A4 consecutive e orizzontali su una pagina A4. seleziona pagine pari Seleziona tutte le pagine pari di un documento. seleziona pagine dispari Seleziona tutte le pagine dispari di un documento. seleziona pagine pari (ordine inverso) Seleziona tutte le pagine pari di un documento e invertine l'ordine. seleziona pagine dispari (ordine inverso) Seleziona tutte le pagine pari di un documento e invertine l'ordine. inverti tutte le pagine Inverti tutte le pagine di un documento. copia tutte le pagine (ordinate) Copia tutte le pagine di un documento. Devi scegliere il numero di copie ordinate. Copia tutte le pagine (ordinate) Copia tutte le pagine (ordinate) copia tutte le pagine (non ordinate) Copia tutte le pagine di un documento. Devi scegliere il numero di copie non ordinate. Copia tutte le pagine (non ordinate) Copia tutte le pagine (non ordinate) pstops: scegli parametro Ci sono molte opzioni per i comandi &postscript; pstops e psselect. Se ti serve un'opzione particolare, puoi chiamare pstops con un'opzioni di tua scelta. Riferisciti al manuale per tutte le opzioni possibili. psselect: scegli parametro Puoi chiamare psselect con un'opzione di tua scelta. Riferisciti al manuale per tutte le opzioni possibili. La finestra delle statistiche ti dà una panoramica di una selezione, di un documento o di un intero progetto. Include il numero di parole, i comandi e gli ambienti &latex;, e include anche il numero di caratteri per ogni tipo. I numeri possono essere copiati come testo o come un ambiente tabulare &latex; ben formattato. Se vuoi avere statistiche per tutto il progetto puoi usare FileApri tutti i file del progetto per aprire facilmente tutti i file sorgente del tuo progetto. Si deve fare attenzione all'accuratezza dei numeri. Abbiamo incluso della logica per avere una buona stima, per esempio K\"uhler risulta in una parola, un comando e sei caratteri. Però ci sono altre combinazioni in cui parte dei comandi viene contata come parola e viceversa. Va tenuto a mente che l'algoritmo è stato sviluppato e provato per le lingue simili all'inglese o al tedesco, quindi non considerare i numeri perfetti. Se devi fare un rapporto con un numero esatto di parole o caratteri, fai delle prove per verificare se l'accuratezza di &kile; è adatta a te. &latex; ha migliaia di etichette per simboli e caratteri speciali. Il modo più facile per inserirli è usare il menu della barra laterale, a sinistra della finestra dell'editor. Il menu della barra laterale Il menu della barra laterale Il menu della barra laterale Sono disponibili i seguenti tipi: Usati più spesso Relazione Operatori Frecce Matematica varia Testo vario Delimitatori Greco Caratteri speciali Caratteri cirillici Definiti dall'utente I suggerimenti delle icone mostrato i comandi &latex; e i pacchetti aggiuntivi necessari. Premere &Shift; e fare clic su un simbolo farà inserire $\comandosimbolo$. Similmente, premere &Ctrl; lo inserirà tra parentesi graffe. Se inserisci un comando che richiede un pacchetto non incluso nel tuo documento &latex;, vedrai un messaggio nella finestra del log. Il primo elenco di simboli contiene i simboli Usati più spesso. I simboli che inserisci saranno aggiunti a questo elenco per poterli ritrovare facilmente. L'ordine dei simboli non verrà cambiato all'aggiunta di nuovi elementi; verrà invece aumentato un contatore. Se il numero di elementi passa oltre i 30, l'elemento con il conto minore sarà rimosso. L'elenco di simboli Definiti dall'utente può contenere i tuoi simboli. Per crearli devi avere il programma gesimb e il file definitions.tex del pacchetto sorgente di &kile;. Inoltre ti serve un compilatore &latex; e &dvipng; (versione 1.7 o successiva). La procedura è creare un file &latex; con \input{definitions}, che rende disponibili i comandi elencati sotto, ed eseguire gesymb mieisimboli.tex utente (che chiama &latex; e &dvipng;) per creare le icone. Dopo averle copiate in $HOME/.trinity/share/apps/kile/mathsymbols/user/ e aver riavviato &kile; puoi usare i tuoi simboli. In definitions.tex sono definiti i seguenti comandi: \command[\opzione]{\simbolo}: include il simbolo \simbolo nell'elenco dei simboli; l'argomento opzionale \opzione specifica il comando che &kile; deve inserire. Se non viene dato, viene usato il comando fornito nell'argomento obbligatorio. \mathcommand[\opzione]{\simbolo}: come sopra, tranne che il comando nell'argomento obbligatorio viene inserito in modalità matematica. \pkgs[argomento]{pacchetto}: dichiara che il comando dato su questa riga ha bisogno del pacchetto &latex; pacchetto con l'argomento opzionale argomento. Questo comando deve stare davanti al comando \command e sostituisce qualsiasi specificazione di pacchetti da parte dell'ambiente neededpkgs. \begin{neededpkgs}[argomenti]{pacchetti} ... \end{neededpkgs}: ha lo stesso effetto come sopra, ma per tutti i comandi inclusi nell'ambiente. Per completezza, viene qui dato un esempio: \documentclass[a4paper,10pt]{article} \usepackage{amssymb} \input{definitions} % \begin{document} \pagestyle{empty} % \begin{neededpkgs}{amssymb} \mathcommand{\surd} \pkgs{amsmath}\mathcommand[\ddddot{}]{\ddddot{a}} \mathcommand{\angle} \end{neededpkgs} \command{\"A} \mathcommand{\exists} \mathcommand[\stackrel{}{}]{\stackrel{abc}{=}} \begin{neededpkgs}[russian,koi8-r,T2C,]{babel,inputenc,fontenc,mathtext} % % \end{neededpkgs} % this would need to include the packages % \usepackage{mathtext} % \usepackage[T2C]{fontenc} % \usepackage[russian]{babel} % \usepackage[koi8-r]{inputenc} % just to explain the format \end{document} \bibitem è un comando usato per inserire una referenza in un ambiente thebibliography nel tuo documento. La sintassi per usare \bibitem è \bibitem[etichetta]{chiave}. L'[etichetta] 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. L'argomento {chiave} è usato per referenziare e collegare i comandi \bibitem e \cite l'uno all'altro e le informazioni che essi contengono. Il comando \cite contiene l'etichetta associata al \bibitem desiderato, che è situato all'interno di un ambiente thebibliography, e contiene i dati della referenza. Sia \bibitem che il corrispondente \cite devono avere la stessa {chiave}; il modo più semplice per organizzare le chiavi è il cognome dell'autore. Le graffe secondarie in {thebibliography} indicano l'etichetta più lunga che ti aspetti di 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. La bibliografia è una sezione separata dal tuo documento principale, e un esempio di codice per la bibliografia è il seguente: \begin{thebibliography}{50} \bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm... ciambelle}. Evergreen Terrace Printing Co., Springfield, DaqualchepartenegliUSA, 1998 \end{thebibliography) Poi, il tuo codice sorgente principale conterrebbe l'indirizzo dell'informazione relativa al \bibitem usando \cite. Quel codice sorgente assomiglierebbe a questo: La mia tesi riguardo alla filosofia dei Simpson\copyright viene dal mio libro preferito \cite{Simpson}. 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. Comparirà un elenco 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, seleziona ModificaAggiorna Struttura o premi F12. Il prodotto finale nella bibliografia del tuo documento sarebbe più o meno come questo: [1] Homer J. Simpson. Mmmmm... ciambelle. Evergreen Terrace Printing Co., Springfield, DaqualchepartenegliUSA, 1998. Il modo più facile di lavorare con i \bibitem e \cite è usare l'opzione del menu a cascata chiamato cite. Quando selezioni una citazione da inserire, ti sarà data la lista dei bibitem che hai creato fino a quel momento, e potrai scegliere la referenza da quella lista. &kile; può anche lavorare insieme ad applicazioni &bibtex;, come &kbibtex;, per renderti le citazioni più facili. &kile; ti dà la possibilità di fare le tue etichette. Un'etichetta è simile a una scorciatoia che avvia qualche comando o scrive del testo frequentemente usato. Per esempio, Pinco Pallino usa spesso le frasi Preferisco \LaTeX a \TeX e Cosa farei senza Linux?. Per creare etichette utente per scrivere queste frasi, dovrebbe andare a LaTeXEtichette utenteModifica etichette utente...; ciò farà apparire una finestra dove potrà creare le sue etichette utente. La finestra Modifica etichette utente La finestra Modifica etichette utente La finestra Modifica etichette utente Chiamare un'etichetta utente Chiamare un'etichetta utente Chiamare un'etichetta utente Probabilmente darebbe a ogni etichetta un nome che la possa identificare chiaramente. Il nome che dài alla tua etichetta viene inserito nella sezione chiamata Elemento del menu, e il testo del comando dovrebbe essere inserito nella sezione etichettata Valore. Una volta che i comandi sono inseriti, li può usare rapidamente usando la scorciatoia &Ctrl;&Shift;1 affinché la mia prima etichetta inserisca Preferisco \LaTeX a \TeX e &Ctrl;&Shift;2 per inserire Cosa farei senza Linux?. Ci sono alcuni segnaposti che puoi usare nelle etichette utente: sono %B, %C, %M, e %S. %B: sarà sostituito da un punto. %C: questo è dove il cursore sarà posizionato dopo l'inserimento di un'etichetta definita dall'utente. %M: questo sta per il testo evidenziato; il testo selezionato è inserito al suo posto quando si inseriscono le etichette definite dall'utente. %S: sarà sostituito il nome del file sorgente senza estensione. Per mostrarti come funziona, diciamo per esempio di avere un'etichetta utente che contenga il valore \bfseries{%M}%C, e di avere una selezione di testo evidenziata nel nostro documento che vogliamo trasformare in grassetto. Quindi, evidenziamo la frase Adoro i venerdì, applichiamo la nostra etichetta utente premendo &Ctrl;&Shift;1, e otteniamo il testo \bfseries{Adoro i venerdì}, con il cursore posizionato alla fine dell'espressione. Per visualizzare il risultato del tuo lavoro, devi prima compilarne il sorgente. Tutti gli strumenti di costruzione sono raggruppati nei menu CostruzioneCompila, CostruzioneConverti, e CostruzioneVisualizza. Per compilare il tuo codice sorgente per visori come &kdvi;, &kghostview;, &kpdf; o conversioni successive, puoi usare la scorciatoia &Alt;2. Poi puoi visualizzare il file DVI usando il tuo visore predefinito con &Alt;3, convertire il DVI a un file PS con &Alt;4, e visualizzare il file PS con &Alt;5. Se usi &bibtex; per le tue voci bibliografiche, normalmente devi seguire uno schema di compilazione speciale. Ciò vuol dire chiamare &latex; e poi &bibtex; e poi di nuovo &latex;. Fortunatamente &kile; è abbanstanza intelligente da rilevare da solo se è necessario chiamare strumenti aggiuntivi come &bibtex;, &makeidx; e &asymptote;. Questa logica è attivata come impostazione predefinita, ma ciò può essere cambiato a ImpostazioniConfigura Kile...StrumentiCostruzione nella scheda Generale negli strumenti &latex; e &pdflatex;. Se stai usando il pacchetto &makeidx; per fare un indice analitico finale per il tuo documento, devi anche seguire un certo schema di compilazione, o fallo fare a &kile; come per i file &bibtex;. Se vuoi compilare il tuo documento con MetaPost o Asymptote, dei programmi di disegno, puoi farlo con CostruzioneCompilaMetapost o CostruzioneAltroAsymptote. C'è anche un altro modo per compilare il tuo documento, se vuoi un PDF: puoi eseguire &pdflatex;, che compilerà il sorgente direttamente in un file PDF, con &Alt;6: puoi quindi visualizzare il file premendo &Alt;7. Alternativamente, puoi convertire un PS in un PDF con &Alt;8, o un DVI direttamente in un PDF con &Alt;9. Usare &pdflatex; invece di &latex; può essere solo una questione di semplicità o d'abitudine, ma a volte il comportamento dei due programmi può differire. Infine, potresti voler pubblicare il tuo lavoro sul Web, e non solo su carta. Puoi allora usare il programma latex2html, che può essere chiamato dal menu CostruzioneConvertiDa LaTeX a Web di &kile;. Il risultato sarà posizionato in una sottocartella della cartella di lavoro, e potrai vedere il risultato della conversione scegliendo l'elemento CostruzioneVisualizzaVisualizza HTML. Se vuoi passare alcuni parametri da riga di comando specifici agli strumenti di compilazione, conversione e visualizzazione, puoi configurarne la chiamata in ImpostazioniConfigura Kile...StrumentiCostruzione. Lavorando con &latex;, ti servirà sempre un po' di tempo per vedere il risultato. &latex; deve compilare il sorgente, e deve essere avviato il visore. Ciò potrebbe essere fastidioso se hai solo cambiato qualche lettera in un'equazione difficile da scrivere. &kile; offre una modalità di Anteprima rapida, dove puoi compilare solo parte del documento e risparmiare molto tempo. Supporta quattro diverse modalità, che possono essere combinate con sette configurazioni. Anteprima rapida Anteprima rapida Tutte le impostazioni devono essere fatte in ImpostazioniConfigura Kile...StrumentiAnteprima. Configurazione dell'anteprima rapida Configurazione dell'anteprima rapida L'utente deve selezionare una parte del documento. La voce del menu CostruzioneAnteprima rapidaSelezione o la scorciatoia da tastiera &Ctrl;&Alt; P,S avvierà i programmi selezionati. &kile; prende il preambolo del testo originale, in modo che tutti i pacchetti e i comandi definiti dall'utente siano inclusi. L'utente può scegliere una configurazione tra sette predefinite: LaTeX+DVI (visore incorporato) LaTeX+DVI (KDVI) LaTeX+PS (visore incorporato) LaTeX+PS (KGhostView) PDFLaTeX+PDF (visore incorporato) PDFLaTeX+PDF (KGhostView) PDFLaTeX+PDF (KPDF) Ciò dovrebbe bastare per tutte le situazioni per cui ci sia bisogno di una anteprima rapida. Molto spesso vorresti avere un'anteprima dell'ambiente attuale, e in particolare gli ambienti matematici, che a volte sono difficili da scrivere. &kile; offre un modo molto veloce di farlo. Non c'è bisogno di selezionare, basta scegliere CostruzioneAnteprima rapidaAmbiente o la scorciatoia da tastiera &Ctrl;&Alt;P,E, e l'ambiente attuale sarà compilato e visualizzato. Se hai dei progetti con molti documenti, compilare tutto il progetto non è una buona idea, se hai fatto cambiamenti in un documento solo. &kile; può compilare e mostrare un'anteprima del sottodocumento attuale. Prende il preambolo del documento principale e compila solo la parte attuale quando selezioni CostruzioneAnteprima rapidaSottodocumento o la scorciatoia da tastiera &Ctrl;&Alt;P,D. La modalità di anteprima del gruppo matematico ti permette di vedere il gruppo matematico che stai attualmente modificando. &kile; prende il preambolo del documento principale e compila solo il gruppo matematico in cui il cursore si trova quando scegli CostruzioneAnteprima rapidaGruppo matematico o la scorciatoia da tastiera &Ctrl;&Alt;P, M. Invece di mostrare l'anteprima in un nuovo documento, &kile; può anche essere configurato per usare la barra in basso per fare un'anterprima delle compilazioni. Puoi attivare questa funzionalità nel pannello di configurazione dell'anteprima rapida. &pdflatex;, quando usato con i pacchetti graphics o graphicx, può compilare correttamente i file PNG e JPG nei DVI e PDF, ma non è in grado di gestire i file EPS. Di converso, il processo di compilazione &latex; in DVI e conversione a PS e infine PDF supporta EPS, ma non supporta PNG e JPG. Molti utenti vogliono creare dei documenti PDF, ma vogliono anche usare l'ottimo pacchetto Pstricks per creare grafica &postscript;, o vogliono usare i grafici &postscript; prodotti da programmi matematici e scientifici come Mathematica, Maple o MuPAD. Questi utenti di &latex; devono prima compilare in &postscript;, anche se vogliono creare documenti PDF, perché questi programmi producono del codice &postscript; che non può essere gestito da &pdflatex;. Però non è così difficile, perché &kile; può aiutare. Per superare questa impasse, se vuoi includere sia codice &postscript; che file PNG o JPG, hai a disposizione una serie di soluzioni: Se hai bisogno di un file in formato PS, ma hai file grafici JPG o PNG, puoi semplicemente usare prima &pdflatex; con output DVI, e poi usare dvips per creare il file PS. &pdflatex; è un'ottima scelta, se il tuo sorgente non contiene nessun codice &postscript;. Puoi convertire i file EPS a PNG o altri formati con applicazioni come Gimp o &imagemagick;, e quindi usare &pdflatex;. Un modo preferibile è convertire la grafica EPS in PDF con il comando epstopdf, presente in ogni distribuzione di &tex;, e quindi usare &pdflatex;. Produce grafica di alta qualità, e puoi anche controllarne il risultato con alcune delle seguenti opzioni: -dAutoFilterColorImages=false -dAutoFilterGrayImages=false -sColorImageFilter=FlateEncode -sGrayImageFilter=FlateEncode -dPDFSETTINGS=/prepress -dUseFlateCompression=true Ancora meglio, se il tuo sistema permette shell-escape, la conversione può essere fatta al volo. Tutto quello che devi fare è includere il pacchetto epstopdf, che fa parte delle distribuzioni &tex;, con il comando \usepackage{epsdopdf}. Supponendo che il tuo codice sia \includegraphics[width=5cm]{prova.eps} Quando chiami &pdflatex; con l'opzione --shell-escape, il file grafico prova.eps viene convertito automaticamente in prova.pdf. Questa conversione avverrà ogni volta che esegui &pdflatex;. Se il tuo comando per la grafica viene dato implicitamente \includegraphics[width=5cm]{test} epstopdf controllerà se c'è già un prova.pdf disponibile, in modo da poter saltare la conversione. Puoi convertire nell'altro senso, e usare &latex; e la conversione PS-PDF. Questa non è sempre una buona idea, perché l'incapsulazione EPS di file JPG o PNG può produrre file più grandi, che a loro volta producono documenti inutilmente grandi; questo però dipende molto dall'applicazione grafica che usi, perché EPS può incapsulare altri file grafici, ma non tutte le applicazioni supportano perfettamente questa possibilità. Alcune potrebbero anche cercare di costruire la tua immagine JPG con vettori e vari script, che risulterà in file giganteschi. La conversione di tutti i file grafici in EPS può essere fatta con &imagemagick;. Un altro semplice programma che fa correttamente questo processo è jpg2ps. Puoi anche usare una conversione automatica. Tutti i file grafici sono convertiti al volo in EPS, e inseriti nel documento PS. Questa è una modalità comoda, ma devi impostare correttamente il tuo sistema. Ciò viene discusso nella sezione sulla grafica EPS. EPS è una specie di linguaggio script a vettori, che descrive tutte le linee e punti di cui il grafico è composto; non perde molto quando viene ingrandito oltre la sua dimensione predefinita, e si adatta al meglio ai diagrammi e alla grafica vettoriale prodotta nativamente in EPS, che hanno un aspetto chiaro e netto pur mantenendo una dimensione molto ridotta. PNG (o lo sconsigliato 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. 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. Ma ricorda sempre il principio di conservazione della rumenta: nessuna conversione abbellirà una cattiva immagine. I file grafici EPS sono il modo tradizionale di inserire i file grafici nei documenti &latex;. Siccome le mailing list sono piene di domande sulla grafica EPS, discuteremo alcuni aspetti importanti e dimostreremo come &kile; li supporta. Se hai deciso di usare il classico &latex; per produrre file PS o PDF, probabilmente incorrerai in alcuni problemi con la grafica. Devi usare la grafica EPS (Encapsulated &postscript;), senza file JPEG o PNG. Non dovrebbe essere un problema, perché ci sono molti convertitori come convert dell'eccellente pacchetto &imagemagick;. Però ci vuole un po' di tempo. I file EPS vengono usati sia da &latex; che dai convertitori DVI-PS: &latex; scansiona il file EPS per trovare la linea del riquadro di delimitazione, che dice a &latex; quanto spazio riservare per la grafica. Il convertitore DVI-PS legge il file EPS e inserisce la grafica nel file PS. Ciò comporta alcune conseguenze: &latex; non legge mai il file EPS se i parametri del riquadro di delimitazione sono specificati nel comando di inserimento della grafica. Siccome &latex; non può leggere file non ASCII, non può leggere le informazioni sul riquadro di delimitazione da file di grafica compressi o non EPS. La grafica EPS non viene inclusa nel file DVI. Siccome i file EPS devono essere presenti nella conversione del file DVI in PS, i file EPS devono accompagnare i file DVI ovunque. Ora puoi chiamare &latex; e un convertitore DVI-PS come dvips per creare il tuo documento &postscript;. Se il tuo obbiettivo è un documento PDF, dovresti eseguire dvips con l'opzione -Ppdf, e quindi chiamare ps2pdf. Troverai molti documenti che descrivono questo soluzione. &kile; ti aiuta a ottenere le informazioni sul riquadro di delimitazione. Se hai installato il pacchetto &imagemagick;, &kile; estrarrà queste informazioni dal file EPS e le inserirà come opzioni. Ciò viene fatto automaticamente, quando selezioni il file di grafica. Ci sono due vantaggi in questa procedura: L'informazione viene scansionata nella finestra, e non deve essere fatta da &latex; in seguito. È ancora più importante che saranno calcolate la larghezza e l'altezza dell'immagine, quando ne sarà nota la risoluzione. Queste informazioni saranno mostrate in alto nella finestra, e potranno servire da suggerimento quando vorrai riscalare la grafica. &kile; può anche supportare i file EPS compressi con zip o gzip, che sono molto più piccoli dei file EPS non compressi. Però questa funzionalità può essere usata solo con una particolare configurazione di sistema, come descritto nella sezione sulla grafica bitmap. Se il tuo sistema permette shell-escape, &kile; supporta anche un modo semplice di includere la grafica bitmap, se hai impostato correttamente il tuo sistema &tex;. Non è necessario convertire la grafica JPEG o PNG, si può fare automaticamente quando il file DVI viene convertito in PS. &latex; ha bisogno di alcune informazioni sui suffissi dei file. Il pacchetto graphicx cerca un file graphics.cfg, che deve essere da qualche parte nel tuo percorso di ricerca per i documenti &latex;. Cerca voci come: \DeclareGraphicsRule{.pz}{eps}{.bb}{}% \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}% \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}% \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}% \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{}% e sostituisci queste righe con: \DeclareGraphicsRule{.pz}{eps}{.bb}{}% \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}% \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}% \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}% % regole cambiate o nuove \DeclareGraphicsRule{.eps.zip}{eps}{.eps.bb}{`unzip -p #1}% EPS zip \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}% EPS gzip \DeclareGraphicsRule{.jpg}{eps}{}{`convert #1 eps:-}% JPEG \DeclareGraphicsRule{.gif}{eps}{.bb}{`convert #1 eps:-}% GIF \DeclareGraphicsRule{.png}{eps}{.bb}{`convert #1 eps:-}% PNG \DeclareGraphicsRule{.tif}{eps}{.bb}{`convert #1 eps:-}% TIFF \DeclareGraphicsRule{.pdf}{eps}{.bb}{`convert #1 eps:-}% grafica PDF Potrai trovare questo file, per esempio in Debian, in /etc/texmf/latex/graphics.cfg. Il modo migliore di procedere è copiare questo file nel tuo percorso &tex; locale, e poi cambiarlo. Vedi il manuale della tua distribuzione di &tex; per sapere come ottenere un elenco delle tue cartelle &tex;. Con questo file di configurazione puoi inserire grafica bitmap e file EPS compressi con zip o gzip in &latex;. Il comando per la conversione è dato da dvips. Quando guardi al comando di conversione vedrai che non viene creato nessun file aggiuntivo. Il risultato di questo processo di conversione viene incanalato direttamente nel file PS. L'unica cosa che &latex; deve sapere è la dimensione della grafica, e quindi abbiamo bisogno del riquadro di delimitazione, che viene fornito da &kile;. Alcuni dicono che questo modo non è sicuro, devi decidere tu in che modo lavorare. In ogni caso non hai bisogno di un riquadro di delimitazione, perché &kile; estrarrà questa informazione da tutti i tipi di grafica. Come già notato, &pdflatex; non è in grado di gestire i file di grafica EPS, ma i convertitori come epstopdf saranno d'aiuto. Il modo migliore è includere il pacchetto epstopdf, che deve seguire il pacchetto graphicx. \usepackage[pdftex]{graphicx} \usepackage{epstopdf} Adesso puoi già includere la grafica EPS, se esegui pdflatex con l'opzione --shell-escape, ma possiamo ancora migliorare le cose e gestire anche i file EPS compressi con zip o gzip. Di nuovo, dobbiamo cambiare il file di configurazione grafica graphics.cfg, come sopra. Questa volta cerchiamo: % pdfTeX is running in pdf mode \ExecuteOptions{pdftex}% e aggiungiamo alcune righe. % pdfTeX is running in pdf mode \ExecuteOptions{pdftex}% \AtEndOfPackage{% \g@addto@macro\Gin@extensions{.eps.gz,.eps.zip}% \@namedef{Gin@rule@.eps.gz}#1{{pdf}{.pdf}{`gunzip -c #1 | epstopdf -f >\Gin@base.pdf}}% \@namedef{Gin@rule@.eps.zip}#1{{pdf}{.pdf}{`unzip -p #1 | epstopdf -f >\Gin@base.pdf}}% }% Con queste righe, &pdflatex; è in grado di gestire i file EPS, e ciò dovrebbe risolvere tutte le questioni di grafica. 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 Strumenti si applicheranno solo a questo documento, anche se starai lavorando sui documenti figli. Puoi anche chiudere il documento principale. Dopo aver compilato qualcosa, &kile; dà un'occhiata ai messaggi d'errore che sono stati generati. Se ci sono errori o avvertimenti, saranno riportati brevemenet nella finestra Log e messaggi. Si può dare un'occhiata ai messaggi più da vicino selezionando CostruzioneVisualizza log, o usando la scorciatoia da tastiera &Alt;0. Il log generato è quindi mostrato nella vista Log e messaggi; gli errori e gli avvertimenti sono evidenziati. Visualizzazione del log Visualizzazione del log Visualizzazione del log Puoi facilmente saltare da un messaggio all'altro nel file di log usando gli elementi del menu CostruzioneErrore / Avvertimento LaTeX Successivo / Precedente, o usando i pulsanti corrispondenti nella barra degli strumenti. Per saltare alla riga del codice &latex; dove è avvenuto l'errore o l'avvertimento, fai clic sull'errore o avvertimento nella vista Log e messaggi. &kile; ti porterà automaticamente alla riga incriminata. Quando avvii il comando Costruzione rapida, un visore di qualche tipo sarà chiamato dopo la compilazione. Se non stai usando un visore integrato, ogni volta sarà aperta una nuova finestra. Se stai sistemando l'aspetto del tuo documento, potresti avviare Costruzione rapida molto spesso, e avere molte finestre di visori aperte sul tuo desktop; per evitare questa confusione, puoi attivare la modalità Sorveglia file, che impedirà a Costruzione rapida di avviare un visore. Al momento, &kdvi; supporta l'aggiornamento continuo del file DVI visualizzato, ma &kghostview; non è altrettanto perfetto: per aggiornare il documento dopo la compilazione, dovrai cambiare pagina, e il numero di pagine non sarà cambiato nella visualizzazione di &kghostview;. Questa modalità è ovviamente inutile con i visori integrati, perché devi chiuderli comunque per tornare a modificare il documento e ricompilare. La vista Struttura mostra la gerarchia del documento creato in &kile;, e ti permette di navigarci rapidamente, mostrandone la segmentazione. Per navigare nel tuo documento, tutto quello che devi fare è fare clic sinistro su un qualsiasi etichetta, capitolo, sezione, sottosezione, etichetta, eccetera, e sarai portato all'inizio dell'area corrispondente. Se includi un file separato nel tuo sorgente &latex; usando le etichette \input o \include, questi file saranno rappresentati nella vista Struttura; fare doppio clic sui loro nomi farà mostrare a &kile; il file incluso nella finestra dell'editor. L'albero di gerarchia ha anche un ramo a parte per le etichette di riferimento usate nel testo. Uso della vista Struttura Uso della vista Struttura Uso della vista Struttura Per aggiornare la tua vista struttura puoi andare a ModificaAggiorna Struttura, premere F12, o puoi salvare il tuo documento, che farà aggiornare a &kile; la sua vista Struttura. I segnalibri sono il tuo riferimento a un segmento di testo o una riga all'interno dell'ambiente di &kile;. Per usare un segnalibro, seleziona una riga di testo specifica del tuo documento alla quale vorresti tornare, quindi premi &Ctrl;B, e &kile; aggiungerà un segnalibro a quella riga. Alternativamente, puoi anche impostare un segnalibro evidenziando la riga alla quale vorresti tornare, e scegliere il menu chiamato SegnalibriCommuta Segnalibri. Per rimuovere tutti i tuoi segnalibri, seleziona SegnalibriPulisci i segnalibri. Nota che attualmente i segnalibri non sono salvati all'uscita di &kile;. In &kile; puoi creare e lavorare con progetti. Un progetto è un gruppo di file &latex;, grafici, &bibtex;, o di altro tipo, che contengono tutte le informazioni relative al tuo documento completo. Un progetto tipico sarebbe un documento costituito da diversi capitoli, scritti in diversi file .tex; tutti potrebbero essere inclusi in un progetto, per rendere più facile da gestire il documento complessivo. Le specificazioni del progetto sono conservate in un file speciale, con estensione .kilepr. Un progetto aggiunge le seguenti funzionalità: Non devi impostare un documento principale, &kile; lo fa automaticamente. I file di progetto possono facilmente essere archiviati assieme andando a CostruzioneAltroArchivio. La vista File e progetto mostra quali file sono inclusi nel tuo progetto. Dopo aver aperto un progetto, ogni file precedentemente aperto sarà ripristinato con la codifica e l'evidenziazione originali. Il completamento del codice funziona in tutti i file del progetto. Il completamento delle referenze funziona in tutti i file del progetto. Il completamento delle citazioni funziona in tutti i file del progetto. Cerca in tutti i file del progetto. Specifica la generazione rapida personalizzata e il comando &makeidx;. Per creare un progetto, seleziona ProgettoNuovo progetto.... Ti saranno chieste le seguenti informazioni per creare il tuo progetto: Titolo del tuo progetto. Nome del file progetto con estensione .kilepr. Nome file. Tipo del file da creare: Documento vuoto, Articolo, Libro, Lettera, Rapporto, ... Quando riempi la casella Nome file, devi includere un percorso relativo da dove il file progetto .kilepr è conservato al file. La vista File e progetto è un pulsante della barra laterale. Da questa vista, puoi vedere la struttura del tuo progetto, i suoi file, e il nome del file .kilepr in cui sono salvate le informazioni del progetto. Aggiunta, rimozione o cambiamento delle opzioni del tuo progetto si fanno attraverso la vista File e progetto. La vista File e progetto La vista File e progetto La vista File e progetto Per aggiungere un file al tuo progetto, apri un qualsiasi file &tex;, fai clic destro sul suo nome nella vista File e progetto, e seleziona Aggiungi al progetto. Se hai più progetti aperti, una finestra ti chiederà a quale progetto debba essere aggiunto. Se hai più file da aggiungere a un progetto, puoi selezionare il progetto dalla vista File e progetto e fare clic destro, quindi selezionare Aggiungi file; potrai quindi selezionare i tuoi file in un riquadro. Puoi anche fare clic destro sul nome del progetto nella vista File e progetto, e selezionare Aggiungi file... per far apparire una finestra di selezione file. Aggiunta di un file a un progetto Aggiunta di un file a un progetto Aggiunta di un file a un progetto Per rimuovere un file da un progetto, fai clic destro su di esso e seleziona Rimuovi dal progetto. Ciò non elimina il tuo file (e nemmeno lo chiude), ma lo rimuove soltanto dalla lista dei file contenuta nel file con estensione .kilepr. &kile; ha alcune opzioni relative al tuo progetto che possono essere impostate. Per cambiarle, fai clic destro sul titolo del tuo progetto e seleziona Opzioni progetto, e avrai la possibilità di cambiare: Il titolo del tuo progetto. Il documento principale. Il comando di costruzione rapida. Le opzioni di &makeidx;. &kile; ti permette di fare facilmente una copia di sicurezza del tuo progetto salvandone tutti i file in un singolo archivio (spesso conosciuto come tarball). Per archiviare il tuo progetto fai clic destro sul nome del progetto nella vista File e progetto, o seleziona ProgettoArchivia. 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 di esso nella vista File e progetto, e deseleziona l'opzione Includi in archivio. I comandi di archiviazione sono semplici comandi shell che vengono eseguiti dalla cartella del progetto (dove è situato il file .kilepr). Per chiudere un progetto, seleziona la vista File e progetto dalla barra degli strumenti verticale, fai clic destro sul titolo del tuo progetto, e quindi seleziona Chiudi. Questo chiuderà il tuo progetto, tutti i file associati con il progetto, e inoltre ne aggiungerà il nome in Apri progetto recente... nel menu Progetto. L'editor &kile; ti permette di leggere, convertire e impostare il testo nella codifica che serve al tuo documento. 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: Un modo di impostare la codifica è usare la casella combinata Imposta codifica, situata in fondo alla vista Apri file della barra laterale. Un altro modo è usare il sottomenu ImpostazioniConfigura Kile...Editor, dove puoi impostare la codifica dei caratteri predefinita per tutti i file. Imposta la codifica dei caratteri predefinita Imposta la codifica dei caratteri predefinita Un terzo modo per impostare la codifica di un documento è impostarne l'opzione quando usi l'assistente per creare un nuovo documento. &latex; di per sé capisce solo ASCII, un insieme molto limitato di caratteri, quindi non potresti usare caratteri accentati o speciali direttamente. Per usare lettere accentate, è stata creata una sintassi speciale: come per esempio \"e per ë. C'è un pacchetto per aiutarti in ciò, chiamato inputenc, ed è incluso nel preambolo usando \usepackage[latin1]{inputenc}, dove l'argomento opzionale è la codifica che vuoi usare (oggi, nella maggior parte dei casi utf8x). Ciò dice a &latex; di tradurre tutte le ë che hai scritto in \"e prima di compilare. Per piacere riferisciti direttamente la documentazione di inputenc per ulteriori informazioni. In ultimo, ma non certo per importanza: ricordati di assicurarti che il file sia davvero codificato nella stessa codifica che hai indicato a inputenc! Scelta della codifica del file sorgente Scelta della codifica del file sorgente Scelta della codifica del file sorgente La schiera di diverse codifiche di caratteri ha creato problemi su molte applicazioni: per esempio, non puoi scrivere un corso di turco in francese senza perdere i caratteri speciali di una lingua. C'è accordo generale sul fatto che, prima o poi, tutti si sposteranno a Unicode. Ci sono molte implementazioni di Unicode, e UTF-8 è la più popolare su Linux; Windows® si affida invece alla più ingombrante e meno flessibile UCS-2. Alcune distribuzioni, come RedHat, hanno già cominciato a impostare la loro codifica predefinita a UTF-8, e quindi ti potrebbe interessare molto usare l'argomento utf8x per il pacchetto inputenc. Se non hai il pacchetto &ucs;, puoi procedere come segue: Prendi il pacchetto &ucs; dalla pagina Web per il supporto Unicode per &latex;, di Dominique Unruh dell'università di Karlsruhe. Per installarlo, scompatta il file scaricato e mettilo in una cartella elencata nella tua variabile d'ambiente $TEXINPUTS. Questa può essere impostata anche all'interno di &kile;. \usepackage{ucs} \usepackage[utf8x]{inputenc} Aggiungere il supporto per le lingue ideografiche è piuttosto complicato. Tuttavia, una volta che hai finito, funzionerà piuttosto bene. Oltre a installare dei pacchetti, c'è da fare del lavoro di configurazione aggiuntivo. La tua distribuzione Linux potrebbe già avere un pacchetto &cjk; (cinese, giapponese, coreano) pronto per te, quindi ti potresti risparmiare la fatica di installare tutto a mano. Controlla prima di andare avanti! C'è la possibilità di usare il pacchetto &ucs; per scrivere brevi inserti di testo &cjk;, ma quell'opzione è seriamente limitata perché non gestisce, tra l'altro, i ritorni a capo. Noi invece installeremo il pacchetto &cjk;-&latex; completo e lo faremo funzionare sia per &latex; che per &pdflatex;. Molto di questo materiale è stato ispirato alla pagina Web su come configurare &pdflatex; di Pai H. Chou. Scarica il pacchetto &cjk;. Copiane i file scompattati in una sottocartella appropriata di $TEXMF, come hai fatto prima per il pacchetto &ucs; (vedi ). I file saranno scompattati in una cartella CJK/X_Y.Z, non è fondamentale che li estrai, anche se ti sarà poi più facile mantenerli. Adesso devi scaricare un tipo di carattere che supporti tutti i caratteri &cjk; di cui hai bisogno. Puoi scegliere qualsiasi file *.ttf che li contenga, ma in questa guida useremo Cyberbit. Scompatta il file e rinomina Cyberbit.ttf in cyberbit.ttf, perché le maiuscole potrebbero confondere il tuo sistema. Posiziona cyberbit.ttf in una cartella insieme a Unicode.sfd, e genera i file *.tfm e *.enc con il comando $ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@. Per qualche motivo, a volte questo non produce le centinaia di file che dovrebbe. Se fosse il tuo caso, puoi scaricare sia i file *.tfm che *.enc. Posiziona i file *.tfm in una cartella appropriata, diciamo $TEXMF/fonts/tfm/bitstream/cyberbit/; i file *.enc possono essere installati in $TEXMF/pdftex/enc/cyberbit/. Adesso abbiamo bisogno di un file di mappatura per connettere i file *.enc al tipo di carattere. Scarica cyberbit.map e installalo in $TEXMF/pdftex/config/. Scarica un altro file, c70cyberbit.fd, e posizionalo in una cartella appropriata. Puoi scegliere, per esempio, $TEXMF/tex/misc/. L'ultimo file che dobbiamo generare è un tipo di carattere PostScript Type 1, necessario per leggere i file DVI generati con &latex;. Esegui il comando $ ttf2pfb cyberbit.ttf -o cyberbit.pfb, e copia il file risultante cyberbit.pfb in una cartella come $TEXMF/fonts/type1/cyberbit/. Ora mettiamo cyberbit.ttf tra i tipi di carattere dove &latex; lo può trovare. Puoi posizionarlo in una cartella di nome $TEXMF/fonts/truetype/. Controlla il file di configurazione che trovi a $TEXMF/web2c/texmf.cnf, e assicurati che la riga contenente TTFONTS non sia commentata e punti alla cartella dove hai salvato cyberbit.ttf. Per fare sì che &pdflatex; usi i tuoi caratteri &cjk;, è necessario che aggiungi una riga nel file di configurazione $TEXMF/pdftex/config/pdftex.cfg. Aggiungi map +cyberbit.map nel file per completare la configurazione di &pdflatex;. Per configurare &latex; in modo da poter produrre file DVI con caratteri &cjk;, devi aggiungere una riga nel file ttfonts.map. Il file potrebbe essere in una cartella di nome $TEXMF/ttf2pk/, ma probabilmente dovrai cercarlo. Aggiungici la riga cyberbit@Unicode@ cyberbit.ttf. Adesso, devi solo eseguire texhash e il sistema dovrebbe essere pronto. Per controllare se la tua configurazione è corretta, puoi provare a compilare questo file di testo. Ci sono molte cose che possono andare storte quando si imposta il supporto &cjk; manualmente. Se qualcosa sembra non funzionare, l'elenco seguente ti potrebbe aiutare. Ovviamente, siccome usi &latex; come utente e non come root, devi permettere agli utenti normali di accedere ai nuovi file. Assicurati che tutte le cartelle e i file siano accessibili usando il comando chmod. Se &latex; scrive un DVI senza problemi, ma non può visualizzarlo, è quasi sicuramente a causa di problemi nella generazione automatica dei caratteri *.pk. Dovrebbero essere generati al volo quando si visualizza un file DVI, ma ciò potrebbe non riuscire per vari motivi: per prima cosa ricontrolla accuratamente di aver inserito la nuova riga in ttfonts.map. Tuttavia, potrebbe capitare che il tuo comando ttf2pk, che è normalmente chiamato dal visore DVI, sia stato compilato senza supporto per le librerie kpathsea. Se è questo il caso, $ ttf2pk --version non nominerà kpathsea. Siccome il supporto di queste librerie è necessario, potresti dover trovare un nuovo pacchetto, o ricompilare da te FreeType 1. Ci sono una serie di diversi motori di inserimento, e la scelta può dipendere anche dai gusti personali. L'autore usa Skim, un trasferimento su &kde; del motore Scim. Riferisciti alla documentazione della tua distribuzione per sapere come installare questi programmi. Anche la configurazione di questi programmi può essere difficile, nel caso di Skim dovrai definire una variabile d'ambiente XMODIFIERS="@im=SCIM" prima di avviare X. La funzionalità di script di &kile; permette l'esecuzione di codice ECMAScript. Gli script possono essere gestiti con il pannello degli script nella barra laterale. In questa sezione descriviamo l'interfaccia alla programmazione di script di &kile;. Nota che l'API degli script non è stata ancora completata. L'API descritta sotto potrebbe cambiare in versioni successive di &kile;. Innanzi tutto, l'ambiente di esecuzione di script di &kile; fornisce un oggetto globale chiamato kile, che ha i seguenti metodi: (kile).currentTextDocument() Restituisce un oggetto KileTextDocument che riflette il documento di testo attualmente attivo. Restituisce null se nessun documento di testo è attivo. (kile).getInputValue(didascalia, etichetta) Apre una finestra con la didascalia e l'etichetta date. Restituisce il valore inserito dall'utente. Gli oggetti del tipo KileTextDocument rappresentano i documenti di testo di &kile;, e hanno le seguenti proprietà: (KileTextDocument).backspace() Elimina il carattere posizionato immediatamente prima della posizione attuale del cursore e sposta il cursore una posizione indietro nel testo. (KileTextDocument).cursorLeft() Sposta il cursore di una posizione indietro nel testo. (KileTextDocument).cursorRight() Sposta il cursore di una posizione avanti nel testo. (KileTextDocument).insertText(testo) Inserisce il testo contenuto nella variabile testo nel documento alla posizione attuale del cursore. (KileTextDocument).insertBullet() Inserisce un elemento di una lista a puntata nel documento alla posizione attuale del cursore. (KileTextDocument).nextBullet() Seleziona il primo elemento di una lista puntata nel documento dopo la posizione attuale del cursore. (KileTextDocument).previousBullet() Seleziona il primo elemento di una lista puntata nel documento prima della posizione attuale del cursore. (KileTextDocument).up() Sposta il cursore di una riga in su nel documento. (KileTextDocument).down() Sposta il cursore di una riga in giù nel documento. (KileTextDocument).cursorLine() Restituisce la riga sulla quale si trova il cursore. (KileTextDocument).cursorColumn() Restituisce la colonna sulla quale si trova il cursore. (KileTextDocument).setCursorLine(riga) Sposta il cursore alla riga indicata da riga. (KileTextDocument).setCursorColumn(colonna) Sposta il cursore alla colonna indicata da colonna. &latex; è un sistema piuttosto sofisticato, dove le funzionalità di base possono essere espanse da una moltitudine di pacchetti aggiuntivi. &kile; fornisce molti aiuti diversi per supportare l'utente. Riferimento LaTeX Un indice alfabetico dei comandi &latex; più comuni. Documentazione TeX &tetex; e &texlive; includono una gran quantità di documenti. Ciò comprende una documentazione per tutti i pacchetti inclusi e un riferimento &latex; aggiuntivo. LaTeX Un riferimento completo per &tex; e compagnia. Non è solo una descrizione di tutti i programmi, sono inclusi anche alcuni pacchetti importanti. Include anche un manuale di riferimento completo dei comandi &latex;, ideale per cercare un particolare comando di formattazione quando si scrive un documento. Siccome questo documento è molto grande, &kile; lo separa con tre segnalibri importanti. Comando LaTeX Un altro indice alfabetico dei comandi &latex; più comuni. Soggetto LaTeX Una descrizione dei soggetti &latex; più importanti. Ambienti LaTeX Un indice alfabetico degli ambienti &latex; più comuni. &kile; supporta anche un aiuto contestuale, richiamato con &Ctrl;&Alt;H,K. In impostazioniConfigura Kile...KileAiuto puoi scegliere se vuoi usare il riferimento &latex; di &kile; o il sistema di aiuto di &tetex; o &texlive;, che è l'impostazione predefinita. Punti Punti Non è sempre facile trovare il documento giusto, perché &tetex; e &texlive; includono una quantità impressionante di documenti. Un aiuto possibile è che &tetex; e &texlive; forniscono un programmino, texdoctk. Contiene una banca dati dei documenti che &kile; usa per offrirne un'interfaccia. Punti Punti Tutti i documenti sono raggruppati in alcune categorie, e il vantaggio principale è che puoi cercare i nomi dei pacchetti o delle parole chiave. Quindi, &kile; mostrerà solo i risultati. Punti Punti Un clic doppio del mouse o del tasto Spazio avvierà il visore del documento. Questo può essere un documento qualsiasi, non solo un documento DVI, PS, PDF o HTML. &kile; userà le impostazioni di &konqueror; per avviare un visore appropriato. Oltre alla documentazione statica di &tetex; e &texlive;, &kile; supporta anche un'altra modalità variabile per i documenti di aiuto all'utente. Nel menu Aiuto, &kile; ha un sottomenu speciale Aiuto dell'utente, dove l'utente può aggiungere dei documenti a sua scelta. Questi possono essere i documenti &tetex; o &texlive; più importanti o anche documenti scritti da sé. È anche possibile scegliere degli &url; Web. Vai a ImpostazioniConfigura Kile...KileAiuto e scegli il pulsante Configura per configurare questo menu Aiuto dell'utente. Puoi aggiungere, rimuovere o navigare nelle voci, e anche inserire dei separatori per avere una struttura migliore. Premere il pulsante Aggiungi aprirà un'altra finestra, dove devi modificare il nome della voce del menu e scegliere il file corrispondente o &url; Web. Se scegli un &url; Web, verrà avviato &konqueror;, e dovresti copiare l'&url; finale. Punti Punti &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. Molti ringraziamenti sono dovuti a tutti coloro che lavorano per continuare il progetto &kile;, per le molte ore contribuite a sviluppare gli strumenti che possiamo usare tutti sotto la licenza GNU. Le informazioni aggiornate sui partecipanti si trovano nella finestra Informazioni su &kile; nel menu Aiuto. Contributi da, tra gli altri: Rob Lensen, Roland Schulz, Michael Margraf, Holger Danielsson Molte grazie a tutti i partecipanti! &underFDL; &underGPL; &documentation.index;