Navigere Quarto-filer (*.qmd) fra Saros

Jobbe med Quarto-dokument

  1. Filplassering og synkronisering av filer lokalt:
    1. Pass på at filene ikke ligger i en mappe med lang stibaner på en Sharepoint/Teams-mappe (over 260 tegn). Dette vil skape trøbbel når du skal rendre.
    2. Hvert kapittel bør ligge i sin egen mappe. Ikke bruk en mappe med ditt navn på der du har flere kapitler. Blir bare rot.
    3. La alle filer tilknyttet kapittelet ligge i samme mappe, også versjoner sendt til kvalitetssikring, osv. Alt på ett sted. Bruk gjerne undermapper for å holde det ryddig.
    4. Alle filer/mapper som du anser som “arkiv” som andre skal ignorere kan navngis med en understrek i starten av fil/mappe-navnet. F.eks. filen “_biter_jeg_har_klipt_ut.qmd”
  2. I RStudio, trykk først på Edit ➠ Folding ➠ Collapse all. Det skjuler chunks du ikke jobber med enda.
  3. Stavekontroll:
    1. Husk å skru på norsk stavekontroll! Tools → Global options → Spellchecking. Må installere norsk språk. Etter du har endret, lukk RStudio og åpne det igjen.
  4. Åpne en og en chunk ved å trykke på den. Lukk dem gjerne etterpå (pil på venstre side av chunken).
  5. Forhåndsvis figurer, grafer, etc ved å trykke på grønn knapp til høyre på chunken, eller trykk Ctrl + Shift + Enter for å kjøre hele chunken som markøren står på.
  6. Trykk på Show in new window over forhåndsvisningen for figurer som er større enn forhåndsvisningen. Juster eventuelt vinduet for å se alt.
  7. Skriv tekst til resultatene.
  8. Ønsker du å se hvordan alt ser ut til slutt? Trykk Render-knappen, og en HTML-side åpnes etter hvert. Får du feilmeldinger, les disse nøye og sjekk med denne listen.
    1. Ved å trykke på tannhjulet til høyre for Render-knappen så kan du sette outputen til Viewer-vinduet i RStudio (gjelder HTML-output). En del folk foretrekker dette.
  9. Ikke tenk særlig på layout (såfremt du ikke har behov for å sette enkelte ord/setninger i kursiv/fet skrift). De fleste layout/design-innstillinger er satt globalt og vil bli synlig når hele nettsiden/rapporten kompileres.

Ordliste

Note
Chunk / code cell

En bit med R-kode, definert som alt mellom ```{r} og ```. Den kan ha spesielle innstillinger, indikert ved #| (kalt hashpipe), øverst. Ønsker man ikke å kjøre koden midlertidig (for eksempel om man er usikker på om den skal med) kan man kommentere ut selve koden (behold da innstillingene), eller slette det helt, og heller hente det inn igjen fra originalen om ønskelig.

Render/kompilering

Kjører alle chunkene og setter sammen dokumentet til f.eks. en HTML-side, PDF eller DOCX. Kan også kalles kompilere på norsk.

YAML-hode

YAML er en måte å skrive innstillinger for et dokument (potensielt også for et helt prosjekt) som er lesbart både for mennesker og datamaskinen. Vil aldri synes etter kompilering.

Quarto/QMD

Quarto er teknologien som setter sammen R-kode, vanlig tekst, med YAML-innstillinger, osv. QMD er filetternavnet for et slikt dokument.

Gjenbruk