Investigations
Investigations are the core content of the Ongehoord website. Each investigation documents animal welfare conditions at farms, slaughterhouses, or transport operations. This page covers everything about creating and editing investigations.
Investigation Structure
Every investigation lives in a numbered folder inside content/{locale}/onderzoek/:
content/nl/onderzoek/22.uitgemolken-transport-koeien-kalfjes/
├── index.md # Main investigation article
├── hoofdstukken/ # Chapters
│ ├── 1.chapter-slug.md
│ ├── 2.chapter-slug.md
│ └── 3.chapter-slug.md
├── locaties/ # Locations
│ ├── city-street-number.md
│ └── city-street-number.md
└── bronnen/ # Annotation sources (references)
├── 1.md
├── 2.md
└── 3.mdCreating a New Investigation
Step 1: Choose the folder number and slug
Look at the existing investigations in content/nl/onderzoek/ to find the next available number. If the last one is 22.uitgemolken-transport-koeien-kalfjes/, your new investigation should start with 23..
Choose a descriptive slug in kebab-case:
23.nieuw-onderzoek-titel/Step 2: Create the folder structure
Create the folder in both content/nl/onderzoek/ and content/en/onderzoek/ with the same name:
content/nl/onderzoek/23.nieuw-onderzoek-titel/
├── index.md
├── hoofdstukken/
├── locaties/
└── bronnen/
content/en/onderzoek/23.nieuw-onderzoek-titel/
├── index.md
├── hoofdstukken/
├── locaties/
└── bronnen/Step 3: Write the index.md
This is the main investigation page. Here's a complete template:
Dutch version (content/nl/onderzoek/23.nieuw-onderzoek-titel/index.md):
---
title: Titel van het Onderzoek
description: >-
Een korte beschrijving van het onderzoek (150-160 tekens
is ideaal voor SEO). Beschrijf wat er is gevonden.
animals:
- pig
- cow
video: https://vimeo.com/123456789
image:
src: /images/investigations/nieuw-onderzoek-titel/hero.jpg
alt: Beschrijvende alt tekst voor het beeld
date: 2026-03-01
published: false
modifiedAt: '2026-03-01'
robots: index, follow
sitemap:
changefreq: monthly
priority: 0.8
---
Hier schrijf je de introductietekst van het onderzoek. Dit is het eerste
wat bezoekers lezen op de onderzoekspagina.
Gebruik meerdere alinea's om het verhaal te vertellen.English version (content/en/onderzoek/23.nieuw-onderzoek-titel/index.md):
---
title: Investigation Title
description: >-
A short description of the investigation (150-160
characters ideal for SEO). Describe what was found.
animals:
- pig
- cow
video: https://vimeo.com/123456789
image:
src: /images/investigations/nieuw-onderzoek-titel/hero.jpg
alt: Descriptive alt text for the image
date: 2026-03-01
published: false
modifiedAt: '2026-03-01'
robots: index, follow
sitemap:
changefreq: monthly
priority: 0.8
---
Write the introduction text of the investigation here. This is the first
thing visitors read on the investigation page.WARNING
Start with published: false while you're still working on the content. Change it to true when the investigation is ready to go live.
Step 4: Set published: true
When all content is ready (chapters, locations, sources, translations), change published: true in both the NL and EN index.md files.
Adding Chapters
Chapters break an investigation into readable sections. They live in the hoofdstukken/ folder.
File naming
Use a numbered prefix to control order:
hoofdstukken/
├── 1.natuurlijk-leven.md
├── 2.leven-in-de-industrie.md
├── 3.een-zieke-industrie.md
├── 4.sterfte.md
└── 5.keurmerken.mdChapter template
---
title: Chapter Title
description: Investigation Name - Chapter Title
image:
src: /images/investigations/nieuw-onderzoek-titel/chapter-image.jpg
alt: Chapter image description
modifiedAt: '2026-03-01'
---
# First Section Heading
Your chapter content goes here. Use regular Markdown for formatting.
## Subsection
More content with **bold** and *italic* text as needed.
Writing tips for chapters
- Start each chapter with a clear heading (
#or##) - Use images to break up long text
- Keep paragraphs focused on one topic
- Use annotation sources for scientific claims (see below)
Adding Locations
Locations represent specific farms, slaughterhouses, or other sites documented in the investigation. They appear on the interactive map.
File naming
Name location files after the city and street:
locaties/
├── aalten-gendringseweg-37.md
├── hedel-parallelweg-61.md
└── someren-heikantstraat-11.mdLocation template
---
position:
lat: 51.91561
lng: 6.49327
address:
street: Gendringseweg 37
postalCode: 7122 LT
city: Aalten
country: nl
video: https://youtu.be/oC4ODPcinRs
animals:
- pig
welfareBrandKey: beter-leven-1
owner: Naam Eigenaar
organization: BL1
stableSystem: null
companyName: null
title: Beschrijvende titel van de locatie
modifiedAt: '2026-03-01'
---
Beschrijf hier wat er op deze locatie is gefilmd en aangetroffen.
Wat voor omstandigheden waren er? Wat viel op?Finding GPS coordinates
- Open Google Maps
- Right-click on the exact location
- Click the coordinates that appear at the top of the context menu
- They're now copied to your clipboard as
lat, lng
Important location fields
welfareBrandKey: Set to one of the valid brand keys (e.g.,beter-leven-1) ornullif the location has no welfare certificationcountry: Must benl(Netherlands) orbe(Belgium)organization: Can benullif not applicablestableSystemandcompanyName: Can benullor an empty string''
Annotation Sources
Annotation sources are scientific references, reports, or citations that support claims made in chapters. They provide credibility and allow readers to verify facts.
How sources work
- Source files live in
bronnen/and are numbered (1.md,2.md, etc.) - In-text annotations in chapters reference these sources by number
Creating a source file
Source files contain only the reference text — no frontmatter needed:
bronnen/1.md:
Marino, L. & Colvin, C.M. (2015) Thinking pigs: a comparative
review of cognition, emotion, and personality in Sus domesticus.
International Journal of Comparitive Psychology, 28bronnen/2.md:
Studnitz, M., Jensen, M.B. & Pedersen, L.J. (2007) Why do pigs
root and in what will they root?: A review on the exploratory
behaviour of pigs in relation to environmental enrichment.
Applied Animal Behaviour Science, 107(3-4), 183-197Referencing sources in chapters
Use the :annotation syntax to create in-text references:
Varkens zijn zeer intelligente dieren.
:annotation{:ids="[1]"}[Zo kunnen varkens objecten met
verschillende kleuren en vormen van elkaar onderscheiden.]This creates a superscript reference number that links to source 1.md in bronnen/.
Syntax breakdown:
:annotation— the component name{:ids="[1]"}— array of source numbers to reference (can be multiple:[1, 2, 3])[text in brackets]— the annotated text (the claim being sourced)
Multiple sources on one claim:
:annotation{:ids="[1, 2, 3]"}[This claim is supported by
three different studies.]Example in context:
Van nature leven varkens in groepen. :annotation{:ids="[1]"}[Varkens
wroeten ongeveer 70% van hun tijd als ze de kans krijgen en doen dit
niet alleen om voedsel te zoeken.] Met hun neus kunnen varkens ook
goed ruiken.WARNING
Make sure the source number in :ids matches an actual file in bronnen/. If you reference source [5], the file bronnen/5.md must exist.
Editing Existing Investigations
Updating text
Simply edit the markdown content in the relevant file. The dev server will hot-reload your changes.
Adding a new chapter
- Create a new file in
hoofdstukken/with the next number prefix - Create the matching file in the English version
- Add frontmatter and content
Adding a new location
- Create a new file in
locaties/named after city and street - Fill in all required frontmatter fields (coordinates, address, video, etc.)
- Create the matching file in the English version
Unpublishing
Set published: false in the index.md of both the NL and EN versions. The investigation will be hidden from the overview page and search engines but the files remain in the repository.
Checklist for a Complete Investigation
See the New Investigation Checklist for a comprehensive step-by-step guide covering folder setup, content creation, images, translations, quality checks, and publishing.