# Manuale di &kbibtex;

## Prefazione

### Requisiti

Per eseguire &kbibtex; devono essere installati nel tuo sistema i seguenti componenti:

- le librerie &kf5-full;.

- &latex;, un programma di composizione tipografica di alta qualità. Se lavori in un sistema di tipo Unix, allora avrai quasi sicuramente bisogno del pacchetto &texlive; (o &tetex; nei sistemi più vecchi): è una dipendenza opzionale, ma senza di esso &kbibtex; avrebbe funzionalità molto limitate.

- bibtex2html, una raccolta di strumenti per convertire dal formato &bibtex; ad &HTML;: aumenta le funzionalità di anteprima delle voci di &kbibtex; (dipendenza opzionale).

La maggior parte di questi programmi, come &kbibtex; stesso, potrebbero già essere inclusi nella tua distribuzione &Linux;; consulta quindi la documentazione della tua distribuzione, oppure dai un'occhiata all'interno del &CD; o DVD d'installazione per aggiungere nel tuo computer i pacchetti necessari.

### Pubblico

Questo manuale è destinato a chiunque, indipendentemente dall'esperienza maturata con &latex;, &kde;, &kbibtex; oppure con &Linux;.

Gli utenti esperti probabilmente non leggeranno questo manuale, ma tutti i suggerimenti su come migliorare la documentazione saranno tenuti considerazione. Qualora tu volessi collaborare al progetto o alla sua documentazione, consulta per favore la pagina web di &kbibtex;.

## Introduzione

### Informazioni su &kbibtex;

&kbibtex; è un ambiente integrato per creare e modificare bibliografie in formato &bibtex;. &kbibtex; ti permette di usare tutte le funzionalità di &bibtex; in un'interfaccia grafica, fornendoti anche un accesso facile, immediato e personalizzabile alle bibliografie, sia online che locali. Ti dà la possibilità di compiere operazioni quali il completamento delle voci, la compilazione, l'anteprima e la ricerca.

#### Informazioni su &bibtex;

&bibtex; e il suo formato di file sono stati creati da Oren Patashnik e Leslie Lamport nel 1985 per il sistema di composizione tipografica &latex; Lamport86.

