Skip to content

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.md

Creating 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):

yaml
---
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):

yaml
---
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.md

Chapter template ​

yaml
---
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.

![Optional inline image](/images/investigations/nieuw-onderzoek-titel/inline-image.jpg)

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.md

Location template ​

yaml
---
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

  1. Open Google Maps
  2. Right-click on the exact location
  3. Click the coordinates that appear at the top of the context menu
  4. 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) or null if the location has no welfare certification
  • country: Must be nl (Netherlands) or be (Belgium)
  • organization: Can be null if not applicable
  • stableSystem and companyName: Can be null or 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 ​

  1. Source files live in bronnen/ and are numbered (1.md, 2.md, etc.)
  2. 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, 28

bronnen/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-197

Referencing sources in chapters ​

Use the :annotation syntax to create in-text references:

markdown
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:

markdown
:annotation{:ids="[1, 2, 3]"}[This claim is supported by
three different studies.]

Example in context:

markdown
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 ​

  1. Create a new file in hoofdstukken/ with the next number prefix
  2. Create the matching file in the English version
  3. Add frontmatter and content

Adding a new location ​

  1. Create a new file in locaties/ named after city and street
  2. Fill in all required frontmatter fields (coordinates, address, video, etc.)
  3. 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.