English version of this page

Referansehåndtering i LaTeX

Ved UiO kan du bruke den nettbaserte LaTeX-editoren Overleaf i premium versjon som du kan koble til Zotero. Du kan også bruke Zotero om du jobber i desktop editor for LaTeX. Her får du hjelp med begge. Uansett valg av editor og referanseverktøy, anbefales det at du bruker pakken BibLaTeX for håndtering av referansene.

Integrere Zotero med Overleaf 

Ved UiO kan du bruke den nettbaserte LaTeX-editoren Overleaf i premium versjon (logg inn med UiOs SSO) som du kan koble til Zotero. 

Gå til siden for Overleaf Account Settings og huk av på Zotero integration, se How to link Zotero to your Overleaf account. 

Etter å ha huket av for Zotero-integrasjon, får du ulike integrasjonsfunksjoner: 

  1. Zotero Sync
  2. Zotero-linked .bib file
  3. Advanced reference search

Advanced reference search søker i alle referanser du kobler til Zotero og gjør det enkelt å sitere med autocomplete. Anbefales i kombinasjon med en av de første løsningene som vil synke/refreshe med endringer du gjør i Zotero. Følg lenkene over for å sette opp.

Enkelt eksempel på oppsett i prosjekt

I dette eksempelet har jeg valgt å koble til en Zotero-linked .bib file i et prosjekt. Jeg legger inn koblingen til .bib-filen under File → File upload → From Zotero. Jeg kaller .bib-filen references.bib. I preambelen, under angitt dokumentklasse, legger jeg inn disse kommandoene:

\usepackage{biblatex} %Dette importerer BibLaTeX pakken som er en nyere og bedre pakke for referanser enn det eldre BibTeX-systemet 
\addbibresource{references.bib} %Dette legger til .bib-filen jeg har koblet til
\begin{document}

Her kan jeg begynne å skrive og sitere med 

\cite{…}

Nederst legger jeg til litteraturlisten:

\printbibliography %Dette genererer litteraturlisten
\end{document}

Til slutt klikker jeg Recompile for at Overleaf skal kompilere kommandoene og generere en PDF.

BibLaTeX er den anbefalte pakken for referansehåndtering framfor det eldre BiBTeX-systemet. Biblatex opererer med biber som backend-program der biblatex tar seg av hvordan referansene dine ser ut i selve dokumentet, mens biber er motoren i bakgrunnen som sorterer og behandler kildedataene dine. Når du skal kjøre kompileringer, aktiveres biber, og må derfor være tilgjengelig i editor. I Overleaf er biber default.

Overleaf guide

Jobbe offline med Overleaf

Overleaf kan benyttes med UiO-Dropbox. Det betyr at man kan jobbe offline og synkronisere til UiO-Dropbox eller klone dokumentet med git, editere og synkronisere endringene når man er tilbake online. (UiO-skytjenester)

Eksempel på flere kommandoer i oppsett av prosjekt

Her er et litt mer detaljert eksempel på hvordan du kan sette opp en preamble i en editor:

\documentclass{article}
\usepackage[T1]{fontenc}
\usepackage[english]{babel}
\usepackage{csquotes,graphicx}
\usepackage[backend=biber, style=numeric, sorting=none]{biblatex}
\usepackage{hyperref}
\addbibresource{references.bib}
\title{...}
\author{...}
\date{...}
\begin{document}
\maketitle
Her kan du begynne å skrive og sitere med \cite{...}
\printbibliography
\end{document}

Forklaring på kommandoene i eksempelet

  • \documentclass{article} Angir hva slags type dokument du oppretter, her artikkel. Du kan se en oversikt over ulike klasser her: https://www.ctan.org/topic/class 
  • \usepackage[T1]{fontenc} Fontenc sørger for riktig skrifttype-koding, og [T1] gjør at LaTeX håndterer spesialtegn (som de norske bokstavene æ, ø og å) på en god måte. [T1]  gir 8-bits-koding på bokstav-tegnene istedet for 7-bits, hvilket vil si at man dobler antall mulige bokstav-tegn fra 128 til 256. Med 7-bits-koding er det en del spesialtegn (for eksempel ö), som ikke får sitt eget tegn, og som istedet blir satt sammen av to tegn (o + ¨)
  • \usepackage[english]{babel} Tilpasser dokumentet til engelsk språk og sørger automatisk for at faste tekstelementer blir engelske (f.eks. at det står "References" i stedet for "Litteraturliste"), og aktiverer engelske regler for orddeling.
  • \usepackage{csquotes,graphicx} Henter inn to praktiske pakker samtidig:
  • csquotes: Håndterer anførselstegn automatisk basert på språket du har valgt (nyttig ved sitering).
  • graphicx: Gjør det mulig å sette inn bilder og illustrasjoner i dokumentet.
  • \usepackage[backend=biber, style=numeric, sorting=none]{biblatex} Henter inn biblatex for referansehåndteringen. I tillegg tre innstillinger:
    • backend=biber: Setter biber som backend hjelpeprogram til biblatex
    • style=numeric: Angir kildehenvisninger med nummer (numerisk stil), for eksempel [1]. 
    • sorting=none: Sorterer kildene i litteraturlisten i den rekkefølgen de dukker opp i teksten, i stedet for alfabetisk.
  • \usepackage{hyperref} Gjør om alle kildehenvisninger, innholdsfortegnelser og nettadresser til klikkbare hyperlenker i PDF-filen.
  • \addbibresource{references.bib} Forteller LaTeX hvor (hvilken fil) kildene dine er lagret. Den sier at referansene dine ligger i en egen fil i samme mappe som .tex-filen som heter references.bib
  • \maketitle henter ut informasjon ført inn under title, author, date og lager et tittelfelt med denne informasjonen
  • \cite{…} er kommandoen for å sitere
  • \printbibliography er kommandoen for å skrive ut listen over siterte referanser; standardtittelen er «References» for dokumentklassen article og «Bibliography» for bøker og rapporter.

