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
make server
orhugo server -D
(-D
means 'show also content marked as draft')- 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:
git submodule init themes/<theme_name>
git submodule update
- set
theme = "theme_name"
in config.toml
Site Configuration
Configuration is stored in config.toml.