# Usare &appname;

## Guida rapida

Come impostazione predefinita &appname; si avvia con una collezione di libri vuota. Per lavorare ad un qualunque tipo di collezione va creata usando il menu File Nuovo o il pulsante sulla barra degli strumenti. Le collezioni sono formate da alcuni tra i campi più comuni, ma si possono aggiungere, modificare o cancellare per adattarli alle nostre necessità.

Si possono aggiungere nuovi elementi usando l'editor degli elementi. La voce di menu Collezione Nuovo elemento aprirà l'editor degli elementi per un elemento vuoto, pronto per essere modificato. L'editor degli elementi può inoltre essere aperto usando la voce di menu Impostazioni Mostra editor degli elementi. Dopo aver immesso i valori per l'elemento si può salvarlo nella collezione usando il pulsante Salva elemento nella finestra di dialogo dell'editor degli elementi, che rimarrà aperto nel caso in cui si vorrà continuare ad aggiungere elementi alla collezione. Dopo aver salvato un elemento nella collezione lo si può modificare facendovi clic nella finestra principale. Se l'editor degli elementi non è già aperto fare doppio clic su di un elemento per aprire l'editor degli elementi e cominciare a modificarlo.

Se si vuole includere un immagine all'elemento si può usare il selettore standard di file &kde; facendo clic sul pulsante Seleziona immagine... nell'editor degli elementi, o trascinare un immagine direttamente dal gestore di file o dal browser nell'editor degli elementi.

Quando si seleziona un elemento il suo contenuto viene visualizzato, formattato, nella vista degli elementi. Si può cambiare il modello usato per la visualizzazione degli elementi nella finestra di dialogo configurazione.

Gli elementi della collezione vengono raggruppati quando condividono un certo valore in un dato campo, come l'autore o il regista. Si cambiare il campo secondo il quale gli elementi vengono raggruppati dal menu a tendina nella barra degli strumenti, o mediante la voce di menu Impostazioni Selezione di gruppo.

Si può usare il filtro rapido nella barra degli strumenti per limitare rapidamente gli elementi visibili a quelli che contengono la parola inserita. Il filtro è utile anche quando si vuole trovare rapidamente uno specifico elemento. Si inserisce il titolo o qualche altra parola che identifichi univocamente un elemento e nella vista per colonne verrà mostrato solo l'elemento che corrisponde al filtro immesso. La barra di stato mostra quanti elementi ci sono in totale nella nostra collezione, e quanti sono quelli filtrati.

## Uso generale

La finestra principale ha tre aree principali, ognuna delle quali mostra informazioni sulla collezione in modo diverso. La vista principale è detta vista per colonne che si trova nella parte superiore destra, e dove si può visualizzare ogni valore di ogni campo. Nella parte sinistra tre schede contengono vista di gruppo, usata per mostrare gli elementi in gruppi con struttura ad albero, vista filtrata che viene usata per visualizzare solo gli elementi che soddisfano alcuni criteri, e vista per prestiti dove sono elencati solo gli elementi in prestito. Infine la vista degli elementi visualizza i dati di un singolo elemento impaginati, o una vista a icone di un gruppo di elementi, e si trova nella parte inferiore destra.

La finestra principale di &appname;
La finestra principale di &appname;

### Vista delle colonne

Tutti i campi della collezione possono essere visualizzati nella vista per colonne anche se probabilmente non risulterà comodo visualizzare qui i campi Paragrafo, Immagine, e tabella. Facendo clic destro sull'intestazione di colonna si apre un menu per selezionare i campi visibili. Le colonne possono essere ridimensionate e riordinate a piacimento e i cambiamenti saranno salvati per le volte successive.

### Vista di gruppo

Nella vista di gruppo gli elementi sono raggruppati in uno schema ad albero per ogni campo per cui è stato impostato ammetti il raggruppamento. Il numero di elementi in ogni gruppo viene mostrato accanto al nome del gruppo. I gruppi possono essere espansi o ridotti con un clic sul segno più o un doppio clic sul nome. Espandi e riduci tutti sono opzioni disponibili tramite il menu contestuale apribile con un clic destro. Lo schema ad albero può essere ordinato sia per il nome del gruppo che per il numero di elementi contenuti facendo clic sull'intestazione. Un gruppo può anche essere usato come filtro per la vista per colonne facendo clic destro sul nome del gruppo.

Quando più di un campo della collezione ha l'opzione Formatta come nome un ulteriore gruppo viene aggiunto per combinarli in uno pseudo gruppo Persone.

Se un elemento non ha nessun valore nel campo usato per raggruppare viene posto nel gruppo (Vuoto) che usa una cartella rossa.

