92 lines
2.2 KiB
Markdown
92 lines
2.2 KiB
Markdown
# 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:
|
|
|
|
```markdown
|
|
# Om oss
|
|
|
|
Velkommen til vår side. Vi bygger enkle, vedlikeholdbare nettsider.
|
|
```
|
|
|
|
4. 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:
|
|
|
|
```markdown
|
|
# Mitt første innlegg
|
|
|
|
Dette er mitt første blogginnlegg med PnP!
|
|
|
|
|
|
```
|
|
|
|
4. Legg til et bilde: Dra `bilde.jpg` inn i samme mappe
|
|
5. Besøk `dinside.no/blogg/2025-01-15-mitt-forste-innlegg/`
|
|
|
|
## Steg 4: Tilpass med metadata
|
|
|
|
Legg til en `metadata.ini`-fil i blogginnleggsmappen:
|
|
|
|
```ini
|
|
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/`:
|
|
|
|
```ini
|
|
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
|
|
|
|
- Lær om [tilpasning av maler](../../hvordan/customize-templates/)
|
|
- Forstå [mappebasert ruting](../../forklaring/routing/)
|