Usare ProQuest RefWorks con LaTex

Transcript

Usare ProQuest RefWorks con LaTex
Usare ProQuest RefWorks con LaTex
Aggiornato il 01 dicembre 2016
Sommario
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
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
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
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
Per un elenco più ampio dei vari stili citazionali esistenti, è possibile consultare il
seguente link:
https://it.sharelatex.com/learn/Bibtex_bibliography_styles
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:
http://gd.tuwien.ac.at/publishing/latex/CTAN/macros/latex/contrib/jurabib/docs/engli
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
https://it.sharelatex.com/learn/Bibliography_management_with_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
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
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