mirror of
https://github.com/tiennm99/iammiti99.git
synced 2026-10-15 00:17:36 +00:00
tiennm99
d79a1a1e54
Closes #8. Opt-in via `params.rss = true` (off by default). When enabled: - layouts/index.rss.xml renders an RSS 2.0 feed of [[params.links]] at /index.xml — one <item> per link, pubDate = build time - head.html emits <link rel="alternate" type="application/rss+xml"> - Users must remove "RSS" from their disableKinds to let Hugo emit it Channel populated from params.{name,tagline,bio} and site.BaseURL. Item shape: <title> = link title, <link> = link URL, <guid isPermaLink="false"> = bonsai-link-{url}, optional <description>. XML declaration uses safeHTML+printf to defeat Hugo's default escape (otherwise '<?xml ... ?>' becomes '<?xml ... ?>' and breaks parsers). exampleSite enables rss=true to demo the feature; verified output parses as valid XML via Python ElementTree.
iammiti99
Personal link-in-bio page — built with Hugo and the bonsai theme. Self-hosted Linktree alternative for my own use.
How it works
Edit hugo.yml (params: block) → push to main → GitHub
Actions builds with Hugo + bonsai → output deploys to GitHub Pages.
Local development
Requires Hugo Extended ≥ 0.128.
hugo server # http://localhost:1313
hugo --gc --minify # build to ./public
Deployment
Every push to main deploys to GitHub Pages. The workflow self-enables Pages
on first run via actions/configure-pages@v5 with enablement: true, so no
manual UI setup is required for fresh forks (provided Settings → Actions →
General → Workflow permissions is set to "Read and write").
(Optional) Custom domain: drop a static/CNAME file containing your apex
domain — Hugo will copy it through to the deployed site.
Project layout
hugo.yml # site content — edit params here
content/_index.md # placeholder so Hugo renders the index
static/images/ # avatar etc.
themes/bonsai/ # bonsai theme (in-repo, full history)
.github/workflows/deploy.yml
public/ # build output (gitignored)