Usare ProQuest RefWorks con LaTex Aggiornato il 01 dicembre 2016

Transcript

1 Sommario Usare ProQuest RefWorks con LaTex Aggiornato il 01 dicembre 2016 Il contesto Esportare i riferimenti da RefWorks a LaTex. Inserire le citazioni in LaTex. Errori più comuni Il contesto RefWorks: è un software che permette di importare, organizzare e salvare riferimenti tratti da database bibliografici, libri, pagine web o altre fonti; formattare automaticamente le bibliografie e inserire bibliografie e citazioni direttamente in un testo. LaTeX: è un linguaggio di markup utilizzabile su vari editor di testo. Utilizza pacchetti, ambienti e comandi che vengono scritti su un file sorgente con estensione.tex il quale, una volta compilato, produrrà generalmente un file di output PDF. Esempio di file input scritto con LaTeX: Una volta compilato, il file PDF di output apparirà così: 1

2 BibTeX: è uno strumento utilizzato da LaTex che permette di organizzare e formattare la bibliografia. Ogni riferimento bibliografico è descritto in un file di testo secondo una precisa struttura che ne identifica i diversi campi (titolo, autore, edizione...) e può essere richiamato all'interno del file sorgente tramite un codice identificativo (tipicamente \cite{} ). BibTex non contiene istruzioni circa lo stile citazionale da usare per formattare la bibliografia. Esempio di riferimento bibliografico formattato con BibTeX: 2

3 Esportare i riferimenti da RefWorks a LaTex. Per utilizzare le citazioni salvate in RefWorks con LaTex è necessario prima esportarle in formato BibTex e salvarle nel modo corretto. 1. Apri RefWorks ed inserisci username e password 2. seleziona la cartella che contiene i riferimenti da utilizzare nel documento LaTeX. Puoi anche selezionare Tutti i documenti 3. dalla barra dei menu seleziona l icona Condividi ed esporta e poi scegli la voce Riferimenti esportazione 4. puoi decidere se esportare tutti i riferimenti della cartella o solo quelli selezionati, scegli il formato BibTeX 5. salva il file e scegli come destinazione la cartella dove hai salvato il documento LaTeX sul quale stai lavorando 6. rinomina il file che stai salvando filename.bib e clicca su Salva. In questo modo avrai salvato in modo corretto il file per essere letto e utilizzato con BibTeX. 3

