packit.dev

packit.dev website content

Hugo

Installation

This repository uses git submodules, so you have to git clone --recurse-submodules it. If you forget and realize later, just run:

$ git submodule init themes/book
$ git submodule update

Fedora

$ dnf install hugo
$ hugo help

There's also a copr repo, but the newer versions not always work as expected, you have to experiment a bit:

$ dnf copr enable daftaupe/hugo

MacOS

$ brew install hugo

Add new post

$ hugo new posts/packit-xyz.md

Content

All content is organized in content directory tree.

Start Hugo server

1. make server or hugo server -D (-D means 'show also content marked as draft')
2. Web Server

Rebuild content & Github Pages

It's done automatically with each push to master. We use Hugo Deploy GitHub Pages Action configured in .github/workflows/deploy-pages.yml which pushes the generated content into packit/packit.dev-github-pages from where the Github Pages are served. The secret used by the action is stored in settings/secrets.

Themes

Currently, we use Book theme. For complete list of themes for Hugo, see this. If you want to use a new theme:

1. git submodule init themes/<theme_name>
2. git submodule update
3. set theme = "theme_name" in config.toml

Site Configuration

Configuration is stored in config.toml.