Flere valg for referansestiler og andre kommandoer

UiO støtte i LaTeX og BibLaTeX

Hvis du har spørsmål om LaTeX og Zotero, kan du kontakte: latexguru@ub.uio.no 

Se også vår kurskalender: Getting started with LaTeX and Overleaf

Se også denne illustrerte veiledningen: Referansehåndtering i LaTeX (NTNU) illustrerte veiledninger for bruk av Zotero med både Overleaf og desktop editor, og Zotero plugin Better BibTeX. Har også en god oversikt over anbefalte pakker og kommandoer, og ulike valg for referansestiler.

Integrere Zotero med desktop editor

Dersom du vil jobbe med LaTeX i lokal desktop editor, installerer du anbefalt progamvare for din plattform:

  • Linux: TeX Live (allerede installert på UiO-eide Linux maskiner med editoren Kile)
  • Mac: MacTeX (tilgjengelig for UiO-eide maskiner fra Managed Software Center) (MacTeX kommer med editoren TexShop)
  • Windows: MiKTeX (tilgjengelig for UiO-eide maskiner fra Company Portal og Software Center) (MikTeX kommer med editoren TeXworks) 

Opprette bib-fil med referanser for LaTeX

Du trenger en .bib-fil med referansene dine. Denne kan opprettes i et referanseverktøy, f.eks. EndNote eller Zotero (anbefalt).

Hvis du ikke benytter Zotero, er JabRef et godt gratisprogram for håndtering av .bib-filer for LaTeX, se NTNUs anbefalinger for referansehåndteringsprogram.

Zotero-plugin: Better BibTeX

Better BibTeX er et anbefalt Zotero-plugin (tillegg) for LaTeX. Better BibTeX er spesielt nyttig hvis du skriver i lokal desktop editor fordi det kan sørge for at eksporterte .bib-filer oppdateres automatisk også der (Overleaf har enkel funksjonalitet for dette). Det sikrer også stabile siteringsnøkler. Se NTNUs illustrerte hjelp for installering av Better BibTeX for Zotero.

Eksportere bib-fil fra Zotero til LaTeX

  1. I  Zotero, gå til File > Eksporter bibliotek...
  2. Velg Better BibLaTex som format hvis du har installert Better BibTeX-tillegget, ellers BibLaTex
  3. Legg den eksporterte .bib-filen (f.eks. referanser.bib) i samme mappe som .tex-filen din (f.eks. mythesis.tex). 
  4. Med Zotero-tillegget Better BibTeX vil .bib-filen oppdatere seg automatisk ved endringer du gjør i Zotero
  5. I  lokal desktop editor bruker du biber som backend-program for biblatex
Det er viktig at .tex-fil og .bib-fil ligger i samme mappe:
MyThesis/
├── mythesis.tex
└── references.bib

Oppsett og kommandoer

I TeXShop for Mac:

  • Gå til settings → engine → skriv inn biber i feltet for BibTeX Engine

TeXworks for Windows:

  • TeXworks kommer med biber som valg i nedtrekksmenyen for kompilering

Kile for Linux: 

  • Kile kommer med Biber som valg under Build i menyen for kompilering

I preambelen av .tex-filen din, etter du har angitt dokumentclass, aktiverer du biblatex-pakken med biber som backend-program:

\usepackage[backend=biber]{biblatex}
  • Når du har begynt å skrive og sitere, må du kompilere for å se endringene. 
  • Du må kjøre biber mellom pdflatex-kjøringer når du endrer på referansene dine.

Kompilering i TexShop for Mac: Gå til Typeset i menyen

Velg LatTeX,
så BibTex (som du har satt opp til å kjøre biber),
deretter LaTeX igjen,
gjenta LaTeX.

Kompilering i TeXworks for Windows: Gå til nedtrekksmenyen ved siden av den grønne play-knappen:

Velg pdfLaTeX og trykk den grønne knappen.
Velg Biber og trykk den grønne knappen.
Velg pdfLaTeX igjen og trykk den grønne knappen.
Gjenta pdfLaTeX.

Kompilering i Kile for Linux: Kile har bedre støtte for å automatisere byggeprosessen. For kompilering gå til Build i menyen og kjør

Build → Compile
Build → Biber
Build → Compile
Build → Compile

Hvis Kile tilbyr Latexmk i Build-menyen, er dette enklest. Da kjører programmet nødvendige steg automatisk, inkludert Biber når dokumentet bruker backend=biber. 

Build → Compile → Latexmk