### Vista filtrata

Se vengono salvati filtri per la collezione viene attivata la vista filtrata. Quando gli elementi vengono aggiunti o modificati questi verranno verificati con i criteri del filtro e aggiunti o rimossi a seconda dei casi. Il filtro può essere modificato facendo doppio clic sul nome del filtro per aprire la finestra del filtro avanzato. Il clic destro da inoltre la possibilità di cancellare un filtro.

La vista filtrata
La vista filtrata

### Vista per prestiti

Quando gli elementi vengono dati in prestito la vista per prestiti viene aggiunta alla finestra cosicché gli oggetti prestati possano essere monitorati. I prestiti sono controllati singolarmente, quindi facendo clic destro su un elemento si ha un opzione per modificare il prestito usando la finestra dei prestiti.

La vista per prestiti
La vista per prestiti

### Vista degli elementi

Una versione impaginata dei valori dell'elemento viene mostrata nella vista degli elementi. Per l'impaginazione e la parte grafica vengono usati modelli. Modelli diversi a seconda del tipo di collezione possono essere specificati nella finestra di dialogo configurazione, come caratteri e colori personalizzati.

Tutti i modelli predefiniti rispettano il carattere e colore impostati ma altri modelli personalizzati potrebbero non farlo. I modelli predefiniti rendono inoltre i campi &URL; attivi, e facendovi clic verranno aperti con l'applicazione predefinita &kde;. Quando si esporta in &HTML; per esportare i singoli file degli elementi viene usato il modello corrente.

### Barra di stato

La barra di stato è usata per mostrare cosa &appname; sta facendo. Include inoltre un conteggio totale degli elementi della collezione, e se c'è un filtro attivo quanti elemento sono attualmente visibili.

## Modificare gli elementi

L'editor degli elementi viene usato per aggiungere e modificare gli elementi della collezione. Facendo doppio clic su di un elemento, sia nella vista di gruppo che nella vista per colonne, viene aperto l' editor degli elementi per quell'elemento. Nuovi elementi si possono creare usando il menuCollezione, l'apposita icona della barra degli strumenti o il pulsante nell'editor degli elementi stesso.

Chiudendo l'editor degli elementi dopo aver effettuato cambiamenti senza averli però salvati apparirà un messaggio di avvertimento. I campi sono raggruppati per categoria e appaiono nello stesso ordine della finestra di dialogo campi. Possono anche essere riordinati.

L'editor degli elementi
L'editor degli elementi

Facendo clic sull'etichetta di un campo &URL; verrà aperto il collegamento usando l'applicazione predefinita &kde;. Il pulsante per aprire un percorso &URL; accanto alla casella di testo aprirà la finestra standard &kde; Apri file, ma il campo non è limitato ai file locali.

Per i campi Immagine il pulsante Seleziona immagine... apre la finestra &kde; per selezionare il file. Le immagini vengono salvate nella collezione nel formato originale, ed una versione scalata viene mostrata nell'editor degli elementi. L'immagine può essere rimossa utilizzando il pulsante Pulisci. Così facendo le immagini verranno rimosse dalla collezione.

L'editor degli elementi per i campi immagine
L'editor degli elementi per i campi immagine

L'editor permette di usare anche il trascinamento. Trascinare un immagine da un gestore di file o da una finestra del browser ha lo stesso effetto di selezionarla tramite il selettore di file. Trascinare un immagine dall'editor in una finestra del gestore di file &konqueror; salverà l'immagine in quella cartella.

In modo predefinito le immagini vengono salvate nel file della collezione, per tenere tutto nello stesso posto. Tuttavia troppe immagini causeranno un rallentamento significativo di &appname; e un file di dimensioni molto grandi. In alternativa &appname; può salvare le immagini separatamente, sia nella cartella `$`KDEHOME`/share/apps/tellico/data/` che in una cartella allo stesso percorso del file dati. In questo caso caricamento e salvataggio dei dati sono molto più veloci, ma i file dati non saranno più portabili o archiviabili. Si può sempre creare un file dati contenente tutte le informazioni usando la voce di menu FileEsporta Esporta in Zip....

I campi Tabella sono composti inizialmente di cinque righe, ma spostando il cursore sull'ultima riga ne verrà automaticamente aggiunta un'altra. Per le tabelle di più colonne solo la prima viene usata per il raggruppamento e la formattazione.

L'editor degli elementi per i campi tabella
L'editor degli elementi per i campi tabella

### Modificare più elementi

