153 lines
2.8 KiB
Markdown
153 lines
2.8 KiB
Markdown
|
|
# Metadata-referanse
|
||
|
|
|
||
|
|
PnP støtter valgfrie metadatafiler for forbedret innholdskontroll.
|
||
|
|
|
||
|
|
## Filformat
|
||
|
|
|
||
|
|
Metadatafiler bruker INI-formatet og må hete `metadata.ini`.
|
||
|
|
|
||
|
|
## Plassering
|
||
|
|
|
||
|
|
Plasser `metadata.ini` i samme mappe som innholdsfilen din:
|
||
|
|
|
||
|
|
```
|
||
|
|
/content/blogg/2025-01-15-innlegg/
|
||
|
|
├── article.md
|
||
|
|
├── metadata.ini
|
||
|
|
└── cover.jpg
|
||
|
|
```
|
||
|
|
|
||
|
|
## Støttede felt
|
||
|
|
|
||
|
|
### `title`
|
||
|
|
**Type**: String
|
||
|
|
**Påkrevd**: Nei
|
||
|
|
**Standard**: Hentet fra første H1 i innholdet eller mappenavn
|
||
|
|
|
||
|
|
Overstyr sidetittelen.
|
||
|
|
|
||
|
|
```ini
|
||
|
|
title = "Min egendefinerte tittel"
|
||
|
|
```
|
||
|
|
|
||
|
|
### `date`
|
||
|
|
**Type**: Dato (YYYY-MM-DD)
|
||
|
|
**Påkrevd**: Nei
|
||
|
|
**Standard**: Hentet fra mappenavn eller filmodifiseringstidspunkt
|
||
|
|
|
||
|
|
Sett publiseringsdatoen.
|
||
|
|
|
||
|
|
```ini
|
||
|
|
date = "2025-01-15"
|
||
|
|
```
|
||
|
|
|
||
|
|
### `lastModified`
|
||
|
|
**Type**: Dato (YYYY-MM-DD)
|
||
|
|
**Påkrevd**: Nei
|
||
|
|
**Standard**: Ingen
|
||
|
|
|
||
|
|
Spor når innholdet sist ble oppdatert.
|
||
|
|
|
||
|
|
```ini
|
||
|
|
lastModified = "2025-02-10"
|
||
|
|
```
|
||
|
|
|
||
|
|
### `summary`
|
||
|
|
**Type**: String
|
||
|
|
**Påkrevd**: Nei
|
||
|
|
**Standard**: Ingen
|
||
|
|
|
||
|
|
Gi et sammendrag for listevisninger.
|
||
|
|
|
||
|
|
```ini
|
||
|
|
summary = "En kort beskrivelse av dette innholdet."
|
||
|
|
```
|
||
|
|
|
||
|
|
### `menu`
|
||
|
|
**Type**: Boolean
|
||
|
|
**Påkrevd**: Nei
|
||
|
|
**Standard**: false
|
||
|
|
|
||
|
|
Vis denne siden i navigasjonsmenyen.
|
||
|
|
|
||
|
|
```ini
|
||
|
|
menu = true
|
||
|
|
```
|
||
|
|
|
||
|
|
### `menu_order`
|
||
|
|
**Type**: Integer
|
||
|
|
**Påkrevd**: Nei
|
||
|
|
**Standard**: 999
|
||
|
|
|
||
|
|
Rekkefølgen for menyvisning (lavere tall vises først).
|
||
|
|
|
||
|
|
```ini
|
||
|
|
menu_order = 1
|
||
|
|
```
|
||
|
|
|
||
|
|
### `slug`
|
||
|
|
**Type**: String
|
||
|
|
**Påkrevd**: Nei
|
||
|
|
**Standard**: Mappenavn
|
||
|
|
|
||
|
|
Egendefinert URL-slug for oversatte versjoner.
|
||
|
|
|
||
|
|
```ini
|
||
|
|
slug = "about"
|
||
|
|
```
|
||
|
|
|
||
|
|
## Flerspråklig metadata
|
||
|
|
|
||
|
|
For flerspråklige sider kan du legge til språkspesifikke seksjoner:
|
||
|
|
|
||
|
|
```ini
|
||
|
|
title = "Om oss"
|
||
|
|
summary = "Lær mer om oss"
|
||
|
|
menu = true
|
||
|
|
|
||
|
|
[en]
|
||
|
|
title = "About us"
|
||
|
|
summary = "Learn more about us"
|
||
|
|
slug = "about"
|
||
|
|
```
|
||
|
|
|
||
|
|
PnP vil automatisk bruke riktig seksjon basert på nåværende språk.
|
||
|
|
|
||
|
|
## Fullstendig eksempel
|
||
|
|
|
||
|
|
Fullstendig metadata.ini-eksempel:
|
||
|
|
|
||
|
|
```ini
|
||
|
|
title = "Forstå PnP-ruting"
|
||
|
|
date = "2025-01-15"
|
||
|
|
lastModified = "2025-01-20"
|
||
|
|
summary = "Lær hvordan PnPs mappebaserte rutingssystem fungerer og hvorfor det er designet for lang levetid."
|
||
|
|
menu = true
|
||
|
|
menu_order = 3
|
||
|
|
|
||
|
|
[en]
|
||
|
|
title = "Understanding PnP Routing"
|
||
|
|
summary = "Learn how PnP's folder-based routing system works and why it's designed for longevity."
|
||
|
|
slug = "routing"
|
||
|
|
```
|
||
|
|
|
||
|
|
## Fallback-atferd
|
||
|
|
|
||
|
|
Hvis metadata.ini ikke er til stede:
|
||
|
|
- Tittel: Hentet fra første H1 i markdown/HTML, eller mappenavn
|
||
|
|
- Dato: Hentet fra mappenavn (YYYY-MM-DD-*) eller filmodifiseringstidspunkt
|
||
|
|
- Sammendrag: Vises ikke
|
||
|
|
- Meny: Vises ikke i navigasjon
|
||
|
|
|
||
|
|
## Bruke metadata i egendefinerte maler
|
||
|
|
|
||
|
|
Metadata er tilgjengelig i maler via `$metadata`-variabelen:
|
||
|
|
|
||
|
|
```php
|
||
|
|
<?php if ($metadata && isset($metadata['custom_field'])): ?>
|
||
|
|
<p><?= htmlspecialchars($metadata['custom_field']) ?></p>
|
||
|
|
<?php endif; ?>
|
||
|
|
```
|
||
|
|
|
||
|
|
Du kan legge til egendefinerte felt i metadata.ini og bruke dem i malene dine.
|