Skip to content

Commit e86c259

Browse files
Stensel8Copilot
Stensel8
and
Copilot
authored
feat: add Podman & Podman Desktop documentation (#30)
## Summary - Add full Podman guide under virtualization (EN + NL) covering installation, registry configuration, and Docker Hub/GitHub PAT setup - Add short Podman section to applications page with package links - Add auto-convert workflow (.github/workflows/convert-images.yml) that converts PNG/JPG to AVIF on push and commits the result back - Simplify homepage to hero + system table only; all tiles now live on /docs/ - Rename "Looking Glass Attempt" to "Looking Glass B7" across titles and tiles - Fix navigation chain: winboat → podman → known-issues - Add Podman tile to docs index (EN + NL) ## Type of change <!-- Check all that apply --> - [x] `feat` — new page or feature - [ ] `fix` — bug fix (broken link, incorrect command, layout issue) - [x] `content` — update or improve existing content - [x] `docs` — changes to CONTRIBUTING, README, or meta documentation - [x] `chore` — maintenance (dependencies, config, CI/CD) - [ ] `refactor` — restructuring without content changes - [ ] `style` — formatting, whitespace, typos ## Checklist - [x] PR title follows the commit convention (e.g. `fix: correct nmcli command in eduroam guide`) - [x] Both EN and NL versions updated (if applicable) - [x] Media is in AVIF format (not PNG/JPG) - [x] No broken image references (`/images/*.avif` all exist in `static/images/`) - [x] Tested locally with `hugo server` --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
1 parent 0e6428a commit e86c259

23 files changed

Lines changed: 422 additions & 208 deletions

‎.github/workflows/convert-images.yml‎

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
name: Convert images to AVIF
2+
3+
on:
4+
push:
5+
branches-ignore:
6+
- main
7+
paths:
8+
- "static/images/**"
9+
10+
permissions:
11+
contents: write
12+
13+
jobs:
14+
convert:
15+
name: PNG/JPG to AVIF
16+
runs-on: ubuntu-latest
17+
steps:
18+
- uses: actions/checkout@v6
19+
20+
- name: Install avifenc
21+
run: sudo apt-get update -y && sudo apt-get install -y libavif-apps
22+
23+
- name: Convert and update references
24+
id: convert
25+
run: |
26+
changed=false
27+
sed_script="$(mktemp)"
28+
29+
while IFS= read -r -d '' f; do
30+
[ -f "$f" ] || continue
31+
dir="$(dirname "$f")"
32+
name="$(basename "${f%.*}")"
33+
outfile="${dir}/${name}.avif"
34+
35+
if avifenc -q 80 -s 6 "$f" "$outfile"; then
36+
rm "$f"
37+
# Build static-relative paths for markdown reference replacement
38+
rel_src="${f#static}"
39+
rel_dst="${outfile#static}"
40+
# Escape regex metacharacters (. [ \ * ^ $) in the source path
41+
esc_src="$(printf '%s\n' "$rel_src" | sed 's/[.[\*^$]/\\&/g')"
42+
# Accumulate substitutions; apply in one pass after the loop
43+
printf 's|%s|%s|gI\n' "$esc_src" "$rel_dst" >> "$sed_script"
44+
changed=true
45+
echo "Converted: $f"
46+
else
47+
echo "Failed to convert: $f, skipping." >&2
48+
fi
49+
done < <(find static/images -type f \( -iname "*.png" -o -iname "*.jpg" -o -iname "*.jpeg" \) -print0)
50+
51+
# Single pass over all markdown files with all substitutions at once
52+
if [ "$changed" = "true" ]; then
53+
find content -name "*.md" -exec sed -i -f "$sed_script" {} +
54+
fi
55+
rm -f "$sed_script"
56+
57+
echo "changed=$changed" >> "$GITHUB_OUTPUT"
58+
59+
- name: Commit converted images
60+
if: steps.convert.outputs.changed == 'true'
61+
run: |
62+
git config user.name "github-actions[bot]"
63+
git config user.email "github-actions[bot]@users.noreply.github.com"
64+
git add static/images/ content/
65+
git commit -m "chore: auto-convert images to AVIF"
66+
git push

‎content/_index.md‎

Lines changed: 0 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -43,101 +43,3 @@ toc: false
4343
| **Secure Boot** | Enabled |
4444

4545
![System information overview](/images/system-info.avif)
46-
47-
## Getting Started
48-
49-
{{< hextra/feature-grid >}}
50-
{{< hextra/feature-card
51-
title="Getting Started"
52-
subtitle="From fresh CachyOS install to fully configured system"
53-
icon="play"
54-
link="docs/getting-started"
55-
>}}
56-
{{< /hextra/feature-grid >}}
57-
58-
## Hardware & Drivers
59-
60-
{{< hextra/feature-grid >}}
61-
{{< hextra/feature-card
62-
title="NVIDIA Driver Installation"
63-
subtitle="Proprietary NVIDIA drivers with Secure Boot on CachyOS"
64-
icon="chip"
65-
link="docs/hardware/nvidia-driver-installation"
66-
>}}
67-
{{< hextra/feature-card
68-
title="Secure Boot"
69-
subtitle="Custom signing keys with sbctl, UEFI Secure Boot enabled"
70-
icon="shield-check"
71-
link="docs/hardware/secure-boot"
72-
>}}
73-
{{< hextra/feature-card
74-
title="asusctl & ROG Control Center"
75-
subtitle="Fan curves, performance profiles, GPU switching, Slash LED"
76-
icon="adjustments"
77-
link="docs/hardware/asusctl-rog-control"
78-
>}}
79-
{{< /hextra/feature-grid >}}
80-
81-
## Security & Privacy
82-
83-
{{< hextra/feature-grid >}}
84-
{{< hextra/feature-card
85-
title="YubiKey 5C NFC"
86-
subtitle="FIDO2 LUKS unlock and what currently works"
87-
icon="key"
88-
link="docs/security/yubikey"
89-
>}}
90-
{{< hextra/feature-card
91-
title="GDM Autologin"
92-
subtitle="Skip GDM login after LUKS unlock"
93-
icon="lock-open"
94-
link="docs/security/autologin"
95-
>}}
96-
{{< /hextra/feature-grid >}}
97-
98-
## Applications
99-
100-
{{< hextra/feature-grid >}}
101-
{{< hextra/feature-card
102-
title="Applications"
103-
subtitle="Browser, communication, development tools, and system configuration"
104-
icon="collection"
105-
link="docs/applications"
106-
>}}
107-
{{< /hextra/feature-grid >}}
108-
109-
## Networking
110-
111-
{{< hextra/feature-grid >}}
112-
{{< hextra/feature-card
113-
title="eduroam Network Installation"
114-
subtitle="PEAP/MSCHAPv2 setup that actually works on Linux"
115-
icon="wifi"
116-
link="docs/networking/eduroam-network-installation"
117-
>}}
118-
{{< /hextra/feature-grid >}}
119-
120-
## Virtualization
121-
122-
{{< hextra/feature-grid >}}
123-
{{< hextra/feature-card
124-
title="Windows 11 VM Setup"
125-
subtitle="KVM/QEMU VM with VirtIO and SPICE GL"
126-
icon="desktop-computer"
127-
link="docs/virtualization/vm-setup"
128-
>}}
129-
{{< hextra/feature-card
130-
title="Looking Glass Attempt"
131-
subtitle="GPU passthrough attempt, not working on this hardware"
132-
icon="eye"
133-
link="docs/virtualization/looking-glass-attempt"
134-
>}}
135-
{{< hextra/feature-card
136-
title="WinBoat"
137-
subtitle="Windows apps on Linux via Podman container, early beta"
138-
icon="beaker"
139-
link="docs/virtualization/winboat"
140-
>}}
141-
{{< /hextra/feature-grid >}}
142-
143-
---

‎content/_index.nl.md‎

Lines changed: 0 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -43,101 +43,3 @@ toc: false
4343
| **Secure Boot** | Ingeschakeld |
4444

4545
![Systeeminformatie-overzicht](/images/system-info.avif)
46-
47-
## Aan de slag
48-
49-
{{< hextra/feature-grid >}}
50-
{{< hextra/feature-card
51-
title="Aan de slag"
52-
subtitle="Van schone CachyOS-installatie tot volledig geconfigureerd systeem"
53-
icon="play"
54-
link="docs/getting-started"
55-
>}}
56-
{{< /hextra/feature-grid >}}
57-
58-
## Hardware & Drivers
59-
60-
{{< hextra/feature-grid >}}
61-
{{< hextra/feature-card
62-
title="NVIDIA Driver Installatie"
63-
subtitle="Proprietary NVIDIA drivers met Secure Boot op CachyOS"
64-
icon="chip"
65-
link="docs/hardware/nvidia-driver-installation"
66-
>}}
67-
{{< hextra/feature-card
68-
title="Secure Boot"
69-
subtitle="Aangepaste ondertekeningssleutels met sbctl, UEFI Secure Boot ingeschakeld"
70-
icon="shield-check"
71-
link="docs/hardware/secure-boot"
72-
>}}
73-
{{< hextra/feature-card
74-
title="asusctl & ROG Control Center"
75-
subtitle="Fan curves, performance profielen, GPU switching, Slash LED"
76-
icon="adjustments"
77-
link="docs/hardware/asusctl-rog-control"
78-
>}}
79-
{{< /hextra/feature-grid >}}
80-
81-
## Beveiliging & Privacy
82-
83-
{{< hextra/feature-grid >}}
84-
{{< hextra/feature-card
85-
title="YubiKey 5C NFC"
86-
subtitle="FIDO2 LUKS-poging en wat vandaag werkt"
87-
icon="key"
88-
link="docs/security/yubikey"
89-
>}}
90-
{{< hextra/feature-card
91-
title="GDM Autologin"
92-
subtitle="GDM-inlogscherm overslaan na LUKS-ontgrendeling"
93-
icon="lock-open"
94-
link="docs/security/autologin"
95-
>}}
96-
{{< /hextra/feature-grid >}}
97-
98-
## Applicaties
99-
100-
{{< hextra/feature-grid >}}
101-
{{< hextra/feature-card
102-
title="Applicaties"
103-
subtitle="Browser, communicatie, ontwikkeltools en systeemconfiguratie"
104-
icon="collection"
105-
link="docs/applications"
106-
>}}
107-
{{< /hextra/feature-grid >}}
108-
109-
## Netwerk
110-
111-
{{< hextra/feature-grid >}}
112-
{{< hextra/feature-card
113-
title="eduroam Setup"
114-
subtitle="PEAP/MSCHAPv2 configuratie die daadwerkelijk werkt op Linux"
115-
icon="wifi"
116-
link="docs/networking/eduroam-network-installation"
117-
>}}
118-
{{< /hextra/feature-grid >}}
119-
120-
## Virtualisatie
121-
122-
{{< hextra/feature-grid >}}
123-
{{< hextra/feature-card
124-
title="Windows 11 VM Setup"
125-
subtitle="KVM/QEMU VM met VirtIO en SPICE GL"
126-
icon="desktop-computer"
127-
link="docs/virtualization/vm-setup"
128-
>}}
129-
{{< hextra/feature-card
130-
title="Looking Glass Poging"
131-
subtitle="GPU passthrough poging (werkt niet op deze hardware)"
132-
icon="eye"
133-
link="docs/virtualization/looking-glass-attempt"
134-
>}}
135-
{{< hextra/feature-card
136-
title="WinBoat"
137-
subtitle="Windows-apps op Linux via Podman container, vroege beta"
138-
icon="beaker"
139-
link="docs/virtualization/winboat"
140-
>}}
141-
{{< /hextra/feature-grid >}}
142-
143-
---

‎content/docs/_index.md‎

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -91,11 +91,17 @@ Everything I've documented while running CachyOS on the ROG Zephyrus G16. Start
9191
link="virtualization/vm-setup"
9292
>}}
9393
{{< hextra/feature-card
94-
title="Looking Glass Attempt"
95-
subtitle="GPU passthrough attempt, not working on this hardware"
94+
title="Looking Glass B7"
95+
subtitle="GPU passthrough via Looking Glass, not working on this hardware"
9696
icon="eye"
9797
link="virtualization/looking-glass-attempt"
9898
>}}
99+
{{< hextra/feature-card
100+
title="Podman & Podman Desktop"
101+
subtitle="Docker replacement with rootless containers and a desktop GUI"
102+
icon="server"
103+
link="virtualization/podman"
104+
>}}
99105
{{< /hextra/feature-grid >}}
100106
101107
## Known Issues

