Source for rasonyang.dev: engineering notes on AICC, FreeSBC, Cascade Realtime Gateway, mlx-realtime and Web SIP Phone.
Built with Hugo (pinned in .github/workflows/pages.yml)
and the Blowfish theme
(git submodule at themes/blowfish, pinned by commit). Deployed to GitHub Pages by GitHub Actions
on every push to main.
git clone --recurse-submodules git@github.com:rasonyang/rasonyang.github.io.git
hugo new content posts/<slug>.md # created with draft: true
hugo server -D # preview drafts at http://localhost:1313One post per pull request. Remove draft: true and merge to publish.
projects:in front matter puts the post on a project page (/projects/<slug>/, with its own RSS feed). Values:aicc,freesbc,cascade-realtime-gateway,mlx-realtime,web-sip-phone.- Optional
featured.jpg(1200x630) in the post's bundle becomes its card and social image; without it the site defaultassets/img/default-feature.jpgis used. - New tag? Add
content/tags/<tag>/_index.mdwith the displaytitle(e.g.SIP,WebRTC) so it is not auto-capitalised. - Slugs are permanent once published.
- Link code by commit SHA, not
main. - Diagrams are committed as SVG, not rendered at runtime.
- Post ideas go in
notes/ideas.md.
- Comments: install the giscus app on this repo, enable
Discussions with a
Commentscategory, then setgiscus.repoIdandcategoryIdinconfig/_default/params.toml. - Analytics: set
analytics.goatcounter.codeinconfig/_default/params.toml.