packit.dev website content

Clone

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

Hugo

The website is generated by Hugo (see also the documentation). If you want to contribute to our website content and want to see how your contribution would look like, you have to install Hugo on your machine.

Fedora

$ dnf install hugo
$ hugo help

CentOS/Epel

$ dnf copr enable daftaupe/hugo
$ dnf install hugo

MacOS

Add new post

$ hugo new posts/packit-xyz.md

Content

All content is organized in content directory tree.

A newly hugo new created content file contains only title and date metadata in the front matter. You should also add weight to re-arrange your post in the file-tree menu. If you want your post to be the uppermost one, set the weight to a value (one) lesser than the currently last/uppermost post has.

Start Hugo server

1. hugo server
2. Web Server

Rebuild content & Github Pages

It's done automatically with each push to main. 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.