‎content/docs/_index.nl.md‎

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -91,11 +91,17 @@ Alles wat ik heb opgeschreven tijdens het draaien van CachyOS op de ROG Zephyrus
9191
link="virtualization/vm-setup"
9292
>}}
9393
{{< hextra/feature-card
94-
title="Looking Glass Poging"
95-
subtitle="GPU passthrough poging, werkt niet op deze hardware"
94+
title="Looking Glass B7"
95+
subtitle="GPU passthrough via Looking Glass, werkt niet op deze hardware"
9696
icon="eye"
9797
link="virtualization/looking-glass-attempt"
9898
>}}
99+
{{< hextra/feature-card
100+
title="Podman & Podman Desktop"
101+
subtitle="Docker-vervanging met rootless containers en een desktop GUI"
102+
icon="server"
103+
link="virtualization/podman"
104+
>}}
99105
{{< /hextra/feature-grid >}}
100106
101107
## Bekende Problemen

‎content/docs/applications.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -352,6 +352,18 @@ After saving, Archi appears in the GNOME app launcher:
352352

353353
![Archi running on Wayland with GNOME 49](/images/archi-running.avif)
354354

355+
### Podman & Podman Desktop
356+
357+
For container workloads I use Podman instead of Docker. Podman is daemonless, runs containers rootless by default, and ships a Docker-compatible CLI so existing workflows keep working. `podman-docker` replaces the `docker` package entirely.
358+
359+
All three packages are available in the CachyOS repositories: [podman](https://packages.cachyos.org/package/cachyos-extra-znver4/x86_64_v4/podman), [podman-docker](https://packages.cachyos.org/package/cachyos-extra-znver4/x86_64_v4/podman-docker), [podman-desktop](https://packages.cachyos.org/package/extra/x86_64/podman-desktop).
360+
361+
```bash
362+
sudo pacman -S podman podman-docker podman-desktop
363+
```
364+
365+
For the full setup — including registry configuration and connecting Docker Hub and GitHub — see [Podman & Podman Desktop]({{< relref "/docs/virtualization/podman" >}}) in the Virtualization section.
366+
355367
---
356368

357369
## Gaming & Media

‎content/docs/applications.nl.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -352,6 +352,18 @@ Na het opslaan verschijnt Archi in de GNOME-app launcher:
352352

353353
![Archi draaiend op Wayland met GNOME 49](/images/archi-running.avif)
354354

355+
### Podman & Podman Desktop
356+
357+
Voor container workloads gebruik ik Podman in plaats van Docker. Podman heeft geen daemon, draait containers standaard rootless en levert een Docker-compatibele CLI zodat bestaande workflows gewoon blijven werken. `podman-docker` vervangt het `docker`-pakket volledig.
358+
359+
Alle drie de pakketten zijn beschikbaar in de CachyOS-repositories: [podman](https://packages.cachyos.org/package/cachyos-extra-znver4/x86_64_v4/podman), [podman-docker](https://packages.cachyos.org/package/cachyos-extra-znver4/x86_64_v4/podman-docker), [podman-desktop](https://packages.cachyos.org/package/extra/x86_64/podman-desktop).
360+
361+
```bash
362+
sudo pacman -S podman podman-docker podman-desktop
363+
```
364+
365+
Voor de volledige setup — inclusief registryconfiguratie en het koppelen van Docker Hub en GitHub — zie [Podman & Podman Desktop]({{< relref "/docs/virtualization/podman" >}}) in de Virtualisatie-sectie.
366+
355367
---
356368

357369
## Games & Media

‎content/docs/known-issues.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Known Issues"
33
weight: 7
4-
prev: docs/virtualization/winboat
4+
prev: docs/virtualization/podman
55
---
66

77
Central reference for hardware and software issues on the ASUS ROG Zephyrus G16 GA605WV. Active issues are listed first. Resolved issues are kept as reference at the bottom.

‎content/docs/known-issues.nl.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Bekende Problemen"
33
weight: 7
4-
prev: docs/virtualization/winboat
4+
prev: docs/virtualization/podman
55
---
66

77
Centrale referentie voor hardware- en softwareproblemen op de ASUS ROG Zephyrus G16 GA605WV. Actieve problemen staan bovenaan. Opgeloste problemen staan onderaan als naslagwerk.

‎content/docs/virtualization/_index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,4 @@ weight: 6
44
toc: false
55
---
66

7-
Running Windows workloads and GPU passthrough experiments on the Zephyrus G16.
7+
Running Windows workloads, GPU passthrough experiments, and container workloads on the Zephyrus G16.

0 commit comments

Comments
 (0)