tiennm99
49107f6164
- 9 CSS files (tokens, reset, typography, layout, components, home, archive, toc, view-transitions) bundled via resources.Concat - 3 ES module JS files (theme-toggle, code-copy, toc-active); toc-active loaded only on long posts - @view-transition: navigation auto for cross-page morph (CSS-only) - TOC partial gated by WordCount>400 and Params.toc!=false; sticky on wide viewports, framed block on narrow - render-heading.html adds cosmetic anchor links - Hugo asset pipeline: resources.Concat | minify | fingerprint (no SCSS, no PostCSS, no Node) - i18n/vi.yml extended with prev/next/posts/archiveEmpty/toggleTheme - Bundle sizes: CSS 3.3 KB gz (budget 15), JS 0.8 KB gz (budget 8) Config: github-ascii heading IDs, :contentbasename permalink token for clean ASCII URLs, pagination.pagerSize migration (Hugo 0.128+).
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.