tiennm99/blog
1
0 Fork 0
mirror of https://github.com/tiennm99/blog.git synced 2026-10-14 00:16:34 +00:00
Code Issues Packages Projects Releases Wiki Activity
559 Commits 4 Branches 0 Tags
fc65a04a7b0d8ac4bd411366adf4f89dfc67f555
Commit Graph
559 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
tiennm99 fc65a04a7b fix: post-v0.2.0 review P1s + CI hygiene (v0.2.1) 
Security:
- render-link: drop `| safeHTML` on .Text (self-XSS surface w/ Goldmark unsafe:true)
- projects.html: safeURL + noreferrer + target=_blank on repo/demo
- comments: require repo+repoId+categoryId in gate (prevent broken Giscus iframe)
- htmltest-action: pin to commit SHA 31be84a (supply-chain)

Fixed:
- seo.html: nil-safe \$authorURL chain (no nil.url template error)
- nav.html: relURL on Menu.URL (sub-path deploy correctness)
- pages.yml: drop dead if-find Pagefind guard
 2026-05-10 03:04:58 +07:00
tiennm99 7125b3e324 chore: archive v0.2.0 roadmap, add prerelease checklist 
The 7-phase v0.2.0 implementation roadmap is shipped (commits
6e17ee6..5d73a13). Move it under plans/archive/ so plans/ root only
shows active work.

Add plans/260509-0947-v0.2.0-prerelease-checklist/ capturing what's
left before the v0.2.0 tag and gallery submission: action SHA pin,
phase-07 plan-todo accuracy fix, CI watch, journal, tag, plus
maintainer decisions (Q1 unsafe Goldmark, Q3 audience) and external
tasks (hugoBasicExample smoke, hugoThemes registry PR).
 2026-05-09 09:52:00 +07:00
tiennm99 1491b3b491 refactor: consolidate TOC gate, inline single-call SEO partial, prune unused i18n 
- Extract duplicated TOC predicate to _partials/toc-enabled.html
  (single.html + footer.html were both computing the same 6-line gate).
- Inline _partials/head/og-image.html into head/seo.html — single caller,
  the fallback chain is the contract; the partial wasn't earning its
  override surface.
- Drop 6 unused i18n keys: postedOn, tags, categories, archive, noResults,
  copyright. None referenced by any template (verified via grep). Also
  removed an accidental duplicate of the callout title block; vi.yml
  reorganized into thematic groups.

Behavior unchanged. Smoke (11 checks) + Hugo build clean. CSS bundle
unchanged at 3962 B gz.
 2026-05-09 09:45:57 +07:00
tiennm99 dbca4964dd docs: v0.2.0 changelog and implementation roadmap 
Document all v0.2.0 phases (audit, a11y, SEO, UX, discovery, release, CI)
with detailed changes. Archive implementation plan and research reports.
 2026-05-09 09:32:44 +07:00
tiennm99 04ad6154b0 ci: htmltest smoke tests and build validation 
Add htmltest configuration, smoke test script, CSS budget assertion in CI
pipeline for quality gates.
 2026-05-09 09:32:40 +07:00
tiennm99 2dc6f8d55f chore(release): theme metadata, module mounts, installation guide 
Update theme.toml with v0.2.0, configure module mounts for clean theme
structure, add comprehensive installation documentation.
 2026-05-09 09:32:36 +07:00
tiennm99 ea3c47ded7 feat: related posts discovery with configurable algorithm 
Add related posts sidebar component, configure related: block in Hugo config,
enable readers to discover similar content.
 2026-05-09 09:32:33 +07:00
tiennm99 56add1e997 feat: native Markdown callouts, reading time, archetype scaffold 
Add blockquote-to-callout rendering, reading time estimate, improved default
archetype with demo callout content and Vietnamese translations.
 2026-05-09 09:32:29 +07:00
tiennm99 fd7702cdc7 feat(seo): JSON-LD Article schema and OG/Twitter cards 
Add semantic structured data and social sharing metadata for better
discoverability and previews across platforms.
 2026-05-09 09:32:25 +07:00
tiennm99 dd88949e97 feat(a11y): skip-link, focus rings, render hooks, giscus paint fix 
Add skip-to-content link, enhance focus indicators, implement custom render
hooks for links and images, fix giscus dark mode paint issue.
 2026-05-09 09:32:21 +07:00
