Getting Started
This guide explains everything you need to know about editing content on the Ongehoord website. Whether you're writing a new investigation, updating an existing page, or translating content — this is your reference.
How the Website Works
The Ongehoord website is built with Nuxt and uses Nuxt Content to turn Markdown files into web pages. This means:
- You write content in
.md(Markdown) files - Each file has a frontmatter block at the top (between
---lines) with metadata like title, description, and images - The website automatically builds pages from these files
- Content exists in two languages: Dutch (nl) and English (en)
You don't need to know how to code — you just need to edit Markdown files and follow the conventions described in this guide.
Prerequisites
To work on the website content, you need:
| Tool | Why | Install |
|---|---|---|
| Git | Version control — track and share changes | git-scm.com |
| Node.js 22+ | Runs the development server | nodejs.org |
| pnpm | Package manager (installs dependencies) | corepack enable then corepack use pnpm |
| Code editor | Edit files — VS Code recommended | code.visualstudio.com |
Setting Up Your Environment
1. Clone the repository
git clone https://github.com/Ongehoord/website.git
cd website2. Install dependencies
pnpm install3. Start the development server
pnpm devThe website is now running at http://localhost:3000. Any changes you make to content files will automatically appear in the browser.
Quick Editing Workflow
Here's the simplest path to making a content change:
- Start the dev server (
pnpm dev) - Find the file you want to edit in the
content/folder - Edit the file in your code editor
- Check your changes in the browser (auto-refreshes)
- Commit and push your changes
git add .
git commit -m "content: update investigation description"
git pushThe website will automatically redeploy after your changes are merged.
What's in This Guide
| Section | What you'll learn |
|---|---|
| Content Structure | How files and folders are organized |
| Frontmatter Reference | Every field you can use in content files |
| Investigations | Adding and editing investigation articles |
| Images | Working with photos and media |
| Translations | Managing Dutch and English content |
| Automation Scripts | AI-powered grammar, readability, and translation tools |
| Publishing Workflow | Git workflow, commits, and deployment |
Markdown Basics
If you're new to Markdown, here's a quick reference:
# Heading 1
## Heading 2
### Heading 3
Regular paragraph text. **Bold text** and *italic text*.
- Bullet list item
- Another item
1. Numbered list
2. Second item
[Link text](https://example.com)
TIP
You can preview Markdown rendering in VS Code by pressing Ctrl+Shift+V (or Cmd+Shift+V on Mac).
Getting Help
- Technical issues: Ask a developer on the team
- Content questions: Check the relevant section in this guide
- Something broken?: Don't panic — Git tracks every change, so nothing is ever truly lost