Projects

Showcase your work, research projects, case studies, and portfolio items. Add links, featured images, and connect projects to publications.

Showcase your research projects, software tools, case studies, or portfolio items. Projects support featured images, external links, tags, and can be connected to related publications and events.

Quick Start

Open the Ownable sidebar in VS Code.
Click + (Create) next to the Projects collection.
Enter a title and press Enter.

Install Ownable CMS for visual project management.

hugo new content/projects/my-project/index.md

Create a folder: content/projects/my-project/
Add index.md with the frontmatter below.
Optionally add featured.jpg for a thumbnail.

File Structure

_index.md # Project listing page

index.md # Project page

featured.jpg # Thumbnail / hero image

index.md

featured.png

screenshot.png # Additional images

Use page bundles (folder + index.md) for projects so you can include screenshots and assets.

Frontmatter Template

---
title: "My App"
date: 2024-06-01

# Summary for listing cards
summary: "An open-source tool for automated data analysis."

# Tags for filtering
tags:
  - Python
  - Data Science
  - Open Source

# Featured image
image:
  filename: featured.jpg
  caption: "Screenshot of My App"
  focal_point: Smart

# Links displayed as buttons
links:
  - name: Demo
    url: https://demo.example.com
    icon: globe
  - name: Code
    url: https://github.com/user/project
    icon: brands/github
  - name: Paper
    url: /publication/my-paper/
    icon: document

# External link (clicking project card opens this URL)
external_link: ""

# Shorthand link fields
url_code: ""
url_pdf: ""
url_slides: ""
url_video: ""

# Pin to top of listings
featured: true

# Draft
draft: false
---

## About This Project

Describe your project in detail using Markdown. Include motivation, methodology, results, and impact.

## Results

Add figures, tables, and discussion.

## How to Use

Include installation instructions, usage examples, or API documentation.

Project Listing Page

The listing page at /projects/ automatically shows all projects as cards with thumbnails, summaries, and tags.

Customizing the Listing

content/projects/_index.md

---
title: Projects
---

Visitors can filter projects by tag by clicking on tag labels.

Linking Projects to Publications

Reference a project from a publication's frontmatter to create bidirectional links:

content/publications/my-paper/index.md

---
title: "Research Paper"
projects:
  - my-app    # Matches the project folder name
---

The publication will show a link to the project page.

Quick Reference

Field	Type	Description
`title`	`string`	Project name (required)
`date`	`date`	Project date
`summary`	`string`	Short description for listing cards
`tags`	`list`	Tags for filtering
`image.filename`	`string`	Featured image
`links`	`list`	Action buttons (name, url, icon)
`external_link`	`string`	External URL (card click target)
`featured`	`bool`	Pin to top of listings
`draft`	`bool`	Hide from published site