tiennm99
8a368471f3
- post/list.html paginated section list with post-card - pagination.html partial (renders only when >1 page) - _default/taxonomy.html for term lists (/tags/, /categories/) with counts - taxonomy/term.html for single term pages (paginated posts) - archives/list.html + archive-group.html: year/month grouped flat list - exampleSite: 4 new posts across 2025-2026, 2 categories, 4 tags, archive index Modern Hugo 0.146+ template naming: term.html resolved via taxonomy/ path (Hugo 0.154 lookup ignores _default/term.html).
blog
Source of miti99.com — personal blog (VN/EN) built with Hugo and the Stack theme.
Quick start
git submodule update --init --recursive
hugo server -D
Site available at http://localhost:1313.
Content structure
Posts live under content/post/YYYY/MM/DD/index.md. Each post is a Hugo leaf bundle — images and assets sit next to index.md in the same directory.
content/
post/
2024/
03/
15/
index.md ← post content (Vietnamese / English)
cover.jpg ← optional cover image
page/ ← standalone pages (about, projects, …)
Theme customization
Theme config lives in config/ (Hugo config directory split). Key overrides:
config/_default/params.toml— sidebar, avatar, footer, color schemeconfig/_default/menu.toml— navigation linksassets/— custom CSS/JS overrides loaded on top of the Stack themelayouts/— template overrides (add a file here to override any Stack partial)
The Stack theme is pulled in as a git submodule under themes/hugo-theme-stack/.
Working with AI tools
This repo runs from Claude Code, OpenCode, or Codex off one shared engine (scripts/newsletter/, Node — run npm ci once, then node scripts/newsletter <command>; see docs/newsletter/engine-commands.md) and one instruction file (AGENTS.md). Repository-scoped Codex skills use the official .agents/skills/ format; no installer is required. Setup, invocation per tool, and how to pick one and remove the rest: see docs/multi-tool-usage.md.
License
Apache-2.0 — see LICENSE.