lyx_mirror/lib/doc/it/Intro.lyx
Uwe Stöhr 99b6cd7572 Intro.lyx: - bugzilla is dead
- some cleanups

the other language versions of Intro.lyx are coming later

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@29999 a592a061-630c-0410-9148-cb99ea01b6c8
2009-06-06 15:26:49 +00:00

2373 lines
49 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#LyX 1.6.3 created this file. For more info see http://www.lyx.org/
\lyxformat 345
\begin_document
\begin_header
\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
\use_default_options false
\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
<lyxtabular version="3" rows="20" columns="2">
<features>
<column alignment="center" valignment="top" width="0">
<column alignment="center" valignment="top" width="0">
<row>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
unità
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
nome/descrizione
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
mm
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
millimetro
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
cm
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
centimetro
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
in
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
pollice
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
pt
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\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
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
pc
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\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
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
sp
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\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
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
bp
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\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
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
dd
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\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
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
cc
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\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
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
Scala%
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
% della larghezza immagine originale
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
testo%
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
% della larghezza del testo
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
col%
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
% della larghezza della colonna
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
pagina%
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
% della larghezza del foglio
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
linea%
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
% della larghezza della linea
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
txtaltt%
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
% dell'altezza del testo
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
pgalt%
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
% dell'altezza della pagina
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
ex
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
altezza della letera
\emph on
x
\emph default
nel font corrente
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
em
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
larghezza della lettera
\emph on
M
\emph default
nel font corrente
\end_layout
\end_inset
</cell>
</row>
<row>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
\begin_inset Text
\begin_layout Plain Layout
mu
\end_layout
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
\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
</cell>
</row>
</lyxtabular>
\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
Contribuire al progetto LyX
\begin_inset CommandInset label
LatexCommand label
name "sec:Contrib"
\end_inset
\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://www.lyx.org/trac/wiki/BugTrackerHome
\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