Update AGENTS.md after Gitea migration
All checks were successful
Deploy / deploy (push) Successful in 5s

- 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 <noreply@anthropic.com>
This commit is contained in:
Thanwer 2026-05-23 18:45:31 +02:00
parent 3441e6b457
commit c1d13b435b

View File

@ -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. 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 ## 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`. 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 ## Commands
| Command | Purpose | | Command | Purpose |
|---------|---------| |---------|---------|
| `hugo server -D` | Dev server with drafts | | `hugo server -D` | Dev server with drafts |
| `hugo --minify` | Production build | | `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. 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). 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
- `config/_default/config.toml` — baseURL, theme, default language - `config/_default/config.toml` — baseURL, theme, default language