The official website for the BlueZ Linux Bluetooth protocol stack, built with Hugo.
- Hugo (extended edition recommended)
Start a local development server with live reload:
hugo serverThe site will be available at http://localhost:1313.
hugo --minifyOutput is written to the public/ directory.
The homepage is a single page assembled from partials in this order:
- Header
- Hero
- Features
- Modules
- Profiles
- News
- Footer links
- Footer
Most homepage sections are driven by YAML files in data/:
| File | Section |
|---|---|
data/features.yaml |
Features list |
data/modules.yaml |
Modules grid |
data/profiles.yaml |
Profiles/people |
data/footer_links.yaml |
Footer link columns |
Edit these files to update the content in those sections. Each file is self-documenting through its existing entries.
News cards on the homepage and the full news listing at /news/ are generated from Markdown files under content/news/.
Use the built-in archetype to scaffold a new article. Include the publication year as a subfolder:
hugo new news/2026/my-article-title.mdThis creates content/news/2026/my-article-title.md pre-filled with the required front matter. Hugo picks up the news archetype automatically regardless of the year subfolder in the path.
| Field | Required | Description |
|---|---|---|
title |
Yes | Article headline displayed on cards and the article page |
date |
Yes | Publication date (YYYY-MM-DD); controls sort order |
summary |
Yes | Short description shown on news cards |
image |
No | Path to a card thumbnail image (relative to assets/images/news/) |
hero_image |
No | Path to a larger hero image shown at the top of the article page |
draft |
— | Set to false (or remove) to publish; true hides the article from the build |
Example:
---
title: "Release of BlueZ 6.0"
date: 2026-04-17
draft: false
summary: "BlueZ 6.0 brings major improvements to LE Audio and ISO socket support."
image: ""
hero_image: ""
---Write the article body in Markdown below the front matter. Fenced code blocks are supported.
Place news images in assets/images/news/ and reference them by filename in the front matter fields above.
hugo.toml is the single configuration point for automatic card images:
defaultNewsImageis used by articles without animagevalue.weeklyReportImagesis the ordered, circular list used for weekly reports. Add, remove, or rename entries to change the rotation and its count.
The site is deployed automatically to GitHub Pages via .github/workflows/hugo.yml on pushes to the main branch.