From c1d13b435bf515ad0fb1389282d672e5049703b8 Mon Sep 17 00:00:00 2001 From: Thanwer Date: Sat, 23 May 2026 18:45:31 +0200 Subject: [PATCH] Update AGENTS.md after Gitea migration - Replace the rsync-from-laptop deploy story with the Gitea Actions workflow that now writes directly to /srv/www/www on the host. - Add Repository section: clone URL + default branch is master. - Note the Hugo 0.123+ template-field breakage we hit in the blog repo, in case a future theme update trips the same wires. Co-Authored-By: Claude Opus 4.7 --- AGENTS.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 25020cb..b5afa1c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,17 +4,30 @@ Personal CV/resume Hugo site using the [EuroZephyr](https://codeberg.org/gbilder/eurozephyr) theme (git submodule from Codeberg). No test/lint/typecheck infrastructure. +## Repository + +- Primary: `ssh://git@git.thanwer.com:2222/thanwer/www.git` (self-hosted Gitea) +- Default branch: `master` (not `main`) +- GitHub mirror is being retired. + ## Content All content is in `data/{en,pt,de}.yaml` — there is **no** `content/` directory. Profile image referenced as `/images/profile.png` in data but actual file is `static/images/profile.jpg`. +## Deploy + +Pushes to `master` trigger `.gitea/workflows/deploy.yml` on the shinobi gitea-runner: it builds Hugo and writes directly into the host's `/srv/www/www` via a bind-mounted volume. Caddy on the same host serves from there for both `www.thanwer.com` and `thanwer.com`. + +`deploy.sh` (legacy rsync-from-laptop) is kept as a manual fallback. + ## Commands | Command | Purpose | |---------|---------| | `hugo server -D` | Dev server with drafts | | `hugo --minify` | Production build | -| `./deploy.sh` | Build + rsync to `shinobi.thanwer.com:/srv/www/www/` | +| `git push` | Triggers Gitea Actions deploy | +| `./deploy.sh` | Fallback: build + rsync from laptop | No npm/build step needed — `hugo` alone is sufficient. @@ -22,6 +35,8 @@ No npm/build step needed — `hugo` alone is sufficient. Remote submodule. `min_version = "0.146.0"`. Custom overrides in `layouts/partials/` (profile-image, head, skillbar shortcode). +When updating the submodule, watch for the same Hugo 0.123+ template-field breakage we hit in the blog repo (`site.Locale` and `.Language.Label` were removed). If the theme starts failing on a Hugo bump, see `blog/AGENTS.md` for the replacement-field cheat sheet. + ## Config - `config/_default/config.toml` — baseURL, theme, default language