Più elementi possono essere modificati insieme selezionandone più di uno sia nella vista di gruppo che nella vista per colonne. Se vengono selezionati più elementi i campi che hanno lo stesso valore in tutti gli elementi saranno abilitati alle modifiche, mentre quelli differenti saranno disabilitati. Ci sono inoltre delle caselle alla destra di ogni campo per stabilire se il campo è abilitato o meno, come mostrato nella schermata sotto.

Solo i campi abilitati saranno modificati al salvataggio dell'elemento, rendendo le modifiche su larga scala molto più semplici. Ad esempio per impostare il supporto di tutti gli elementi di una collezione di video assicurarsi che il campo Supporto sia abilitato, cambiare il valore a DVD e quindi salvare gli elementi. Solo il campo Supporto verrà modificato, lasciando inalterati tutti gli altri valori degli elementi.

L'editor degli elementi per elementi multipli
L'editor degli elementiper elementi multipli

### Aggiornare i dati di un elemento

Gli elementi possono essere aggiornati automaticamente interrogando le fonti disponibili per il tipo di collezione che si sta usando, il che è molto utile per combinare informazioni ottenute da fonti diverse. Ad esempio si può aggiungere un film alla collezione usando i servizi web Amazon.com, e poi aggiornare l'elemento dall'Internet Movie Database.

Solo i campi vuoti vengono aggiornati salvo diversamente specificato nellaconfigurazione di quella fonte. Per gli script esterni va specificato il campo di aggiornamento nelle opzioni della fonte.

L'aggiornamento degli elementi può essere effettuato con il clic destro sull'elemento stesso o usando la voce di menu Collezione Aggiorna elemento.

## Modificare i campi

La finestra campi della collezione permette di aggiungere nuovi campi alla collezione, di modificare quelli che ci sono già o di cancellarli del tutto.

La finestra di dialogo campi della collezione di &appname;
La finestra di dialogo campi della collezione di &appname;

### Lista dei campi

Nella parte sinistra della finestra c'è una lista dei campi presenti. I campi modificati sono mostrati in grassetto inclinato. I pulsanti sotto la lista servono ad aggiungere o cancellare i campi, e le frecce servono a cambiarne l'ordine. L'ordine dei campi nella lista è importante in quanto l'editor degli elementi usa questo ordine per la disposizione dei campi nella finestra. Per ogni categoria i campi saranno ordinati da destra a sinistra seguendo l'ordine della lista dall'alto verso il basso.

### Proprietà dei campi

Un campo viene definito da titolo, categoria, descrizione e volendo un valore predefinito o alcuni valori permessi. Il titolo viene usato ovunque per riferirsi a quel campo nell'interfaccia utente. Nell'editor degli elementi è usato per suggerire il tipo di valore da inserire. La vista per colonne lo usa come intestazione di colonna. I tipi di campo sono spiegati in dettaglio nella sezione Tipi di campo. La descrizione viene usata come suggerimento nell'editor degli elementi e può aiutare a capire in cosa consiste il contenuto del campo. Inoltre, per i campi con valore derivato, un modello di valore viene usato per formattare il valore del campo. Il valore predefinito viene aggiunto automaticamente quando si crea un nuovo elemento. La lista dei valori permessi per i campi Scelta deve essere divisa da un punto e virgola.

I nuovi campi possono essere di qualsiasi tipo, ma nel cambiare un tipo di campo esistente la scelta è ristretta ad alcuni campi compatibili secondo la tabella seguente:

#### Cambiamenti del tipo di campo permessi

Tipo attuale | Nuovo tipo permesso
--- | ---
Testo semplice | Testo semplice, Paragrafo, Numero, &URL;,Tabella
Paragrafo | Testo semplice, Paragrafo
Scelta | Testo semplice, Paragrafo, Scelta, Numero, &URL;, Tabella
Spunta | Testo semplice, Paragrafo, Spunta, Numero, &URL;, Tabella
Numero | Testo semplice, Paragrafo, Numero, &URL;,Tabella
&URL; | Testo semplice, Paragrafo, Numero, &URL;,Tabella
Data | Testo semplice, Data
Tabella | Testo semplice, Paragrafo, Tabella
Immagine | Immagine
Voto | Scelta, Voto

### Formattazione dei campi

&appname; fornisce alcune funzioni di formattazione automatica. La più semplice di queste è il maiuscolo automatico che rende maiuscola ogni parola tranne gli articoli. La formattazione come titolo sposta alcuni articoli dall'inizio alla fine del campo. Ad esempio "The Return of the King" diventa "Return of the King, The". Gli articoli nel titolo sono configurabili. Infine la formattazione come nome dividerà la stringa cercando di fare in modo che il cognome preceda il nome. I prefissi e suffissi nominali sono configurabili. Inoltre il gruppo speciale Persone usa tutti i campi formattati come nome, anche se l'impostazione globale è disattivata.