4 Il corretto ordine per lanciare LaTeX e BibTeX è latex documento bibtex documento latex documento latex documento dove documento è il nome del tuo file. Questo procedimento ti permetterà di creare correttamente la tua bibliografia e le citazioni interne al testo. La bibliografia si trova in un file con estensione.bib separato dal file sorgente di LaTex, ma è fondamentale ricordarsi che non bisogna aprire e formattare con LaTex il file con la bibliografia, ma compilare il file.tex in BibTex. Il proprio documento, dunque, andrà compilato quattro volte affinché la bibliografia appaia nel modo corretto: la prima in LaTex, la seconda in BibTex, la terza e la quarta di nuovo con LaTex. Sostanzialmente, con la prima compilazione si genera un file.aux che verrà letto da BibTex per trovare le citazioni; la seconda definisce tutti i riferimenti all interno del documento; la terza inserirà la bibliografia nel documento, ma la numerazione non sarà corretta; la quarta sistemerà infine i riferimenti nel modo corretto. Inserire le citazioni in LaTex. Ora potrai inserire le citazioni che hai appena salvato direttamente nel tuo documento LaTex. I principali comandi da utilizzare sono: \bibliographystyle{style} da inserire sotto il comando \begin{document}. style.bst è il nome dello stile citazionale che detterà il formato della tua bibliografia. \bibliography{filename} è la stringa di comando da utilizzare in LaTeX ogni volta che vorrai generare la bibliografia. filename.bib è il nome del file con i riferimenti che hai appena esportato da RefWorks. \cite{refworks:#} dove # è il numero identificativo della citazione in RerWorks (Ref ID lo trovi in alto a sinistra in ogni citazione): inserisci questo comando ogni volta che vuoi inserire un riferimento. Lo stile citazionale secondo il quale sarà formattata la bibliografia è determinato dalla stringa che indicherai nel comando \bibliographystyle{style}. E possibile impostare diversi stili citazionali, fra cui i seguenti quattro sono i più conosciuti: Plain: lo stile normale, dove i riferimenti nella bibliografia finale appaiono in ordine alfabetico e sono numerati progressivamente; Unsrt: come lo stile plain, ma i riferimenti in bibliografia appaiono nell ordine in cui vengono citati; Alpha: come lo stile plain, però i riferimenti non sono numerati progressivamente, ma etichettati in base alle iniziali dell autore e all anno di pubblicazione; Abbrv: come lo stile plain, con la differenza che i nomi propri, quelli delle riviste e quelli dei mesi vengono abbreviati. 4

5 Per un elenco più ampio dei vari stili citazionali esistenti, è possibile consultare il seguente link: Oltre a questi stili citazionali, è possibile utilizzare tre differenti strade per modificare il proprio stile citazionale: natbib, jurabib e biblatex. La prima permette di fare citazioni inserendo gli anni e gli autori (le istruzioni per il suo utilizzo sono illustrate dettagliatamente da questo articolo ftp://ftp.tex.ac.uk/texarchive/macros/latex/contrib/natbib/natbib.pdf); la seconda, più malleabile, permette di scegliere fra varie opzioni per creare uno stile citazionale che si avvicini il più possibile alle proprie esigenze. Risulta particolarmente utile per tutti gli utenti delle discipline umanistiche e legali. L articolo che fa da guida all uso di questo pacchetto si può consultare a questo indirizzo: sh/jbendoc.pdf. il terzo ridisegna in maniera sostanziale il modo in cui LaTeX e BibTeX lavorano. Biblatex riduce l utilizzo di BibTeX all ordinamento della bibliografia e alla creazione di etichette. La formattazione della bibliografia è resa possibile dall utilizzo di macro. Attualmente, è il sistema più utilizzato e più aggiornato. Jens Berger, lo sviluppatore di Jurabib, non lo sta più aggiornando, quindi col passare del tempo questo pacchetto diventerà sempre più obsoleto. È consigliabile, se le il proprio stile citazionale lo richiede, usare biblatex Errori più comuni. "Sorry--you've exceeded BibTeX's buffer size 5000." BibTex ha come limite di campo 5000 caratteri; la maggior parte dei campi non supera questo limite. Se però il campo Note di una citazione contiene una grande quantità di informazioni (ad es. l indice completo), questo limite potrebbe essere superato. Per risolvere questo inconveniente usa un editor di testo per aprire il file della tua bibliografia e modificare i campi con troppi caratteri. Caratteri speciali parte della sintassi di LaTex inseriti nelle citazioni Se le citazioni contengono caratteri speciali utilizzati anche nella sintassi di LaTex questo potrebbe produrre degli errori quando si utilizza BibTex. Ad esempio LaTex interpreterà il carattere & presente nel titolo di una rivista come un carattere di allineamento e questo genererà l errore "Misplaced alignment tab character &.". Per risolvere questo problema usa un editor di testo per trovare le linee che causano l errore (LaTex dovrebbe indicartele come parte del messaggio di errore) e cambia il carattere che crea problemi con uno dei seguenti comandi 5

6 Carattere Comando LaTeX # \# $ \$ % \% & _ \& \_ { \{ } \} ~ \~{ } ^ \^{ } \ $\backslash$ Quando riceverai l avviso di LaTex che ti informerà che la modifica è avvenuta, semplicemente lancia LaTex nuovamente. Errore nella formattazione del campo autore BibTex legge il testo nel campo autore come il nome di un autore o più autori senza la necessità di aggiungere nessun ulteriore comando. Talvolta questo può comportare degli errori: se ad es. una citazione esportata da RefWorks contiene la linea author={institute of Electrical Engineers} BibTex leggerà questo comando come il nome di una persona dove Institute sarà il nome proprio e of Electrical Engineers sarà il cognome, e formatterà la citazione basandosi su questa interpretazione. Per correggere questo errore usa un editor di testo per aggiungere le virgolette e modificarlo in questo modo author="{institute of Electrical Engineers}" Così BibTex leggerà il nome come unico e lo formatterà correttamente. Modificare l utilizzo delle maiuscole in BibTex BibTex tende a correggere le lettere maiuscole nel campo titolo in modo che solo la prima lettera della prima parola sia maiuscola. Generalmente questo è corretto dal punto di vista grammaticale, ma può causare problemi se il titolo contiene nomi propri o acronimi. Se ad esempio nella bibliografia compare questa linea di comando: title={iee Proceedings} 6

7 sarà formattata nella bibliografia come Iee proceedings. Per modificare questa regola usa un editor di testo e aggiungi le virgolette come segue title="{iee Proceedings}" In questo modo la citazione apparirà in modo corretto. 7