Content Structure
All website content lives in the content/ folder at the root of the project. This page explains how everything is organized.
Top-Level Layout
content/
├── nl/ # Dutch content (primary language)
│ ├── animals/ # Animal definitions (JSON)
│ ├── onderzoek/ # Investigations
│ ├── over-ons/ # About page sections
│ └── welfare-brands/ # Welfare brand definitions (JSON)
│
└── en/ # English content (mirror of nl/)
├── animals/
├── onderzoek/
├── over-ons/
└── welfare-brands/Important
The Dutch (nl/) and English (en/) folders must mirror each other exactly. Every folder name, file name, and slug must be identical in both languages. Only the text content and frontmatter values like title and description differ.
How Folders Map to URLs
| Folder | URL |
|---|---|
content/nl/over-ons/index.md | /nl/over-ons |
content/en/over-ons/index.md | /en/over-ons |
content/nl/onderzoek/index.md | /nl/onderzoek |
content/nl/onderzoek/2.het-leven-van-een-varken/index.md | /nl/onderzoek/het-leven-van-een-varken |
The locale prefix (nl/ or en/) in the folder maps to the URL prefix. The numbered prefix on folders (like 2.) is stripped from the URL — it only controls ordering.
The Four Content Types
1. Investigations (onderzoek/)
This is the main content of the website. Each investigation is a numbered folder containing:
onderzoek/
├── index.md # Investigation overview page
├── 2.het-leven-van-een-varken/
│ ├── index.md # Investigation article
│ ├── hoofdstukken/ # Chapters
│ │ ├── 1.natuurlijk-leven.md
│ │ ├── 2.leven-in-de-industrie.md
│ │ └── 3.een-zieke-industrie.md
│ ├── locaties/ # Locations (farms, slaughterhouses)
│ │ ├── aalten-gendringseweg-37.md
│ │ └── hedel-parallelweg-61.md
│ └── bronnen/ # Annotation sources (references)
│ ├── 1.md
│ ├── 2.md
│ └── 3.mdKey folder names (these are Dutch and must not change):
hoofdstukken/— Chapters of the investigationlocaties/— Locations filmed during the investigationbronnen/— Annotation sources (scientific references, citations)
See Investigations for the complete guide on adding and editing investigations.
2. About Page (over-ons/)
The about page is built from numbered section files:
over-ons/
├── index.md # Page metadata (title, description, image)
├── 01.hero.md # Hero section
├── 02.onze-positie.md # Our position
├── 03.systeemproblemen.md
├── 04.delen.md
├── 05.onderzoeken.md
├── 06.eten.md
├── 07.actie.md
└── 08.doneren.mdEach numbered file becomes a section on the about page. The number prefix controls the display order.
3. Animals (animals/)
Simple JSON files that define animal types used across the site:
{
"name": "Varken",
"plural": "Varkens",
"key": "pig"
}Valid animal keys: chicken-egg, chicken-meat, cow, deer, mink, pig, rabbit, turkey
4. Welfare Brands (welfare-brands/)
JSON files defining welfare certification brands:
{
"label": "Beter Leven",
"subLabel": "1 ster",
"key": "beter-leven-1"
}Valid welfare brand keys: beter-leven-1, beter-leven-2, beter-leven-3, caring-farmers, eko, parkkonijn
Numbered Prefixes
Many files and folders use numbered prefixes to control their order:
| Pattern | Example | Purpose |
|---|---|---|
N.slug/ | 2.het-leven-van-een-varken/ | Investigation ordering |
NN.slug.md | 01.hero.md | Section ordering on a page |
N.slug.md | 1.natuurlijk-leven.md | Chapter ordering |
TIP
The number prefix is stripped from the URL. A folder named 2.het-leven-van-een-varken/ produces the URL /onderzoek/het-leven-van-een-varken.
When adding a new investigation, use the next available number. For example, if the last investigation is 22.uitgemolken-transport-koeien-kalfjes/, the next one should be 23.your-new-investigation/.
The index.md Convention
Every folder that represents a page needs an index.md file. This file contains:
- Frontmatter (metadata between
---lines) — title, description, images, SEO data - Body content (below the frontmatter) — the actual page text in Markdown
Example:
---
title: Het leven van een varken
description: Het onderzoeksteam bezocht 26 varkensfokkers...
image:
src: /images/investigations/het-leven-van-een-varken/hero.jpg
alt: Het leven van een varken
date: 2011-06-19
published: true
---
The body content goes here. This is regular Markdown.Content Schemas
Every content type has a schema defined in content.config.ts at the project root. The schema defines which frontmatter fields are required and what values they accept. If you add a field that doesn't match the schema, the build will fail.
See the Frontmatter Reference for the complete list of fields for each content type.
File Naming Rules
- Use kebab-case for all file and folder names:
het-leven-van-een-varken, notHet Leven Van Een Varken - Use lowercase only
- Separate words with hyphens (
-) - Location files are named after the city and street:
aalten-gendringseweg-37.md - Source files are numbered:
1.md,2.md,3.md