hoelee
2df67b6c50
Deploy / build (push) Successful in 36s
Listings render `pubDate` but sorted by `updatedDate ?? pubDate`, so any
post carrying both dates sorted by a date it never displayed. After the
backdate commit the two diverged by years and the list read out of order
("January 7, 2026" above "September 13, 2026", "March 11, 2026" below
"December 10, 2025").
Replace `sortByUpdated` with `sortForListing`, which orders by `pubDate`
and uses `updatedDate` only as a tiebreak. This matches the RSS feed,
which already sorted by `pubDate`.
Verified all three listings (EN, EN homepage, ZH) are monotonically
non-increasing across the full 2024-09 -> 2026-09 span.
hoelee-blog
My personal technical blog — where I write about what I build and learn.
Built with Astro 5 + Markdown, deployed via self-hosted Gitea CI/CD to an nginx container on my unRaid server, served through Cloudflare tunnel + CDN. Live at blog.hoelee.com.
Purpose (read this first)
This blog exists so that when a recruiter, hiring manager, or freelance client Googles "Lee Teong Hoe", they land on a stream of concrete technical work that proves I can build things — plus a clear, trustworthy picture of who I am. It backs the job hunt and the freelance funnel (Upwork / Fiverr / Codeable).
- 67% of hiring managers check a candidate's online presence before deciding (Stack Overflow 2025).
- SEO is a long game — while posts rank, the blog doubles as a portfolio and inbound-lead magnet.
Every decision below optimizes for credibility + discoverability + speed of shipping, not monetization or vanity traffic.
Stack
- Framework: Astro 5 (static output, zero runtime JS by default)
- Content: Markdown + MDX, versioned in git
- i18n: English (default) + Chinese (
zh) — English-first - CI/CD: Gitea Actions →
act_runneron unRaid → nginx container - Host: nginx on unRaid → Cloudflare tunnel → Cloudflare CDN
Structure
src/
content/
posts/ # English posts (flat)
zh/ # Chinese posts (subfolder -> /posts/zh/<slug>/)
pages/
index.astro # homepage
posts/[...slug].astro # post template
about.astro
layouts/
BaseLayout.astro
lib/
lang.ts # derives en/zh from folder path
docs/
content-guide.md # what to write, what to avoid (READ before writing a post)
post-guideline.md # HOW to write it: title case, locale, frontmatter, publish flow
design-guide.md # what the design must have, what to avoid (READ before touching UI)
seo-reference.md # E-E-A-T / name identity, SEO + GEO checklist, syndication
ops-runbook.md # pipeline, publish steps, build pitfalls, health checks
project-state.md # enhancement backlog (Tier 1/2/3) — work through one by one
Knowledge guides (my rules of thumb)
| Doc | When to read |
|---|---|
docs/content-guide.md |
Before writing/planning any blog post — categories, post types, the "hard job → post" template, and the anti-patterns. |
docs/post-guideline.md |
Before writing/editing a post — title case, locale folder structure, frontmatter, publish flow. |
docs/design-guide.md |
Before changing theme, layout, typography, color, or SEO markup. |
docs/seo-reference.md |
Before adding posts/<head> markup or debugging search visibility. |
docs/ops-runbook.md |
Before debugging CI/CD, deployment, or hosting. |
docs/project-state.md |
To see what's next — the prioritized enhancement backlog. |
Write a post
- Create
src/content/posts/<slug>.md(English) orsrc/content/posts/zh/<slug>.md(Chinese) with frontmatter (see content guide — nolang:field, it's derived from the folder). - Push to
main. - CI builds and deploys automatically.
Categories
engineering · devops · ai · web3 · tutorials · case-studies · notes
Conventions
- Repo publishing order: push to git.hoelee.com (Gitea) first, then GitHub. (My standing convention.)
- Language: English posts flat in
posts/; Chinese posts inposts/zh/; no Malay. - Theme: defaults to dark mode (light is opt-in via the toggle).
- No overclaiming — especially Web3 (learning projects, not production DeFi).
- Name identity is consistent everywhere: "Lee Teong Hoe" / "Mr Hoelee" + same photo + same
sameAshandles across blog, LinkedIn, GitHub, git.hoelee.com.