cappuccinocraft: a www.252.no Hugo theme

A beautiful, minimal Hugo theme styled with the Catppuccin Macchiato color palette. This theme features Nix flake support, custom shortcodes, modern and clean styling.

Features

• Nix Integration: Built to work seamlessly with Nix and flake-based deployments
• Catppuccin Macchiato: Beautiful pastel theme with light and dark mode support
• Zero JavaScript: Fast, lightweight, and privacy-focused
• No External Dependencies: No tracking, no spyware, no embedded fonts
• Responsive Design: Looks great on all devices
• Syntax Highlighting: Beautiful code blocks with Catppuccin colors
• Indieweb Compatible: Modern web standards and markup
• Customizable Shortcodes: Easy to use components for common content patterns

Theme Preview

The Catppuccin Macchiato color palette provides:

• Pleasant, carefully selected colors that work well in both light and dark modes
• Enhanced readability with proper color contrast
• Soothing pastel colors for a modern, clean design
• Full compatibility with system dark/light mode preferences

Installation

Standard Hugo Installation

In your Hugo site themes directory, run:

git clone https://code.252.no/pub/www.252.no-cappuccinocraft.git themes/www.252.no-cappuccinocraft

Then, update your config.toml:

theme = "cappuccinocraft"

Nix Flake Installation

This theme includes Nix flake support for reproducible builds. Add it to your flake.nix:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs";
    cappuccinocraft = {
      url = "git+https://code.252.no/pub/www.252.no-cappuccinocraft";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { self, nixpkgs, cappuccinocraft }: {
    # Your configuration here
  };
}

Configuration

Add the following to your config.toml to set site parameters:

title = "Your Site Name"
baseURL = "https://your.domain.tld"
copyright = "Your Copyright Message"

# Parameters
[params]
  subtitle = "Your Subtitle"
  dateFmt = "Monday, January 2, 2006"
  # tagPostOlderThanXDays = 555 # Display warning for older posts
  # xslpath = "/rss.xsl" # Optional RSS styling

[params.author]
  name = "Your Name" # required for h-card
  email = "your@email.tld"
  avatar = "/path/to/avatar.png"
  bio = "Your bio description<br />HTML is accepted."

# Menu Configuration
[menu]
  [[menu.main]]
        identifier = "posts"
        name = "Posts"
        url = "/posts/"
        weight = 1
  # Other menu entries...

Shortcodes

Separator

{{</* separator */>}}       <!-- Standard separator -->
{{</* separator "small" */>}} <!-- Small separator -->

Image Icon

{{</* image-icon "/path/to/icon.png" "Alt text" */>}}

Blogroll

First create a data/blogroll.json file:

[
  {
    "name": "Site Name",
    "url": "https://example.com/",
    "description": "Site description"
  }
]

Then use the shortcode:

{{</* blogroll */>}}

Syntax Highlighting

This theme uses the Catppuccin Macchiato color palette for syntax highlighting.

Code Blocks with Line Numbers

Default code blocks have no line numbers. Add line numbers with:

```yaml lineNos
version: '3'
services:
  web:
    image: nginx

Or use the shortcode:

{{</* code yaml lineNos />}} version: '3' services: web: image: nginx {{</ /code */>}}

## License

Released under the [MIT license](LICENSE.md).

CappuccinoCraft is a fork of [Minindie](https://sr.ht/~bacardi55/MinIndie/) and [Smol](https://github.com/colorchestra/smol) by [colorchestra](https://github.com/colorchestra).