mirror of
https://github.com/tiennm99/miti99.git
synced 2026-09-19 22:22:42 +00:00
tiennm99
d0bf8bd347
Switches every call site to `node scripts/newsletter` and, in the same pass, fixes three structural problems in the skill layer. The seven subcommands were spelled out in five files; they are now enumerated once in docs/newsletter/engine-commands.md, and every other mention is a link except where a skill inlines the one or two commands it actually invokes. The shared post mechanics move out of mt-add-url's directory into docs/newsletter/, so no skill owns another skill's documentation and both runtimes reach it by a repository-relative path. The Codex adapters become symlinks to their canonical counterparts, which removes the parallel frontmatter that could drift. Two skills are renamed for a uniform mt-<verb>-<object> scheme: mt-add-post becomes mt-add-article, since it adds an article to a post, and mt-webfetch becomes mt-fetch-url. The other four already conformed. Note that $mt-add-post and mt-webfetch no longer resolve; no alias directories are left behind, because two names for one skill is the duplication this change removes. Trigger wording in the frontmatter descriptions is left alone apart from the renamed tokens and the corrected fetch-tier summary: those strings are how the runtimes decide whether to invoke a skill. Setup documentation now states the npm ci prerequisite. The engine has dependencies, so unlike its predecessor it does not run on a bare clone.
47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
# blog
|
|
|
|
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/`, Node — run `npm ci` once, then `node scripts/newsletter <command>`; see [docs/newsletter/engine-commands.md](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](docs/multi-tool-usage.md).
|
|
|
|
## License
|
|
|
|
Apache-2.0 — see [LICENSE](LICENSE).
|