Referere bilder fra markdown‑filer

Den mest naturlige måten å jobbe med bilder i markdown‑filer på er å plassere dem i en /media‑mappe. media‑mappen må ligge rett under docs‑mappen, altså docs/media.

Det kan være flere undermapper i media‑mappen dersom det er praktisk. For eksempel, for bildene som brukes i developers‑mappen, ligger bildene i docs/media/developers. Det kan kun være én media‑mappe under docs‑mappen.

Eksempel på å referere til et bilde i en markdown‑fil:

![Text](./media/developers/media-folder.png)

Det fine med denne tilnærmingen er at du kan forhåndsvise bildet i markdown‑editoren din (f.eks. VS Code) mens du jobber lokalt, før du pusher til dokumentasjons‑repoet.

Referere bilder med eksterne lenker fra markdown‑filer Bilder kan også refereres via eksterne lenker. Hvis du trenger et sted å lagre dem, er det foreslåtte stedet Norsk Helsenett‑området på GitHub: https://github.com/NorskHelsenett/shp-developerportal.

Opprett en dedikert mappe for tjenesten din og gi den samme navnet som tjenesten på utviklerportalen. Last opp filene der. Finn filen, høyreklikk og velg «Open image in new tab». Kopier den absolutte adressen fra den nye fanen, og test at du kan nå filen i et inkognito‑vindu.

Når du refererer til filene, bruk følgende syntaks: ![Text][<absolute path to file>] Eksempel:

![Text][https://raw.githubusercontent.com/NorskHelsenett/shp-developerportal/main/plattform-utviklerportal/developer/helsegitlab-web-ide.png]

Hvordan referere bilder i en markdown‑fil

Du kan legge bilder direkte i docs‑repoet, så blir de synkronisert inn. Dette kan være nyttig i enkelte tilfeller. Filene importeres til media‑delen i Umbraco og vises som frittstående filer i det importerte docs‑repoet.

Støttede filformater

Støttede bilde‑formater er jpg, svg og png.