Live site: https://taqiam.github.io/BoneLog/
Documentation: BoneLog docs (start here)
A small file-based blog on Blazor WebAssembly, write Markdown, push to Git, deploy static files. No CMS, no database.
- Fork this repo and enable GitHub Actions.
- Add posts under
src/BoneLog.Blazor/wwwroot/data/posts. - Edit
config.json, setBaseDir(e.g."/BoneLog/") andBaseDataPath("data/"). Deploy workflows patch<base href>inindex.htmland404.htmlfromBaseDir. - Settings → Pages → branch
gh-pages, root/. - Deploy: Actions → Deploy to GitHub Pages, or push tag
v1.0.0.
Push post changes → Update index on main refreshes index.json on main, then Update data on gh-pages syncs full data/ to the live site (no full deploy). Run Deploy to GitHub Pages for WASM, CSS, images under wwwroot/images/, or config.json changes.
| Topic | Link |
|---|---|
| Index | Documentation hub |
| Quick start | GitHub Pages |
| Publishing | Deploy & hosting |
| Custom hosting | Release zip & any host |
| Writing | Posts & Markdown |
| Paths | Paths & addresses |
| Search | Filters |
| Config | config.json |
| Workflows | GitHub Actions |
| Developers | Architecture |
| Goal | Location |
|---|---|
| Posts | wwwroot/data/posts/ |
| About | wwwroot/data/AboutMe.md |
| Settings & nav | wwwroot/config.json |
| Images | wwwroot/images/ |
| Styles | wwwroot/css/app.css |
PRs welcome, keep small and clear.