Move documentation files from custom to content directory

This commit is contained in:
Ruben 2025-10-03 13:12:38 +02:00
parent cea2c167ff
commit c501635912
32 changed files with 0 additions and 0 deletions

View file

@ -1,169 +0,0 @@
# Metadata
Metadata lar deg kontrollere hvordan innholdet ditt vises. Du legger metadata i en fil som heter `metadata.ini`.
## Hva er metadata?
Metadata er informasjon *om* innholdet ditt, for eksempel:
- Tittel
- Publiseringsdato
- Kort beskrivelse
- Om siden skal vises i menyen
## Opprett metadata.ini
Lag en fil som heter `metadata.ini` i samme mappe som innholdsfilen:
```
/content/om-oss/
├── page.md
└── metadata.ini
```
## Grunnleggende felt
### Tittel
Overstyr tittelen som vises:
```ini
title = "Om oss - Hvem vi er"
```
Hvis du ikke setter tittel, brukes første `# Overskrift` fra innholdsfilen.
### Dato
Sett publiseringsdatoen:
```ini
date = "2025-01-15"
```
Datoen formateres automatisk til norsk: "15. januar 2025"
For blogginnlegg trekkes datoen automatisk fra mappenavnet (`2025-01-15-innlegg`), men du kan overstyre med metadata.
### Sammendrag
Legg til et kort sammendrag som vises i listevisninger:
```ini
summary = "Lær mer om hvem vi er og hva vi driver med."
```
## Menyinnstillinger
### Vis i meny
For å vise siden i navigasjonsmenyen:
```ini
menu = true
```
### Menyen rekkefølge
Kontroller rekkefølgen i menyen (lavere tall vises først):
```ini
menu = true
menu_order = 1
```
Eksempel:
- `menu_order = 1` → Vises først
- `menu_order = 2` → Vises som nummer to
- `menu_order = 10` → Vises senere
## Komplett eksempel
**`/content/om-oss/metadata.ini`:**
```ini
title = "Om oss"
summary = "Lær mer om vårt team og vår filosofi"
menu = true
menu_order = 1
```
## Blogginnlegg med metadata
**`/content/blogg/2025-01-15-mitt-innlegg/metadata.ini`:**
```ini
title = "Mitt fantastiske blogginnlegg"
date = "2025-01-15"
summary = "I dette innlegget deler jeg mine tanker om enkel webpublisering."
```
**Merk**: Du trenger ikke `menu = true` for blogginnlegg - de vises automatisk i blogglisten.
## Metadata for mapper
Du kan også legge metadata.ini i mapper som inneholder andre mapper:
**`/content/blogg/metadata.ini`:**
```ini
title = "Blogg"
summary = "Les våre siste artikler og nyheter"
menu = true
menu_order = 2
```
Dette påvirker hvordan bloggen vises i menyen og i listevisninger.
## Hva skjer uten metadata.ini?
Hvis du ikke har metadata.ini, bruker systemet:
- **Tittel**: Første `# Overskrift` i innholdsfilen, eller mappenavnet
- **Dato**: Dato fra mappenavn (`YYYY-MM-DD-navn`), eller filens endringsdato
- **Meny**: Vises ikke i menyen
- **Sammendrag**: Vises ikke
## Flerspråklige sider
Hvis nettsiden har flere språk, kan du legge til oversettelser i metadata.ini:
```ini
title = "Om oss"
summary = "Lær mer om oss"
menu = true
[en]
title = "About us"
summary = "Learn more about us"
```
Den norske tittelen brukes som standard, og den engelske tittelen brukes når siden vises på engelsk.
## Tips
### Bruk beskrivende titler
```ini
# Bra
title = "Om oss - Vår historie og verdier"
# Mindre bra
title = "Om oss"
```
### Skriv gode sammendrag
Sammendrag skal være 1-2 setninger som oppsummerer innholdet:
```ini
summary = "Lær hvordan du publiserer innhold enkelt og raskt med vårt system."
```
### Hold datoformatet korrekt
Bruk alltid formatet `YYYY-MM-DD`:
```ini
# Riktig
date = "2025-01-15"
# Feil
date = "15.01.2025"
date = "15/01/2025"
```