# Hvordan bidra

Om du ønsker å legge inn en oppskrift selv for så å lage en innlemmelsesforespørsel (pull request, PR), kan du gjøre det ved å følge disse stegene.

Lag en fork eller gafling av lageret.

En ny oppskrift kan legges til ved å opprette en ny fil i en eksisterende eller en ny mappe.

Nye filer må ha filendelsen .md, og filnavnet må være uten mellomrom (bruk heller bindestrek, -) og kun med små bokstaver, også kjent som kebab case.

La oss si at du ønsker å legge til en bolleoppskrift. Da oppretter du en ny fil i mappen bakst og kaller den for eksempel ferske-boller.md. Kopier innholdet i TEMPLATE.md inn i ferske-boller.md, og rediger etter eget ønske.

Filstrukturen du ønsker å legge til filer i ser omlag slik ut, før og etter:

.
├── IMAGE.md
├── LICENSE
├── README.md
├── TEMPLATE.md
├── retype.yml
└── src
    ├── _includes
    │   └── head.html
    ├── bakst
    │   ├── bananpannekaker.md
    │   └── index.yml
    ├── blog
    │   └── 2022-5-24-hvordan-bidra.md
    ├── hovedretter
    │   ├── index.yml
    │   └── tomat-paprika-suppe.md
    ├── index.md
    └── static
        └── pasta-a-la-vodka.webp

.
├── IMAGE.md
├── LICENSE
├── README.md
├── TEMPLATE.md
├── retype.yml
└── src
    ├── _includes
    │   └── head.html
    ├── bakst
    │   ├── bananpannekaker.md
    │   ├── ferske-boller.md
    │   └── index.yml
    ├── blog
    │   └── 2022-5-24-hvordan-bidra.md
    ├── hovedretter
    │   ├── index.yml
    │   └── tomat-paprika-suppe.md
    ├── index.md
    └── static
        └── pasta-a-la-vodka.webp

For å unngå at bilder gjør lageret veldig stort skal de være i filformatet webp, med en maks filstørrelse på 500 kB. Dette forklares i større detailj i IMAGE.md, men kort fortalt kan det gjøres ved hjelp av kommandolinjeprogrammet cwebp slik:

cwebp -size 500000 in.jpg -o out.webp

Eventuelt kan du forsøke en av de mange nettsidene for å konvertere, f.eks freeconvert.

Nå kan åpne en pull request (PR) mot min gren "main".