packit.dev website content
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
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.
$ dnf install hugo
$ hugo help
$ dnf copr enable daftaupe/hugo
$ dnf install hugo
$ brew install hugo
$ hugo new posts/packit-xyz.md
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.
hugo server- Web Server
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.
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
Configuration is stored in config.toml.