Overview

A lightweight, easily-managed rebuild of the OpenFlightHPC project's history & existing projects.

Content

There are 2 types of content for the website

Labs

Lab content is a single blog post that describes the purpose and understanding of a tool we've experimented with.

Create a lab element under content/labs/ and probably include the following frontmatter:

---
title: My Experiment
description: Experimenting with my things
date: 2025-12-25
params:
  status: active
  source: https://example.com
---

Probably make date reflective of when the experiment was done and status either active or archived.

Knowledge

Knowledge content are categorised guides/documentation.

Create a parent folder reflective of the category/series that documentation relates to and then the file, such as content/knowledge/my-series/first-page.md and probably include the following frontmatter:

---
title: First Page
description The first page description
weight: 1
toc: true
---

The directory holding the doc will be it's "Section", add metadata (like name and description) by creating an _index.md file within the section's directory (e.g. content/knowledge/my-series/_index.md). Weight is a number, think of it as page number (starting at 1 and going up).

To link to other pages within the website sensibly use the shortcode helper in markdown:

[LINK_TEXT]({{< relref "path/to/markdown-file-without-extension" >}}) 

Dev

• Run dev server on localhost (http://localhost:1313)

hugo server -F -D --cleanDestinationDir

Release

The site is hosted with statichost.uk. Automated deployments are not configured. To deploy, login to that dashboard and click deploy.

OLD

To build the site simply

hugo --cleanDestinationDir

Then sync the contents of public/ to the web root of a web server somewhere (probably want to remove any existing old/stuff so something like rsync -auv --delete)