Tutti i tipi di formattazione automatica possono essere disabilitati cambiando le impostazioni globali nella finestra di configurazione. Globalmente il minuscolo automatico è un'opzione distinta dalla formattazione, e quindi un titolo può essere auto formattato senza essere cambiato in maiuscolo. Non tutti i tipi di campo permettono la formattazione automatica.

#### Esempi di formattazione

Tipo di formato | Valore del campo | Maiuscolo automatico | Formattazione automatica | Maiuscolo & formattazione automatici
--- | --- | --- | --- | ---
Titolo | the return of the king | The Return of the King | return of the king, the | Return of the King, The
Nome | tom swift, jr. | Tom Swift, Jr. | swift, jr., tom | Swift, Jr., Tom

### Opzioni dei campi

I campi hanno inoltre tre opzioni generali. Se il completamento automatico viene abilitato, &appname; raccoglie i valori degli elementi inseriti per quel campo, e l'editor degli elementi fornisce il completamento automatico, usando le impostazioni standard di &kde;. Non tutti i tipi di campo permettono il completamento automatico. È anche necessario impostare se un campo ammetta valori multipli o possa essere usato per raggruppare gli elementi. Un punto e virgola viene usato per separare i valori multipli quando si inserisce un elemento.

Per ragioni di efficienza è meglio non abilitare l'auto completamento se non se ne ha bisogno per un dato campo. Maggiori sono i campi con la funzione di completamento automatico più tempo impiegherà &appname; per caricare il file.

## Filtrare gli elementi

La finestra di dialogo filtro avanzato permette di limitare gli elementi visibili nella vista per colonne a quelli che soddisfano una o più regole di filtraggio. Il filtro può essere usato per trovare gli elementi che soddisfano tutti i criteri o anche quelli che ne soddisfano solo alcuni. La finestra di dialogo filtro avanzato è utile anche per effettuare ricerche avanzata nella collezione.

La finestra di dialogo filtro avanzato di &appname;
La finestra di dialogo filtro avanzato di &appname;

Ogni riga contiene una singola regola di filtraggio. Selezionare il campo interessato nella prima casella della riga, e il valore da filtrare al centro. Le regole possono essere valide per valori che contengano una certa parola, o che siano esattamente uguali. Anche un'espressione regolare può essere usata per cercare corrispondenze negli elementi, e in tal caso il pulsante Modifica... diventa attivo per modificare l'espressione se &kregexpeditor; è installato nel computer. Infine la parola o stringa da confrontare sarà inserita nella casella.

In un filtro possono essere usate fino ad un massimo di otto regole. I pulsanti Più e Meno servono per aggiungere o rimuovere regole.

I filtri possono essere salvati cosicché gli elementi che soddisfano i criteri di un dato filtro siano raggruppati nella vista filtrata. La visualizzazione è dinamica, quindi quando gli elementi vengono aggiunti o modificati i valori saranno automaticamente aggiornati. Per salvare un filtro digitare un nome nella casella di testo e premere il pulsante Salva filtro.

I filtri salvati possono essere modificati facendo clic col tasto destro sul nome del filtro nella vista filtrata e selezionando Modifica filtro. La finestra di dialogo filtro avanzato verrà aperta e si potrà cambiare il nome del filtro o le sue regole.

Per trovare tutti i libri di fantascienza che non si è letto scegliere Verifica tutti i criteri seguenti, scegliere Genere contiene fantascienza come prima regola e Letto non contiene true. (Per i campi Spunta il valore interno è true).

Per trovare i libri di Bujold o Weber, selezionare Verifica almeno uno dei criteri seguenti, impostare la prima regola come Autore contiene Bujold e la seconda come Autore contiene Weber.

## Generare resoconti

&appname; è in grado di generare vari resoconti della collezione. La finestra di dialogo resoconto cercherà tutti i modelli &xslt; nella cartella di installazione e in `$`KDEHOME`/share/apps/tellico/report-templates/`. Così facendo quando si crea un nuovo modello questo viene trovato automaticamente e reso disponibile come opzione nella finestra di dialogo resoconto. Alcuni resoconti complessi potrebbero richiedere un po' di tempo per essere generati se la collezione è grande.

I modelli installati con &appname; includono una lista di soli titoli, la vista predefinita per colonne, una vista di gruppo, un sommario di tutti i gruppi e i valori più frequenti in essi, un registro prestiti e un ampio resoconto con immagini di copertina. Selezionare il modello desiderato e fare premere il pulsante Genera. Ogni resoconto può anche essere stampato o salvato come file &HTML;.

