lyx_mirror/lib/doc/it/Intro.lyx
Scott Kostyshak 9aaa6c73d5 Intro.lyx: remove a "short title"
This short title removed a spaced, and when taking a look we decided
that the advantages of removing it (simplicity and consistency)
outweigh the benefits of having a shorter entry in the table of
contents and PDF bookmarks.

(cherry picked from commit 9c748a04702a979786f39bb7fa367e3945b51ae3)
2019-02-15 12:19:29 -05:00

2457 lines
51 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 2.3 created this file. For more info see http://www.lyx.org/
\lyxformat 544
\begin_document
\begin_header
\save_transient_properties true
\origin /systemlyxdir/doc/it/
\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
% 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} }
\end_preamble
\use_default_options false
\maintain_unincluded_children false
\language italian
\language_package default
\inputencoding iso8859-1
\fontencoding global
\font_roman "palatino" "default"
\font_sans "helvet" "default"
\font_typewriter "courier" "default"
\font_math "auto" "auto"
\font_default_family default
\use_non_tex_fonts false
\font_sc true
\font_osf false
\font_sf_scale 100 100
\font_tt_scale 100 100
\use_microtype false
\use_dash_ligatures false
\graphics default
\default_output_format pdf2
\output_sync 0
\bibtex_command default
\index_command 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 true
\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"
\papersize a4paper
\use_geometry false
\use_package amsmath 1
\use_package amssymb 1
\use_package cancel 1
\use_package esint 1
\use_package mathdots 1
\use_package mathtools 1
\use_package mhchem 1
\use_package stackrel 1
\use_package stmaryrd 1
\use_package undertilde 1
\cite_engine basic
\cite_engine_type default
\biblio_style plain
\use_bibtopic false
\use_indices false
\paperorientation portrait
\suppress_date false
\justification true
\use_refstyle 0
\use_minted 0
\index Indice
\shortcut idx
\color #008000
\end_index
\secnumdepth 3
\tocdepth 2
\paragraph_separation indent
\paragraph_indentation default
\is_math_indent 0
\math_numbering_side default
\quotes_style english
\dynamic_quotes 0
\papercolumns 1
\papersides 1
\paperpagestyle default
\tracking_changes false
\output_changes false
\html_math_output 0
\html_css_as_file 0
\html_be_strict false
\end_header
\begin_body
\begin_layout Title
Introduzione a \SpecialChar LyX
\end_layout
\begin_layout Author
a cura del Team di \SpecialChar LyX
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\noindent
Se avete commenti o correzioni, inviateli cortesemente alla mailing list
della documentazione di \SpecialChar LyX
:
\begin_inset CommandInset href
LatexCommand href
target "lyx-docs@lists.lyx.org"
literal "false"
\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 \SpecialChar LyX
\end_layout
\begin_layout Subsection
Che cosa è \SpecialChar LyX
?
\end_layout
\begin_layout Standard
\SpecialChar LyX
è un sistema per la preparazione di documenti.
Eccelle nel consentirvi 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 softhyphen
me\SpecialChar softhyphen
ra\SpecialChar softhyphen
zio\SpecialChar softhyphen
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 \SpecialChar 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 \SpecialChar 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 \SpecialChar LyX
, quest'ultimo può concentrarsi unicamente
sul contenuto del suo scritto.
\end_layout
\begin_layout Standard
Buona parte dell'iniziale sfida nell'apprendere \SpecialChar 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 softhyphen
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
\lang english
What you see is what you get
\lang italian
\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
\lang english
What you see is all you get
\lang italian
\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 \SpecialChar LyX
differisce da tutti gli altri word processor.
Non dovete lambiccarvi il cervello circa la posizione che occuperà un determina
to carattere.
Direte semplicemente a \SpecialChar 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 \SpecialChar 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), \SpecialChar LyX
li aggiornerà automaticamente
per tutto il documento, sì che voi non abbiate mai e poi mai a scriverli
manualmente.
\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 \SpecialChar 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 scrivendo 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 \SpecialChar 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 \SpecialChar LyX
è: specificate
\emph on
cosa
\emph default
state facendo, e non
\emph on
come
\emph default
farla.
Il modello di \SpecialChar LyX
non è WYSIWYG, ma WYSIWYM, ossia
\begin_inset Quotes eld
\end_inset
\lang english
What You See Is What You
\emph on
Mean
\emph default
\lang italian
\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 \SpecialChar 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 che \SpecialChar 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 \SpecialChar LyX
e gli altri word processor
\end_layout
\begin_layout Standard
Ecco un elenco di cose che non troverete in \SpecialChar 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 \SpecialChar 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: \SpecialChar 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 \SpecialChar 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.
\SpecialChar LyX
se ne occuperà al posto vostro, a seconda di quello che state facendo.
Parti dif\SpecialChar softhyphen
fe\SpecialChar softhyphen
ren\SpecialChar softhyphen
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 stresso 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 \SpecialChar 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 \SpecialChar 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 \SpecialChar LyX
(e \SpecialChar 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
\SpecialChar LyX
è costruito intorno al sistema di preparazione documentale \SpecialChar LaTeX
, che è operativo
da oltre 20 anni\SpecialChar ldots
e
\emph on
funziona
\emph default
.
\end_layout
\begin_layout Subsection
Cos'è \SpecialChar LaTeX
?
\end_layout
\begin_layout Standard
\SpecialChar 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 \SpecialChar 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 \SpecialChar TeX
, creato da Donald Knuth nel 1984.
\SpecialChar 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 softhyphen
pu\SpecialChar softhyphen
ta\SpecialChar softhyphen
zio\SpecialChar softhyphen
na\SpecialChar softhyphen
li, e incorporati in \SpecialChar TeX
: ecco perché i documenti prodotti con
\SpecialChar TeX
hanno un aspetto così eccellente.
L'ouput di \SpecialChar 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
\SpecialChar TeX
non è soltanto un motore per la composizione tipografica: consente anche
di definire le macro.
In effetti, molti utenti di \SpecialChar 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 \SpecialChar LaTeX
.
\end_layout
\begin_layout Standard
Parallelamente allo sviluppo e alla crescita di \SpecialChar LaTeX
, poi, altre persone realizzaron
o propri pacchetti macro per \SpecialChar TeX
, del tipo atto a creare presentazioni o articoli
per riviste di matematica e così via.
Alcuni utilizzavano la struttura di \SpecialChar TeX
per raggiungere un risultato, mentre
altri cominciarono a modificare \SpecialChar LaTeX
.
Per testare e unificare questo caos, un team di \SpecialChar LaTeX
-isti cominciò a lavorare
su \SpecialChar LaTeX2e
l'attuale versione di \SpecialChar LaTeX
nel corso dei tardi anni '80.
Questa nuova versione di \SpecialChar LaTeX
dispone di istruzioni che forniscono un'interfaccia
agevole da usare per i comandi di creazione delle macro di \SpecialChar TeX
, agevolano
l'utilizzo di nuovi font, e così via.
In effetti, \SpecialChar LaTeX
è un linguaggio alquanto voluminoso, anche se preso a sé stante.
Utilizzatori di tutto il mondo hanno poi creato i propri componenti per
\SpecialChar LaTeX
, che si aggiungono così a quelli standard.
\end_layout
\begin_layout Standard
Esistono due metodi per estendere le potenzialità di \SpecialChar LaTeX
: classi e stili.
Una
\emph on
classe
\emph default
è un set di macro \SpecialChar 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, \SpecialChar 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
\SpecialChar TeX
: Un linguaggio di composizione tipografica con funzionalità macro.
\end_layout
\begin_layout Description
\SpecialChar LaTeX
: Un pacchetto di macro costruito su \SpecialChar TeX
.
\end_layout
\begin_layout Description
Classi: Descrizioni di un tipo di documento, usando \SpecialChar LaTeX
.
\end_layout
\begin_layout Description
Stili: Modifica in determinata entità il comportamento di base di \SpecialChar LaTeX
\end_layout
\begin_layout Description
\SpecialChar LyX
: Word processor visuale di tipo WYSIWYM, che utilizza \SpecialChar LaTeX
per la sua composizione
tipografica.
\end_layout
\begin_layout Standard
In questa sezione abbiamo quindi cercato di spiegare le differenze tra \SpecialChar LyX
e gli altri word processor.
In breve, la differenza è \SpecialChar LaTeX
.
\SpecialChar LyX
utilizzando \SpecialChar 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 \SpecialChar LyX
non si fermerà mai, si spera; quindi, alcuni documenti potrebber
o essere incompleti o un po' datati, anche se cerchiamo di tenere il passo.
I manuali (ma questo vale per tutto ciò che riguarda \SpecialChar 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 softhyphen
nu\SpecialChar softhyphen
a\SpecialChar softhyphen
li
vi lascia confusi, è poco chiaro, o è sbagliato, non esitate a comunicarcelo!
Potete scrivere a coloro che attualmente gestiscono la do\SpecialChar softhyphen
cu\SpecialChar softhyphen
men\SpecialChar softhyphen
ta\SpecialChar softhyphen
zio\SpecialChar softhyphen
ne,
all'indirizzo
\begin_inset CommandInset href
LatexCommand href
target "lyx-docs@lists.lyx.org"
type "mailto:"
literal "false"
\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:"
literal "false"
\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 \SpecialChar LyX
.
Ci sono alcune differenze tra il file \SpecialChar 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/footnote.png
scale 95
\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/reference.png
scale 95
\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 punto 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 \SpecialChar 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 \SpecialChar 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
Additional.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 indifferentemente l'una o l'altra etichetta; e alcune
hanno proprio due tasti separati.
Siccome per \SpecialChar 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à \SpecialChar 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 \SpecialChar 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 open
\begin_layout Plain Layout
\begin_inset Caption Standard
\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 tabularvalignment="middle">
<column alignment="center" valignment="top">
<column alignment="center" valignment="top">
<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 \SpecialChar LyX
, e non avete mai usato \SpecialChar LaTeX
prima d'ora,
dovreste cominciare da qui.
Quando anche aveste già usato \SpecialChar LaTeX
, dovreste ugualmente leggere il
\emph on
Tutorial
\emph default
, a partire dalla sezione
\begin_inset Quotes eld
\end_inset
\SpecialChar LyX
per utilizzatori di \SpecialChar 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 \SpecialChar 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 \SpecialChar 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 \SpecialChar 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 \SpecialChar 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
\SpecialChar LaTeX
Durante l'installazione, \SpecialChar LyX
controlla il vostro sistema.
Questo file contiene tutte le informazioni reperite da \SpecialChar 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 \SpecialChar 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.
\SpecialChar 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 \SpecialChar LyX
\begin_inset CommandInset label
LatexCommand label
name "sec:Contrib"
\end_inset
\end_layout
\begin_layout Subsection
Contribuire a \SpecialChar LyX
\end_layout
\begin_layout Standard
\SpecialChar LyX
è scritto quasi interamente in C++ (l'importazione di \SpecialChar 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 \SpecialChar LyX
, potreste notare un comportamento bizzarro, tale da essere considerato
un vero e proprio
\begin_inset Quotes eld
\end_inset
bug
\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 \SpecialChar LyX
considera particolarmente critici i problemi all'interfaccia utente:
le indicazioni più utili quindi sono quelle relative alle parti dell'interfacci
a \SpecialChar LyX
che trovate confuse o poco chiare.
\end_layout
\begin_layout Standard
\SpecialChar LyX
dispone di un sistema per la segnalazione di
\begin_inset Quotes eld
\end_inset
bug
\begin_inset Quotes erd
\end_inset
, raggiungibile a
\begin_inset CommandInset href
LatexCommand href
target "https://www.lyx.org/trac/wiki/BugTrackerHome"
\end_inset
.
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:"
literal "false"
\end_inset
.
Gli archivi di questa lista sono raggiungibili dal link indicato sul sito
principale di \SpecialChar LyX
,
\family typewriter
\family default
\begin_inset CommandInset href
LatexCommand href
target "http://www.lyx.org"
\end_inset
\family typewriter
.
\end_layout
\begin_layout Standard
Per essere utile, una segnalazione di errore dovrebbe contenere almeno l'indicaz
ione della versione di \SpecialChar 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
\SpecialChar LyX
; quale versione di tale sistema operativo possedete; e, se è rilevante,
le versioni dei programmi esterni che \SpecialChar 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 \SpecialChar 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
unified
\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 \SpecialChar 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:"
literal "false"
\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 \SpecialChar LyX
come qualunque cosa nell'ambito del progetto
\SpecialChar LyX
ha sempre bisogno di aiuto.
Se vuoi contribuire, devi:
\end_layout
\begin_layout Enumerate
Anzitutto, reperire il codice sorgente \SpecialChar LyX
più recente da
\begin_inset Newline newline
\end_inset
\begin_inset CommandInset href
LatexCommand href
target "https://www.lyx.org/trac/browser/lyxgit/lib/doc?rev=master"
\end_inset
\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:"
literal "false"
\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