tiennm99 8b023f39bd fix: address v0.1.0 audit findings and security notes 
Fixes issues flagged in audit: improve footer spacing, meta tag refinement,
code-copy utility robustness, and add security notes to data schemas.
 2026-05-09 09:32:17 +07:00
tiennm99 1aad10f7d2 chore: add 1500x1000 screenshot and 900x600 thumbnail for theme gallery 
Captured via puppeteer headless Chrome from local exampleSite build.
 2026-05-07 22:26:50 +07:00
tiennm99 0bf2521918 feat: docs, changelog, expanded examples for v0.1.0 (Phase 8) 
- docs/config.md: full params reference (required + optional + per-post
  frontmatter); explains why theme defaults don't deep-merge into
  consumer sites
- docs/data-schemas.md: profile.yaml + projects.yaml field tables
- docs/customization.md: layout overrides, design token override via
  custom CSS, font self-hosting, per-page color overrides, kill switches
- docs/migrating-from-stack.md: submodule swap, drop list, Stack-to-tsuki
  param mapping, frontmatter compat, gotchas (heading id changes break
  inbound anchor links)
- CHANGELOG.md: complete 0.1.0 entry covering all phases
- README.md: drop "under construction"; add full params snippet, search
  + comments + browser support sections, links to all docs
- exampleSite/data/projects.yaml: +tsuki, +penny-pincher (6 total)

Screenshots, miti99 migration, and v0.1.0 tag are user-driven actions
recorded in phase-08 plan.
 2026-05-07 22:20:44 +07:00
tiennm99 80dd906827 feat: Pagefind search and Giscus comments (Phase 7) 
- search/list.html: Pagefind UI container + module init with full vi
  i18n strings; loads /pagefind/pagefind-ui.{css,js} from generated dir
- search-button.html in header, gated by params.search.enable
- comments.html for Giscus, opt-in via params.comments.giscus.enable;
  reads repo/repoId/category/categoryId/mapping/theme/lang from params
- giscus-theme.js: MutationObserver on data-theme, postMessage iframe
  on toggle so Giscus theme stays in sync with site
- search.css: header-actions row, search button, Pagefind UI tokens
  mapped to tsuki design tokens
- comments.css: min-block-size on iframe to prevent layout shift
- exampleSite/hugo.yaml: commented giscus params block as docs
- i18n/vi.yml: Pagefind UI strings (clear, loadMore, zeroResults...)

Both features no-op when disabled. CSS bundle 3.5 KB gz (budget 15).
 2026-05-07 22:03:32 +07:00
tiennm99 49107f6164 feat: visual layer with vi typography, dark mode, view transitions (Phase 6) 
- 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+).
 2026-05-07 21:27:46 +07:00
tiennm99 8a368471f3 feat: posts, taxonomies, archive (Phase 5) 
- 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).
 2026-05-07 21:10:28 +07:00
tiennm99 a9b858bd9e feat: homepage personal portfolio (Phase 4) 
- data/profile.yaml schema: name, handle, tagline, avatar, bio, links
- data/projects.yaml schema: featured projects with title, tagline, repo, demo, image, tags
- _partials/home/hero.html: avatar + name + tagline + bio + social links
- _partials/home/projects.html: data-driven project grid
- _partials/home/recent-posts.html: configurable count, view-all link
- home.html composes hero → projects → recent-posts
- assets/icons: github, mail, rss (Lucide-style)
- exampleSite fixtures: profile, 4 projects, 5 SVG placeholder images
 2026-05-07 20:53:06 +07:00
tiennm99 a6b1b6ab55 feat: core layouts and partials (Phase 3) 
- baseof.html with named blocks (head_extra, body_class, main, scripts)
- single.html with data-pagefind-body wrapper
- list.html using post-card partial
- home.html placeholder (Phase 4 fills hero/projects/recent-posts)
- 404.html with vi i18n
- _partials: head (full meta + OG + Twitter Card + RSS autodiscovery + theme-flash script), header, nav, footer, meta, post-card, icon
- Sample post fixture in exampleSite to validate render

ci: bump GitHub Actions to Node 24-compatible versions

- actions/checkout v4 → v6
- actions/setup-node v4 → v6, node 20 → 22
- actions/upload-pages-artifact v3 → v5
- actions/deploy-pages v4 → v5
 2026-05-07 20:45:31 +07:00