La finestra di dialogo resoconto di &appname;
La finestra di dialogo resoconto di &appname;

Gli elementi inclusi nel resoconto saranno limitati a quelli visibili nella vista per colonne, quindi se è attivo un filtro verrà usato anche per la finestra resoconto.

## Tener traccia dei prestiti

&appname; può tener traccia del prestito di ogni elemento della collezione. La finestra di dialogo prestiti può essere aperta usando la voce di menu Presta o facendo clic destro su un elemento. Più elementi possono essere prestati contemporaneamente.

Il nome della persona a cui abbiamo prestato può essere inserito direttamente o prelevato dalla rubrica predefinita &kde; premendo il pulsante accanto alla casella per inserire il nome. Si presume che la data di prestito sia quella odierna ma può essere cambiata. La data di restituzione è opzionale, e altre note sul prestito possono essere inserite.

Se viene inserita una data di restituzione e &appname; è stato compilato con il supporto a libkcal si può aggiungere un promemoria al calendario predefinito di &kde; come cosa da fare. Si può usare &korganizer; per visualizzare il promemoria.

Quando un elemento viene prestato il valore del campo Prestato viene impostato a true. Se nella collezione non ci sono campi prestato ne viene aggiunto uno in automatico. Non modificare i valori del campo direttamente! Gli elementi in prestito possono essere impostati come restituiti usando la voce di menu o mediante clic destro nella vista per prestiti.

La finestra vista per prestiti di &appname;
La finestra vista dei prestiti di &appname;

## Suggerimenti generali

La lista dei suggerimenti contenuta in "suggerimento del giorno" per &appname;

Se un libro ha più di un autore, dovresti separare i diversi nomi usando un punto e virgola, cosicché Tellico possa suddividerli ed usarli separatamente.Qualsiasi campo che ammetta valori multipli riconoscerà i diversi valori allo stesso modo, identificando il punto e virgola (;) come separatore.

Puoi cambiare i campi che vengono visualizzati facendo clic con il tasto destro sull'intestazione della colonna.

Puoi aggiungere, modificare e cambiare i campi della collezione usando la finestra campi della collezione. I tasti freccia sotto i campi possono essere usati per cambiare la posizione all'interno della lista, il che modificherà la posizione nell'editor degli elementi.

Se vuoi filtrare dei contenuti secondo un campo Spunta dovresti usare un valore "true".Se, per esempio, vuoi che un filtro ti mostri solo i libri di fantascienza che non hai ancora letto seleziona Verifica tutti i criteri seguenti, imposta la prima regola in modo da avere "Genere" "contiene" "Fantascienza" (senza virgolette) e la seconda regola: "Letto" "non contiene" "true" (senza virgolette).

Se nel filtro rapido inserisci un carattere non alfanumerico il testo verrà interpretato come una espressione regolare. Per mostrare solo i libri di Vidal o Weber, per esempio, digita "vidal|weber" (senza virgolette) nella casella del filtro rapido.

Puoi modificare più di un elemento alla volta tenendo premuto il tasto &Shift; o il tasto &Ctrl; e selezionando più elementi.

Puoi convertire una collezione di libri in una bibliografia che può essere poi esportata in formato Bibtex o Bibtexml.

Se più di un campo contiene un nome allora viene aggiunto un gruppo alla collezione chiamato "persone", permettendo così, per esempio, di stampare un elenco di autori ed editori.

Puoi cambiare l'aspetto delle pagine stampate modificando il file `tellico-printing.xsl`. Il file genera l' &HTML;, mentre il &CSS; interno gestisce cose come i caratteri, i margini, eccetera.

Fare doppio clic su un elemento apre l'editor degli elementi.

Puoi aggiungere ad un qualsiasi campo Paragrafo dei tag &HTML; come <b>grassetto</b> o <i>corsivo</i>.

Nella vista per colonne basta premere un pulsante sulla tastiera per saltare al primo elemento che comincia con quella lettera.

Puoi usare i valori derivati per combinare più campi singoli in un unico campo derivato. Per fare ciò seleziona il valore derivato e usa una descrizione del tipo "`Valore: %{campoa}%{campob}`" in cui %{ } viene sostituito con il valore appropriato per il campo. Questa operazione può tornare utile per raggruppare più valori in un unico campo, &eg; per un raggruppamento migliore, e per combinare campi di tipi diversi senza influire sull'ordinamento. Ad esempio un campo numerico seguito da un sotto-campo testuale.