È un formato basato sui caratteri, così può essere utilizzato da qualsiasi programma (anche se utilizza l'insieme di caratteri accentati di &tex;). È basato sui campi (tag), e, dato che &bibtex; ignora i campi sconosciuti, è espandibile. È probabilmente il formato più comune per le bibliografie su internet.

&bibtex; usa file di stile, una lista di citazioni di &latex; e una base di dati &bibtex; per creare un file &latex; che elenchi i riferimenti citati. L'idea è quella di utilizzare i file di stile per creare automaticamente la copia finale in un qualsiasi formato giornalistico.

Un esempio di voce del database di &bibtex;:

    @article{PAM_doi:10.1007/BF00048294,
            author = {Streitenberger, P. and Knott, John F.},
            doi = {10.1007/BF00048294},
            issn = {1573-2673},
            journal = {{International Journal of Fracture}},
            number = {3},
            pages = {R49},
            publisher = {Springer},
            title = {{The calculation of crack opening area and crack opening volume from stress intensity factors}},
            url = {http://dx.doi.org/10.1007/BF00048294},
            volume = {76},
            x-fetchedfrom = {SpringerLink},
            year = {1995}
    }

#### &kbibtex; ed editor &latex;

Il codice generato da &latex; può essere modificato da una gran varietà di strumenti, dai piccoli editor di testo alle potenti suite visuali. Per una comparazione tra i vari editor di &latex; fai riferimento a questa pagina.

&kbibtex; fornisce un'immediata integrazione con &kile; e &lyx;, anche se può essere utilizzato senza problemi insieme ad un qualsiasi editor &latex;.

### Funzionalità principali di &kbibtex;

&kbibtex; ti consente di svolgere le seguenti operazioni:

- Inserire un preambolo, che definisce come il testo speciale deve essere formattato nella bibliografia, usando l'elemento del menu Elemento Nuovo elemento Nuovo preambolo, oppure usando la barra degli strumenti principale.

- Scegliere una voce da codificare, usando l'elemento Codifica nella finestra Salva come..., oppure il pannello delle impostazioni dei file.

- Inserire dei commenti, che non vengono presi in considerazione da &bibtex;, usando l'elemento del menu Elemento Nuovo elemento Nuovo commento, oppure usando la barra degli strumenti principale.

- Fare l'anteprima e salvare voci bibliografiche in vari formati (fonte (&bibtex;), fonte (RIS), Wikipedia, standard (&XML;/XSLT), di fantasia (&XML;/XSLT), e solo sommario (&XML;/XSLT)), usando il pannello di anteprima dei riferimenti. Ulteriori stili di anteprima sono disponibili dopo l'installazione di bibtex2html.

- Ricercare dati in voci bibliografiche nei database online, usando il pannello delle ricerche online.

- Visualizzare le risorse (come i file) locali o remote (online) collegatenelle voci &bibtex;, usando il pannello di anteprima del documento.

- Trovare e sistemare le voci duplicate nelle bibliografie, usando l'elemento del menu Modifica Trova duplicati, oppure la barra degli strumenti principale.

- Importare la libreria di Zotero, per mezzo del Pannello di Zotero.

## Guida rapida

### Scrivere un file bibliografico per principianti

Dopo il primo avvio &kbibtex; si propone come editor predefinito di formati bibliografici; ti raccomandiamo di fare in modo che lo sia.

Se per qualche ragione decidessi di riconsiderare questa decisione, devi rimuovere le stringhe con la sotto-stringa `kbibtex` dal file `mimeapps.list`, che si trova nella cartella `.local/share/applications`.

A questo punto ti troverai di fronte ad una finestra somigliante a questa:

La finestra di &kbibtex; dopo il primo avvio La finestra di &kbibtex; dopo il primo avvio

Per iniziare una nuova bibliografia fai clic sul pulsanteNuovo che si trova sul pannello a destra, oppure sul pulsante Nuovo che è sulla barra degli strumenti, o in alternativa scegli l'elemento del menu &Ctrl;N File Nuovo.

Ora è il momento di aggiungere qualche voce.

Gli utenti di &kbibtex; hanno due possibilità per aggiungere una nuova voce: possono usare il pannello delle ricerche online per cercare delle voci online, oppure possono scrivere il codice a mano.

Proviamo ad aggiungere una voce manualmente.

1. Scegli Elemento Nuovo elemento Nuova voce dal menu di &kbibtex;: si dovrebbe aprire la finestra Modifica elemento.

   la finestra di modifica degli elementi di &kbibtex; la finestra di modifica degli elementi di &kbibtex;

2. Scegli Libro dal menu a discesa Tipo:.

3. Inserisci `Lamport86` nel campo Id:.

   L'Id viene usato per citare la voce bibliografica nel documento principale.

4. Ora vai nella scheda Titolo, ed inserisci `LaTeX: A Document Preparation System` nella casella di testo Titolo:.

5. Vai nella scheda Autore/Editore, fai clic sul pulsante Aggiungi e digita `Lamport, Leslie`.

6. Vai poi nella finestra Pubblicazione e scrivi `1986` nella casella di testo Anno:, e `Addison-Wesley` nella casella di testo Editore:.

7. Premi OK.

8. Seleziona l'elemento del menu &Ctrl;S File Salva per salvare il file bibliografia come `example.bib` nella cartella dei documenti ancora da scrivere.

### Uso della bibliografia nei documenti &latex;

Al momento, per usare la bibliografia nei documenti devi aggiungere i seguenti comandi nei file &latex; (questi comandi si trovano in genere alla fine del documento, nella sezione Riferimenti):

    \bibliography{foo}
    \bibliographystyle{plain}

Qui `foo` è il nome del file `bib` creato con &kbibtex;, mentre plain è il nome dello stile bibliografico.

Ci sono molti stili bibliografici specifici; consulta quindi il tuo editore per scegliere quello migliore, e comunque cerca sempre quello che meglio si adatta ai tuoi scopi.

Qui sotto c'è una lista di alcuni degli stili generici ovunque disponibili:

plain

- stile normale, elencato in ordine alfabetico ed etichettato numericamente

unsrt

- uguale a plain, tranne per il fatto che le voci appaiono in ordine di citazione

alpha

- uguale a plain, eccetto che gli identificatori delle voci sono usati

abbrv

- uguale a plain, ma usa abbreviazioni per il nome, i nomi dei mesi ed i nomi delle riviste

Adesso puoi usare le funzionalità del tuo editor &latex; (consulta a questo proposito la documentazione dell'editor stesso) o puoi semplicemente inserire il seguente codice in un generico editor di testo, salvando quindi il file con l'estensione `tex`.

    \documentclass{article}
     \begin{document}
     \bibliographystyle{plain}% Scegli uno stile bibliografico
     File di testo con riferimento (vedi~\cite{Lamport86}).
     \bibliography{example}
     \end{document}

Dato che il nostro proposito è quello di fare un test, questo file si chiamerà `example.tex`.

Salva questo file nella stessa cartella di `example.bib`.

Ora che hai le basi per creare un documento, devi avviare sia latex che bibtex per elaborarlo.

Per prima cosa devi avviare latex (per creare un file foo.aux, che viene letto da bibtex). Poi avvia una prima volta bibtex, in modo da creare un file `bbl` con alcune delle citazioni, quindi avvia nuovamente latex: questo per far sì che i riferimenti incrociati tra il file di testo e la bibliografia siano corrette. Potresti avviare nuovamente bibtex e latex sul file per essere sicuro che i riferimenti incrociati siano corretti. Però attenzione: l'aggiunta o la cancellazione di citazioni e sorgenti richiederà un nuovo avvio di bibtex.

I comandi seguenti possono essere usati per compilare il documento dalla console:

    latex example
    bibtex example
    latex example
    latex example

Se stai usando una shell &latex; avanzata, come &kile; or &lyx;, non hai bisogno di avviare questi comandi da un emulatore console per vedere i risultati: puoi usare una scorciatoia (&Alt;6 in &kile;), o un pulsante sulla barra degli strumenti.

Ora puoi vedere i risultati: un file &DVI; o uno &PDF; (il formato dipende dalla configurazione) salvato nella stessa cartella dei file sorgente.

Congratulazioni! Hai appena creato il tuo primo documento con una bibliografia &bibtex;.

## Interfaccia di &kbibtex;

### I pannelli di &kbibtex;

Le principali funzionalità di &kbibtex; sono disponibili attraverso i suoi nove pannelli. È possibile riorganizzare questi pannelli, o anche staccarli dalla finestra principale: basta fare clic con il &LMB; sulla testata del pannello stesso, e quindi trascinarlo in una nuova posizione.

Puoi rendere i pannelli di &kbibtex; visibili oppure nasconderli, usando il sotto-menu Impostazioni Mostra Pannelli: è sufficiente spuntare l'elemento del pannello per renderlo visibile, oppure non spuntarlo per nasconderlo.

#### Pannello Lista dei documenti

Il pannello Lista dei documenti permette di spostarsi tra le bibliografie aperte (scheda Apri file), aprire un documento usato di recente (scheda Usati di recente), aprire le proprie bibliografie principali (scheda Preferiti), oppure sfogliare il filesystem per trovare le bibliografie (scheda Sfoglia il filesystem).

Per aggiungere un file bibliografico nei preferiti selezionalo in una qualsiasi scheda (tranne preferiti), e facci clic sopra con il &RMB;. A questo punto premi Aggiungi ai preferiti. Per rimuovere invece la bibliografia dai preferiti devi invece selezionarla nella scheda Preferiti, farci clic sopra con il &RMB; e scegliere Rimuovi dai preferiti.

Pannello Lista dei documenti Pannello Lista dei documenti

#### Pannello Lista dei valori

Il pannello Lista dei valori può essere usato per visualizzare facilmente le statistiche sull'uso dei valori nei campi delle voci, e per la modifica in lotti di questi valori.

La casella a cascata superiore viene utilizzata per scegliere il campo della bibliografia usato per visualizzare dati statistici (un conteggio delle voci con lo stesso valore nel campo) nella lista in basso.

Puoi fare clic con il &RMB; su una voce nella lista in basso per aver accesso alle funzionalità di modifica in lotti: da qui Sostituisci tutte le occorrenze oppure Elimina tutte le occorrenze del valore, Cerca i valori selezionati usando la barra del filtro, Aggiungi valore alle voci selezionate, Sostituisci valore delle voci selezionate oppure Rimuovi valore dalle voci selezionate (qualche voce dovrebbe però prima essere selezionata nella lista delle voci principali).

Pannello Lista dei valori Pannello Lista dei valori

#### Pannello delle statistiche

Il pannello Statistiche è progettato per visualizzare una lista globale delle informazioni statistiche in merito all'attuale bibliografia.

Pannello delle statistiche Pannello delle statistiche

#### Pannello anteprima riferimento

Il pannello Anteprima riferimento viene utilizzato per creare l'anteprima della voce bibliografica attualmente selezionata, che viene salvata poi in formato &HTML;.

Pannello anteprima riferimento Pannello anteprima riferimento

È possible fare un'anteprima di un riferimento in formato sorgente (&bibtex;), sorgente (RIS), Wikipedia, standard (&XML;/XSLT), di fantasia (&XML;/XSLT) e solo sommario (&XML;/XSLT). Le opzioni aggiuntive diventano disponibili quando viene installato bibtex2html.

Quando fai clic sugli elementi di un riferimento in un formato basato su &XML;, &kbibtex; applicherà il corrispondente filtraggio nella lista bibliografica.

Fai clic sul pulsante Apri per aprire il riferimento nel browser internet predefinito. Il pulsante Salva come &HTML; può essere usato per salvare il riferimento in &HTML;, in modo da renderlo disponibile per ulteriori usi nel tuo sito web.

Puoi fare clic con il &RMB; sul pannello per selezionare Ricarica e aggiornare il riferimento in base agli ultimi cambi nelle voci.

#### Pannello delle impostazioni del file

Il pannello Impostazioni file può essere utilizzato per definire alcuni parametri del file `bib` dell'attuale bibliografia.

Pannello delle impostazioni del file Pannello delle impostazioni del file

È possibile selezionare Codifica, Separatori di stringa, Marcatura del commento, Cassa tipografica delle parole chiave e Formattazione dei nomi di persona.

Come comportamento predefinito &bibtex; convertirà in minuscolo tutte le parole intermedie nelle frasi. Spunta la casella Proteggi titoli per proteggere il maiuscolo/minuscolo nei titoli delle voci.

#### Pannello delle ricerche online

Il pannello Ricerche online può essere usato per eseguire una ricerca nelle basi di dati bibliografici su internet, per trovare tutte le voci necessarie o per ottenere l'insieme completo dei dati di una voce inserita manualmente.

Pannello delle ricerche online Pannello delle ricerche online

Le voci possono essere ricercate per Testo libero, Titolo, Autore, oppure per Anno. Il numero dei risultati mostrati nel pannello Risultati di ricerca può essere regolato usando la casella numerica Numero di risultati.

Fai clic sul pulsante Usa voce per riempire il campo dei criteri di ricerca della voce bibliografica attualmente selezionata. In questo modo puoi completare le voci esistenti con dati provenienti da basi di dati su internet. Il pulsante Cerca può essere utilizzato per iniziare la ricerca.

&kbibtex; può eseguire ricerche nelle più popolari basi di dati in internet. Per selezionare l'insieme di queste basi di dati da usare per la ricerca devi andare nella scheda Motori, oppure puoi fare clic con il &LMB; sul collegamento Cambia che si trova nella scheda Termini di ricerca.

Per visitare l'homepage del database su internet fai clic con il &RMB; nella sua voce che si trova nella scheda Motori, e seleziona quindi Vai alla pagina iniziale.

#### Pannello di Zotero

Il pannello di Zotero può essere utilizzato per importare le librerie di Zotero.

Zotero usa estensioni specializzate del browser per salvare le voci bibliografiche presenti nelle pagine Internet. I dati sono immagazzinati in un database online, che è quindi raggiungibile da ogni luogo. La documentazione di Zotero può essere trovata qui.

Pannello di Zotero Pannello di Zotero

Per iniziare la procedura guidata di autorizzazione a Zotero fai clic sul pulsante Ottieni credenziali che si trova nella scheda Credenziali. Segui quindi le istruzioni, così da permettere a &kbibtex; di accedere alla libreria di Zotero.

Per accedere alle voci di libreria, fai doppio clic sull'oggetto corrispondente nelle pagine Raccolte oppure Etichette. Le voci che soddisfano i criteri scelti saranno mostrate nel pannello dei risultati di ricerca.

#### Pannello dei risultati di ricerca

Il pannello Risultati di ricerca viene usato per gestire i risultati di ricerca che sono stati ottenuti usando il pannello delle ricerche online.

Pannello dei risultati di ricerca Pannello dei risultati di ricerca

Fai clic sul pulsante Importa per importare i risultati di ricerca attualmente selezionati nella bibliografia.

Per accedere ad altre azioni per i risultati attualmente selezionati devi farci clic sopra con il &RMB;. Dal menu che si apre puoi revisionare i risultati (voce Visualizza elemento) o copiarli per poterli incollare altrove in formato &bibtex; con &Ctrl;V (voce Copia).

#### Pannello editor elemento

Il pannello Editor elemento può essere utilizzato per modificare l'elemento della bibliografia attualmente selezionato.

Pannello editor elemento Pannello editor elemento

Fai clic sul pulsante per selezionare un identificatore suggerito per l'elemento.

Inserisci i rispettivi dati nell'editor dei campi. Usando la casella a cascata a sinistra della casella di testo puoi cambiare il formato del campo di dati, scegliendo tra testo, riferimento o codice sorgente.

Fai clic sul pulsante Opzioni per aprire una casella a cascata con due elementi.

L'elemento Mostra tutti i campi può essere usato per mostrare o nascondere anche i campi vuoti dell'elemento corrente.

È possibile spostarsi tra i vari campi usando il tasto della tastiera. Il secondo elemento del menu, La tabulazione si posiziona solo sui campi modificabili, può essere attivato o disattivato in questo senso.

Fai clic sul pulsante Controlla con &bibtex; per aver un'anteprima di come verrebbero mostrate le voci modificate nel file &PDF; compilato.

Controlla l'opzione Applica automaticamente le modifiche se vuoi applicare automaticamente i cambiamenti alle voci, senza dover fare clic sul pulsante Applica.

Fai clic sul pulsante Azzera per annullare tutti i cambiamenti.

#### Pannello di Anteprima del documento

Il panello Anteprima documento può essere utilizzato per avere un'anteprima delle pagine o dei documenti collegati alla voce bibliografica attualmente selezionata.

Come comportamento predefinito, il pannello Anteprima documento può essere aperto usando la scorciatoia &Ctrl;&Shift;D.

Pannello di anteprima del documento Pannello di anteprima del documento

Fai clic sul pulsante per passare dalla visualizzazione dei soli file locali ad una che includa anche quelli remoti.

Fai clic sul pulsante per aprire la pagina o il documento nell'applicazione esterna predefinita.

La casella a cascata degli indirizzi può essere usata per passare dalle pagine ai documenti.

### Le barre degli strumenti di &kbibtex;

&kbibtex; dispone di due barre degli strumenti completamente personalizzabili, che sono localizzate nella parte superiore della sua finestra.

Maggiori informazioni sulla personalizzazione delle barre degli strumenti possono essere trovate nell'apposita sezione del manuale dei fondamenti di &kde;. Qui sotto viene data una breve descrizione dei pulsanti predefiniti delle barre degli strumenti di &kbibtex;.

#### La barra degli strumenti principale

La barra degli strumenti principale La barra degli strumenti principale

La barra degli strumenti predefinita di &kbibtex;.

- Nuovo: crea una nuova bibliografia.

- Apri: apre la generica finestra Apri/Salva di &kde; per aprire e modificare una bibliografia esistente.

- Chiudi: chiude l'attuale bibliografia attiva.

- Salva: salva l'attuale bibliografia attiva.

- Salva come: permette di salvare l'attuale documento bibliografico aperto con un nuovo nome, usando la generica finestra Apri/Salva di &kde;.

- Nuovo elemento: permette di creare nell'attuale documento nuove voci, commenti, preamboli, oppure delle macro.

- Trova duplicati: trova e corregge elementi duplicati nell'attuale bibliografia.

- Invia a &lyx;/&kile;: invia a &lyx; o &kile; un riferimento alla voce bibliografica attualmente selezionata. Maggiori informazioni possono essere trovate nel corrispondente capitolo di questo manuale.

#### Barra del filtro

Barra del filtro Barra del filtro

La barra del filtro predefinita di &kbibtex;.

Il modo più semplice per navigare nelle grandi bibliografie è quello di usare la barra del Filtro: &kbibtex; filtrerà la lista visualizzata a seconda dei dati in ingresso. Sei stai cercando elementi di cui non conosci l'esatta posizione nella lista, ti basta semplicemente inserire alcune lettere nella casella di testo Filtro.

Noterai dei cambiamenti alla lista non appena immetti alcune lettere: infatti, più lettere inserite, più la lista si riduce. Questo filtraggio viene applicato immediatamente, non appena cominci a digitare.

Se guardi nella parte destra della barra degli strumenti del Filtro noterai due menu a cascata, che sono stati progettati per creare dei criteri di filtraggio adatti alle tue esigenze. Il primo menu a cascata viene usato per definire la modalità di abbinamento (qualsiasi parola, ogni parola oppure la frase esatta). Il secondo serve per definire i campi in cui si deve applicare il filtraggio. Puoi scegliere qualsiasi campo, oppure, se lavori su grandi bibliografie, selezionare un solo campo per restringere la lista dei risultati.

Ci sono ancora due pulsanti su questa barra:

- Includi i file &PDF; nella ricerca a tutto testo: ti permette di includere nel filtraggio la ricerca a testo completo nei file &PDF;.

- Azzera i filtri: azzera i criteri di filtraggio.

### I menu di &kbibtex;

&kbibtex; segue lo schema standard dei menu di &kde;: in questo modo ha molte voci comuni a tutte le applicazioni di &kde;. Maggiori informazioni su queste voci di menu possono essere trovate in questa sezione di aiuto.

Sotto puoi trovare le descrizioni alle voci di menu specifiche di &kbibtex;.

Modifica Elimina

- Cancella dalla lista bibliografica l'elemento attualmente selezionato.

Modifica Trova duplicati

- Ti permette di trovare e rimuovere i duplicati nella bibliografia attualmente aperta.

Elemento Nuovo elemento Nuova voce

- Apre la finestra Modifica elemento per aggiungere una nuova voce bibliografica.

Elemento Nuovo elemento Nuovo commento

- Apre la finestra Modifica elemento per inserire un nuovo commento, che non verrà preso in considerazione da &bibtex;.

Elemento Nuovo elemento Nuova macro

- Apre la finestra Modifica elemento per inserire una nuova macro.

Elemento Nuovo elemento Nuovo preambolo

- Apre la finestra Modifica elemento per inserire un nuovo preambolo bibliografico, che definisce come dovrebbe essere formattato il testo speciale nella bibliografia.

&Ctrl; E Elemento Modifica elemento

- Apre la finestra Modifica elemento per modificare l'elemento della bibliografia attualmente selezionato.

&Ctrl; D Elemento Visualizza documento

- Apre un documento, locale o remoto, per la voce attualmente selezionata nella lista bibliografica.

  Il collegamento al documento può essere aggiunto o modificato usando la scheda Esterno nella finestra Modifica elemento.

  La scheda dei documenti esterni della finestra di modifica delle voci La scheda dei documenti esterni nella finestra di modifica delle voci

  Il pulsante Aggiungi può essere usato per aggiungere un collegamento ad una pagina remota.

  La casella a cascata Aggiungi file... viene usata per selezionare alcuni file locali, ed aggiungere un riferimento, o l'intero file, all'attuale bibliografia.

  Se fai clic su pulisci il contenuto dell'elemento attualmente selezionato.

  Fai clic sul pulsante per aprire il collegamento al documento nel browser.

  Fai clic sul pulsante per rimuovere l'elemento attualmente selezionato del documento.

  Per riordinare gli elementi nel documento usa i pulsanti e .

  Infine, con il pulsante puoi salvare localmente i documenti remoti.

Elemento Trova &PDF;...

- Trova in Internet alcuni documenti &PDF; per la voce bibliografica attualmente selezionata.

  La finestra Trova &PDF; La finestra Trova &PDF;

  Puoi selezionare Ignora, Scarica o semplicemente Uso solo &URL; per la voce.

Elemento Formatta gli identificatori delle voci

- Ti permette di formattare gli identificatori delle voci bibliografiche con la formattazione predefinita.

  La formattazione predefinita degli identificatori può essere definita usando la pagina di suggerimento degli Id nella finestra di configurazione di &kbibtex;.

Elemento Colore

- Ti permette di selezionare un'etichetta colorata per le voci bibliografiche, oppure di rimuovere quest'etichetta (Nessun colore).

  Le etichette colorate possono essere configurate usando la pagina Colori & etichette nella finestra di configurazione di &kbibtex;.

Elemento Invia a &lyx;/&kile;

- Invia i riferimenti alle voci bibliografiche attualmente selezionate a &lyx; o &kile;.

Impostazioni Configura &kbibtex;...

- Apre la finestra di configurazione di &kbibtex;.

### Finestra di configurazione di &kbibtex;

Molti dei parametri di &kbibtex; possono essere configurati attraverso la finestra Preferenze, che può essere aperta usando l'elemento del menu Impostazioni Configura &kbibtex;. Qui sotto puoi trovare una descrizione delle pagine di configurazione di &kbibtex;.

Fai clic sul pulsante Predefiniti per riportare tutti gli elementi al loro valore predefinito.

Il pulsante Azzera può essere usato per abbandonare tutti i cambiamenti all'attuale configurazione senza chiudere la finestra Preferenze.

#### Configurazione generale

Configurazione generale Configurazione generale

Questa pagina di configurazione ti permette di cambiare la formattazione dei nomi di persona predefinita; questa sarà applicata automaticamente ai nomi di persona inseriti nella finestra Editor elemento.

#### Configurazione delle parole chiave

Configurazione delle parole chiave Configurazione delle parole chiave

Questa pagina della configurazione può essere usata per modificare la lista delle parole chiave. Queste parole chiave, applicate alle voci bibliografiche mediante l'editor elemento, sono utili per strutturare la bibliografia. Il filtraggio tramite parole chiave porta ad avere risultati finemente filtrati per argomento.

Il pulsante Aggiungi può essere usato per aggiungere una parola chiave alla lista.

Fare clic sul pulsante Rimuovi per rimuovere la parola chiave attualmente selezionata.

#### Configurazione di colori & etichette

Configurazione di colori & etichette Configurazione di colori & etichette

Le etichette colorate sono un altro modo utile di strutturare la bibliografia. Questa pagina di configurazione può essere usata per definire le etichette ed i loro colori.

Si può usare il pulsante Aggiungi per aggiungere un'etichetta alla lista.

Fai clic sul pulsante Rimuovi per rimuovere l'etichetta attualmente selezionata.

Fai doppio clic nella colonna colore o etichetta per iniziare a modificarla.

#### Configurazione del suggerimento degli id

Configurazione del suggerimento degli id Configurazione del suggerimento degli id

Questa pagina di configurazione viene usata per maneggiare lo schema di suggerimento degli id per l'editor elemento. Puoi aggiungere, modificare, rimuovere o riordinare gli schemi usando i pulsanti corrispondenti, che si trovano alla destra della lista dei suggerimenti.

Fai clic sul pulsante Usa come predefinito per cambiare lo schema di suggerimento degli id con quello attualmente selezionato. Questo pulsante può essere usato per definire un formato per l'azione Formatta gli identificatori delle voci.

#### Configurazione dell'interfaccia utente

Configurazione dell'interfaccia utente Configurazione dell'interfaccia utente

Usando questa pagina di configurazione puoi fare in modo che &kbibtex; mostri o nasconda i commenti e le macro nella lista bibliografica, puoi scegliere il sistema bibliografico (&bibtex; or &biblatex;) e definire cosa fare quando si fa doppio clic su un elemento della lista bibliografica (Apri editor o Visualizza documento).

&biblatex; è una re-implementazione di &bibtex;. Con &biblatex; la formattazione della bibliografia è controllata interamente da macro di &latex;, non si ha a che fare con file `bst`. Viene supportata la suddivisione di bibliografie, le bibliografie multiple in un solo documento e le liste di abbreviazioni bibliografiche separate. Le bibliografie possono essere suddivise in parti, o segmentate per argomento. Tutti i comandi di citazione possono essere liberamente definiti, proprio come negli stili bibliografici. Il pacchetto &biblatex; è completamente localizzato, e si può interfacciare con babel.

Dalla documentazione di &biblatex;.

Anche &biblatex; può usare biber come motore. Con &biblatex; è possibile usare i simboli UTF-8 nelle voci bibliografiche.

In questo modo è possibile usare &biblatex; per creare bibliografie sofisticate.

#### Configurazione di salvataggio ed esportazione

Configurazione di salvataggio ed esportazione Configurazione di salvataggio ed esportazione

Questa pagina ti permette di scegliere un comando &latex; (⪚ `\cite{...}`) che sarà usato per incapsulare il riferimento che è stato copiato con l'elemento del menu a comparsa &Ctrl;&Shift;C Copia riferimento dalla lista bibliografia.

Spuntando l'apposita casella è anche possibile rendere &kbibtex; in grado di determinare automaticamente la pipe dei dati di &lyx;.

Quando la casella Rileva automaticamente la pipe di &lyx; non è selezionata, puoi aggiungere manualmente l'indirizzo di incanalamento nella casella di testo Pipe di &lyx; specificata manualmente, oppure puoi selezionarlo usando la generica finestra Apri/Salva di &kde;: devi premere il pulsante che si trova alla destra della casella di testo.

Infine, ora è possibile configurare le copie di sicurezza. Si può scegliere l'argomento della copia di sicurezza (Solo file locali, Nessuna copia di sicurezza, oppure File locali e remoti) usando la casella a cascata Copie di sicurezza al salvataggio, e il numero di copie di sicurezza da immagazzinare.

#### Configurazione &PDF; e Postscript

Configurazione &PDF; e Postscript Configurazione &PDF; e Postscript

Questa pagina di configurazione può essere utilizzata per scegliere alcune opzioni nell'anteprima delle voci di &kbibtex;. Puoi selezionare opzioni come Dimensione carta, la lingua per il pacchetto babelusato da &latex; e lo stile bibliografico.

## Utilizzo avanzato

### Riferimenti incrociati

I riferimenti incrociati permettono di risparmiare tempo, creando dei collegamenti tra voci genitore (possono essere trattati come atti o come una collezione di articoli) e le voci figlio (rapporti o articoli).

Per creare un riferimento incrociato aggiungi il suo identificatore nel campo riferimento incrociato: nella scheda Pubblicazione di una voce.

Scheda pubblicazione della finestra di modifica delle voci Scheda pubblicazione della finestra di modifica delle voci

Puoi inserire l'identificatore sia direttamente, sia facendo clic sul pulsante , selezionandolo dalla lista degli identificatori disponibili.

### Macro

Immagina che la bibliografia contenga molti riferimenti alla stessa rivista, e di non voler inserire il suo titolo più volte. Puoi quindi definire una macro che sostituisca il titolo della rivista.

Diciamo di voler definire una macro `efm` per sostituire Engineering Fracture Mechanics. Dobbiamo fare come riportato di seguito:

1. Scegliere l'elemento del menu Elemento Nuovo elemento Nuova macro.

2. Inserire un identificatore (l'abbreviazione) per il titolo nella casella di testo Id:. L'identificatore predefinito si chiama `Nuovo1`. Occorre inserire `efm`.

3. Scegliere (Testo semplice). L'altra opzione, (Codice sorgente) può essere usata se vuoi inserire al suo interno delle macro con i comandi di &latex;.

4. Inserire `Engineering Fracture Mechanics` nella casella di testo Valore:.

   Definizione di macro Definizione di macro

5. Fai clic sul pulsante Applica.

6. Se vuoi, spostati nella scheda Sorgente per ispezionare il codice della macro.

   Definizione delle macro (codice sorgente) Definizione delle macro (codice sorgente)

7. Fai clic sul pulsante OK.

La stessa procedura può essere utilizzata per sistemare titoli, autori, nomi dei mesi &etc;, a seconda delle regole di abbreviazione dell'editore per le voci provenienti dai database online. Come comportamento predefinito, queste regole (macro) dovrebbero essere definite nei file di stile bibliografico (`bst`).

## Integrazione con &kile; e &lyx;

&kbibtex; può essere facilmente integrato con comuni editor &latex; come &kile; e &lyx;.

### Integrazione con &kile;

&kile; è un editor di sorgenti &tex; e &latex; e una shell.

&kbibtex; è l'editor e il visualizzatore predefinito di file &bibtex; di &kile;, e quindi non sono necessarie configurazioni aggiuntive.

Per aggiungere citazioni selezionate da un file bibliografico, avvia &kile;, apri alcuni file &latex; e posiziona il puntatore nel punto in cui vuoi aggiungere la citazione. Passa quindi alla finestra di &kbibtex;, e seleziona gli elementi nella lista degli elementi. Scegli Elemento Invia a &lyx;/&kile;, oppure usa il menu contestuale (che compare facendo clic con il &RMB;) Invia a &lyx;/&kile;.

Le citazioni vengono inserite come `\cite{`identificatori dell'elemento`}` nella posizione del puntatore all'interno del documento corrente di &kile;.

### Integrazione con &lyx;

&lyx; è un elaboratore di documenti che incoraggia un approccio alla scrittura basato sulla struttura dei documenti (WYSIWYM) e non sulla loro apparenza (WYSIWYG).

&kbibtex; può essere integrato in &lyx; attraverso una pipe di input/output con &lyx;.

1. Come prima cosa bisogna configurare &lyx; in modo che sia in grado di usare questo canale (pipe). Dal menu principale di &lyx; scegli Strumenti Preferenze, quindi apri la pagina Percorsi e inseriscine uno (⪚ `~/.lyx/lyxpipe`) nella casella di testo LyXServer pipe.

   Configurazione di &lyx; Configurazione di &lyx;

2. Fai clic su Salva per salvare i cambiamenti.

3. Scegli Strumenti Riconfigura per riconfigurare &lyx;, quindi riavvialo.

4. Per aggiungere le citazioni selezionate da file bibliografici apri un documento, piazza il puntatore nel punto in cui vuoi aggiungere la bibliografia, e quindi seleziona Inserisci Elenco / Indice Bibliografia &bibtex;... dal menu principale di &lyx;.

5. Fai clic su Aggiungi..., quindi su Sfoglia.... Devi poi fare in modo che &lyx; punti ad un file `bib` di &kbibtex;. Fai clic su Aggiungi, quindi su OK.

6. Piazza il puntatore nel punto in cui vuoi aggiungere la citazione, quindi passa alla finestra di &kbibtex;. Seleziona gli elementi dalla lista degli elementi facendo clic su Elemento Invia a &lyx;/&kile;, oppure usa il menu contestuale (che appare facendo clic con il &RMB;) Invia a &lyx;/&kile;.

7. La citazione verrà inserita come un riferimento nella posizione del puntatore all'interno dell'attuale documento di &lyx;.

## Riconoscimenti e licenza

&kbibtex;

Copiright del programma © 2004-2014 Thomas Fischer fischer@unix-ag.uni-kl.de

Copyright della documentazione © 2013 Yuri Chornoivan yurchor@ukr.net

Traduzione a cura di Paolo Zamponizapaolo@email.it

&underFDL; &underGPL;
Lamport86 Leslie Lamport

## Latex: un sistema di preparazione della documentazione

1986

Addison-Wesley Publishing Company
&documentation.index;