57 lines
2.6 KiB
Markdown
57 lines
2.6 KiB
Markdown
# AGENTS.md — Thanwer's Blog
|
|
|
|
## Project
|
|
|
|
Hugo blog (multilingual EN + PT-BR) using the **anubis2** theme as a git submodule (`themes/anubis2`, v1.6.0). Deployed via rsync to a VPS.
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
hugo server # dev server at localhost:1313
|
|
hugo # build to ./public/
|
|
./deploy.sh # hugo --minify && rsync to server
|
|
```
|
|
|
|
No tests, linter, or typecheck.
|
|
|
|
## Content conventions
|
|
|
|
- **Posts**: `content/posts/<slug>.md` (EN), `content/posts/<slug>.pt.md` (PT-BR)
|
|
- **Images**: `static/images/<filename>` — referenced as `/images/<filename>` in markdown
|
|
- **PT translations** set `canonical = "/posts/<en-slug>"` in frontmatter to point to the English original
|
|
- **`lastmod`** in frontmatter must use bare TOML datetime (no quotes): `lastmod = 2026-05-09T00:00:00Z`. With `enableGitInfo = true`, the template prefers `.Params.lastmod` over git dates — avoid `'<string>'` quoted format (Hugo stores it as string, not `time.Time`)
|
|
- **Archetype**: `hugo new posts/<slug>.md` uses `archetypes/default.md`
|
|
- **Tags** only (no categories used): `tags = ["GNU/Linux", "Tools"]`
|
|
|
|
## Theme overrides (site `layouts/` shadows theme)
|
|
|
|
- `layouts/partials/head.html` — overrides theme head: adds canonical from frontmatter (`Params.canonical`), production-only Umami analytics
|
|
- `layouts/partials/post-info.html` — overrides theme: prefers `.Params.lastmod` over `.Lastmod` (git override), shows "Last modified" when `lastmod ≠ date`
|
|
- `layouts/partials/footer-extra.html` — Ko-fi floating chat widget
|
|
- `layouts/robots.txt` — custom sitemap entries for both languages
|
|
|
|
## Configuration quirks
|
|
|
|
- Theme expects **all lowercase keys** under `params.anubis2`: `colortheme`, `enablecolorthemeswitcher`, `readnextposts`, `socialicons`, etc. — see `themes/anubis2/PARAMS.md`
|
|
- `[params.anubis2.services.umami]` uses lowercase keys: `id`, `url`
|
|
- Analytics only inject in production (`hugo.IsProduction`). For testing analytics locally: `hugo server --environment production`
|
|
- Config uses modern Hugo keys: `locale` (not `languageCode`), `label` (not `languageName`)
|
|
- `enableGitInfo = true` — `.Lastmod` is derived from git; template falls back to frontmatter `lastmod` when set
|
|
|
|
## Frontmatter reference
|
|
|
|
```toml
|
|
date = 2024-10-26T16:59:23-03:00
|
|
lastmod = 2026-05-09T00:00:00Z # bare datetime, no quotes
|
|
title = 'Post Title'
|
|
description = "One-line summary for SEO and RSS"
|
|
tags = ["tag1", "tag2"]
|
|
canonical = "/posts/original-post" # PT translations only
|
|
```
|
|
|
|
## Deprecated Hugo keys (avoid)
|
|
|
|
- `languageCode` → use `locale`
|
|
- `languageName` → use `label`
|
|
- `.Site.LanguageCode` → use `.Site.Language.Locale`
|