www/AGENTS.md
Thanwer c1d13b435b
All checks were successful
Deploy / deploy (push) Successful in 5s
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 <noreply@anthropic.com>
2026-05-23 18:45:31 +02:00

45 lines
1.8 KiB
Markdown

# AGENTS.md — www.thanwer.com
## Overview
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 |
| `git push` | Triggers Gitea Actions deploy |
| `./deploy.sh` | Fallback: build + rsync from laptop |
No npm/build step needed — `hugo` alone is sufficient.
## Theme
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
- `config/_default/languages.toml` — en (1), pt (2), de (3)
- `config/_default/params.toml` — layout sidebar/main sections, formatting, Dracula theme