Kom igång med Overleaf

Vad Overleaf är

Overleaf är en skrivmiljö för LaTeX. LaTeX är ett sätt att skriva dokument där ni beskriver vad något är, alltså en rubrik, en formel, en tabell, och programmet bestämmer hur det ska se ut. Ni flyttar aldrig en bild för hand och ni justerar aldrig ett radavstånd. Resultatet blir en PDF som ser ut som en bok.

Det är omständligare än ett vanligt ordbehandlingsprogram första dagen och enklare den femte. Skriver ni något med många formler, källhänvisningar eller ett hundratal sidor som ska hänga ihop är det överlägset. Skriver ni ett kort utskick till kunder är det fel verktyg.

Overleaf gör LaTeX användbart utan att någon installerar något: ni skriver i webbläsaren, PDF:en uppdateras bredvid, och flera personer kan skriva i samma dokument samtidigt.

Windows och Linux Mint

Ingen installation. Overleaf körs på overleaf.com och behöver bara en webbläsare, vilken som helst, på vilket operativsystem som helst. Skapa ett konto, starta ett nytt projekt och välj en av mallarna.

Tjänsten har en gratisnivå och flera betalda. Vad som ingår var för sig ändras över tid, så läs det på deras sida i stället för att lita på en guide.

Egen server, om ni verkligen vill

Overleaf finns som Community Edition att köra själv. Det kräver Docker och en uppsättning skript som projektet kallar Overleaf Toolkit. De hämtas från GitHub och startas så här:

git clone https://github.com/overleaf/toolkit.git ./overleaf-toolkit
cd ./overleaf-toolkit
bin/init
bin/up

bin/up kör i förgrunden och visar loggarna, bra för att se att det startar. För att låta det ligga igång bakgrunden efteråt, kör bin/start i stället. Den första administratören skapar ni genom att öppna /launchpad på adressen till er installation.

Skripten är skrivna i bash, alltså Linux skal. På Linux Mint fungerar de direkt i Terminal. På Windows behöver ni köra dem inuti WSL, och Docker Desktops interna distribution räcker inte, den är bara till för att köra Docker självt. Installera en egen distribution, till exempel wsl --install i PowerShell för Ubuntu, och slå på WSL-integrationen för den under Docker Desktops inställningar, Resources och WSL Integration. Kör sedan skripten i den distributionen, inte i PowerShell.

Räkna med att det tar tid och plats. Overleaf drar igång flera containrar och en databas, men LaTeX-installationen i Community Edition-avbilden är medvetet minimal (scheme-basic) och saknar de paket många mallar behöver. Fler paket installeras i efterhand med tlmgr inuti containern, vilket Overleafs egen dokumentation om TeX Live-uppgradering går igenom. Vi har inte kört hela den här uppsättningen från början till slut, alltså står den här som en väg att undersöka och inte som ett recept vi lovar fungerar. Läs snabbstartsguiden i toolkit-repot innan ni börjar.

Tre saker att göra först

1. Börja i en mall i stället för i ett tomt dokument. Overleaf har mallar för rapporter, artiklar och presentationer, och den som börjar tomt fastnar på inställningarna innan första meningen är skriven.
2. Sätt \usepackage[swedish]{babel} och \usepackage[T1]{fontenc} högst upp i dokumentet. Utan det första blir rubrikerna engelska mitt i den svenska texten, alltså Contents i stället för Innehåll. Utan det andra kan åäö bete sig konstigt vid orddelning.
3. Bjud in någon i företaget via delningsknappen och skriv samtidigt i en minut. Det är den funktionen ni valde Overleaf för.

Den vanligaste fällan

Ett kompileringsfel som inte går att förstå. LaTeX bygger dokumentet varje gång, och saknas en klammerparentes någonstans stannar bygget med ett felmeddelande som handlar om något helt annat på en rad långt bort.

Två vanor löser nästan allt. Bygg ofta, alltså efter varje litet stycke, så att ni vet var felet kom in. Och läs det första felet i listan, inte det sista; resten är oftast följdfel av det första.

Fastnar ni ändå, kommentera bort halva dokumentet med procenttecken och bygg igen. Går det då ligger felet i den bortkommenterade halvan, och ni har halverat sökområdet. Upprepa tills ni står på rätt rad.