Example: How to Add Projects

completed

Template showing all available project features and how to use them

Hugo Markdown YAML

Overview

This is an example project showing all the features available in the project system.

Adding Your Own Projects

Create a new file in content/projects/your-project-name.md with this structure:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
---
title: "Your Project Title"
tagline: "One-line description"
status: "active"  # or "ongoing", "completed", "archived"
year: "2023-2024"
role: "Principal Investigator"
image: "/images/projects/your-image.jpg"
technologies:
  - "Technology 1"
  - "Technology 2"
collaborators:
  - "Partner Institution"
funding: "Funding Body (£XXk)"
demo_url: "https://..."
github_url: "https://github.com/..."
paper_url: "https://doi.org/..."
project_posts:
  - "/blog/post-about-this-project"
tags:
  - "tag1"
  - "tag2"
---

Your project content in Markdown...

Project Features

Status Badges

  • active - Currently working on it
  • ongoing - Long-term project
  • completed - Finished
  • archived - Historical reference

Technology Tags

List the key technologies, languages, or methodologies used.

Link to blog posts about this project using the project_posts parameter.

  • demo_url - Live demo or product
  • github_url - Code repository
  • paper_url - Published research

Adding Images

  1. Place your image in: static/images/projects/your-image.jpg
  2. Reference it as: image: "/images/projects/your-image.jpg"
  3. See IMAGES-GUIDE.md for details

Linking Blog Posts

In blog post front matter, add:

1
project: "climate"  # matches the project filename

Or list posts in the project’s project_posts parameter.