innhold/content/docs/utvikling/veiledninger/getting-started/page.md

2.2 KiB

Kom i gang med PnP

I denne veiledningen lærer du det grunnleggende i PnP ved å lage dine første sider.

Hva du skal bygge

Ved slutten av denne veiledningen har du:

  • En forside
  • En om-side
  • En enkel blogg med flere artikler

Forutsetninger

  • PHP 8.3 eller høyere
  • En webserver (innebygd PHP-server fungerer fint)
  • Grunnleggende kjennskap til HTML/Markdown

Steg 1: Forstå strukturen

PnP bruker et mappebasert rutingssystem. Mappestrukturen i /content/ blir direkte til URL-er:

/content/om/page.md → dinside.no/om
/content/blogg/2025-01-15-hei/article.md → dinside.no/blogg/2025-01-15-hei

Steg 2: Lag din første side

  1. Opprett en mappe: /content/om/
  2. Lag en fil: /content/om/page.md
  3. Legg til innhold:
# Om oss

Velkommen til vår side. Vi bygger enkle, vedlikeholdbare nettsider.
  1. Besøk dinside.no/om - siden din er live!

Steg 3: Legg til et blogginnlegg

  1. Opprett en mappe: /content/blogg/2025-01-15-mitt-forste-innlegg/
  2. Lag en fil: /content/blogg/2025-01-15-mitt-forste-innlegg/article.md
  3. Legg til innhold:
# Mitt første innlegg

Dette er mitt første blogginnlegg med PnP!

![Eksempelbilde](bilde.jpg)
  1. Legg til et bilde: Dra bilde.jpg inn i samme mappe
  2. Besøk dinside.no/blogg/2025-01-15-mitt-forste-innlegg/

Steg 4: Tilpass med metadata

Legg til en metadata.ini-fil i blogginnleggsmappen:

title = "Mitt fantastiske første innlegg"
date = "2025-01-15"
summary = "Oppdag hvor enkelt det er å publisere med PnP."

Steg 5: Lag en bloggindeks

Når du har flere blogginnlegg i /content/blogg/, vil PnP automatisk lage en liste når du besøker /blogg.

Legg til metadata.ini i /content/blogg/:

title = "Blogg"
menu = true
menu_order = 2

Dette legger til "Blogg" i navigasjonsmenyen.

Steg 6: Legg til et forsidebilde (cover image)

For hvert blogginnlegg kan du legge til et forsidebilde som vises i listen:

  1. Legg til cover.jpg, cover.webp eller cover.png i innleggsmappen
  2. Bildet vises automatisk i bloggindeksen

Neste steg