#LyX 1.6.0 created this file. For more info see http://www.lyx.org/ \lyxformat 345 \begin_document \begin_header \use_default_options false \textclass article \begin_preamble % DO NOT ALTER THIS PREAMBLE!!! % %This preamble is designed to ensure that the document prints % out as advertised. If you mess with this preamble, % parts of the document may not print out as expected. If you % have problems LaTeXing this file, please contact % the documentation team % email: lyx-docs@lists.lyx.org \usepackage{ifpdf} % part of the hyperref bundle \ifpdf % if pdflatex is used % set fonts for nicer pdf view \IfFileExists{lmodern.sty}{\usepackage{lmodern}}{} \fi % end if pdflatex is used % the pages of the TOC is numbered roman % and a pdf-bookmark for the TOC is added \pagenumbering{roman} \let\myTOC\tableofcontents \renewcommand\tableofcontents{% \pdfbookmark[1]{\contentsname}{} \myTOC \cleardoublepage \pagenumbering{arabic} } % redefine the \LyX macro for PDF bookmarks \def\LyX{\texorpdfstring{% L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\@} {LyX }} \end_preamble \language italian \inputencoding latin1 \font_roman default \font_sans default \font_typewriter default \font_default_family default \font_sc false \font_osf false \font_sf_scale 100 \font_tt_scale 100 \graphics default \paperfontsize 12 \spacing single \use_hyperref true \pdf_title "Introduzione a LyX" \pdf_author "LyX Team, traduzione in italiano di Nicola Focci" \pdf_subject "LyX-documentation Intro" \pdf_keywords "LyX, documentation" \pdf_bookmarks true \pdf_bookmarksnumbered true \pdf_bookmarksopen true \pdf_bookmarksopenlevel 2 \pdf_breaklinks false \pdf_pdfborder false \pdf_colorlinks true \pdf_backref false \pdf_pdfusetitle false \pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false, pdfpagelabels" \papersize a4paper \use_geometry false \use_amsmath 1 \use_esint 0 \cite_engine basic \use_bibtopic false \paperorientation portrait \secnumdepth 3 \tocdepth 2 \paragraph_separation indent \defskip medskip \quotes_language english \papercolumns 1 \papersides 1 \paperpagestyle default \tracking_changes false \output_changes false \author "" \author "" \end_header \begin_body \begin_layout Title Introduzione a LyX \end_layout \begin_layout Author a cura del Team di LyX \begin_inset Foot status collapsed \begin_layout Plain Layout \noindent Se avete commenti o correzioni, inviateli cortesemente alla mailing list della documentazione di LyX: \begin_inset CommandInset href LatexCommand href target "lyx-docs@lists.lyx.org" \end_inset \end_layout \end_inset \begin_inset Newline newline \end_inset Traduzione in italiano di Nicola Focci \end_layout \begin_layout Standard \begin_inset CommandInset toc LatexCommand tableofcontents \end_inset \end_layout \begin_layout Section La filosofia di LyX \end_layout \begin_layout Subsection Che cosa è LyX? \end_layout \begin_layout Standard LyX è un sistema per la preparazione di documenti. Eccelle nel consertirvi di creare complessi scritti tecnici e scientifici, con elementi matematici, riferimenti incrociati, bibliografie, indici, eccetera. E' particolarmente efficace qualora siano richieste tipiche funzionalità di elaborazione del tipo: nu\SpecialChar \- me\SpecialChar \- ra\SpecialChar \- zio\SpecialChar \- ne automatica di sezioni e pagine, controllo ortografico, e così via -- a prescindere dalla lunghezza del documento. Può essere anche usato per scrivere una lettera alla vostra mamma, ma sicuramen te esistono programmi più semplici per tale scopo. In definitiva, non è lo strumento migliore per creare striscioni, loghi, annunci pubblicitari (più avanti spiegheremo il perché), anche se -- con qualche sforzo -- può essere realizzato pure tutto questo. Ecco alcuni esempi relativi a ciò per cui LyX viene impiegato: memo, lettere, dissertazioni e tesi, estratti di conferenze, appunti da seminari, atti di congressi, documentazione di software, libri, articoli per pubblicazioni scientifiche, copioni di opere e film, proposte d'affari, presentazioni\SpecialChar \ldots{} \end_layout \begin_layout Standard Il programma LyX fornisce un approccio moderno alla scrittura di documenti mediante un computer, utilizzando un modello di linguaggio di marcatura; un approccio che rompe la tradizionale concezione a \begin_inset Quotes eld \end_inset macchina da scrivere \begin_inset Quotes erd \end_inset . E' stato progettato per quegli autori che vogliono un risultato professionale in modo rapido e col minimo sforzo, senza diventare esperti in composizione tipografica. Le procedure di composizione tipografica vengono svolte in gran parte dal computer, non dall'autore; con LyX, quest'ultimo può concentrarsi unicamente sul contenuto del suo scritto. \end_layout \begin_layout Standard Buona parte dell'iniziale sfida nell'apprendere LyX deriva dal cambiamento di mentalità che voi, utilizzatori, dovrete mettere in atto. Anni fa, per creare documenti disponevamo unicamente delle macchine da scrivere; quindi abbiamo tutti imparato alcuni trucchi per sopperire alle loro limitazioni. La sottolineatura, che altro non era se non ripassare il testo col carattere \begin_inset Quotes eld \end_inset _ \begin_inset Quotes erd \end_inset , diventò un sistema per enfatizzare il testo. Eravamo costretti a calcolare la dimensione di colonne e tabulazioni, e a impostarle -- prima di creare una tabella. Idem dicasi per le lettere, o altro testo allineato a destra. La sillabazione al termine della riga richiedeva un occhio circospetto, e tanta premonizione. \end_layout \begin_layout Standard In altre parole, ci siamo tutti esercitati nel preoccuparci dei piccoli dettagli, circa quali caratteri servissero, e dove servissero. Di conseguenza, quasi tutti i word processor presentano questa mentalità. Utilizzano ancora le ta\SpecialChar \- bulazioni per aggiungere spazi. Dovete ancora preoccuparvi di dove qualcosa andrà esattamente a finire, nella pagina. Enfatizzare il testo significa cambiare un font, analogamente alla sostituzione di un rullo nella vecchia macchina da scrivere. E' la filosofia di fondo del WYSIWYG, \begin_inset Quotes eld \end_inset What you see is what you get \begin_inset Quotes erd \end_inset ( \begin_inset Quotes eld \end_inset Quello che vedi è quello che ottieni \begin_inset Quotes erd \end_inset ). Sfortunatamente, questo modello spesso finisce per diventare \begin_inset Quotes eld \end_inset What you see is all you get \begin_inset Quotes erd \end_inset ( \begin_inset Quotes eld \end_inset Quello che vedi è tutto quello che ottieni \begin_inset Quotes erd \end_inset ). \end_layout \begin_layout Standard Ecco dove LyX differisce da tutti gli altri word processor. Non dovete alambiccarvi circa la posizione che occuperà un determinato carattere. Direte semplicemente a LyX quello che state facendo, e lui si prenderà cura di tutto il resto, seguendo l'insieme di regole definite da ciò che viene chiamato uno \emph on stile \emph default \begin_inset Foot status collapsed \begin_layout Plain Layout Per correttezza, va detto che la maggiorparte degli attuali pacchetti di tipo Office possiede una sorta di foglio di stile, che segue una metodologia smilare. La nostra esperienza, però, ci dice che tali funzionalità sono molto poco usate nella pratica. \end_layout \end_inset . Vediamo un piccolo esempio. \end_layout \begin_layout Standard Immaginiamo che stiate scrivendo una relazione. Volete cominciarla con una sezione chiamata \begin_inset Quotes eld \end_inset Introduzione \begin_inset Quotes erd \end_inset . Quindi, nel vostro word processor, entrate in qualunque menù che vi consenta di cambiare la dimensione del carattere, e ne selezionate una. Poi attivate il grassetto. Quindi, scrivete \begin_inset Quotes eld \end_inset 1. \begin_inset space ~ \end_inset \begin_inset space ~ \end_inset Introduzione \begin_inset Quotes erd \end_inset . Logicamente, se più tardi decidete che questa sezione appartiene ad un altro punto del documento, o se ne inserite un'altra prima, dovrete cambiare la numerazione; per essa, e per tutte quelle che seguono -- così come i rispettivi riferimenti nell'indice. \end_layout \begin_layout Standard In LyX, invece, fate clic sul menù a tendina posto nell'estremità sinistra della barra dei pulsanti, scegliete \family sans Sezione \family default , e scrivete \begin_inset Quotes eld \end_inset Introduzione \begin_inset Quotes erd \end_inset . \end_layout \begin_layout Standard Sì, è tutto qui. Se tagliate la sezione e la incollate in qualche altro punto, sarà automaticame nte ri-numerata -- ovunque essa sia. E se inserite dei riferimenti a quella sezione in modo corretto (aggiungendo le etichette per i riferimenti incrociati), LyX li aggiornerà automaticamente per tutto il documento, sì che voi non abbiate mai e poi a scriverli manualment e. \end_layout \begin_layout Standard Affrontiamo ora il problema della coerenza. Cinque giorni dopo, aprite nuovamente il vostro report e cominciate la Sezione 4. Ma vi eravate dimenticati di aver usato un font in grassetto a dimensione 18, quindi scrivete il titolo della Sezione 4 in un font diverso (diciamo a dimensione 16) rispetto a quello che avevate usato nella Sezione 1. Ebbene, questo problema in LyX non esiste assolutamente. E' il computer -- e non voi -- a farsi carico di questa sciocca contabilità in merito a quale dimensione di font si debba avere per quel determinato elemento. Del resto, è ciò per cui i computer sono stati creati. \end_layout \begin_layout Standard Vediamo un altro esempio. Immaginiamo che voi stiate scivendo un elenco. In altri word processor, l'elenco non è altro che un gruppo di tabulazioni e ritorni a capo. Siete obbligati a calcolare dove inserire l'etichetta di ogni elemento, quale essa deve essere, quante linee vuote inserire tra ogni elemento, e così via. In LyX, avete unicamente due preoccupazioni: di quale tipo d'elenco si tratta, e cosa volete metterci dentro. Tutto qui. \end_layout \begin_layout Standard Quindi, l'idea di base dietro a LyX è: specificate \emph on cosa \emph default state facendo, e non \emph on come \emph default farla. Il modello di LyX non è WYSIWYG, ma WYSIWYM, ossia \begin_inset Quotes eld \end_inset What You See Is What You \emph on Mean \emph default \begin_inset Quotes erd \end_inset ( \begin_inset Quotes eld \end_inset Ciò che vedi è ciò che intendi \begin_inset Quotes erd \end_inset ). E' un'idea potente, che semplifica moltissimo il meccanismo della scrittura di documenti. Peraltro, questo è anche il motivo per cui LyX non è così adatto alla creazione di poster e loghi: in questo caso -- e dal momento che non esistono elementi funzionali come paragrafi, sezioni, eccetera -- voi \emph on volete proprio \emph default specificare dove sono posizionate tutte le cose, e in modo esatto. Ciò non significa LyX sia privo di funzionalità interessanti, ma semplicemente che non è lo strumento adatto per quel mestiere. Non si spara alle zanzare con un cannone. \end_layout \begin_layout Subsection Differenze tra LyX e gli altri word processor \begin_inset OptArg status collapsed \begin_layout Plain Layout \begin_inset ERT status open \begin_layout Plain Layout \backslash texorpdfstring{ \end_layout \end_inset LyX \begin_inset ERT status open \begin_layout Plain Layout }{LyX} \end_layout \end_inset e altri word processor \end_layout \end_inset \end_layout \begin_layout Standard Ecco un elenco di cose che non troverete in LyX. \end_layout \begin_layout Itemize Il righello del documento. \end_layout \begin_layout Itemize Tabulazioni. \end_layout \begin_layout Itemize Spazio extra (cioè premere \family sans Enter \family default o \family sans Spazio \family default due o più volte). \end_layout \begin_layout Standard Le tabulazioni sono inutili in LyX; e idem dicasi per un righello, che mostri la posizione degli elementi sulla pagina. E' il programma a preoccuparsi di questo posizionamento: non voi. Lo stresso vale per lo spazio extra: LyX lo aggiunge dove è necessario, a seconda del contesto. Inizialmente, il fatto di non poter digitare due righe vuote di fila è cosa fastidiosa; ma avrà molto più senso, non appena comincerete a pensare in termini WYSIWYM. \end_layout \begin_layout Standard Ecco un elenco di cose che esistono in LyX, ma non sono utilizzate nel modo che vi aspettereste: \end_layout \begin_layout Itemize Controlli dell'indentazione. \end_layout \begin_layout Itemize Interruzioni di pagina. \end_layout \begin_layout Itemize Spaziatura tra le righe (singola, doppia, ecc.). \end_layout \begin_layout Itemize Spazio bianco, orizzontale e verticale. \end_layout \begin_layout Itemize Caratteri e dimensione degli stessi. \end_layout \begin_layout Itemize Formattazioni del carattere (grassetto, corsivo sottolineato, ecc.). \end_layout \begin_layout Standard Anche se tutte queste cose sono presenti, in genere non vi serviranno. LyX se ne occuperà al posto vostro, a seconda di quello che state facendo. Parti dif\SpecialChar \- fe\SpecialChar \- ren\SpecialChar \- ti del documento assumono automaticamente una differente dimensione e formattazione del carattere. Anche l'indentazione del paragrafo è dipendente dal contesto: paragrafi differenti posseggono indentazioni diverse. Lo stesso vale per le interruzioni di pagina, che sono gestite in modo automatico. In generale, lo spazio tra righe, parole, e paragrafi, è variabile, e gestito da LyX \begin_inset Foot status collapsed \begin_layout Plain Layout Esistono sistemi per personalizzare tutti questi spazi (solo alcuni di questi modi richiedono una conoscenza di LaTeX), sia per l'intero documento, che per specifiche porzioni di esso. Per i dettagli, vedi la \emph on Guida utente \emph default e/o il manuale delle \emph on Caratteristiche estese \emph default . \end_layout \end_inset . \end_layout \begin_layout Standard Infine, esistono alcuni aspetti in cui riteniamo che LyX (e LaTeX) sia superiore a molti word processor: \end_layout \begin_layout Itemize Sillabazione. \end_layout \begin_layout Itemize Liste di qualunque tipo. \end_layout \begin_layout Itemize Elementi matematici. \end_layout \begin_layout Itemize Tabelle. \end_layout \begin_layout Itemize Riferimenti incrociati. \end_layout \begin_layout Standard Certo, molti word processor moderni sono in grado di maneggiare simboli matematici, tabelle, e la sillabazione; e molti si sono spostati verso la filosofia della definizione degli stili e il concetto WYSIWYM. Sono però funzionalità implementate in tempi relativamente recenti, mentre LyX è costruito intorno al sistema di preparazione documentale LaTeX, che è in operativo da oltre 20 anni\SpecialChar \ldots{} e \emph on funziona \emph default . \end_layout \begin_layout Subsection Cos'è LaTeX? \end_layout \begin_layout Standard LaTeX è un sistema per la preparazione di documenti, progettato da Leslie Lamport nel 1985 \begin_inset Foot status collapsed \begin_layout Plain Layout La fonte di queste informazioni è \begin_inset Quotes eld \end_inset \emph on A Guide to LaTeX2e \emph default \begin_inset Quotes erd \end_inset , di Helmut Kopka e Patrick Daly, che ha una voce nella bibliografia della \emph on Guida utente \emph default . \end_layout \end_inset . E' stato implementato a partire da un linguaggio di composizione tipografica chiamato TeX, creato da Donald Knuth nel 1984. TeX legge una serie di comandi di composizione tipografica, scritti come sequenza di codice in un file ASCII, e li esegue. Molti \begin_inset Quotes eld \end_inset trucchi \begin_inset Quotes erd \end_inset impiegati dalle aziende editoriali furono modellati da Knuth come algoritmi com\SpecialChar \- pu\SpecialChar \- ta\SpecialChar \- zio\SpecialChar \- na\SpecialChar \- li, e incorporati in TeX: ecco perché i documenti prodotti con TeX hanno un'aspetto così eccellente. L'ouput di TeX è un documento portabile di tipo \emph on pdf \emph default , o un cosiddetto \begin_inset Quotes eld \end_inset file indipendente dalla periferica \begin_inset Quotes erd \end_inset in formato \emph on dvi \emph default . Il formato dvi viene spesso usato per la creazione di anteprime di stampa, e può essere poi convertito in altri formati come il PostScript. \end_layout \begin_layout Standard TeX non è soltanto un motore per la composizione tipografica: consente anche di definire le macro. In effetti, molti utenti di TeX utilizzano un pacchetto di macro che Knuth creò per nascondere molti dettagli tipografici. Qui è dove Leslie Lamport fa il suo ingresso nella nostra storia. Era alla ricerca di pacchetto macro che fosse orientato più all'utilizzatore che al tipografo, con un insieme di comandi in grado di comporre tipograficamen te (e in modo coerente) elementi quali le sezioni, le tabelle o le formule matematiche\SpecialChar \ldots{} Così nacque LaTeX. \end_layout \begin_layout Standard Parallelamente allo sviluppo e alla crescita di LaTeX, poi, altre persone realizzarono propri pacchetti macro per TeX, del tipo atto a creare presentazio ni o articoli per riviste di matematica e così via. Alcuni utilizzavano la struttura di TeX per raggiungere un risultato, mentre altri cominciarono a modificare LaTeX. Per testare e unificare questo caos, un team di LaTeX-isti cominciò a lavorare su LaTeX2e -- l'attuale versione di LaTeX -- nel corso dei tardi anni '80. Questa nuova versione di LaTeX dispone di istruzioni che forniscono un'interfac cia agevole da usare per i comandi di creazione delle macro di TeX, agevolano l'utilizzo di nuovi font, e così via. In effetti, LaTeX è un linguaggio alquanto voluminoso, anche se preso a sé stante. Utilizzatori di tutto il mondo hanno poi creato i propri componenti per LaTeX, che si aggiungono così a quelli standard. \end_layout \begin_layout Standard Esistono due metodi per estendere le potenzialità di LaTeX: classi e stili. Una \emph on classe \emph default è un set di macro LaTeX che descrive un nuovo tipo di documento, come un libro o un articolo. Esistono classi per presentazioni, articoli scientifici di fisica, di matematic a\SpecialChar \ldots{} molte università posseggono classi per il proprio formato di tesi! Lo \emph on stile \emph default differisce dalla classe per il fatto che non definisce un nuovo tipo di documento, ma un differente tipo di \emph on comportamento \emph default messo in atto da un qualunque documento. Per esempio, LyX controlla i margini delle pagine e l'interlinea usando due diversi file di stile, progettati per questo scopo. Esistono file di stile per una gran quantità di cose: stampare etichette o buste, cambiare il comportamento dell'indentazione, aggiungere nuovi font, manipolare gli elementi grafici, creare intestazioni di pagina fantasiose , personalizzare le bibliografie, modificare il posizionamento e l'aspetto delle note a piè di pagina o tabelle o figure, personalizzare gli elenchi, e così via. \end_layout \begin_layout Standard Riassumendo: \end_layout \begin_layout Description TeX: Un linguaggio di composizione tipografica con funzionalità macro. \end_layout \begin_layout Description LaTeX: Un pacchetto di macro costruito su TeX. \end_layout \begin_layout Description Classi: Descrizioni di un tipo di documento, usando LaTeX. \end_layout \begin_layout Description Stili: Modifica in determinata entità il comportamento di base di LaTeX \end_layout \begin_layout Description LyX: Word processor visuale di tipo WYSIWYM, che utilizza LaTeX per la sua composizione tipografica. \end_layout \begin_layout Standard In questa sezione abbiamo quindi cercato di spiegare le differenze tra LyX e gli altri word processor. In breve, la differenza è LaTeX. LyX -- utillizzando LaTeX come substrato -- vi aiuta a pensare maggiormente a ciò che scrivete, e con quali parole scriverlo. Il computer poi si occupa della forma con la quale il vostro testo deve apparire. \end_layout \begin_layout Section Destreggiarsi con la documentazione \end_layout \begin_layout Standard La documentazione è stata suddivisa su diversi files, per rispondere più facilmente alle vostre domande e descrivere tutte le funzionalità. Ognuno di questi files ha il proprio scopo, come specificato più sotto. Prima che vi addentriate in uno qualunque di essi, dovreste leggere per bene questo capitolo, perché contiene un sacco di informazioni e commenti utili: possono farvi risparmiare un po' di tempo. \end_layout \begin_layout Standard Lo sviluppo di LyX non si fermerà mai, si spera; quindi, alcuni documenti potrebbero essere incompleti o un po' datati, anche se cerchiamo di tenere il passo. I manuali (ma questo vale per tutto ciò che riguarda LyX) sono frutto del lavoro di un gruppo di volontari che hanno un \begin_inset Quotes eld \end_inset vero lavoro \begin_inset Quotes erd \end_inset , famiglie, piatti da lavare, spazzatura da vuotare, e così via. Se volete rendervi utili alla causa, assicuratevi di aver letto prima la Sezione \begin_inset space ~ \end_inset \begin_inset CommandInset ref LatexCommand ref reference "sec:Contrib" \end_inset , unitamente al resto di questo documento. \end_layout \begin_layout Standard Cortesemente, inoltre, rendeteci questo favore: se qualcosa in questi ma\SpecialChar \- nu\SpecialChar \- a\SpecialChar \- li vi lascia confusi, è poco chiaro, o è sbagliato, non esitate a comunicarcelo! Potete scrivere a coloro che attualmente gestiscono la do\SpecialChar \- cu\SpecialChar \- men\SpecialChar \- ta\SpecialChar \- zio\SpecialChar \- ne, all'indirizzo \begin_inset CommandInset href LatexCommand href target "lyx-docs@lists.lyx.org" type "mailto:" \end_inset . Se avete domande alle quali la documentazione non è riuscita a dare risposte chiare, e avete bisogno di un aiuto rapido, esiste una mailing list attiva che potete raggiungere all'indirizzo \begin_inset CommandInset href LatexCommand href target "lyx-users@lists.lyx.org" type "mailto:" \end_inset . \end_layout \begin_layout Subsection Il formato dei manuali \end_layout \begin_layout Standard Alcuni staranno leggendo i manuali dopo averli stampati. Altri, invece, li staranno leggendo direttamente dall'interno di LyX. Ci sono alcune differenze tra il file LyX e la versione stampata. Nel primo, anzitutto, il titolo è semplicemente in cima al documento, e non formattato in una pagina a sé stante come in alcune versioni stampate. Poi, non è pienamente visibile alcuna nota a piè di pagina, e l'Indice generale. Per aprire una nota a piè di pagina, che si presenta così: \begin_inset Graphics filename clipart/it_footnoteQt4.png scale 75 \end_inset , fate clic su di essa col tasto sinistro del mouse. Per l'Indice generale, cliccate sul box grigio, oppure sul menù Naviga (nel quale i contenuti vengono visualizzati in modo automatico). \end_layout \begin_layout Standard Nella versione stampata, tutti i riferimenti incrociati appaiono come numeri effettivi di capitoli, sezioni, sottosezioni, e così via. Nella versione \begin_inset Quotes eld \end_inset in linea \begin_inset Quotes erd \end_inset , invece, appaiono come box color grigio chiaro, analoghi a questo: \begin_inset Graphics filename clipart/it_referenceQt4.png scale 75 \end_inset . Se fate clic col tasto sinistro del mouse sul box, apparirà una finestra di dialogo contenente la lista di tutti i riferimenti incrociati del documento. Questo Manuale, \emph on Introduzione \emph default , ne ha solo due; il primo ha nome \begin_inset Quotes eld \end_inset sec:Contrib \begin_inset Quotes erd \end_inset . Per andare direttamente alla sezione referenziata, fate clic col tasto destro del mouse sul box, oppure sul bottone \family sans Vai \begin_inset space ~ \end_inset all'etichetta \family default nella finestra di dialogo sopra citata. Se volete tornare al puno in cui eravate, è semplice: fate clic sul pulsante \family sans Torna indietro \family default . \end_layout \begin_layout Standard Ora che abbiamo chiarito le differenze tra la versione stampata e quella \begin_inset Quotes eld \end_inset in linea \begin_inset Quotes erd \end_inset di questo file, possiamo cominciare ad analizzare il formato. Occasionalmente, noterete che alcune parole sono scritte con caratteri differenti: \end_layout \begin_layout Itemize \emph on Corsivo \emph default : viene usato per dare genericamente enfasi, per argomenti generici, per titoli di libri, per nomi di sezioni da altri manuali, e note dagli autori. \end_layout \begin_layout Itemize \family typewriter Monospazio \family default : è usato per i nomi di programmi e di file, per il codice LyX, e le funzioni. \end_layout \begin_layout Itemize \family sans Senza grazie \family default : viene usato per i menù, i bottoni, i nomi delle finestre di dialogo, ed i nomi dei tasti sulla tastiera. \end_layout \begin_layout Itemize \noun on Maiuscoletto \noun default : è usato per i nomi propri di persone. \end_layout \begin_layout Itemize \series bold Grassetto \series default : è usato per il codice LaTeX. \end_layout \begin_layout Standard In merito alle scorciatoie da tastiera per comandi e menù, verrete probabilmente rimandati alla sezione \emph on Scorciatoie da tastiera \emph default del manuale \begin_inset Quotes eld \end_inset \emph on Caratteristiche estese \emph default \begin_inset Quotes erd \end_inset (il file \family typewriter Extended.lyx \family default ). Quando è necessario fare riferimento a tasti specifici, useremo questa notazione: \end_layout \begin_layout Itemize \begin_inset Quotes eld \end_inset \family sans C- \family default \begin_inset Quotes erd \end_inset indica il tasto \family sans Control-. \end_layout \begin_layout Itemize \begin_inset Quotes eld \end_inset \family sans S- \family default \begin_inset Quotes erd \end_inset indicata il tasto \family sans Shift-. \end_layout \begin_layout Itemize \begin_inset Quotes eld \end_inset \family sans M- \family default \begin_inset Quotes erd \end_inset indicata il tasto \family sans Meta- \family default , che in alcune tastiere è presente come tasto \family sans Alt-. \end_layout \begin_layout Itemize \begin_inset Quotes eld \end_inset \family sans F1 \family default \begin_inset Quotes erd \end_inset \SpecialChar \ldots{} \begin_inset Quotes eld \end_inset \family sans F12 \family default \begin_inset Quotes erd \end_inset sono i tasti funzione. \end_layout \begin_layout Itemize \begin_inset Quotes eld \end_inset \family sans Esc \family default \begin_inset Quotes erd \end_inset è il tasto di \emph on escape \emph default (uscita). \end_layout \begin_layout Itemize \begin_inset Quotes eld \end_inset \family sans Sinistra \family default \begin_inset Quotes erd \end_inset \begin_inset Quotes eld \end_inset \family sans Destra \family default \begin_inset Quotes erd \end_inset \begin_inset Quotes eld \end_inset \family sans Su \family default \begin_inset Quotes erd \end_inset \begin_inset Quotes eld \end_inset \family sans Giù \family default \begin_inset Quotes erd \end_inset : sono i tasti freccia, autoesplicativi. \end_layout \begin_layout Itemize \family sans \begin_inset Quotes eld \end_inset Insert \family default \begin_inset Quotes erd \end_inset \begin_inset Quotes eld \end_inset \family sans Canc \family default \begin_inset Quotes erd \end_inset \begin_inset Quotes eld \end_inset \family sans Inizio \family default \begin_inset Quotes erd \end_inset \begin_inset Quotes eld \end_inset \family sans Fine \family default \begin_inset Quotes erd \end_inset \begin_inset Quotes eld \end_inset \family sans PagSu \family default \begin_inset Quotes erd \end_inset \begin_inset Quotes eld \end_inset \family sans PagGiù \family default \begin_inset Quotes erd \end_inset : sono i sei tasti solitamente collocati al sopra dei tasti di movimentazione del cursore (tasti freccia). \begin_inset Quotes eld \end_inset \family sans PagSu \family default \begin_inset Quotes erd \end_inset and \begin_inset Quotes eld \end_inset \family sans PagGiù \family default \begin_inset Quotes erd \end_inset sono -- in alcune tastiere -- denominati \begin_inset Quotes eld \end_inset \family sans Precedente \family default \begin_inset Quotes erd \end_inset e \begin_inset Quotes eld \end_inset \family sans Seguente \family default \begin_inset Quotes erd \end_inset . \end_layout \begin_layout Itemize \family sans Return \family default e \family sans Invio \family default si riferiscono entrambi al medesimo tasto. Alcune tastiere usano indiefferentemente l'una o l'altra etichetta; e alcune hanno proprio due tasti separati. Siccome per LyX sono la stessa cosa, useremo \family sans Return \family default e \family sans Invio \family default indistintamente. \end_layout \begin_layout Standard Di tanto in tanto leggerete anche qualcosa come \begin_inset Quotes eld \end_inset (Vedi \emph on Caratteristiche estese \emph default ) \begin_inset Quotes erd \end_inset . Abbiamo fatto un elenco di tutte le possibili scorciatoie da tastiera nel manuale \begin_inset Quotes eld \end_inset \emph on Caratteristiche estese \emph default \begin_inset Quotes erd \end_inset , quindi controllate anche lì. Occorre notare che, nella comunità LyX, esistono due differenti modalità per mappare queste scorciatoie: lo stile \begin_inset Quotes eld \end_inset CUA \begin_inset Quotes erd \end_inset , che è il default, ed è più familiare per coloro che provengono dal mondo dei personal computer; e lo stile \begin_inset Quotes eld \end_inset emacs \begin_inset Quotes erd \end_inset , comune per coloro che sono cresciuti nell'ambiente Unix e con l'editor Emacs. Se non diversamente specificato, la mappatura citata nella documentazione è quella di default, \begin_inset Quotes eld \end_inset CUA \begin_inset Quotes erd \end_inset . Se amate Emacs, dovreste essere sufficientemente brillanti da leggere la documentazione e capire i legami, da voi stessi. \end_layout \begin_layout Subsection Unità di misura utilizzate nei Manuali \end_layout \begin_layout Standard La tabella \begin_inset space ~ \end_inset \begin_inset CommandInset ref LatexCommand ref reference "cap:Units-for-image" \end_inset mostra tutte le unitò di misura disponibili in LyX, e vi aiuterà a comprendere meglio quelle descritte in questa documentazione. \end_layout \begin_layout Standard \end_layout \begin_layout Standard \begin_inset Float table placement t wide false sideways false status collapsed \begin_layout Plain Layout \begin_inset Caption \begin_layout Plain Layout \begin_inset CommandInset label LatexCommand label name "cap:Units-for-image" \end_inset Unità \end_layout \end_inset \end_layout \begin_layout Plain Layout \begin_inset VSpace medskip \end_inset \end_layout \begin_layout Plain Layout \align center \begin_inset Tabular \begin_inset Text \begin_layout Plain Layout unità \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout nome/descrizione \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout mm \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout millimetro \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout cm \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout centimetro \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout in \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout pollice \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout pt \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout point (72.27 \begin_inset Formula $\,$ \end_inset pt = 1 \begin_inset Formula $\,$ \end_inset in) \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout pc \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout pica (1 \begin_inset Formula $\,$ \end_inset pc = 12 \begin_inset Formula $\,$ \end_inset pt) \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout sp \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout punto di scalatura (65536 \begin_inset Formula $\,$ \end_inset sp = 1 \begin_inset Formula $\,$ \end_inset pt) \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout bp \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout punto grande (72 \begin_inset Formula $\,$ \end_inset bp = 1 \begin_inset Formula $\,$ \end_inset in) \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout dd \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout didot (72 \begin_inset Formula $\,$ \end_inset dd \begin_inset Formula $\approx$ \end_inset 37.6 \begin_inset Formula $\,$ \end_inset mm) \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout cc \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout cicero (1 \begin_inset Formula $\,$ \end_inset cc = 12 \begin_inset Formula $\,$ \end_inset dd) \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout Scala% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % della larghezza immagine originale \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout testo% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % della larghezza del testo \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout col% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % della larghezza della colonna \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout pagina% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % della larghezza del foglio \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout linea% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % della larghezza della linea \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout txtaltt% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % dell'altezza del testo \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout pgalt% \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout % dell'altezza della pagina \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout ex \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout altezza della letera \emph on x \emph default nel font corrente \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout em \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout larghezza della lettera \emph on M \emph default nel font corrente \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout mu \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout unità matematica (1 \begin_inset Formula $\,$ \end_inset mu = 1/18 \begin_inset Formula $\,$ \end_inset em) \end_layout \end_inset \end_inset \end_layout \end_inset \end_layout \begin_layout Subsection I Manuali \end_layout \begin_layout Standard L'elenco a seguire illustra i contenuti di ciascun file della documentazione: \end_layout \begin_layout Description Introduzione Il presente documento. \end_layout \begin_layout Description Tutorial Se siete nuovi utenti di LyX, e non avete mai usato LaTeX prima d'ora, dovreste cominciare da qui. Quando anche aveste già usato LaTeX, dovreste ugualmente leggere il \emph on Tutoral \emph default , a partire dalla sezione \begin_inset Quotes eld \end_inset LyX per utilizzatori di LaTeX \begin_inset Quotes erd \end_inset (ma dare un'occhiata anche al resto del documento non fa comunque male). \end_layout \begin_layout Description Guida \begin_inset space ~ \end_inset utente E' la documentazione principale. Qui apprenderete la maggior parte delle funzionalità e caratteristiche di base di LyX. Si dà per scontato che voi abbiate letto il \emph on Tutorial \emph default . \end_layout \begin_layout Description Oggetti \begin_inset space ~ \end_inset incorporati Si tratta di un'estensione della \emph on Guida utente \emph default . Dettaglia l'uso di tabelle, figure, oggetti mobili, note, e box. Include anche molti trucchi, a cura dei \begin_inset Quotes eld \end_inset guru \begin_inset Quotes erd \end_inset di LaTeX. \end_layout \begin_layout Description Caratteristiche \begin_inset space ~ \end_inset estese Altra estensione della \emph on Guida utente \emph default . Approfondisce l'uso di comandi in codice sorgente LaTeX, di layout aggiuntivi, e di funzionalità \begin_inset Quotes eld \end_inset editing \begin_inset Quotes erd \end_inset per scopi particolari. \end_layout \begin_layout Description Personalizzazione E' un manuale sulle caratteristiche avanzate di LyX, e sulle modalità atte a personalizzare il comportamento generale del programma. Ci riferiamo ad aspetti quali le scorciatoie da tastiera, le opzioni internazio nali, ed i files di configurazione. \end_layout \begin_layout Description Configurazione \begin_inset space ~ \end_inset LaTeX Durante l'installazione, LyX controlla il vostro sistema. Questo file contiene tutte le informazioni reperite da LyX nel corso di questa verifica. Può esservi utile per accertare l'assenza di qualche elemento che ci piacerebbe fosse installato. \end_layout \begin_layout Standard Questi documenti riportano l'uno all'altro, quando necessario. Per esempio, la \emph on Guida utente \emph default contiene alcune informazioni sull'installazione e la personalizzazione, ma rimanda il lettore alla guida \emph on Personalizzazione \emph default per ulteriori informazioni. \end_layout \begin_layout Standard Ci teniamo a ribadire ancora un punto importante: \end_layout \begin_layout Standard \begin_inset VSpace bigskip \end_inset \end_layout \begin_layout Standard \align center Se usate LyX per la prima volta, leggete il \emph on Tutorial \emph default . Ora. \end_layout \begin_layout Standard \begin_inset VSpace bigskip \end_inset \end_layout \begin_layout Standard In caso contrario, rischiate di ostacolare voi stessi in modo interminabile. LyX fa tutto quello che si richiede da un elaboratore di testi, ma utilizza un approccio diverso da quello utilizzato nella maggior parte degli altri programmi. \end_layout \begin_layout Section \begin_inset CommandInset label LatexCommand label name "sec:Contrib" \end_inset Contribuire al progetto LyX \end_layout \begin_layout Subsection Contribuire a LyX \end_layout \begin_layout Standard LyX è scritto quasi interamente in C++ (l'importazione di LaTeX è scritta in Python). E' un progetto consistente, e di conseguenza non è privo di bachi, né immune da migliorie al codice sorgente. \end_layout \begin_layout Subsubsection Segnalare un errore \end_layout \begin_layout Standard Usando LyX, potreste notare un comportamento bizzarro, tale da essere considerat o un vero e prorio \begin_inset Quotes eld \end_inset buig \begin_inset Quotes erd \end_inset (errore). I \begin_inset Quotes eld \end_inset crash \begin_inset Quotes erd \end_inset , anche se rari, possono verificarsi. Il team LyX considera particolarmente critici i problemi all'interfaccia utente: le indicazioni più utili quindi sono quelle relative alle parti dell'interfaccia LyX che trovate confuse o poco chiare. \end_layout \begin_layout Standard LyX dispone di un sistema per la segnalazione di \begin_inset Quotes eld \end_inset bug \begin_inset Quotes erd \end_inset , raggiunigibile a \family typewriter \begin_inset Flex URL status collapsed \begin_layout Plain Layout http://bugzilla.lyx.org/ \end_layout \end_inset \family default . Dovreste controllare il \begin_inset Quotes eld \end_inset bug tracker \begin_inset Quotes erd \end_inset prima di segnalare qualunque errore, perché potrebbe essere già stato segnalato da qualcuno prima di voi. Alternativamente -- o anche per segnalare un commento su un \begin_inset Quotes eld \end_inset bug \begin_inset Quotes erd \end_inset esistente -- potete scrivere alla mailing list degli sviluppatori, \begin_inset CommandInset href LatexCommand href target "lyx-devel@lists.lyx.org" type "mailto:" \end_inset . Gli archivi di questa lista sono raggiungibili dal link indicato sul sito principale di LyX, \family typewriter \begin_inset Flex URL status collapsed \begin_layout Plain Layout http://www.lyx.org/ \end_layout \end_inset . \end_layout \begin_layout Standard Per essere utile, una segnalazione di errore dovrebbe contenere almeno l'indicaz ione dela versione di LyX che presenta il problema. Sono preferibili descrizioni accurate e dettagliate: il tempo perso dagli sviluppatori per individuare con esattezza un errore, infatti, non può essere impiegato per implementare ulteriori migliorie del programma. Non dimenticate di citare: il sistema operativo sul quale gira il vostro LyX; quale versione di tale sistema operativo possedete; e, se è rilevante, le versioni dei programmi esterni che LyX utilizza. Se è un problema relativo alla compilazione o alla configurazione, includete il file \family typewriter config.log \family default , e indicate quale compilatore usate. \end_layout \begin_layout Subsubsection Contribuire alle riparazioni e a nuove funzionalità \end_layout \begin_layout Standard Se avete effettuato delle modifiche al codice sorgente di LyX che a vostro avviso dovrebbero diventare parte del programma distribuito, mandatele alla mailing list degli sviluppatori sopra citata, in formato diff (formato \begin_inset Quotes eld \end_inset unfied \begin_inset Quotes erd \end_inset ), unitamente ad un registro delle modifiche ( \begin_inset Quotes eld \end_inset change log \begin_inset Quotes erd \end_inset ), ed una descrizione di ciò che la vostra \begin_inset Quotes eld \end_inset patch \begin_inset Quotes erd \end_inset è in grado di fare. \end_layout \begin_layout Subsection Contribuire alla Documentazione \end_layout \begin_layout Standard La documentazione di LyX è voluminosa; il programma però è in costante sviluppo, e nuove funzioni vengono aggiunte ad ogni \begin_inset Quotes eld \end_inset release \begin_inset Quotes erd \end_inset . Magari potreste accorgervi che alcuni documenti necessitano di migliorie. Questa sezione descrive cosa fare se trovate un errore, o avete alcuni suggerimenti atti a migliorare la documentazione. \end_layout \begin_layout Subsubsection Comunicare errori nei Manuali \end_layout \begin_layout Standard Se trovate problemi con la documentazione, mandate un messaggio alla mailing list \begin_inset CommandInset href LatexCommand href target "lyx-docs@lists.lyx.org" type "mailto:" \end_inset . Il team che mantiene la documentazione implementerà i necessari aggiustamenti. \end_layout \begin_layout Subsubsection Partecipare al Team della Documentazione \end_layout \begin_layout Standard Il Progetto Documentazione LyX -- come qualunque cosa nell'ambito del progetto LyX -- ha sempre bisogno di aiuto. Se vuoi contribuire, devi: \end_layout \begin_layout Enumerate Anzitutto, reperire il codice sorgente LyX più recente da \begin_inset Newline newline \end_inset \begin_inset Flex URL status collapsed \begin_layout Plain Layout http://www.lyx.org/trac/browser/lyx-devel/trunk/lib/doc \end_layout \end_inset \begin_inset Newline newline \end_inset All'interno di questa directory trovate il file \family typewriter DocStyle.lyx \family default . Leggetelo: è il foglio di stile per la documentazione. \end_layout \begin_layout Enumerate Poi, leggete la \emph on Guida Utente \emph default ed il \emph on Tutorial \emph default . \begin_inset Newline newline \end_inset Lo scopo di questo esercizio è quello di fornirvi le idee giuste. La \emph on Guida Utente \emph default ed il \emph on Tutorial \emph default , infatti, rappresentano quasi certamente i Manuali più aggiornati di tutta la Documentazione. Dovrebbero permettervi di estrapolare alcune idee in merito a come vogliamo sia l'aspetto e la sostanza dei Manuali. \end_layout \begin_layout Enumerate Quindi, contattate il team all'indirizzo \begin_inset Newline newline \end_inset \begin_inset CommandInset href LatexCommand href target "lyx-docs@lists.lyx.org" type "mailto:" \end_inset \family typewriter \begin_inset Newline newline \end_inset \family default per discutere le modifiche che vorreste apportare, ed avere le relative informazioni di ritorno dal team. \end_layout \begin_layout Standard Le modifiche che vorreste poter apportare possono spaziare da migliorie alla chiarezza del testo, a complete ristrutturazioni della documentazione. Qualunque tipo di miglioramento è comunque ben accetto. \end_layout \end_body \end_document