mirror of
https://github.com/tiennm99/blog.git
synced 2026-10-11 03:13:10 +00:00
tiennm99
e8451d8c24
One Go binary with a subcommand per former script, invoked as 'go run ./scripts/newsletter <command>' from repo root. Stdlib only; publications config embedded via go:embed (go run recompiles on edit). Behavior parity verified side-by-side before deleting the JS — see plans/reports/parity-260818-newsletter-go-migration-report.md. Permissions: allow 'Bash(go *)', drop 'Bash(node *)' and the redundant 'Write(content)' rule (Edit rules cover all file-editing tools).
47 lines
1.6 KiB
Markdown
47 lines
1.6 KiB
Markdown
# miti99
|
|
|
|
Source of [miti99.com](https://miti99.com) — personal blog (VN/EN) built with [Hugo](https://gohugo.io) and the [Stack](https://github.com/CaiJimmy/hugo-theme-stack) theme.
|
|
|
|
## Quick start
|
|
|
|
```bash
|
|
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 scheme
|
|
- `config/_default/menu.toml` — navigation links
|
|
- `assets/` — custom CSS/JS overrides loaded on top of the Stack theme
|
|
- `layouts/` — 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/`, Go via `go run`) 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](docs/multi-tool-usage.md).
|
|
|
|
## License
|
|
|
|
Apache-2.0 — see [LICENSE](LICENSE).
|