tiennm99 046a1622e6 ci: skip Pagefind step when no HTML pages exist yet 2026-05-07 20:29:33 +07:00
tiennm99 8edfa80acc build: add package-lock.json for npm cache in CI 2026-05-07 20:28:23 +07:00
tiennm99 94500a8e3d feat: initial theme scaffold 
- Repo metadata: theme.toml, README, Apache-2.0 license
- Hugo defaults: vi language, post permalinks, taxonomies, paginate, TOC config
- exampleSite skeleton with themesDir wiring
- CI: Hugo build + Pagefind index + Pages deploy
- Pagefind devDependency in package.json (Dependabot weekly)
- vi i18n strings, default archetype
- Empty layouts/_partials/_markup/_shortcodes directories ready for Phase 3
 2026-05-07 20:27:07 +07:00
tiennm99 5d36f5966c Initial commit 2026-05-07 20:25:16 +07:00
github-actions[bot] c083129bc9 chore(projects): refresh projects list 2026-10-04 02:34:26 +07:00
tiennm99 93798350bc docs(referral): add Hermes Agent Cloud referral 2026-10-03 09:30:40 +07:00
github-actions[bot] 8eb701f110 chore(projects): refresh projects list 2026-10-03 04:04:47 +07:00
tiennm99 c5efe95cac docs(referral): refresh current deals and offers 2026-10-02 10:45:26 +07:00
tiennm99 d464b5df8e docs(referral): remove ended OpenCode Go referral 2026-10-02 09:57:16 +07:00
tiennm99 b5a80e3ab6 docs(referral): remove BigModel.cn and Claude Code guest pass entries 2026-10-02 09:00:02 +07:00
github-actions[bot] afd1d56ca1 chore(projects): refresh projects list 2026-10-02 04:30:01 +07:00
github-actions[bot] 2550fbe79d chore(projects): refresh projects list 2026-10-01 04:04:46 +07:00
github-actions[bot] 58261a01cb chore(projects): refresh projects list 2026-09-30 17:07:37 +07:00
github-actions[bot] 1a68d064d5 chore(projects): refresh projects list 2026-09-30 16:58:10 +07:00
github-actions[bot] 470b0a143d chore(projects): refresh projects list 2026-09-30 16:37:51 +07:00
github-actions[bot] c1cb997311 chore(projects): refresh projects list 2026-09-30 16:22:09 +07:00
github-actions[bot] f03bb0f287 chore(projects): refresh projects list 2026-09-30 04:07:31 +07:00
github-actions[bot] b1174df458 chore(projects): refresh projects list 2026-09-29 05:18:57 +07:00
tiennm99 318098d384 docs(newsletter): restore original source titles on article headings 2026-09-28 09:33:15 +07:00
tiennm99 8574eee45e docs(newsletter): mark dead links, fix headings and tags 2026-09-28 09:25:58 +07:00
github-actions[bot] c84fccf0e3 chore(projects): refresh projects list 2026-09-28 02:54:30 +07:00
tiennm99 c0ddcb17b8 docs(newsletter): rewrite newsletters with Opus 5.5 2026-09-27 21:47:31 +07:00
tiennm99 574a830e03 feat(newsletter): protect code, verdicts and author notes in rewrites 
protected-lines now keeps fenced code blocks (re-indent allowed) and
**Đánh giá:** verdict lines, and leaves summary sub-headings and short
italic key-point labels rewritable. The rewrite skill skips posts
without the AI-Assisted tag.
 2026-09-27 21:47:31 +07:00
tiennm99 5804366438 feat(newsletter): add mt-rewrite-newsletter skill and protected-lines guard 2026-09-27 21:47:30 +07:00
github-actions[bot] 4710af385f chore(projects): refresh projects list 2026-09-27 02:29:20 +07:00
github-actions[bot] a53a9f5e07 chore(projects): refresh projects list 2026-09-26 03:10:28 +07:00
github-actions[bot] ba76a170fc chore(projects): refresh projects list 2026-09-25 03:12:20 +07:00
github-actions[bot] 5e6a84b9a4 chore(projects): refresh projects list 2026-09-24 02:54:13 +07:00
github-actions[bot] 21dcce6067 chore(projects): refresh projects list 2026-09-23 02:57:16 +07:00
github-actions[bot] e5f28ef941 chore(projects): refresh projects list 2026-09-22 03:41:18 +07:00
github-actions[bot] 76dd8c9622 chore(projects): refresh projects list 2026-09-21 02:09:31 +07:00
github-actions[bot] 20c4e27dc2 chore(projects): refresh projects list 2026-09-20 02:02:07 +07:00