one-post-a-year — Hugo Blog Template

SHA-256: 3c54a9bf1d8a821df4338a14cd38c7f3f1d126a0cc6bea6228698550ce21fb2e

2026-10-02T21:14:28.408Z

# One post a year

The one-post-a-year theme is a lightweight theme for [Hugo](https://gohugo.io), built with simplicity and speed in mind.

**[Demo site](https://jarv.github.io/one-post-a-year/)**

Are you starting a tech blog or already have one that has posts like this?

[<img width="600" alt="image" src="https://user-images.githubusercontent.com/749175/258733617-ba1f0276-45fa-4495-97cc-420257cdc4e5.png">](https://jarv.github.io/one-post-a-year/)

If so, then this might be the perfect theme for you!

You might ask, what makes this theme so special?

- Some themes have summaries on the main page, you probably don't have time to write a long post anyway so there is none of that, just the links.
- Like article summaries, most Hugo themes have pagination for articles. With only one post a year it's pretty unlikely that it will ever be necessary so there is no pagination.
- Limited use of dates next to articles because it's probably not something you want to highlight.
- Only uses semantic html tags, so yeah, it's pretty modern.
- Maybe you like social media icons? Nothing like that here, so if you like that stuff this is probably not the theme for you.
- Uses [Atkinson Hyperlegible](https://en.wikipedia.org/wiki/Atkinson_Hyperlegible) as the main font.
- Light and Dark theme.
- RSS feed shows the full article.
- 🆕 Allows you to customize the `<head>` and add a footer to your articles, so it's now ready for enterprise!

Design inspired by [100-bytes-of-css-to-look-great-everywhere](https://dev.to/swyx/100-bytes-of-css-to-look-great-everywhere-19pd)

## Screenshots

<table>
<tr><td>⬜️ Light</td><td><img width="600" alt="image" src="https://github.com/jarv/one-post-a-year/assets/749175/b6fd30ae-b35a-40fe-8621-1a9c52b2a458"></td></tr>
<tr><td>⬛️ Dark</td><td><img width="600" alt="image" src="https://github.com/jarv/one-post-a-year/assets/749175/9016c2c3-778c-4ee5-85d4-98e65775017c"></td></tr>
<tr><td>📱Mobile</td><td><img width="300" alt="image" src="https://github.com/jarv/one-post-a-year/assets/749175/a8fa82b5-0bb4-4274-ac62-e6b0fecad987"></td></tr>
</table>


## Documentation

### Quick start using Hugo

The best way to use this theme (or themes in general) is to vendor it, and hack on it yourself so it suites your needs.

```bash
hugo new site quickstart
cd quickstart
git init
curl -L -o one-post-a-year.zip https://github.com/jarv/one-post-a-year/archive/refs/heads/main.zip
unzip one-post-a-year.zip
echo "theme = 'one-post-a-year'" >> hugo.toml
hugo server
```

### Code Highlighting

This theme includes a light and dark style for code highlighting.
To use it, add the following configuration to your `hugo.toml`.

```
[markup]
  defaultMarkdownHandler = 'goldmark'
  [markup.highlight]
    noClasses = false
    # https://xyproto.github.io/splash/docs/longer/all.html
    # Classes included in this theme for the 'github' and 'solarized-dark' styles
```

### Head and Footer

Allows for inserting additional code directly into the `<head>` and `<footer>` sections of the template.
These can be useful for providing scripts or other logic that is very likely not configurable as part of this very simple theme.

Create either `layouts/partials/extend-head.html` or `layouts/partials/extend-footer.html` and these will automatically be included in your website build.
Both partials inject as the last items in `<head>` and `<footer>`.

---
Why? I use this for my own site [jarv.org](https://jarv.org) which sometimes occasionally has more than one update in a year.