Skip to content

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:

ToolWhyInstall
GitVersion control — track and share changesgit-scm.com
Node.js 22+Runs the development servernodejs.org
pnpmPackage manager (installs dependencies)corepack enable then corepack use pnpm
Code editorEdit files — VS Code recommendedcode.visualstudio.com

Setting Up Your Environment ​

1. Clone the repository ​

bash
git clone https://github.com/Ongehoord/website.git
cd website

2. Install dependencies ​

bash
pnpm install

3. Start the development server ​

bash
pnpm dev

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

  1. Start the dev server (pnpm dev)
  2. Find the file you want to edit in the content/ folder
  3. Edit the file in your code editor
  4. Check your changes in the browser (auto-refreshes)
  5. Commit and push your changes
bash
git add .
git commit -m "content: update investigation description"
git push

The website will automatically redeploy after your changes are merged.

What's in This Guide ​

SectionWhat you'll learn
Content StructureHow files and folders are organized
Frontmatter ReferenceEvery field you can use in content files
InvestigationsAdding and editing investigation articles
ImagesWorking with photos and media
TranslationsManaging Dutch and English content
Automation ScriptsAI-powered grammar, readability, and translation tools
Publishing WorkflowGit workflow, commits, and deployment

Markdown Basics ​

If you're new to Markdown, here's a quick reference:

markdown
# 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)

![Image alt text](/images/investigations/<slug>/example.jpg)

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