53 lines
1.6 KiB
Markdown
53 lines
1.6 KiB
Markdown
|
# Filbasert routing
|
|||
|
|
|
|||
|
|
FolderWebs routing er vakkert enkelt: **mappestrukturen din er URL-strukturen din**. Ingen konfigurasjonsfiler, ingen rutedefinisjon, ingen magiske strenger.
|
|||
|
|
|
|||
|
|
## Hvordan det fungerer
|
|||
|
|
|
|||
|
|
Når du besøker en URL, ser FolderWeb etter matchende mapper og filer:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
/content/
|
|||
|
|
├── index.md → /
|
|||
|
|
├── om/
|
|||
|
|
│ └── index.md → /om/
|
|||
|
|
└── blogg/
|
|||
|
|
├── 2024-11-01-innlegg/
|
|||
|
|
│ └── index.md → /blogg/innlegg/
|
|||
|
|
└── index.md → /blogg/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Automatiske funksjoner
|
|||
|
|
|
|||
|
|
**Mappenavn blir URL-er** – Lag en mappe kalt `prosjekter` og den er umiddelbart tilgjengelig på `/prosjekter/`
|
|||
|
|
|
|||
|
|
**Datoprefikser fjernes** – `2024-11-01-mitt-innlegg` blir `/mitt-innlegg/` i URL-en
|
|||
|
|
|
|||
|
|
**Egendefinerte slugs via metadata** – Overstyr standard URL med `slug = "egendefinert-url"` i `metadata.ini`
|
|||
|
|
|
|||
|
|
**Avsluttende skråstrek** – Kataloger omdirigerer alltid til å inkludere avsluttende skråstrek for konsistens
|
|||
|
|
|
|||
|
|
## Eksempel
|
|||
|
|
|
|||
|
|
Denne siden demonstrerer filbasert routing! Stien er:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
app/default/content/examples/file-based-routing/index.no.md
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Som rendres på:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
/examples/file-based-routing/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Ingen ruter å definere. Ingen konfigurasjon å oppdatere. Bare filer og mapper.
|
|||
|
|
|
|||
|
|
## Fordeler
|
|||
|
|
|
|||
|
|
- **Intuitivt** – Hvis du kan navigere mapper, forstår du routingen
|
|||
|
|
- **Refaktorvennlig** – Å flytte innhold betyr å flytte mapper
|
|||
|
|
- **Ingen ødelagte lenker** – URL-er matcher filsystemet
|
|||
|
|
- **Rask** – Ingen rutematching overhead, direkte filoppslag
|
|||
|
|
- **Forutsigbar** – Det du ser er det du får
|